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 |
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 |
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.
Argument | Default | Description |
offsetX | 0 | An 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. |
offsetY | 0 | An offset to be added to all y coordinates in the image map. See offsetX above for description. |
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 |
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.
Argument | Default | Description |
offsetX | 0 | An 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. |
offsetY | 0 | An offset to be added to all y coordinates in the image map. See offsetX above for description. |
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 |
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 |
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.
Argument | Default | Description |
color | (Mandatory) | The color of the sector. |
edgeColor | -1 | The edge color of the sector. -1 means the color is unchanged. |
joinLineColor | -1 | The 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 |
Argument | Default | Description |
distance | -1 | The 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 |
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 |
By default, for circular label layout, the join line color is Transparent. For side label layout, the join line color is SameAsMainColor.
Argument | Default | Description |
joinLineColor | (Mandatory) | The color of the line that joins the sector perimeter with the sector label. |
joinLineWidth | 1 | The 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 |
To set the label format for all sectors, use PieChart.setLabelFormat.
Argument | Default | Description |
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 |
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.
Argument | Default | Description |
layoutMethod | (Mandatory) | Specify the layout method. Must be one of the predefined constants CircleLayout or SideLayout. |
pos | -1 | For 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 |
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 |
To set the sector label position or join line color for all sectors, use PieChart.setLabelPos.
Argument | Default | Description |
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 | -1 | The 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 |
To set the label style for all sector labels, use PieChart.setLabelStyle.
See Font Specification for details on various font attributes.
Argument | Default | Description |
font | "" | The font used to draw the sector label. |
fontSize | 8 | The font size in points. |
fontColor | TextColor | The text color for the sector label. |
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 |
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 |
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 |
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:
Argument | Default | Description |
shadingMethod | (Mandatory) | The sector shading style to use. -1 means to keep the existing value unchanged. |
edgeColor | -1 | The edge color of the sector. -1 means to keep the existing value unchanged. |
edgeWidth | -1 | The 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.