Platforms to show: All Mac Windows Linux Cross-Platform

Back to CDSectorMBS class.

CDSectorMBS.Constructor   Private

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 15.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The private constructor.

CDSectorMBS.getImageCoor(offsetX as Integer = 0, offsetY as Integer = 0) as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Gets the image map coordinates of the sector as HTML image map attributes.

The image map coordinates will be in the following format:

shape="poly" cords="[x1],[y1],[x2],[y2] ..."
where (x1, y1), (x2, y2) ... are vertices of a polygon that approximate the sector. The format is specially designed so that it can easily be incorporated into HTML image maps.

This method should be called only after creating the chart image (eg. using BaseChart.makeChart, BaseChart.makeChart2 or BaseChart.makeChart3). The image map cannot be determined without creating the chart image first.
ArgumentDefaultDescription
offsetX0An offset to be added to all x coordinates in the image map. This is useful if the current image will be shifted and inserted into another image. In this case, the image map will need to be shifted by the same offset.
offsetY0An offset to be added to all y coordinates in the image map. See offsetX above for description.
Return Value
A text string representing the coordinates of the sector in HTML image map attribute format.

CDSectorMBS.getLabelCoor(offsetX as Integer = 0, offsetY as Integer = 0) as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Gets the image map coordinates of the sector label as HTML image map attributes.

The image map coordinates will be in the following format:

shape="rect" cords="[x1],[y1],[x2],[y2]"
where (x1, y1) and (x2, y2) are opposite corners of the box that encloses the sector label. The format is specially designed so that it can easily be incorporated into HTML image maps.

This method should be called only after creating the chart image (eg. using BaseChart.makeChart, BaseChart.makeChart2 or BaseChart.makeChart3). The image map cannot be determined without creating the chart image first.
ArgumentDefaultDescription
offsetX0An offset to be added to all x coordinates in the image map. This is useful if the current image will be shifted and inserted into another image. In this case, the image map will need to be shifted by the same offset.
offsetY0An offset to be added to all y coordinates in the image map. See offsetX above for description.
Return Value
A text string representing the coordinates of the sector label in HTML image map attribute format.

CDSectorMBS.setColor(colorvalue as color, edgeColor as color, joinLineColor as color)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 11.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Same as the other setColor method, but uses color instead of integer data type for passing color values.

See also:

CDSectorMBS.setColor(colorvalue as Integer, edgeColor as Integer = -1, joinLineColor as Integer = -1)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the fill color, edge color and join line color of the sector.

By default, the edge color is SameAsMainColor. For the join line color, if the circular label layout method is used, the default is Transparent, otherwise the default is SameAsMainColor.
ArgumentDefaultDescription
color(Mandatory)The color of the sector.
edgeColor-1The edge color of the sector. -1 means the color is unchanged.
joinLineColor-1The color of the line that join the sector perimeter with the sector label. -1 means the color is unchanged.

See also:

CDSectorMBS.setExplode(distance as Integer = -1)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Explode the sector.

ArgumentDefaultDescription
distance-1The explosion distance in pixels. -1 means the distance is automatically determined.

CDSectorMBS.setJoinLine(joinLineColor as color, joinLineWidth as Integer = 1)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 11.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Same as the other setJoinLine method, but uses color instead of integer data type for passing color values.

See also:

CDSectorMBS.setJoinLine(joinLineColor as Integer, joinLineWidth as Integer = 1)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the color and width of the join line used to connect the sector label to the sector perimeter.

By default, for circular label layout, the join line color is Transparent. For side label layout, the join line color is SameAsMainColor.
ArgumentDefaultDescription
joinLineColor(Mandatory)The color of the line that joins the sector perimeter with the sector label.
joinLineWidth1The line width of the join line.

See also:

CDSectorMBS.setLabelFormat(formatString as string = "")

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the format of the sector label.
Example
dim c as CDSectorMBS

// you can use label formats like this:

c.setLabelFormat("<*block,halign=left*><*font=timesbi.ttf,size=12,underline=1*>{label}<*/font*><*br*>US$ {value}K ({percent}%)")

