Using Data and Data Label Properties
Attach your data to the valueTable property. If you include a label column in your data attachment for valueTable, it can be used to label the legend if the rowSeriesFlag is selected. The rowSeriesFlag controls whether row or column data populates the graph:
 

When the rowSeriesFlag checkbox is not selected, the first numeric column from your data attachment will be used to populate the wedges in the pie. Each wedge will correspond to a row in that column and will display that row's relative value. If your data attachment has a label column, data from that column will be used in the legend.

If the rowSeriesFlag checkbox is selected, the first numeric row from your data attachment will be used to populate the wedges in the pie. Each wedge will correspond to a column in that row and will display that column's relative value. Column names will be used in the legend.

If your data attachment has no label column, select rowNameVisFlag to use row names in the legend when the rowSeriesFlag is not selected. By default, the label column is the first non-numeric text column in your data. Specify a column name in the labelColumnName property to set the label column to a specific column.
 

Using Interaction Properties

Commands
To assign a command to your graph, right-click in the Property Value field of the command property and select Define Command. Commands can be set up to execute when you click on an object or automatically execute the command when the value of an object reaches a specified threshold. See Building Displays>Define/Execute Command for information on how to set up commands.

Drill Down Displays
To specify a drill down display, double click on the drillDownTarget Property Name. Any display (.rtv) file can be targeted as a drill down. Based on your data attachment, substitutions are created that will be passed into drill down displays. To customize which substitutions will be passed into drill down displays, double-click on drillDownColumnSubs in the Object Properties window to open the Drill Down Column Substitutions dialog. Once a drill down target has been set, double-click on the pie wedge to activate the drill down. Drill down displays can be activated in the same window that contains the graph or open in a separate window. This allows you to build a customizable hierarchy of displays.

Use drillDownSelectMode to control how a drill down display is activated. Set to Anywhere to activate a drill down display by double-clicking anywhere on the graph. Set to Element Only to enable a drill down display only when you double-click on a wedge in the pie graph.

Tool Tips
Select the mouseOverFlag to enable tool tips for your pie graph. To display a tool tip, select the graph and point to a pie wedge with your mouse. The tool tip will contain information from your data attachment about that pie wedge.

Background Properties
Specify how the background is displayed in your pie graph.
 

Property Name	Description
bg3dFlag	Select to display a 3D edge on the background rectangle.
bgColor	Select the  button and choose a color from the palette to set the background color. The Default color is grey. Color properties are treated differently on Fx graphs than on other objects, see the Fx Graph Colors section below for more information.
bgGradientFlag	Select to display a gradient in the background rectangle.

Data Properties

Property Name	Description
rowSeriesFlag	Controls how row and column data populate the graph. If rowSeriesFlag is selected, the first numeric row from your data attachment will be used to populate the wedges in the pie. Each wedge will correspond to a column in that row and will display that column's relative value. Column names will be used in the legend.  If rowSeriesFlag is not selected, the first numeric column from your data attachment will be used to populate the wedges in the pie. Each wedge will correspond to a row in that column and will display that row's relative value. If your data attachment has a label column, data from that column will be used in the legend.
valueTable	Attach your data to the valueTable property. It is possible to graph multiple columns or rows of numeric data. If you include a label column in data attached to valueTable, it can be used to label either the x-axis or the legend, depending on whether the rowSeriesFlag is selected or deselected. NOTE: By default, the label column is the first non-numeric text column in your data attachment. Enter a column name in the labelColumnName property to set a specific label column.

Data Format Properties
Specify the format to display values in your pie graph.
 

Property Name	Description
labelColumnFormat	Select or enter the format of numeric or date labels displayed in the legend and in tool tips. To enter a format, use syntax from the Java DecimalFormat class for numeric labels and syntax from the Java SimpleDateFormat class for date labels. To enable tool tips, select the mouseOverFlag.
valueFormat	Select or enter the numeric format of wedge values displayed on wedges, in the legend and in tool tips. To enter a format, use syntax from the Java DecimalFormat class. To enable tool tips, select the mouseOverFlag.

Data Label Properties

Property Name	Description
columnDisplayNames	Set alternate display names for column names in your pie graph's data. Column names are displayed either along the x-axis or in the legend, depending on whether or not rowSeriesFlag is selected.
labelColumnName	Specify the name of a label column in your data attachment. If a labelColumnName is not specified, then by default the first non-numeric text column in your data attachment will be used as the label column.
rowLabelVisFlag	If selected, then data from the label column are displayed either along the x-axis or in the legend, depending on whether or not rowSeriesFlag is selected. Enter a column name in the labelColumnName property to specify a label column in your data attachment.
rowNameVisFlag	If your data attachment does not contain a label column (i.e. a non-numeric text column) select the rowNameVisFlag checkbox to use row names along the x-axis or in the legend, depending on whether or not rowSeriesFlag is selected.

