Visit Gigasoft's Web Site
 ProEssentials v9 Help

PointColors

Scope

Pego, Pesgo, Pe3do, Pepso

Type

Property Array of type Color/Int32

Default

empty

.NET

PeColor.PointColors

Ocx|Vcl

PointColors

DLL

PEP_dwaPOINTCOLORS

 

Purpose

This property array allows control of colors for individual data points, bars, and line segments. If you use this property array, you must declare as many colors as you do YData, except for specific plotting methods as discussed below. When setting this property, it generally takes over all data coloring logic of SubsetColors.

 

Comments

If you do not assign enough colors to match YData, the unassigned colors will default to Black (Gdi/Hybrid), and default to Invisible (GdiPlus.)

 

For Line plotting methods, PointColorLineAdj optionally controls how line segments are colored.

 

PeColor.PointColors members of Pego.PeColor, Pesgo.PeColor, Pe3do.PeColor, Pepso.PeColor

 

This property has an effect on the following plotting methods (PlottingMethod): Point, Point plus Line, Point plus Best Fits, Bar, Line, HighLow, HighLowClose, OpenHighLowClose, BoxPlot, and Bubble.

 

For the Point plus Best Fit Line and Point plus Best Fit Curve plotting methods, the best fit line is still colored via the SubsetColors property.

 

For the specific plotting methods HighLow, HighLowClose, OpenHighLowClose, and BoxPlot plotting methods, you only need to define as many colors as there are Points. Not Subsets X Points as you would normally.

 

When using this property, the standard legends may confuse the user since they are designed to relate one color to a subset. There are two methods to improve this situation.

 

1) You can disable all subset legends by using SubsetsToLegend property array and setting the first element equal to -1.

 

2) You can use the LegendAnnotationType and related properties to define legends which identify the meaning of your colors. These legends are only shown if ShowAnnotations equals true so you may want to set this property equal to true and set the AllowAnnotationControl property to FALSE to prevent the user from removing the legends.

 

The format of the data is defined by the SubsetByPoint property.

 

When used with Surface Polygon mode of the 3D Scientific Graph object, this property controls the per polygon color. When used with the Scatter mode of the 3D Scientific Graph object, this property works similar to that of the Graph and Scientific Graph.

 

Within the demo, see example 008.

 

 

.NET Example

 

'// Subsets = 2 and Points = 4 so there is 8 data points

Pego1.PeColor.PointColors(0, 0) = Color.Red

Pego1.PeColor.PointColors(0, 1) = Color.Green

Pego1.PeColor.PointColors(0, 2) = Color.Blue

Pego1.PeColor.PointColors(0, 3) = Color.White

Pego1.PeColor.PointColors(1, 0) = Color.Black

Pego1.PeColor.PointColors(1, 1) = Color.Yellow

Pego1.PeColor.PointColors(1, 2) = Color.Orange

Pego1.PeColor.PointColors(1, 3) = Color.Purple

 

OCX Example

 

'// Subsets = 2 and Points = 4 so there is 8 data points

Pego1.PointColors(0, 0) = QBColor(1)

Pego1.PointColors(0, 1) = QBColor(4)

Pego1.PointColors(0, 2) = QBColor(7)

Pego1.PointColors(0, 3) = QBColor(1)

Pego1.PointColors(1, 0) = QBColor(4)

Pego1.PointColors(1, 1) = QBColor(7)

Pego1.PointColors(1, 2) = QBColor(1)

Pego1.PointColors(1, 3) = QBColor(4)

 

VCL Example

 

//* Subsets = 2 and Points = 4 so there is 8 data points

PEGraph1.PointColors[0, 0] := clRed;

PEGraph1.PointColors[0, 1] := clRed;

PEGraph1.PointColors[0, 2] := clBlue;

PEGraph1.PointColors[0, 3] := clGreen;

PEGraph1.PointColors[1, 0] := clRed;

PEGraph1.PointColors[1, 1] := clBlue;

PEGraph1.PointColors[1, 2] := clGreen;

PEGraph1.PointColors[1, 3] := clRed;

 

C / C++ Example

 

// Subsets = 2 and Points = 4 so theres 8 data points

DWORD dwPointColors[8];

dwPointColors[0] = RGB(255, 0, 0);

dwPointColors[1] = RGB(0, 255, 0);

dwPointColors[2] = RGB(0, 0, 255);

dwPointColors[3] = RGB(255, 0, 0);

dwPointColors[4] = RGB(0, 255, 0);

dwPointColors[5] = RGB(0, 0, 255);

dwPointColors[6] = RGB(255, 0, 0);

dwPointColors[7] = RGB(0, 255, 0);

PEvset (hWndPE, PEP_dwaPOINTCOLORS, dwPointColors, 8);