GetDataTransparency PowerScript function

Description

Obtains the transparency percentage of a data point 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>GetDataTransparency</span> ( { <span>graphcontrol</span>, } <span>seriesnumber</span>, <span>datapoint</span>, <span>transparency</span> )

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

Argument	Description
controlname	The name of the graph from which you want 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 from which you want the data.
seriesnumber	The number that identifies the series from which you want data.
datapoint	The number of the data point for which you want the 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, GetDataTransparency returns null.

Usage

GetDataTransparency retrieves data from
any DirectX 3D graph (those with 3D rendering).

Examples

These statements obtain the transparency percentage
of data point 3 in the series named Costs in the graph gr_computers in
the DataWindow control dw_equipment:

integer SeriesNbr, rtn, transp_value

1	integer SeriesNbr, rtn, transp_value

// Get the number of the series.

1	// Get the number of the series.

SeriesNbr = dw_equipment.FindSeries( &amp;

1	SeriesNbr = dw_equipment.FindSeries( &

        "gr_computers", "Costs")

1	"gr_computers", "Costs")

rtn = dw_equipment.<span>GetDataTransparency</span>( &amp;

1	rtn = dw_equipment.<span>GetDataTransparency</span>( &

<span>    </span>    "gr_computers" <span>,</span> SeriesNbr, 3, transp_value)

1	<span> </span> "gr_computers" <span>,</span> SeriesNbr, 3, transp_value)

These statements obtain the transparency percentage
of data point 2 in the series Costs in the graph gr_computers:

integer SeriesNbr, rtn, trans_value

1	integer SeriesNbr, rtn, trans_value

SeriesNbr = gr_computers.FindSeries("Costs")

1	SeriesNbr = gr_computers.FindSeries("Costs")

rtn = gr_computers.<span>GetDataTransparency</span>( SeriesNbr, &amp;

1	rtn = gr_computers.<span>GetDataTransparency</span>( SeriesNbr, &

        2, transp_value)

1	2, transp_value)

Connection Information

GetDataTransparency – PB Docs 125