Visit Gigasoft's Web Site
 ProEssentials v9 Help

YData

Scope

Pego, Pesgo, Pepso, Pe3do, Pepco

Type

Single

Default

empty

.NET

PeData.Y

Ocx|Vcl

YData

DLL

PEP_faYDATA

 

Purpose

This property is used to transfer data into the object. The format of the data is defined by the SubsetByPoint property.

 

Comments

PeData.Y members of Pego.PeData, Pesgo.PeData, Pepso.PeData, Pe3do.PeData, Pepco.PeData

 

The Graph, Scientific Graph, and 3D Scientific Graph Objects use YData to identify the data measured against the Y Axis of the object.

 

The Polar/Smith Object uses PEP_faYData to identify magnitude (radius length.)

 

The Pie Chart Object uses YData to identify default slices to explode. A value of 0 not to explode, and a value of 1 to explode. If the quantity of YData does not equal the amount ofXData, then all subsets will be exploded with respect to the first subset of YData.

 

If greater precision is needed, set UsingYDataII to TRUE and use YDataII instead of this property.

 

When used with PEvget, the destination buffer must be large enough to hold all of information. For property arrays, calling PEvget with lpDest equal to NULL will return the number of bytes needed to hold the data.

 

See Also: ScaleForYData, XData, ZData.

 

Refer to the example 000 for more information on the use of this property.

 

WinForm VB.NET Example

'** For a Scientific Graph Object placed into a form **'

Pesgo1.PeData.Subsets = 4

Pesgo1.PeData.Points = 20

 

'** make some random data **'

For s = 0 To 3

  For p = 0 To 19

    Pesgo1.PeData.Y(s, p) = (p + 1) * 5 + (Rnd * (25))

  Next p

Next s

Pesgo1.PeFunction.ReinitializeResetImage

 

OCX Example

'** For a Graph Object placed into a form **'

PEGraph1.Subsets = 4

PEGraph1.Points = 20

 

' ** make some random data **'

For s = 0 To 3

   For p = 0 To 19

     PEGraph1.YData(s, p) = (p + 1) * 5 + (Rnd *  (25))

   Next p

Next s

PEGraph1.PEactions = 0 resets object

 

VCL Example

{ ** For a Graph Object placed into a form ** }

PEGraph1.Subsets := 4;

PEGraph1.Points := 20;

 

{ ** make some random data ** }

for s := 0 To 3 do

   for p := 0 To 19 do

      PEGraph1.YData[s, p] := (p + 1) * 5 + (Random * (25));

PEGraph1.PEactions := gReinitAndReset; {resets object}

 

C / C++ Example

hWndPE = PEcreate (PECONTROL_GRAPH, WS_VISIBLE, &rect, hWnd, 1);

PEnset (hWndPE, PEP_nSUBSETS, 4); /* Object has 4 subsets */

PEnset (hWndPE, PEP_nPOINTS, 20); /* Object has 20 points */

 

float fData[4][20]; /* first place data into fData */

/* set data, 4 subsets * 20 points = 80 elements */

PEvset (hWndPE, PEP_faYDATA, fData, 80);

 

PEreinitialize(hWndPE);

PEresetimage(hWndPE, 0, 0);