Historian Properties

Property Name	Description
historyTableName	Specify name of table in your history database in which to store tabular data. See History Tables>Tabular Data for information.
historyTableRowNameFlag	If selected, data from the row name field will be stored in the first column of the table specified in historyTableName.

Interaction Properties

Property Name	Description
command	Assign a command to your pie graph. See Building Displays>Define/Execute Command for information.
commandCloseWindowOnSuccess	If selected, the window that initiates a system command will automatically close when the system command is executed successfully. This property only applies to system commands. With data source commands, the window is closed whether or not the command is executed successfully. For multiple commands, this property is applied to each command individually. Therefore if the first command in the multiple command sequence succeeds, the window will close before the rest of the commands are executed. NOTE: The commandCloseWindowOnSuccess property is not supported in the Display Server.
commandConfirm	If selected, the command confirmation dialog is enabled. Use the commandConfirmText property to write your own text for the confirmation dialog, otherwise text from the command property will be used. For multiple commands, if you Confirm the execution then all individual commands will be executed in sequence with no further confirmation. If the you Cancel the execution, none of the commands in the sequence will executed.
commandConfirmText	Enter command confirmation text directly in the Property Value field or select the  button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.
drillDownColumnSubs	Select the  button to open the Drill Down Column Substitutions dialog to customize which substitutions will be passed into drill down displays.
drillDownSelectMode	Control how a drill down display is activated. Select one of the following options: Anywhere - Activate a drill down display by double-clicking anywhere on the graph. Element Only - Enable a drill down display only when you double-click on a wedge in the pie graph.
drillDownTarget	Name of display (.rtv) file targeted as a drill down. See Building Displays>Drill Down Displays for information.
mouseOverFlag	Select to enable tool tips for your pie graph. To display a tool tip, select the graph and point to a pie wedge with your mouse. The tool tip will contain information from your data attachment about that pie wedge.

Label Properties

Property Name	Description
label	Edit label text directly in the Property Value field or select the  button to open the Edit Label dialog.
labelTextAlignX	Select x-axis position of label text from the drop down menu.
labelTextColor	Select the  button and choose a color from the palette to set the label text color. NOTE: Color properties are treated differently on Fx graphs than on other objects, see the Fx Graph Colors section for more information.
labelTextFont	Select font style of label text from the drop down menu.
labelTextSize	Set the height of the label text in pixels.

Legend Properties
Specify the way the legend is displayed in your pie graph.
 

