SetDataTransparency

Description

Sets the tranparency percentage of a data point in a series in a DirectX 3D graph (those with 3D rendering).

Applies to

Graph controls in windows and user objects, and graphs in DataWindow controls

Syntax

controlname.SetDataTransparency ( { graphcontrol, } seriesnumber, datapoint, transparency )

Argument

Description

controlname

The name of the graph in which you want to set data, or the name of the DataWindow control containing the graph.

graphcontrol (DataWindow control only)

(Optional) A string whose value is the name of the graph in the DataWindow control in which you want to set the tranparency value of a data point.

seriesnumber

The number that identifies the series in which you want to set data.

datapoint

The number of the data point for which you want to set a transparency value.

transparency

Integer value for percent transparency. A value of 0 means that the data point is opaque and a value of 100 means that it is completely transparent.

Returns

Integer. Returns 1 if it succeeds and -1 if an error occurs. If any argument’s value is null, SetDataTransparency returns null.

Usage

SetDataTransparency sets the transparency value for a data point in any DirectX 3D graph (those with 3D rendering).

Examples

Example 1

These statements set the transparency percentage to 50% for the clicked data in the graph gr_1 in the DataWindow control dw_employee:

integer SeriesNbr, ItemNbr, TransNbr

grObjectType clickedtype

// Get the number of the series and datapoint

clickedtype = this.ObjectAtPointer("gr_1", &

		SeriesNbr, ItemNbr)

//The following statement sets Transparency to 50%

TransNbr = 50

		

dw_employee.SetDataTransparency("gr_1", &

		SeriesNbr , ItemNbr, TransNbr)

Example 2

These statements set the transparency percentage to 50% for the clicked data point in the graph gr_employee.

integer SeriesNbr, ItemNbr, TransNbr

grObjectType clickedtype


clickedtype = gr_employee.ObjectAtPointer( &

		SeriesNbr, ItemNbr)


TransNbr = 50


gr_employee.SetDataTransparency(SeriesNbr, &

		ItemNbr, TransNbr)

See also