// we can reduce that to this:

c.setLabelFormat("{label} {value} {percent}%")

// and it shows 3 numbers. With |1 after the variable name, we define the decimals after dot:

c.setLabelFormat("{label} {value|1} {percent|1}%")

// and

c.setLabelFormat("{label} {value|1.,} {percent|1.,}%")

// uses dot for thousands and comma for decimal separator.

To set the label format for all sectors, use PieChart.setLabelFormat.
ArgumentDefaultDescription
formatString(Mandatory)The format string. See PieChart.setLabelFormat for details.

CDSectorMBS.setLabelLayout(layoutMethod as Integer, pos as Integer = -1)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the layout method and location of the sector label.

To set the sector label layout method and location for all sectors, use PieChart.setLabelLayout.

ChartDirector supports two sector label layout methods - circular layout and side layout. For detail descriptions, please refer to PieChart.setLabelLayout.
ArgumentDefaultDescription
layoutMethod(Mandatory)Specify the layout method. Must be one of the predefined constants CircleLayout or SideLayout.
pos-1For circular layout, it is the distance between the sector perimeter and the sector label. A negative value (but not -1) means the sector label will be drawn in the interior of the sector.

For side layout, it is the distance between the pie perimeter and the left or right edges of the invisible containing rectangle (equal to the width of the rectangle minus the pie diameter and then divided by 2).

In either case, -1 means the distance is automatically determined.

CDSectorMBS.setLabelPos(pos as Integer, joinLineColor as color)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 11.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Same as the other setLabelPos method, but uses color instead of integer data type for passing color values.

See also:

CDSectorMBS.setLabelPos(pos as Integer, joinLineColor as Integer = -1)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the circular label layout method, and configure the join lines used to connect the sector label to the sector perimeter.

To set the sector label position or join line color for all sectors, use PieChart.setLabelPos.
ArgumentDefaultDescription
pos(Mandatory)The distance between the sector perimeter and the sector label. A negative value means the sector label will be drawn in the interior of the sector.
joinLineColor-1The color of the line that joins the sector perimeter with the sector label. The default is Transparent. The join line is ignored if the sector label is inside the sector.

See also:

CDSectorMBS.setLabelStyle(font as string = "", fontsize as Double = 8, fontcolor as Integer = &hffff0002) as CDTextBoxMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the style used to draw the sector label.

To set the label style for all sector labels, use PieChart.setLabelStyle.

See Font Specification for details on various font attributes.
ArgumentDefaultDescription
font""The font used to draw the sector label.
fontSize8The font size in points.
fontColorTextColorThe text color for the sector label.
Return Value
A TextBox object representing the prototype of the obj. This may be used to fine-tune the appearance of the obj.

See font specification here:
http://www.monkeybreadsoftware.net/faq-chartdirectorfontspecification.shtml

See also:

CDSectorMBS.setLabelStyle(font as string, fontsize as Double, fontcolor as color) as CDTextBoxMBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 11.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Same as the other setLabelStyle method, but uses color instead of integer data type for passing color values.

See also:

CDSectorMBS.setStyle(shadingMethod as Integer, edgeColor as color, edgeWidth as Integer = -1)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 11.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Same as the other setStyle method, but uses color instead of integer data type for passing color values.

See also:

CDSectorMBS.setStyle(shadingMethod as Integer, edgeColor as Integer = -1, edgeWidth as Integer = -1)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ChartDirector MBS ChartDirector Plugin 9.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the sector shading style, edge color and edge width.

This method is the same as CDPieChartMBS.setSectorStyle, except it only affects one sector. Please refer to CDPieChartMBS.setSectorStyle for the detail explanation of this method.

Arguments:
ArgumentDefaultDescription
shadingMethod(Mandatory)The sector shading style to use. -1 means to keep the existing value unchanged.
edgeColor-1The edge color of the sector. -1 means to keep the existing value unchanged.
edgeWidth-1The edge width of the sector. -1 means to keep the existing value unchanged.

See also:

The items on this page are in the following plugins: MBS ChartDirector Plugin.


The biggest plugin in space...