Property Name	Description
legendBgColor	Select the  button and choose a color from the palette to set the background color of the legend. The Default color is grey. Color properties are treated differently on Fx graphs than on other objects, see the Fx Graph Colors section below for more information.
legendBgGradientFlag	Select to display a gradient in the legend background.
legendPercentVisFlag	Select to display the value percentages of your data in the legend.
legendPosition	Select Top, Bottom, Left or Right to position the legend relative to the plot area.
legendTextColor	Select the  button and choose a color from the palette to set the text color of the legend.  NOTE: Color properties are treated differently on Fx graphs than on other objects, see the Fx Graph Colors section for more information.
legendTextFont	Set the font to use for the legend text. NOTE: Bold fonts are not supported.`
legendTextSize	Set the font size for the legend text.
legendValueVisFlag	Select to display the numerical values of your data in the legend.
legendVisFlag	Select to display the legend.
legendWidthPercent	Set the percent of the total width of the object used for the legend.

Object Properties

Property Name	Description
anchor	Specify where to anchor an object in the display. NOTE: If an object has the dock property set, the anchor property will be ignored. The anchor property is only applied when the dimensions of the display are modified, either by editing Background Properties or resizing the window in Layout mode Select None, or one or more the following options: None Object not anchored. This is the default. Top Anchor top of object at top of display. Left Anchor left side of object at left of display. Bottom Anchor bottom of object at bottom of display. Right Anchor right side of object at right of display. When a display is resized, the number of pixels between an anchored object and the specified location remain constant. If an object is anchored on opposite sides (i.e. Top and Bottom or Left and Right), the object will be stretched to fill the available space.
dock	Specify the docking location of an object in the display. Select from the following options: None Object is not docked. This is the default. Top Dock object at top of display. Left Dock object at left of display. Bottom Dock object at bottom of display. Right Dock object at right of display. Fill Dock object in available space remaining in the display after all docked objects are positioned. If the dimensions of the display are modified, either by editing Background Properties or resizing the window in Layout mode, the properties (objX, objY, objWidth and objHeight) of docked objects will automatically adapt to match the new size of the display. When multiple objects are docked to the same side of the display, the first object is docked against the side of the display, the next object is docked against the edge of the first object, and so on. When objects are docked to multiple sides of the display, the order in which objects were added to the display controls docking position. For example, let's say the first object added to the display is docked at the Top and the second object is docked at the Left. Consequently, the first object will fill the entire width of the display and the second object will fill the left side of the display from the bottom of the first object to the bottom of the display. Objects in a display have the dock property set to Fill, are laid out across a grid in the available space remaining after all docked objects are positioned. By default, the grid has one row and as many columns as there are objects in the display. You can modify the grid in the Background Properties dialog. Once an object is docked, there are some limitations on how that object can be modified. Docked objects cannot be dragged or repositioned using objX and objY properties. Docked objects cannot be resized using the objWidth or objHeight properties. To resize you must drag on the resize handle. Docked objects can only be resized toward the center of the display (e.g. If an object is docked at the Top, only its height can be increased by dragging down toward the center of the display). Docked objects set to Fill cannot be resized at all. Docked objects cannot be moved using Align. Non-docked objects can be aligned against a docked object, but a docked object will not move to align against another object. Docked objects are ignored by Distribute.
objHeight	Set height of the object in pixels.
objName	Name given to facilitate object management via the Object List dialog. Select Tools>Object List.
objWidth	Set width of the object in pixels.
objX	Plot x-axis position of object.
objY	Plot y-axis position of object.
visFlag	Control visibility of the object.

Transition Properties

Property Name	Description
entranceDuration	Specify the length of time (in milliseconds) that the transition animation will take to display incoming data. NOTE: Duration is a significant value in the overall effect of the animation. The correct duration value depends upon the entranceType selected.
entranceTrigger	Choose whether to display the entrance transition on each data update or only once. Default is Once.
entranceType	Select the type of entrance transition from the drop down menu: Interpolate, Slide Left, Slide Right, Slide Up, Slide Down, Wipe Left, Wipe Right, Wipe Up, Wipe Down, Zoom Chart and Zoom Series.
exitDuration	Specify the length of time (in milliseconds) that the transition animation will take to hide data prior to new data being displayed. NOTE: Duration is a significant value in the overall effect of the animation. The correct duration value depends upon the exitType selected.
exitTrigger	Choose whether to display the exit transition on each data update or only once. Default is Once.
exitType	Select the type of exit transition from the drop down menu: Slide Left, Slide Right, Slide Up, Slide Down, Wipe Left, Wipe Right, Wipe Up, Wipe Down, Zoom Chart and Zoom Series.

Wedge Properties
Specify the way wedges are displayed in your pie graph. Click on any wedge to explode that wedge. Click on the exploded wedge again to collapse it.
 

Property Name	Description
wedgeExplodeRadiusPercent	Specify the percentage of the total radius that wedges will appear exploded from the center.
wedgeLabelPosition	Select from the following to add wedge labels that display information about each data point. NOTE: Wedge labels differ from tool tips in that they are always visible and do not react to mouse movement.   Callout Place labels in two vertical stacks on either side of the pie. Shrink the pie area if necessary to make room for the labels. Draw key lines from each label to the associated wedge. Shrinks labels as necessary to fit the space provided.   Inside Place labels inside the pie. Shrink labels to ensure that they do not overlap each other. Any label that cannot fit, as specified using the wedgeLabelTextSize property, is hidden from view.   Inside with Callout Place labels inside the pie. If labels are shrink below a legible size, they are converted to callout labels.   Outside Place labels around the boundary of the pie.
wedgeLabelTextColor	Select the  button and choose a color from the palette to set the text color of the wedge label.  NOTE: Color properties are treated differently on Fx graphs than on other objects, see the Fx Graph Colors section for more information.
wedgeLabelTextFont	Set the font to use for the wedge label text. NOTE: Bold fonts are not supported.
wedgeLabelTextSize	Set the font size for the wedge label text.
wedgeProperties	Specify the color of wedges in the pie graph. NOTE: Color properties are treated differently on Fx graphs than on other objects, see the Fx Graph Colors section for more information.

 

Fx Graph Colors
Color properties are treated differently on Fx graphs than on other objects. In the Display Builder, the Fx graphs color chooser dialog has five tabs:

The color chooser also has a button for selecting a properties Default color, which is described separately for each color property above.

Internally, all color properties on Fx graphs are stored as a 24-bit integer RGB value in the range of zero (black) to 16,777,215 (white). Therefore if a color property on an Fx graph is attached to data, you must provide an integer value in that range (not a color index between 0 and 252 as with other objects). A value of -1 indicates the default property color.

Note that the Default color and colors selected from the Swatches, HSB, and RGB tabs are only supported on Fx graphs. If a color is selected from one of those tabs and then copied and pasted to a color property on any other object, white will be used instead.

Thin Client Deployment - Additional Interactivity
The following additional interactivity is supported in a Thin Client deployment: 

Wedge Selection

• Click on a wedge to highlight by isolating it from the rest of the pie.

Data Tips

• Text boxes with data info popup when the mouse is over a data point.

Legend

• Position above, below, right, or left of trace area.
• Resize interactively.