SetDataTransparency PowerScript function

Description

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

Controls

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

Syntax

<span>controlname</span>.<span>SetDataTransparency</span> ( { <span>graphcontrol</span>, } <span>seriesnumber</span>, <span>datapoint</span>, <span>transparency</span> )

1	<span>controlname</span>.<span>SetDataTransparency</span> ( { <span>graphcontrol</span>, } <span>seriesnumber</span>, <span>datapoint</span>, <span>transparency</span> )

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.

Return Values

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

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

1	integer SeriesNbr, ItemNbr, TransNbr

grObjectType clickedtype

1	grObjectType clickedtype

// Get the number of the series and datapoint

1	// Get the number of the series and datapoint

clickedtype = this.ObjectAtPointer("gr_1", &amp;

1	clickedtype = this.ObjectAtPointer("gr_1", &

        SeriesNbr, ItemNbr)

1	SeriesNbr, ItemNbr)

//The following statement sets Transparency to 50%

1	//The following statement sets Transparency to 50%

TransNbr = 50

1	TransNbr = 50

<span>    </span>

1	<span> </span>

dw_employee.<span>SetDataTransparency</span>("gr_1", &amp;

1	dw_employee.<span>SetDataTransparency</span>("gr_1", &

        SeriesNbr , ItemNbr, TransNbr)

1	SeriesNbr , ItemNbr, TransNbr)

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

integer SeriesNbr, ItemNbr, TransNbr

1	integer SeriesNbr, ItemNbr, TransNbr

grObjectType clickedtype

1	grObjectType clickedtype

clickedtype = gr_employee.ObjectAtPointer( &amp;

1	clickedtype = gr_employee.ObjectAtPointer( &

        SeriesNbr, ItemNbr)

1	SeriesNbr, ItemNbr)

TransNbr = 50

1	TransNbr = 50

gr_employee.<span>SetDataTransparency</span>(SeriesNbr, &amp;

1	gr_employee.<span>SetDataTransparency</span>(SeriesNbr, &

        ItemNbr, TransNbr)

1	ItemNbr, TransNbr)

SetDataTransparency – PB Docs 126