Composite Properties
There are 2 standard properties in the composite category, rtvName and substitutions. Enter or select the name of a display (.rtv) file in the rtvName property to show that display in your object. The rtvName property should be set before any other properties. The rtvName display is referred to as the composite display. Once you have set the rtvName, the composite display will show up in your object, and all of the public variables from the composite display are added as properties. These properties can be set to static data or attached to data to drive the values in the composite display. While any display can be used as a composite display, there are some limitations on objects and variables names. See the Creating Composite Displays  section for more information.

The substitutions property allows you to set substitutions on the composite display. 

Property Name	Description
rtvName	Specify the name of the display (.rtv) file to show in your object. This display is referred to as the composite display. See Creating Composite Displays below for information on creating displays to use in composite objects.
substitutions	Specify the substitutions for the composite display. NOTE: The composite display also inherits substitutions from the display that contains the composite object.  Substitutions are optional and must use the following syntax: $subname:subvalue $subname2:subvalue2 If a substitution value contains a single quote, it must be escaped using a / : $filter:Plant=/'Dallas/' If a substitution value contains a space, it must be enclosed in single quotes. Do not escape these single quotes: $subname:subvalue $subname2:'sub value 2' A substitution string cannot contain the following: : | . tab space , ; = < > ' " & / \ { } [ ] ( )

Background Properties
Specify how the background is displayed in your composite object.
 

Property Name	Description
bgBorderColor	Select the  button and choose a color from the palette to set the color of the edge on the background rectangle. This property is only applicable if bgBorderFlag is selected.
bgBorderFlag	If selected, a border is drawn around the background rectangle,
bgColor	Select the  button and choose a color from the palette to set the background color.
bgEdgeWidth	Set the width of the 3D edge on the background rectangle. This property is only available if the bgStyle selected is 3D Rectangle.
bgGradientColor2	Select the  button and choose a color for the second color in the gradient. Default is white. NOTE: The bgColor property sets the first color in the gradient.
bgGradientMode	Display a gradient in the background rectangle. Select from the following options:     None No gradient   Diagonal Edge Gradient is drawn at a 45 degree angle from the top left to the bottom right corner of the object.   Diagonal Center Gradient is drawn at a 45 degree angle from the center to the top left and the bottom right corners of the object.   Horizontal Edge Gradient is drawn horizontally from the top to the bottom of the object.   Horizontal Center Gradient is drawn horizontally from the center to the top and bottom of the object.   Vertical Edge Gradient is drawn vertically from the left to the right of the object.   Vertical Center Gradient is drawn vertically from the center to the left and right of the object.
bgRaisedFlag	Reverses the direction of the gradient, as well as that of the 3D edge if the bgStyle selected is 3D Rectangle.
bgRoundness	Set the arc length of the rounded corners. This property is only available if the bgStyle selected is Round Rectangle. NOTE: The value of bgRoundness cannot exceed half the value of the objWidth or the objHeight. If bgRoundness does exceed that value, then half (of the smaller of the two values) of objWidth or objHeight will be used instead. For example if objWidth is 100 and objHeight is 50, then the value of bgRoundness cannot exceed 25. If it does, then half the value of objHeight (25) will be used instead.
bgShadowFlag	Select to display a drop shadow on the background rectangle.
bgStyle	Choose one of  the following three options from the drop down menu:   Rectangle Select to display a background rectangle. 3D Rectangle Select to display a 3D edge on the background rectangle. If selected, use bgEdgeWidth to set the width of the 3D edge. Round Rectangle Select to display a background rectangle with rounded edges. If selected, use bgRoundness to set the arc length of the rounded corners.
bgVisFlag	Select to display the background rectangle.
borderPixels	Set the amount of space (in pixels) between the object and the border.

Object Properties
Specify how you composite object is displayed.
 

Property Name	Description
objHeight	This property is read only. It shows the height in pixels of the composite object which is set by the height of the composite display.
objName	Name given to facilitate object management via the Object List dialog. Select Tools>Object List.
objWidth	This property is read only. It shows the width in pixels of the composite object which is set by the width of the composite display.
objX	Set the x position of the object.
objY	Set the y position of the object.
transparencyPercent	Sets the transparency of the object. This property only applies to the background of the composite object.
visFlag	Set the visibility of the object.

Interaction Properties
To specify a drill down display, double click on the drillDownTarget Property Name. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the composite object to activate the drill down. Drill down displays can be activated in the same window that contains the object or open in a separate window. This allows you to build a customizable hierarchy of displays.

The drillDownTarget and command for objects in a composite display will take precedence over the drill down target or command for the composite object. This is only supported for the Display Viewer and Display Viewer Applet and only if the composite object is not used in an object grid. In those cases, the drill down target or command on the composite object will be used.

Creating Composite Displays
Any display can be used as the display in a composite object, but there are some limitations to objects and variable names. To create a composite display, create a display in the Display Builder as usual. All public variables that are not mapped to substitutions will show up as properties on the composite object. If you do not want a variable to be exposed as a property, mark it as private. For example, you can create a display with two meters attached to two public variables, value1 and value2. When you use this display in a composite object, value1 and value2 will show up in the Composite category of the property sheet for the composite object. Whatever value you enter for these will drive the meters in your composite display. When the composite object is used in an object grid, these properties will also show up in the iconProperties dialog allowing you to either assigned them to values or to data columns.

The following limitations apply:

• To variable names in composite displays:

• None of the standard composite object property names can be used. This includes rtvName, substitutions and any property outside of the Composite category.
• Only public variables that are not mapped to data will show up as properties on the composite object.
• Names of all public variables used for tabular data must have Data Type set to Tabular.

• Composite displays can use any object from the Object Palette, except the composite object.
• Nested composite objects are not supported.
• The drillDownTarget and command for objects in a composite display will take precedence over the drill down target or command for the composite object.