PointColorsPtr

Purpose

This property is used to communicate to ProEssentials that the PointColors property should not allocate it's own memory, but instead use the local memory address that has already been allocated to the appropriate size. If JaggedData=False, the format of the data is defined by the SubsetByPoint property.
 

Comments

.Net developers note that methods such as PeColor.PointColors.UseDataAtLocation are documented in Chapter 3: .Net Property Arrays  

.Net Non-JaggedData: PeColor.PointColors.UseDataAtLocation
.Net JaggedData: PeColor.PointColors.UseJaggedDataAtLocation

DLL develppes must set this property with PEvset (Non-Jagged) or PEvsetcellEx (Jagged-Data).

When using PEvset to block copy this property, note color is (32 bit ARGB). For Winforms, see the Structs.peColor32 structure. 

Examples 146 and 123 show an implementation of this feature for XDataPtr and YDataPtr.

The advantages of using this feature are reducing the memory needs for your project:
1) multiple charts may use the same memory, for example, a 3D Surface and 2D Contour.
2) your project's logic may work with the same copy of memory as the chart.  

Related properties: PointColors, YDataPtr, XDataPtr