SetCollectedProp (Dundas Pie Chart Server 1.0)

Dundas

SetCollectedProp

Overview | Properties | Methods

Sets the properties for the collected data element.

Syntax

long = PieChartObject.SetCollectedProp([Label As String], [Color As Long = 16711680], [Texture As String])

The SetCollectedProp method syntax has the following parts:

Part

Description

Label

The label which will be displayed next to the collected data element.

Color

The underlying color to be used for the collected pie slice.

Texture

The texture to be used for the collected data element.

long

Returns a long indicating the success or failure of the operation. Zero (0) is returned if successful, otherwise a non-zero value is returned.

  Returns

A long which indicates the success/failure of the operation. Zero (0) is returned if successful, otherwise a non-zero value is returned. If an error occurs you can use this return value as the argument for GetErrorText in order to retrieve a relevant text error message, or alternatively you can rem out the "On Error Resume Next" statement and observe the thrown exception for a description of the error.

Remarks

Small data elements are "collected" and then displayed together as one pie slice called the "collected" element.

SetCollectedProp sets the properties of the collected pie slice. If the template (which MUST be loaded before calling this method) defines default values for the collected data element then these default values will be used if you do not specify a collected property. For example, if you call SetCollectedProp and specify a label and underlying color to be used for the collected pie slice then the default values (if they are defined in the template) will not be used, but the default texture will be used since we did not specify a texture in the SetCollectedProp call.

See Also: SetCollectedLimit | LoadTemplate | Template Creator Overview