SetSeriesTransparency

Description

Sets the tranparency percentage of 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.SetSeriesTransparency ( { graphcontrol, } series, 
transparency )

Argument

Description

controlname

The name of the graph in which you want to set a series transparency value, 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 a series transparency value.

series

The string that identifies the series for which you want to set the transparency value.

transparency

Integer value for percent transparency. A value of 0 means that the series 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, SetSeriesTransparency returns null.

Usage

SetSeriesTransparency sets the transparency value for a series in any DirectX 3D graph (those with 3D rendering).

Examples

Example 1

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

integer SeriesNbr, ItemNbr, TransNbr

string ls_SeriesName

grObjectType clickedtype


// Get the number of the series and datapoint

clickedtype = this.ObjectAtPointer("gr_1", &

		SeriesNbr, ItemNbr)


//Get the name of series		

ls_SeriesName = dw_employee.SeriesName("gr_1", &

		SeriesNbr)


//The following statement sets Transparency to 50%

TransNbr = 50	


dw_employee.SetSeriesTransparency("gr_1", &

		ls_SeriesName, TransNbr)

Example 2

These statements set the transparency to 50% for the clicked series in the graph gr_employee.

integer SeriesNbr, ItemNbr, TransNbr

string ls_SeriesName

grObjectType clickedtype


clickedtype = gr_employee.ObjectAtPointer( &

		SeriesNbr, ItemNbr)


ls_SeriesName = gr_employee.SeriesName(SeriesNbr)


TransNbr = 50


gr_employee.SetSeriesTransparency( & 

		ls_SeriesName, TransNbr)

See also