Using the Object Palette

This section contains the following:

§        “Add/Edit Objects” on page 32

§        “Object Properties” on page 36

§        “Object Descriptions” on page 41

Add/Edit Objects

RTView features a wide variety of objects accessible through the Object Palette or from the Add Objects toolbar at the top of the Display Builder.

Adding an Object

Open the Object Palette by clicking on the Open Object Palette button obj_palette_button.gifor by selecting Edit>Add.

Choose a tab from the Object Palette and click on an object. When an object is selected, a black border outlines the object and the class name of that object appears in the status bar at the bottom left of the palette.

object_palette.gif

 

Move the cursor into the Working Area. A + symbol appears next to the cursor, indicating that the application is in Add mode.

object_palette_select.gif

 

Click in the Working Area to place the object. To cancel Add mode, press the <Esc> key.

For more detailed information on each type of object, see “Object Descriptions”.

Connecting Objects (applies to Links only)

With two objects in your Working Area, choose the Links tab from the Object Palette and click on a link. A rectangle appears on the link when it is selected and the class name of the link appears in the status bar at the bottom left of the palette.

object_palette_link.gif

 

Move the cursor into the Working Area. An arrow appears next to the cursor, indicating that the application is in Connect mode.

object_palette_connect.gif

 

Click on the two objects in your display to connect them. To cancel Connect mode, press the <Esc> key.

Working with Objects

Set Location

Set the position in pixels of the objects in the display area with the objX and objY properties.

Move Objects

Click-and-drag to move objects within the Working Area or use the keyboard arrows to nudge objects. Select Tools>“Builder Options” to set the Keyboard Arrow Movement Amount. Click on the Grid grid_vis_button.gifbutton in the toolbar to toggle grid visibility. When the Snap to Grid grid_snap_button.gif button is selected, objects align to the grid while being dragged. See the Grid tab in the Builder Options dialog for additional settings.

Select Objects

Hold down <Ctrl> or <Shift> on your keyboard to select or deselect objects in the Working Area or click-and-drag to select multiple objects.

Note: The first object selected and objects not entirely included in the Select by Extent rectangle will not be selected.

Select by Extent replaces any current selection, unless you hold down <Ctrl> or <Shift> on your keyboard while performing the operation. You can also click on the Select by Extent selectbyextent_button.gifbutton in the toolbar to enter Select by Extent mode. Select Edit>Select All (or Ctrl-A) to select all objects.

Note: When selecting multiple objects, object properties and scaling only apply to the last object selected.

For a list of all objects currently in the Working Area, select Tools>Object List. Within the Object List hold down the <Ctrl> or <Shift> key to select or deselect objects in the list, which will be simultaneously selected in the Working Area.

Copy and Paste Objects

Select one or more objects from the Working Area and click the Copy button copy_button.gif in the toolbar (or right-click on an object). Then click the Paste button paste_button.gif. This will put you in Add or Connect mode depending on the object you have selected. If you are in Add mode, click in the Working Area to paste the object. If you are in Connect mode, click on two objects in your display to paste the link. When copying and pasting nodes with their links, select all nodes connected to the links in order to include them.

Copy and paste are also available via keyboard shortcuts:

        Ctrl-C to Copy

        Ctrl-V to Paste

Scale Objects

To resize an object, click and drag one of the green selection handles on the object.

Order Objects

Right-click on an object and choose Order (or select Edit>Order), then select Move to Front or Move to Back to move the selected object in front of or behind other objects in the Working Area.

Note: Objects are always drawn in front of links.

Align Objects

Hold down the <Ctrl> or <Shift> key and select at least two objects. Right-click on an object and choose Align from the popup menu (or select Edit>Align) and one of the following options. The alignment is based on the first object you select.

        Top - To align the tops of all objects against the first object selected.

        Bottom - To align the bottoms of all objects against the first object selected.

        Left - To align the left sides of all objects against the first object selected.

        Right - To align the right sides of all objects against the first object selected.

        Center Horizontal - To align the objects along their horizontal centers.

        Center Vertical - To align the objects along their vertical centers.

Distribute Objects

Hold down the <Ctrl> or <Shift> key and select at least two objects. Right-click on an object and choose Distribute from the popup menu (or, select Edit>Distribute) and one of the following options. The alignment is based on the first object you select.

        Horizontally - To put equal amounts of horizontal space between the objects without changing their vertical location.

        Vertically - To put equal amounts of vertical space between the objects without changing their horizontal location.

Preview Control Objects

Control objects are not active in the Display Builder main editing window. This enables you to setup a control objects without activating their associated action commands. To preview a control object in the Display Builder, save your file and click the Preview button preview_button.gif in the toolbar. Your display opens in a Preview Window that allows you to activate control objects. The Preview button becomes disabled when you edit your display. Save the display again to enable it.

Delete Objects

Click on the object and click the Delete button delete_button.gif in the toolbar or press <Delete> on your keyboard to remove an object from the Working Area.

Edit Object Properties

See the “Object Properties” section for information on how to edit objects from the Object Properties window.

Undo / Redo

Click the Undo / Redo button undoredo_button.gif in the toolbar to cancel or reapply up to one thousand consecutive actions. Select Tools>“Builder Options” to set the History List Size. Default setting is 20 consecutive actions.

Object Properties

RTView features a wide variety of objects. The Object Properties window lists attributes of the selected object and lets you edit property values. (See “Object Descriptions” section for descriptions of each object.)

all_obj_prop.gif

 

To open the Object Properties window, select an object and click the Object Properties button objectproperty_button.gifon the toolbar. In the Object Properties window, you can view and/or edit the property values of the object selected in the Working Area.

Editing Property Values

Property Names listed in the first column cannot be changed. Property Values, listed in the second column, can be set to static values or attached to dynamic data.

        Blue text signifies that a Property Value is static and cannot be attached to a dynamic data source.

        Green text signifies that a Property Value is currently attached to a dynamic data source and therefore it is no longer possible to edit this value from the Object Properties window. See the Attach to Data section specific to your data source for information on attaching dynamic data.

To remove a data attachment and resume editing capabilities from the Object Properties window, right-click on the Property Name (e.g., value) and select Detach from Data from the popup menu. An object property has been detached from the data source when the Property Name and Value are no longer green.

Copying Property Values

Copying and pasting makes it easy to transfer property values from one object to another.

There are two options for copying object properties:

        Copy All Properties - To copy all object properties, both static properties and data attachments, select an object and click the Copy button copy_button00001.gif on the toolbar.

        Copy Single Property - To copy an individual property from the Object Properties window, right-click on the Property Name and select Copy. To copy a property from the Edit Function dialog, right-click in a text field and select Copy.

There are four options for pasting object properties:

        Paste Data Attachments - To paste only data attachments, select one or more objects and click on the Paste Data Attachments button pastedata_button.gif on the toolbar or use the keyboard shortcut Ctrl+Shift+V. Note: Only properties common to both objects will be pasted onto the selected object(s).

         Paste Static Properties - To paste only the static properties, select one or more objects and click on the Paste Static Properties button pastestatic_button.gif on the toolbar. Note: Only properties common to both objects will be pasted onto the selected object(s).

         Paste All Properties - To paste all properties, select one or more objects and click on the Paste All Properties button pasteall_button.gif on the toolbar. This will paste all static properties as well as all data attachments. Note: Only properties common to both objects will be pasted onto the selected object(s).

         Paste Single Property - To paste an individual property into the Object Properties window, right-click on the Property Name and select Paste. The Paste option will only be enabled if the copied attribute can be set on the selected property (e.g., data attachments cannot be pasted onto static properties). To paste a property in the Edit Function dialog, right-click in a text field and select Paste.

Column Format Properties

In the Object Properties window, double-click on columnFormat in the Property Name field to bring up the Column Format Properties dialog. In the Column Format Properties dialog you can assign numerical and date formats to columns.

column_format.gif

 

Field Name

Description

Column Name

This list is populated based on the table's data attachment. If you have not yet attached the table to data, this list will be empty.

Column Format

Enter or select a format from the drop down menu and press <Enter>. Specify numerical formats using the Java format specification, or with the following shorthand: $ for US dollar money values, $$ for US dollar money values with additional formatting, () for non-money values, formatted similar to money, or # for positive or negative whole values. Specify date formats using the Java date specification.

Add Column

Enter the name of the column and click the Add Column button to insert a column into the table.

Clear

Click the Clear button to remove all Column Formats listed.

Note: Text columns containing data where all the values represent numbers are treated as if they are numeric columns, so number formats can be applied.

Image Property

Click in the image Property Value field and type the name of the image or select the ellipse_button00002.gif button to open the Select Image dialog containing up to three directories:

        Current Directory - Contains images in the current directory and one level of subdirectories.

        Custom Image Library - If you have specified a custom image library, this directory contains those images. See the “Creating a Custom Image Library” section for details.

        Symbol Library - Contains symbolic images (for example, symbols for various types of hardware, shapes, lights, arrows, etc.).

Navigate to the image you want to use and select it. A preview of the image appears in the pane to the right. Click OK or Apply to set the image on your object. If an image is not listed, enter the name of the file, including the relative path.

To scale your image to the size of the object, check the imageScaleFlag. The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object.

The sample display file general_objects.rtv (located in demos/tutorials) features information on working with objects from the General tab.

Creating a Custom Image Library

The custom image library enables you to make your own images available in the Select Image dialog. To add your own image library, perform the following steps.

1.     Place your images in a .jar file and add it to the “RTV_USERPATH” environment variable.

Note: The images must be in a directory and not at the top level of the .jar file. They can be organized into subdirectories of one top level directory.

2.     In the Display Builder, select Tools>Builder Options and, in the Custom Image Library Path field, set the path to the directory containing your .jar file.

For example, suppose you have a .jar file with the following directory structure:

com/mycompany/Images

com/mycompany/Images/Blue Images

com/mycompany/Images/Red Images

com/mycompany/Images/Green Images

In the Custom Image Library Path field you would enter com/mycompany/Images to add a directory named Images to the tree in the Select Image dialog. The Images directory will have three subdirectories: Blue Images, Red Images, and Green Images.

Note: Only directories containing images will be added to the Select Image dialog.

To access your custom image library, edit any property that allows you to set an image on an object (e.g. image, barImage, and filterProperties properties) or select File>“Background Properties” and edit the Image Name field.

webLabelFlag

In a Display Server deployment when the webLabelFlag property is selected, the object will be rendered as an HTML element in the thin client rather than rendered in the image by the Display Server. This allows the Display Server to update the individual object (if necessary) when the display is refreshed, instead of regenerating the entire display image. In some cases, this can improve the performance of the Display Server and thin client.

The webLabelFlag property also enables you to select an object's text and copy it to the clipboard.

General objects that support webLabelFlag are:

obj_rect

obj_rect_il

obj_rect_ilv

obj_rect_ilvs

obj_rect_ilvx_da3

obj_rect_ilvx_ra4

obj_circ2d

obj_circ2d_il

obj_circ2d_ilv

obj_circ2d_ilvs

obj_circ2d_ilvx_da3

obj_circ2d_ilvx_ra4

Use the following entry to set webLabelFlag in an rtview stylesheet (.rts) file:

rtv-all {

 webLabelFlag: 1;

}

Limitations

In the following situations, an object with webLabelFlag selected will still be rendered in the image by the Display Server:

§        Display is opened in Internet Explorer 8 or older.

§        Display Server is run with the -nohtml5 option set on the command line.

§        labelTextPosY is set to "Tab Top" (obj_rect*)

§        labelTextPosY is set to "Title Top" and bgBorderFlag is set to "true" (obj_rect*)  

§        obj_rect* with non-html object above it in Z-order which overlaps (e.g. obj_rect* used as a background behind several meter objects)

§        Object is inside an object grid, and is not inside a composite object in that grid.

In other cases, an object may have a slightly different appearance in the thin client when it is rendered as HTML:

§        bgGradientMode property set to "Diagonal Edge" or "Diagonal Center" is treated as "Vertical Edge" (Only vertical and horizontal gradients are supported on HTML objects in the thin client.)

§        bgShadowFlag property is ignored

Object Descriptions

RTView objects are categorized in the Object Palette according to the appearance and behavior of each type of object. This section describes how to work with each type of object and assumes you have already reviewed the following: “Add/Edit Objects”, “Object Properties”, and the Attach To Data section for your data source.

To view sample displays with tutorials, product features, and data source specific examples go to the demos directory, run the data simulators that apply to your “RTView Data Sources” and start the Display Builder. Open the file alldisplays.rtv and double-click on your selection.

Note: To learn how to start the Display Builder and run the data simulators refer to the “Quick Start Tutorial”.

Object Palette

object_palette00003.gif

 

Graphs

Graphs are useful for comparing data. Trend graphs are used to display a single variable per trace over time. Bar, pie, radar, and XY graphs are designed to display information returned by a tabular element in your data attachment. See “Graph Objects” for details.

Tables

Tables offer the ability to display large amounts of data. See “Table Objects” for details.

General

The General tab contains flexible objects that can be used to display data and images in addition to executing commands either manually or based on thresholds. To display values on these objects, attach the value property to numeric data or the valueString property to text data, and the label property to text data.

If you have a very long label or valueString and do not want to have the label/valueString extend past the edges of the rectangle, you can select the bgClipTextFlag option in the Background category in Object Properties to clip the edges of the text so that only that portion within the rectangle displays. Note: The bgVisFlag must be enabled for bgClipTextFlag to work.

General objects that feature the image property can be customized to display your image (.gif, .jpg, or .png) file.

The styleClass property allows you to enter the style class name for this object as defined in your “Style Sheets”. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

The “webLabelFlag” property allows select objects to be rendered as HTML elements in a thin client deployment.

Threshold Objects

Objects labeled Range Dynamic and Discrete Dynamic on the General tab support threshold functionality, allowing you to change the image and color of the object as well as execute a threshold command from the object based on the current value of the value property. Both the range dynamic and the discrete dynamic objects have the thresholding functionality turned off by default. In the descriptions below, the object's value is the current value of the value property. See “Threshold Commands” for more information.

Range Dynamic 

Range dynamic objects allow you to setup your threshold so that if the object's value is within a range of numbers, the threshold functionality executes. To enable the high alarm threshold, check the valueHighAlarmEnabledFlag. This will enable several related properties. When the object's value is greater than or equal to the valueHighAlarm property, the background of the object will change to the valueHighAlarmColor, the bitmap on the image will change to the valueHighAlarmImage and the valueHighAlarmCommand will be executed. To enable the high warning threshold, check the valueHighWarningEnabledFlag. When the object's value is greater than or equal to the valueHighWarning, but less than the valueHighAlarm, the background of the object will change to the valueHighWarningColor, the bitmap on the image will change to the valueHighWarningImage and the valueHighWarningCommand will be executed. The low alarm and low warning threshold properties work the same way, but activate when the object's value is less than or equal to the valueLowAlarm or valueLowWarning properties.

For both the discrete dynamic and range dynamic objects, threshold commands will only execute if the number of seconds specified in the valueCommandTimeout has elapsed since the previous threshold command was executed and the value has changed to another threshold. For example, if the high warning threshold range is between 40 and 50, when object's value enters this range, the valueHighWarningCommand will be executed. The valueHighWarningCommand will not be executed again until the object's value leaves the high warning threshold range and then re-enters it. If this occurs in less time than is specified in the valueCommandTimeout property, it will not be executed until that time elapses. If the valueCommandTimeout is set to 0, the internal default, 5 seconds, is used.

Discrete Dynamic 

Discrete dynamic objects are similar to range dynamic objects, except that the threshold functionality is executed when the object's value equals the threshold value instead of when it is within the range of threshold values. To enable the high alert threshold, check the valueHighAlertEnabledFlag. When the value property equals the valueHighAlert, the background of the object will change to the valueHighAlertColor, the bitmap on the image will change to the valueHighAlertImage and the valueHighAlertCommand will be executed. To enable the medium alert threshold, check the valueMediumAlertEnabledFlag. When the value property equals the valueMediumAlert, the background of the object will change to the valueMediumAlertColor, the bitmap on the image will change to the valueMediumAlertImage and the valueMediumAlertCommand will be executed. The low alert threshold property works the same way, but activates when the object's value is less than or equal to the valueLowAlert property.

For both the discrete dynamic and range dynamic objects, threshold commands will only execute if the number of seconds specified in the valueCommandTimeout has elapsed since the previous threshold command was executed and the value has changed to another threshold. For example, if the high warning threshold range is between 40 and 50, when object's value enters this range, the valueHighWarningCommand will be executed. The valueHighWarningCommand will not be executed again until the object's value leaves the high warning threshold range and then re-enters it. If this occurs in less time than is specified in the valueCommandTimeout property, it will not be executed until that time elapses. If the valueCommandTimeout is set to 0, the internal default, 5 seconds, is used.

Labels

The Labels tab includes several types of labels. All of the labels have at least one of the following properties: value, valueString, and label. The value property used to display numeric data, either from a data attachment or static values. Some labels can be designed to change color according to value property or feature vu meters to dynamically display that data. The valueString and label properties are both used to display text data, either from a data attachment or static values.

Meters

Meters are useful for displaying data that falls within a known range. You can control the range of data displayed in the meter by setting the valueMax and valueMin properties. Attach your data to the value property.

The styleClass property allows you to enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used. See “Creating Style Sheets” for more information.

Note: The value entered must not contain spaces and cannot start with rtv-.

Scales

Scales are useful for displaying data that falls within a known range. You can control the range of data displayed in the scale by setting the valueMax and valueMin properties. Attach your data to the value property. All of the scales, except the pie scale, support a variety of axis styles and can be oriented vertically or horizontally. See “Scale Objects” for details.

Indicators

The Object Palette features four types of “Indicator Objects”:

        Discrete - Supports 3 discrete comparisons.

        Limits - Supports 2 high and 2 low thresholds.

        Multi - Supports an unlimited number of comparison values.

        Panel - Panel of 2 or 3 indicator lights, each supports a discrete comparison.

For all indicators, attach your data to the value property and setup comparisons using the properties in the Alert category. Indicators that feature the “Image Property” can be customized to display your image (.gif, .jpg or .png) file.

Note: Objects previously featured on the Indicators tab will continue to function in existing displays, but are no longer available in the Object Palette.

Controls

Controls allow you to issue action “Commands” and update variables (see “Add/Edit Variables”) that may be used to control other objects in the display. The visFlag property controls the visibility of the object. See “Control Objects” for details.

Links

The Links tab features three objects. The Direct link draws a straight line between the objects it connects. The Direct Offset link attaches to objects at a right angle, but draws a diagonal line for the remainder of the link. The Orthogonal link draws a line at right angles between the objects it connects. See “Link Objects” for details.

Composite

The Composite tab features pre-configured composite objects. The composite object allows you to show a display (.rtv) file within an object. This is useful for creating groups of objects that you want to use multiple times, either directly in your display, or in an object grid. See “Composite Object” for details.

Fx Graphs

Our Adobe® Flash graphs have been designed specifically for use in a Thin Client deployment. These graphs are similar to objects featured on the Graphs tab, but support additional interactivity. See the “Fx Graphs” page for details.

Composite Object

The composite object (class name: obj_composite) allows you to show a display (.rtv) file within an object. This is useful for creating groups of objects that you want to use multiple times, either directly in your displays or in the “Object Grid”.

composite_object.gif

 

Creating Composite Displays

First, create the display that you want to use inside of a composite object. This display is referred to as the composite display. While any display (.rtv) file can be used as a composite display, there are some rules about constructing that display:

        Property names for composite objects cannot be used as variable names, in the Composite section this only includes rtvName and substitutions.

        Only public variables that are not mapped to data or substitutions 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. See “Add/Edit Variables” for more information.

        Composite displays can use any object from the Object Palette, except the composite object.

        Nested composite objects are not supported.

Next, open new display and add a composite object. On the composite object, set the rtvName property to the name of the composite display you just created.

Note: The rtvName property should be set before any other properties.

Once you have set rtvName, all public unmapped variables in the composite display will show up as properties on the composite object. Like any other property, you can attach those properties to data or set them to static values. See “Add/Edit Variables” for more information.

Note: If you do not want a variable to be exposed as a property, mark it as private.

For example, you can create a display (.rtv) file with two meters that are attached to two public variables: value1 and value2. When you enter the name of that display (.rtv) file in the rtvName property of the composite object, then value1 and value2 will show up in the Composite section of the Object Properties list. These properties can be set to static data or attached to data to drive the values in the composite display. When the composite object is used in an “Object Grid”, these properties will also show up in the iconProperties dialog, which allows you to assign them to either values or data columns.

Note: Composite objects used in Object Grids must have their bgOpaqueFlag property selected.

Use the tabcomposites property to enable the Tab key to switch focus to controls that are inside composite objects. See “Command Line Options: Display Builder and Display Viewer” for more information.

Using Interaction Properties

The specified drillDownTarget or command for objects in the composite display will take precedence over the drillDownTarget or command set on the composite object when it is instanced directly in a display. When the composite object is used in an Object Grid, the specified drillDownTarget or command for objects in the composite display will take precedence over the drillDownTarget or command set on the Object Grid.

For example, let's say you have a composite display with an object that drills down to display A and you set a drillDownTarget on the composite object to display B. When you click on the composite object, if you click directly on the object that drills down to display A, then display A is opened. If you click anywhere else in the composite display, then display B is opened.

A similar thing happens when you use that composite object in an Object Grid. However, in this case, you can't set a drillDownTarget on the composite object, you can only set the drillDownTarget on the Object Grid. So, let's say you set the Object Grid to drill down to display B. Again when you click directly on the object in the composite display that drills down to A, display A is opened. When you click anywhere else in the composite or in the Object Grid, display B is opened.

Commands

To assign a command, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click to activate the drill down. Drill down displays can be activated in the same window or opened in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Background Properties

Property Name

Description

bgBorderColor

Select the ellipse_button00004.gif 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 ellipse_button00005.gif 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 ellipse_button00006.gif button and choose a color for the second color in the gradient. Default is white.

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.

bgOpaqueFlag

When a composite object is used in an “Object Grid”, the bgOpaqueFlag property must be selected. If deselected, then objects inside a composite that is clipped by the edge of the Object Grid may be drawn outside the Object Grid.

In order to avoid showing a border around each composite object in the Object Grid, select Edit>Model Properties and deselect the bgBorderFlag.

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.

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.

Composite Properties

There are two standard properties in the Composite section: rtvName and substitutions. Once you have set the rtvName property, the composite display will show up in your composite object and all of the public variables from the composite display that are not mapped to data or substitutions will be added as Composite properties. See “Add/Edit Variables” for more information.

Property Name

Description

resizeMode

Specify how the composite object is resized. There are two modes:

Size to Display -The size of the composite object is determined by the size of the display it contains. The composite object cannot be resized. This is the default setting. The dock and anchor properties should not be used in this mode.

Layout -The composite object can be resized. Objects in the composite display are situated according to their anchor and dock properties. The dock and anchor properties can be set on the composite object so that it resizes during a window resize if the window resize mode is also set to Layout. If the window resize mode for the display containing the composite object is set to Scale, the composite object performs a scale instead of a layout.

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” for details.

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 , ; = < > ' " & / \ { } [ ] ( )

Historian Properties

Property Name

Description

historyTableName

Specify name of table in your history database in which to store tabular data. See “Configuring the Historian” 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. See “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 ellipse_button00007.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00008.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to TabTop.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title Top - Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00009.gif button and choose a color from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

Set the height of the label text in pixels.

Object Properties

Property Name

Description

anchor

Specify where to anchor an object in the display.

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.

If the Resize Mode is set to Scale and an object is anchored on opposite sides, then the object with be moved rather than stretched to fill the available space.

dock

Specify the docking location of an object in the display.

An object should not be docked if the Resize Mode is set to Scale.

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

This property is read only. It shows the height in pixels of the composite object. See “Creating Composite Displays” for more information.

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. See “Creating Composite Displays” for more information.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used. See “Creating Style Sheets” for more information.

Note: The value entered must not contain spaces and cannot start with rtv-.

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.

Control Objects

The Controls tab features objects that allow you to issue commands and update variables that may be used to control other objects in the display. The sample display file controls.rtv (located in demos/tutorials) features information on working with objects from the Controls tab.

The value, valueString, and selectedValue properties allow you to set the value for the controls. The varToSet property allows you to update the attached variable with the value from the control.

The actionCommand property allows you to set up a command which will be executed from the control. This actionCommand can reference the value from the control by using the keyword $value. To enable selecting, moving and editing the controls without activating the associated action command, the controls are not active in the main window of the Display Builder.

The tabIndex property allows you to define the order in which table and control objects will receive focus when navigated from your keyboard. Initial focus is given to the object with the smallest tabIndex value, from there the tabbing order proceeds in ascending order. If multiple objects share the same tabIndex value, then initial focus and tabbing order are determined by the alpha-numeric order of the object names. Objects with a tabIndex value of 0 are last in the tabbing order.

Note: The tabIndex property does not apply to Slider objects or objects that are disabled, invisible, or have a value of less than 0.

To preview a control object in the Display Builder, save your file and click the Preview button preview_button00010.gif in the toolbar. Your display opens in a Preview Window that allows you to activate control objects. The Preview button becomes disabled when you edit your display. Save your display again to enable it.

Some control object properties cache their colors and therefore do not update when a custom color definition changes. You will need to either to restart RTView or reload the display to see the color change for these objects.

The Controls tab features the following objects:

Navigation Controls

Navigation controls allow you to create a rich and compact visual presentation of hierarchical data. Navigation controls are most often used in a multi-panel application for display navigation. Typically, the navigation control is shown in one panel and another panel contains the displays which you drill-down to by selecting items in the navigation control. Navigation controls can also be used in any application where hierarchical data is most effectively displayed using expandable/collapsible nodes.

You can optionally configure status icons for navigation controls, using images of your choice, to visually indicate whether an element is in a critical state, and to also propagate the status of elements to the top of the navigation control (see the tree control, for example, below).

Tree Control 

With the tree control (class name: obj_c1tree), multiple nodes can expand at a time. The tree control not only allows you to configure status icons and to propagate the status up to parent nodes - you can also configure type icons. Type icons are static images you assign to tree nodes to visually indicate the element type (for example, Production or Sales) or the node depth.    

nodepropogationup.gif

 

For details, see “Tree Control”.

Accordion Control

With the accordion control (class name: obj_c1accordion), nodes appear as pushbuttons and a single node expands at a time. The accordion control visually indicates whether an element in the accordion is closed or open. As with the tree control, the accordion control allows you to configure status icons and to propagate the status up to parent nodes. The accordion control does not display type icons (as the tree control can).   

accordpropogationup.gif

 

For details, see “Accordion Control”.

Text Entry Fields

There are three text entry fields to choose from:

        obj_c1textedit: Allows you to enter numeric or text information. Attach your data to valueString to update the value shown in this text entry field from your data.

        obj_c1textedit_i: Accepts only numbers without decimal points.

        obj_c1textedit_d: Allows numbers with decimal points.

Attach your data to value to update the values shown in these text entry fields from your data.

Note: To get initial values from an internal RTView variable and base those values on user interaction, you must attach the value and varToSet properties to the same variable.

The actionCommand is executed and the variable attached to varToSet is updated with the data you typed into the text entry field when you press <Enter> and, if the executeOnFocusLostFlag is selected, when the text entry field loses focus. To disable text entry, deselect the editableFlag check box. If the editableFlag is off and enabledFlag is on, the mouse and arrow keys can still be used to move the cursor. If the executeOnKeystrokeFlag check box is selected, then each keystroke that modifies the text field will set the varToSet variable and execute the actionCommand, if applicable, using the modified text.

Note: In a Thin Client deployment there may be a delay between the keystroke and the response, depending on the speed of your network and server.

The following properties support input validation. Attach inputValidVarToSet to a local variable and this variable will be updated when the control executes with a value of 1 if the input is valid or a value of 0 if the input is invalid. Attach invalidInputMsgVarToSet to a local variable and this variable will be updated when the control executes with an error message if the input is invalid or an empty string if the input is valid. If validation fails, the actionCommand will not be executed. By default, input validation occurs whenever a control executes (i.e. when you press <Enter>). If executeOnFocusLostFlag is selected, then the control will also execute whenever the object loses focus. If executeOnKeyStrokeFlag is selected, the control will also execute whenever a key is pressed while the object has focus. For numeric validation, set valueMax and valueMin to specify the maximum or minimum valid values. If left blank, there will be no maximum or minimum value validation. Additionally, the following properties apply for text string validation:

        characterCase - Select from the following options: Mixed Case, Upper Case, or Lower Case.

        minCharacters - Specify minimum number of characters allowed in the field. If left blank, there will be no validation of minimum number of characters.

        maxCharacters - Specify maximum number of characters allowed in the field. If left blank, there will be no validation of maximum number of characters.

To set the bgColor and fgColor properties of a text entry field, click on the ellipse_button00011.gif button and choose a color from the palette. The bgColor property sets the color of the object's background area and the fgColor property sets the color of the text. When bgColor and fgColor properties are set to Default, then the text entry field will adopt default settings for background and foreground colors. For example, in the Display Viewer the text entry field in your display will adopt a standard Java appearance. When that same display is viewed via Thin Client Browser, the text entry field will conform to that browser's color preferences.

Use the valueTextAlignX property to set text alignment: Left, Center, or Right.

Note: The selected alignment can only be applied if the length of the text is less than the length of the text entry field.

Use the mouseOverText property to enter a tool tip for this control. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. control\nobject).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

The styleClass property allows you to enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used. NOTE: The value entered must not contain spaces and cannot start with rtv-.

The numeric text entry controls (obj_c1textedit_i and obj_c1textedit_d) support a validation option for blank entries. To enable this feature, select the validateBlankValuesFlag property. If selected and a blank string is entered, the actionCommand will not execute and invalidInputVarToSet and invalidInputMsgVarToSet will indicate an invalid entry.

Set the executeOnlyIfChangedFlag property to true to have the control's command execute only when the text in the control is changes. The text control's varToset and valueString or value property must be attached to the same local variable. By default, executeOnlyIfChangedFlag is false. When false, the control's command is executed when the control loses focus (if executeOnFocusLostFlag = true or the control is a text area), or when the user presses the Enter key in the control (if the control is not a text area), regardless of whether the text in the control was changed. (This matches the text control behavior in all previous releases.)

Text Area Object

The text area control supports display and entry of multi-line text with optional word wrap. Scrollbars will appear as needed. Attach your data to valueString to update the value shown in this text area from your data.

The actionCommand is executed and the variable attached to varToSet is updated with the data you typed into the text area control when the text area control loses focus. To disable text entry, deselect the editableFlag check box. If the editableFlag is off and enabledFlag is on, the mouse and arrow keys can still be used to move the cursor. If the executeOnKeystrokeFlag check box is selected, then each keystroke that modifies the text area will set the varToSet variable and execute the actionCommand, if applicable, using the modified text.

Note: In a Thin Client deployment there may be a delay between the keystroke and the response, depending on the speed of your network and server.

To set the bgColor and fgColor properties of a text area object, click on the ellipse_button00012.gif button and choose a color from the palette. The bgColor property sets the color of the object's background area and the fgColor property sets the color of the text. When bgColor and fgColor properties are set to Default, then the text area control will adopt default settings for background and foreground colors. For example, in the Display Viewer the text area control in your display will adopt a standard Java appearance. When that same display is viewed via Thin Client Browser, the text area control will conform to that browser's color preferences.

Use the mouseOverText property to enter a tool tip for this control. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. control\nobject).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

The styleClass property allows you to enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

maxCharacters - The maximum number of characters that is submitted to the control's actionCommand. The default value is blank (no limit). The limit does not restrict the length of the text in the control, instead the limit is checked before the command is executed and if the limit is exceeded, the command is not executed.

inputValidVarToSet - Attach to a local variable. This variable is updated with a value of 1 if the maxCharacters limit is blank or the text is less than or equal to the maxCharacters limit, or updated with a value of 0 if the text length exceeds the maxCharacters limit.

invalidInputMsgVarToSet - Attach to a local variable. This variable is updated with an error message if the text length exceeds the maxCharacters limit, or updated with an empty string if the text length is less than or equal to the maxCharacters limit.

In the Display Viewer, pressing the <Tab> key inside a text area control inserts a tab character in the text. To move the keyboard focus away from a text area control, either click outside of the control or press <Ctrl-Tab>. In the Display Viewer Applet, pressing the <Tab> key inside a text area will move the keyboard focus.

Button 

The actionCommand is executed and the variable attached to varToSet is updated with the value from the valueToSet property when you click on the button.

Use the hotKey property to enable keyboard activation on a button. Assign an alphanumeric value (A-Z or 0-9) to be used on the keyboard with the Alt key. The button is activated when the panel it resides in has focus and the user holds down the Alt key and simultaneously selects the assigned value on the keyboard. For example, Alt+B, where B is the assigned key.

When keyboard activation is enabled and the defaultButtonFlag is selected, a button can be activated by pressing the <Enter> key. In the display, the activated button will be highlighted with an extra border. While multiple objects in the display can have the defaultButtonFlag selected, it will only apply to first one added to the display.

Note: The defaultButtonFlag property does not apply to objects that are disabled or invisible. If you are viewing the Display Server in Firefox, another control object must have focus when the <Enter> key is pressed in order for the button to be activated.

To set the bgColor and fgColor properties of a button, click on the ellipse_button00013.gif button and choose a color from the palette. The bgColor property sets the color of the object's background area and the fgColor property sets the color of the text. When bgColor and fgColor properties are set to Default, then the button will adopt default settings for background and foreground colors. For example, in the Display Viewer the button in your display will adopt a standard Java appearance. When that same display is viewed via Thin Client Browser, the button will conform to that browser's color preferences.

Use the mouseOverText property to enter a tool tip for this control. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. control\nobject).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

The styleClass property allows you to enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

Use the menuItemIndex, menuItemGroup and menuItemSubmenu properties with the button to extend the RTView context menu. For details, see “Extending the Context Menu”.

The image property enables you to customize a button to display your image (.gif, .jpg or .png) file. Click in the Property Value field and type the name of your image. Or, click on the ellipse_button00014.gif button to open the Select Image dialog.

A button can display an image, a label, or both. If both the image and label properties are set, the image will be to the left of the label. It is best to leave several pixels of padding between the image and/or label of a button to avoid wrapping or clipping of text.

The appearance of a button with an image and/or label can vary slightly between the Display Viewer and supported browsers. You may notice the following variations:

        Alignment of the image inside the button: The image may be somewhat closer to the top or bottom edge of the button.

        Vertical alignment (if any) of the image with the button's label: The center of the image may be somewhat lower or higher than the center of the label.

        Appearance of the image and label if they don't fit inside the button: In some cases the label may be clipped with an ellipsis (...) replacing the clipped text, or the label may be clipped with no indication, or the label may wrap and may extend below the button.

Note: In Firefox a button with an image will not depress when it is clicked, however the button's command will still be executed.

Check box

Attach your data to the value property to update the value displayed by the check box. Note: To get initial values from an internal RTView variable and base those values on user interaction, you must attach the value and varToSet properties to the same variable.

If the value of your data attachment equals the valueToSetChecked property, the check box will be selected. Default values for valueToSetChecked is 1 (On) and for valueToSetUnchecked is 0 (Off).

The actionCommand is executed and the variable attached to varToSet is updated when you click on the check box. If clicking on the check box selects it, then varToSet will be updated with the value of valueToSetChecked. If you click on the check box and it does not become selected, varToSet will be updated with the value of valueToSetUnchecked.

Use the mouseOverText property to enter a tool tip for this control. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. control\nobject).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

The styleClass property allows you to enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

Radio Button Group 

Use the radioListValues property to specify the labels and values for each radio button (e.g., Low,25;Medium,50;High,75), or make a data attachment to a two-column table. When attaching to a table, the first column is used for the radio button labels, the second column is used for radio button values. If only labels are specified, they will also be used as values. Specify which radio button is selected using the selectedValue property.

The orientationMode property specifies how radio buttons are populated, horizontally (by row) or vertically (by column). Specify the width, in pixels, of the space between radio buttons using the horizontalGap and verticalGap properties.

The actionCommand is executed and the variable attached to varToSet is updated with the selected value when you select a previously unselected radio button from the group.

Use the mouseOverText property to enter a tool tip for this control. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. control\nobject). The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Note: In a Thin Client deployment, multi-line and non-static tool tips are not supported.

The styleClass property allows you to enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

Slider 

The valueMin and valueMax properties control the range of values for the slider. Attach your data to the value property to update the value displayed by the slider from a data attachment.

Note: To get initial values from an internal RTView variable and base those values on user interaction, you must attach the value and varToSet properties to the same variable.

The actionCommand is executed and the variable attached to varToSet is updated with the value from the slider when you release the slider thumb after dragging it or when you click on the slider to advance the thumb one unit. Select the updateWhileAdjustingFlag to receive updates while dragging the slider thumb.

The fgColor property sets the tick mark color. Click on the ellipse_button00015.gif button to select a color or select Default to use the best color for your look and feel. The fgColor is only applied when the Slider control is enabled, so tick marks on sliders in the Display Builder's Working Area are not visible. Select Tools>Preview Window to see the fgColor applied.

Note: In the Thin Client deployment, Slider controls do not have tick marks and therefore the fgColor property does not apply.

Use the mouseOverText property to enter a tool tip for this control. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. control\nobject).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

The styleClass property allows you to enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

The axisDirection property allows you to set the axis direction of the scale. Select from the following options:

Bottom to Top - Vertical orientation with min on bottom and max on top.

Left to Right - Horizontal orientation with min on left and max on right.

Top to Bottom - Vertical orientation with min on top and max on bottom.

Right to Left - Horizontal orientation with min on right and max on left.

List Box

Use the listValues property to:

        Specify the labels and values for each radio button (e.g. Low,25;Medium,50;High,75),

        Make a data attachment to a single cell table containing a semicolon (;) delimited list of values, or

        Make a data attachment to a two-column table, where the first column is used for the radio button labels, the second column is used for radio button values. NOTE: If only labels are specified, they will also be used as values.

To set the selected list item from a data attachment, attach your data to the selectedValue property.

The actionCommand is executed and the variable attached to varToSet is updated with the selectedValue when you chose a previously unselected item from the list box.

To set the bgColor and fgColor properties of a list box, click on the ellipse_button00016.gif button and choose a color from the palette. The bgColor property sets the color of the object's background area and the fgColor property sets the color of the text. When bgColor and fgColor properties are set to Default, then the list box will adopt default settings for background and foreground colors. For example, in the Display Viewer the list box in your display will adopt a standard Java appearance. When that same display is viewed via Thin Client Browser, the list box will conform to that browser's color preferences.

Use the mouseOverText property to enter a tool tip for this control. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. control\nobject).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

The styleClass property allows you to enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

Combo Box

Use the listValues property to:

        Specify the labels and values for each radio button (e.g. Low,25;Medium,50;High,75),

        Make a data attachment to a single cell table containing a semicolon (;) delimited list of values, or

        Make a data attachment to a two-column table, where the first column is used for the radio button labels, the second column is used for radio button values. NOTE: If only labels are specified, they will also be used as values.

To set the selected menu item from a data attachment, attach your data to the selectedValue property. Check the textEditEnabledFlag to allow the user to type a selection in addition to selecting from the drop down menu.

The actionCommand is executed and the variable attached to varToSet is updated with the selectedValue when you choose a previously unselected item from the drop down menu or type a new item into the text entry area of the combo box.

To set the bgColor and fgColor properties of a combo box, click on the ellipse_button00017.gif button and choose a color from the palette. The bgColor property sets the color of the object's background area and the fgColor property sets the color of the text. When bgColor and fgColor properties are set to Default, then the combo box will adopt default settings for background and foreground colors. For example, in the Display Viewer the combo box in your display will adopt a standard Java appearance. When that same display is viewed via Thin Client Browser, the combo box will conform to that browser's color preferences.

Use the mouseOverText property to enter a tool tip for this control. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. control\nobject).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

The styleClass property allows you to enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

Date Chooser 

Use the selectedValue property to specify an initial date value. The maximumDate and minimumDate properties control the selectable dates in the popup calendar. It is recommended that initial date you specify is within the maximumDate/minimumDate value range so that the user will not have to navigate to a valid date.

The actionCommand is executed and the variable attached to varToSet is updated with the selectedValue when either the user selects an date from the popup calendar or, if the date is typed in, when the user presses <Enter> or clicks out of the field.

The dateFormat property controls both the input of a date typed into a field, as well as the output to a local variable or action command. If dateFormat is not specified, then a locale dependent format will be used. When users mouse-over the text entry field, a tooltip will display the specified dateFormat so they will know which format to enter.

Since the dateFormat controls both the input and the output of the Date chooser, information not included in the dateFormat will be lost. For example, if the date format is MMMM dd, yyyy (e.g. January 01,2000), and the timeEntryEnabledFlag is selected, even if you enter a time it will not be stored since it was not included in the specified dateFormat. Or, if the specified dateFormat does include the time (e.g. MM/dd/yyyy hh:mm) and the time you entered was PM, it would be stored in the AM since am/pm was not specified in the dateFormat and AM is the default.

The dateFormat should be specified using format specifiers from the SimpleDateFormat class. The dateFormat property does not support backslashes (\). In the Display Viewer Applet, the text entry field validates the date string as you enter it. It is very strict about allowing only dates in the format specified. In the Display Server the parsing is more flexible, but not guaranteed unless the date entered is in the same format as the specified dateFormat.

Note: In the Display Server, the text entry field is not validated and the following format specifiers are not supported: G, w, W, D, F, E, k, K, S, z, Z.

The timeEntryEnabledFlag property controls the visibility of the Time field in the popup calendar. Times entered into this field must be in the following format: hh:mm:ss a. When timeEntryEnabledFlag is selected, an OK and Cancel button are added to the popup calendar, so you can select a date and enter a time before closing the popup. If the timeEntryEnabledFlag is deselected, the popup calendar closes as soon as you select a date.

The validColor property sets the font color to use while editing in the text entry area if the entered value uses the correct format. The default validColor is green. The invalidColor property is the font color used during and after editing in the text entry area if the entered value does not use the correct format. The default invalidColor is red. The fgColor property sets the color of the text entry area. The default fgColor is black.

Note: The validColor and invalidColor properties are not supported in the Thin Client deployment.

The styleClass property allows you to enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

Localization:

        The Time field, OK and Cancel buttons are localized by SL, currently only English and Japanese are available.

        In the Display Builder, Display Viewer Application and Display Viewer Applet the month and day names will use the language settings on the client system.

        In the Display Server, the month and day names can be localized by replacing the date.js file in the Display Servlet with a localized version.

Note: The Display Viewer Applet uses JCalendar 1.3.2 which is distributed under Lesser GPL and can be downloaded from www.toedter.com/en/jcalendar. The Display Server uses the Datejs date library for parsing and formatting dates and times.

Password Field

The Password Field control object works just like Text Entry Fields except that instead of displaying entered text, it displays asterisks (*).

Tab Control Object

The tab control (obj_c1tabs) has two temporary tabs labeled A and B when initially drawn on the palette, and also when the user places an instance on a display. The temporary tabs are replaced with the actual tabs when you attach the tab control's valueTable property to a data table containing one row for each tab.

The size given to the control in the Builder determines the space available for tabs. The tabs are drawn horizontally with the first tab at the left edge of the control. If the control is not wide enough to show all of the tabs, the tabs wrap vertically. If the control is not tall enough to show all of the tabs, some of the tabs might be clipped or invisible.

Changing the control's labelTextSize property changes the size of the tab label text, which also affects the size of the tabs.

The tab control is populated from a data table attached to its valueTable property, with one tab created for each row in the table. The following tab control properties are used to map the columns of the data table to each tab:

        labelColumnName: The value from this column is used as the tab label. If labelColumnName does not specify a column in the valueTable or contains an empty string, then the tab for row N in the valueTable is labeled "Tab N". The labelColumnName property appears in the Label category.

        valueColumnName: The value from this column is assigned to the variable (if any) attached to the tab control's varToSet property when the corresponding tab is selected by the user. If valueColumnName does not specify a column in the valueTable, then the tab's index (0 through N - 1, for a table with N rows) is used as the tab value. The valueColumnName property appears in the Data category.

        imageColumnName: The value from this column is used to load an icon image, shown to the left of the tab's label. If imageColumnName does not specify a column in the valueTable, or if the column is empty, or if the image cannot be found, the tab does not contain an icon. An icon affects the size of the tab. The imageColumnName property appears in the Image category.

        mouseOverColumnName: The value from this column is used as the tooltip for each tab. If mouseOverColumnName does not specify a column in the valueTable, or if the column is empty, the tab does not display a tooltip. The mouseOverColumnName property appears in the Interaction category.

The tab control supports the drillDownColumnSubs property, which can be useful in cases where the tab's command is a drilldown. As with other objects that support drillDownColumnSubs, it can be used to set the values for substitutions and local variables from columns in the row of the valueTable that corresponds to the selected tab.

The control's visFlag property can be used to toggle the control's visibility. Unlike the other control objects, the tab control does not support the enabledFlag property so it is always enabled.

The selectBgColor and selectTextColor fields in the Interaction region in Object Properties allow you to specify the background and text colors for the selected tab. To set the colors, click in the field in the Interaction region, click on the ellipse_button00018.gif button, and select a color from the Color Chooser palette that displays. When selectBgColor and selectTextColor properties are set to Default, then the tab will adopt default settings for the background and text colors. Both options are set to Default initially.

The paddingVertical and paddingHorizontal options in the Label category in Object Properties provide extra padding, in pixels, above and below (paddingVertical) and left and right (paddingHorizontal) of the label of each tab. These options enable you to make the tabs taller and wider without increasing the font size. The default value for both options is zero.

The webHoverTabColor and webHoverTextColor options in the Interaction category in Object Properties define the background color and text color for an unselected tab when the cursor is positioned over the tab. The default values are the same as the normal tab background and text colors. This property only affects the thin client and is ignored in the builder/viewer.

As on other control objects, the predefined substitution named $value can be used in the control's command. The value of the selected tab is substituted for $value when the command is executed. (See the valueColumnName property for a description of how a tab's value is determined).

If a tab control has a command defined and the commandConfirm property is checked, the user is asked to confirm the command when a tab is clicked, but the clicked tab becomes the selected tab regardless of the user's response.

Limitations / Differences:

        In the Thin Client, the tab control is not supported in IE version 8 or older and will not appear in displays opened in those versions.

        The tab sizes and appearance may differ somewhat when viewed in the Builder/Viewer versus the Thin Client.

        In the Thin Client, the background color of the selected tab is brighter than the unselected tabs, while in the Builder/Viewer the selected tab is darker than the other tabs. (This difference is intentional, to conform with the standard appearance of tabs in Swing versus a browser.)

webLabelFlag

In a Display Server deployment when the webLabelFlag property is selected, the object will be rendered as an HTML element in the thin client rather than rendered in the image by the Display Server. This allows the Display Server to update the individual object (if necessary) when the display is refreshed, instead of regenerating the entire display image. In some cases, this can improve the performance of the Display Server and thin client.

The webLabelFlag property also enables you to select an object's text and copy it to the clipboard.

Use the following entry to set webLabelFlag in an rtview stylesheet (.rts) file:

rtv-all {

 webLabelFlag: 1;

}

Limitations 

In the following situations, an object with webLabelFlag selected will still be rendered in the image by the Display Server:

        Display is opened in Internet Explorer 8 or older.

        Display Server is run with the -nohtml5 option set on the command line.

        Object is inside an object grid, and is not inside a composite object in that grid.

In other cases, an object may have a slightly different appearance in the thin client when it is rendered as HTML:

        bgGradientMode property set to "Diagonal Edge" or "Diagonal Center" is treated as "Vertical Edge" (Only vertical and horizontal gradients are supported on HTML objects in the thin client.)

        bgShadowFlag property is ignored

Navigation Control Objects

Display your data in navigation controls by attaching it to the valueTable property. The input of tabular data determines the content of the navigation control, as well as the appearance of each object in the navigation control. As with other controls, to configure a drill-down, set substitutions, or execute a command when a user clicks an navigation control node, use the actionCommand property. As with other table-driven objects, the drillDownColumnSubs property can be configured to set substitutions to column values from the row in the valueTable that corresponds to the selected navigation control node. If the navigation control is not large enough to display all of the data, scroll bars are automatically added.

You can configure user access control for nodes in navigation controls based on user roles. For example, the specified displays are not visible (nor accessible) to users with the associated role.

There are two types of navigation controls: the tree control (class name: obj_c1tree) and the accordion control (class name: obj_c1accordion). Both controls allow you to configure status icons and to propagate the status up to parent nodes.

Tree Control

Multiple nodes can expand at a time and you can configure type icons for tree nodes (static images that visually indicate the element type, such as Production or Sales, or the node depth).

nodepropogationup00019.gif

 

To configure, see “Tree Control”.

Accordion Control

A single node expands at a time and icons visually indicate whether an element in the accordion is closed, open, or a leaf node.

accordpropogationup00020.gif

 

To configure, see “Accordion Control”.

Table Formats for Navigation Controls

There are two table format options for navigation controls, each with their own requirements:

§        Row-Leaf: This format is intended for use when the valueTable property is attached to an indexed table and all leaves in the navigation control are at the same depth. For example, where the navigation control is attached to the current table of an indexed cache.

Typically, the RTView cache data source is indexed. That is, the cache indexColumnNames property specifies the columns to index. If those index columns represent a hierarchy (for example, server, application, process or country, state, city), the cache current table could be used as the valueTable property of a control in the Row-Leaf format. In other cases, a table in the Row-Node format might be required.

To configure, see Creating a Row-Leaf Format Table (below).

§        Row-Node: If the Row-Leaf format is not suitable for your data, use the Row-Node format. This format is intended for use when the valueTable property is attached to an un-indexed table. Your data table must also contain a row for each node in the navigation   control, including the top-level node (rather than just the leaf nodes, as with the Row-Leaf format), as well as a column for the node and a column for the parent node. The Row-Node format allows each leaf of the navigation control to have a different depth.

To configure, see Creating a Row-Node Format Table (below).

Note: If you have an XML file that has the navtree.xml format you can convert it into a row-node format. For details, see “navtree.xml For Navigation Control Objects”.

The default table format is Row-Leaf. The following are examples of the Row-Leaf and Row-Node table formats which both produce the tree control below the table:

Row-Leaf

Row-Node

App Name

PID

Node

Parent

App0

1000

app0

<blank>

App0

1004

1000

app0

App0

1008

1004

app0

App1

1001

1008

app0

App1

1005

app1

<blank>

1001

app1

1005

app1

rowleaf_2level.gif

 

Creating a Row-Leaf Format Table

In the Row-Leaf table format, there is one row in the table for each leaf node in the navigation  control. A leaf node is added to the navigation control for each row in the valueTable. The path to a leaf node (that is, the ancestor nodes of the leaf) is determined by the values in each of the table columns specified by the nodeIndexColumnNames property. When the valueTable property is attached to the current table of an indexed RTView cache, the navigation   control nodeIndexColumnNames property is typically set to the same columns that are specified for the cache index columns.

To illustrate how to create a navigation control using the Row-Leaf format, let us say we have a cache named Applications that has two index columns, App Name and PID, and the current table in that cache has the following rows:   

App Name

PID

App0

1000

App0

1004

App0

1008

App1

1001

App1

1005

We set the navigation control valueTable property to attach to the cache data, with the following fields specified in the Attach To Cache Data dialog:

Cache: Applications

Table: Current

Specify Row-Leaf format for the valueTableFormat property, and App Name;PID for the nodeIndexColumnNames property. The following figure illustrates the structure of the navigation control. There are two nodes labeled App0 and App1. Node App0 has three child nodes labeled 1000, 1004, 1008. Node App1 has two child nodes, labeled 1001 and 1005.

We add another index column, AgentName, to the Applications cache, so that the current table now has the following rows:

Agent Name

App Name

PID

Agent1

App0

1000

Agent1

App0

1004

Agent1

App0

1008

Agent1

App1

1001

Agent1

App1

1005

Agent2

App0

1000

Agent2

App0

1004

Agent2

App1

1001

We also update the navigation control nodeIndexColumnNames property to AgentName;App Name;PID. The following figure illustrates the new structure of the navigation control: two top-level nodes labeled Agent1 and Agent2, each with two child nodes, app0 and app1.

rowleaf_3level.gif

 

As illustrated above, the label string for a node at depth N is taken from the Nth column in nodeIndexColumnNames property. Therefore, the labels for the top-level nodes come from the first column in the nodeIndexColumnNames property (AgentName), the labels for the second-level nodes come from the second column in nodeIndexColumnNames property (App Name), and so forth.

To specify node labels from a different set of valueTable columns, use the nodeLabelColumnNames property. Enter a semicolon-separated list of column names in the nodeLabelColumnNames property, one for each level in the navigation control, where the Nth column name in the list contains the labels for navigation control nodes at depth N.

Return to “Tree Control”.

Return to “Accordion Control”.

Creating a Row-Node Format Table

In the Row-Node table format, there is one row in the table for each node in the navigation control, including the top-level node (rather than just the leaf nodes, as with the Row-Leaf format).

Note: For a demo of an tree control that uses a data table in the row-node format, see the treecon.rtv display, located in the RTV_HOME/demos/features directory. The tree in that display is attached to an XML file (navtree_rownode.xml) that defines a navigation tree containing display titles and filenames in the row-node format. To view the demo: in an initialized command window, navigate to the RTV_HOME/demos/features directory, and type: run_viewer -panelconfig:PANELS_treecon.ini. See “Initializing a Command Prompt or Terminal Window” for more information on initializing a command window.

There are two columns in the table that help define the navigation control structure:

§        One of the table columns contains a node ID string and is identified by the nodeIdColumnName property. By default, the node ID string is used as the node label in the navigation control. The node ID string must be unique among all nodes with the same parent. Or, if the uniqueNodeIdFlag property is checked, each node ID string must be unique in the entire navigation control.

§        Another table column contains the ID of the parent node, which is identified by the parentIdColumnName property.

To create the same navigation control as with our Row-Leaf format example, a table representation of the navigation control using the Row-Node format would be as follows:

Node

Parent

app0

<blank>

1000

app0

1004

app0

1008

app0

app1

<blank>

1001

app1

1005

app1

The <blank> entries represent an empty string, which indicates that nodes app0 and app1 have no parent, making them top-level nodes in the navigation control.

We set the navigation control:

        valueTable property to attach to the unindexed table

        valueTableFormat property to the Row-Node format

        nodeIdColumnName property to Node

        parentIdColumnName property to Parent

We then have the following navigation control structure. There are two top-level nodes labeled App0 and App1. Node App0 has three child nodes labeled 1000, 1004, 1008. Node App1 has two child nodes, labeled 1001 and 1005.

rownode.gif

 

To add another navigation control level for the AgentName, as we did with the Row-Leaf format example, we modify our table as follows:

Node

Parent

Agent1

<blank>

app0

Agent1

1000

app0

1004

app0

1008

app0

Agent2

<blank>

app0

Agent2

1000

app0

1004

app0

app1

Agent2

1001

app1

1005

app1

We also uncheck the uniqueNodeIdFlag property to allow for node IDs that are not unique, such as the app0 and 1000 nodes in our example which are used in multiple navigation control levels. Because some of the rows are also identical, the order of the table rows is important. For example, this row appears twice in the table: 1000 app0. In each case the row comes after a unique parent row: first under app0 Agent1 and then under app0 Agent2. The navigation control uses this information to determine where to place the node for 1000 in each case.

The following figure illustrates the new structure of the navigation control. The navigation control now has two top-level nodes labeled Agent1 and Agent2, each with two child nodes, app0 and app1.

rowleaf_3level00021.gif

 

By default, the node ID string is used as the node label in the navigation control. If a different column in the table must provide the label, specify the name of that column in the nodeLabelColumnName property.

Note that in the Row-Node format each branch of the navigation control can have a different depth, while in the Row-Leaf format all branches typically have the same depth (the number of columns specified in the nodeIndexColumnNames property).

Return to “Tree Control”.

Return to “Accordion Control”.

Status Icons

Status icons indicate the current state of a node. You can optionally configure status icons by assigning images that are used when an element in the navigation control has a specified value. You can also configure the status in order of priority so that the most critical status is propagated up to ancestor nodes. The status icon shown for an ancestor node corresponds to the current highest status priority of all of its descendants. By default, no status icons appear in navigation controls.

The status icon for a node is determined by the discrete value of a specified column in the valueTable. The values can be strings or numbers. The comparison is done for an exact match. If the current status value for a navigation control node does not match any of the values you specify in the nodeStatusProperties property, no status icon is displayed for that node.

When a status icon is configured for the tree control, by default the status icon appears on the left of the node label. The value, Left or Right, is specified in the nodeStatusIconPos property. If a node has both a type icon and a status icon, the type icon always appears to the left of the status icon. By default, no status icons appear in the tree.

When a status icon is configured for the accordion control, by default the status icon appears inside the node button, either to the left or right of the button label, according to the value of the nodeStatusIconPos property.

Configuring Status Icons

This section describes how to configure status icons for the navigation controls using the Node Properties dialog.

Note: Status icons can also be configured by Attaching a Status Icon To Data (see below).

To configure the Status Icon

To configure the status icon, specify the status table column name in the nodeStatusColumnName property, then use the nodeStatusProperties property to define a three-column table of data and configure icon behavior.

Note: The nodeStatusProperties property is only visible if the nodeStatusColumnName property is non-blank.

Select the nodeStatusProperties property in the property sheet, then click the ellipse_button00022.gif button to open the Node Properties dialog.

tree_status_prop.gif

 

To map an image to a node status

Click New, then click in the Status Value column. A drop-down list appears containing all values in the node status column of the valueTable (which you previously specified in the nodeStatusColumnName property). Select a value from the drop-down list.

Click the ellipse_button00023.gif button in the Image column for the node and choose an icon from the Select Image dialog. The icon is used as the status icon for all nodes that match the value selected in the Status column.

Click the ellipse_button00024.gif button in the Priority column for the node and assign a integer value: 0, 1, 2, 3, 4, 5, or a higher number (there is no upper limit on the number), where the largest number is the highest priority and propagated up the navigation control first, and a value of zero (0) is not propagated. A value of zero (0) can be assigned to multiple nodes (so that they do not propagate up the navigation control). Non-zero values must be assigned only once.

For example, if we set the nodeStatusColumnName property to our Application Status table column of our valueTable, and define the mapping for the nodeStatusProperties as follows:

Status Value

Image

Priority

blocked

tree_icon_exclmrk.gif

 

2

running

tree_icon_green.gif

 

1

The values in the Application Status column of each row in the valueTable is compared to the two values listed in the Status Value column (blocked and running). If the Application Status value in one of the rows is blocked, the tree_icon_exclmrk00025.gif status icon is displayed as the status icon for that row. If there is no match (for example, the Application Status value in one of the rows is unknown), no status icon is displayed in the navigation control node for that row. Because the tree_icon_exclmrk00026.gif status icon is assigned the highest priority, the tree_icon_exclmrk00027.gif status icon is always propagated up the navigation control first. If none of the rows has a blocked status, the tree_icon_green00028.gif status icon is propagated up the navigation control.

For example, in the following illustration the priority status of a single node, app3/1003, is propagated up to its parent, app3, and also to the top-level ancestor, Agent1.

accordpropogationup00029.gif

 

For details about creating an application with multiple panels, see “Multiple Display Panels”.

Attaching a Status Icon To Data

For convenience, the status icon can be attached to data. Typically, an attachment to a static XML file containing the appropriate tables is used. To attach the status icon to data, use the nodeStatusProperties property. The data attachment must be a three-column table. Typically, a static XML file containing the table is used. The first column must contain string values that match values from the column in valueTable specified by the nodeStatusColumnName property. The second column must be the path to the .png, .gif, or .jpg image. The third column must contain the non-negative integer priority value.

Note: A static XML file is only read once each time you run RTView. If you specify (or modify) an XML source using the Application Options dialog, you may specify whether that XML source is static. For details, see “Creating XML Sources”.

navtree.xml For Navigation Control Objects

This section describes how to populate a navigation control object from an XML data source using the navtree.xml format. Using the navtree.xml format enables the XML data source to parse the navtree.xml content and convert it into a table in the row-node format, which is a format accepted by “Navigation Control Objects”. A navigation control--the tree control (class name: obj_c1tree) or the accordion control (class name: obj_c1accordion)--can then be used on an RTView display.

When the XML data source parses the navtree.xml file it creates a table and gives it the data key navtree. When you use the Builder Attach to XML Data dialog, enter navtree in the Data Key field. The table has one row for each node that is defined in the navtree.xml file. The table contains the following columns:

Node ID:

An unique integer assigned to a navigation control object node.

Parent ID:

The ID of the node's parent, or blank if the node is a top-level node.

Label:

The value of the node's label attribute.

Display:

The value of the node's display attribute.

Subs:

The value of the node's subs attribute (a string containing sub:value pairs, separated by spaces).

Typically, you attach the valueTable property of a navigation control object to the navtree table, and the navigation control object's valueTableFormat property is set to Row-Node. Subsequently, the column names listed above are specified as values for other properties on the navigation control as follows:

nodeIdColumnName = Node ID   

nodeLabelColumnName = Label   

parentIdColumnName = Parent ID   

uniqueNodeIdFlag = <checked>

valueColumnName = Display   

To see an example of an accordion control configured in this manner, use the Builder to examine the display named accordcon.rtv, located in the RTV_HOME/demos/features directory. The XML file used by the example is demos/features/navtree.xml. To see the working example, type the following commands in an RTView command prompt:

cd %RTV_HOME%\demos\features

run_viewer -panelconfig:PANELS_accordcon.ini

In addition to the columns mentioned above, the navtree table's Subs column can also be used to configure the drilldownColumnSubs property of a navigation control. In the “Drill Down Column Substitutions Dialog”, find the row for Column Name = Subs, and in the Substitution String column enter the string __parse (there are two underscores in the prefix), that is:

Column Name

Substitution

Subs

__parse

This tells RTView to parse the string found in the Subs column for the node selected in the navigation control, which is expected to contain one or more sub:value pairs, separated by spaces. For example, if the Subs column contains this string:

$sub1:abc $sub2:xyz

and if the navigation control's drilldownColumnSubs property is configured as described, a drilldown from the navigation control the $sub1 and $sub2 substitutions is assigned the values abc and xyz, respectively.

Tree Control

This section describes how to create a tree control (class name: obj_c1tree).

There are two methods for creating a tree-driven multi-panel application: the static tree navigation panel and the tree control. Use the static tree navigation panel method if you know the specific sources that are to populate the tree and they remain constant for the life of the application. For example, if you know all the displays that compose your application and the static representation of a tree will only be used for navigating those displays, the static tree navigation panel is suitable (and is easier to configure). To configure the static tree navigation panel, add the tree using the rtvTreePanel tag to the PANELS.ini file. For details about configuring the tree, see “Multiple Display Panels”.

Use the tree control method if the number of nodes or leaves, labels or icons of the tree change during the lifetime of the application. Data can be provided that will change the nodes and leaves of the tree and also change the labels, and icon representations on the tree with dynamic data.

When constructing an application with multiple panels using the tree control, one panel displays an RTView file that has instanced the tree control and the other contains the displays which are drilled down to by selecting items on the tree. The following illustrates a two-panel application in which the tree control in the left panel updates the display in the right panel:

tree_multipanel.gif

 

To see an example of a multi-panel layout that uses a tree control to display live status information (based on alerts) and perform navigation via drill-down in another panel, see the “Navigation Control Demo”.

For details about creating an application with multiple panels, see “Multiple Display Panels”.

Creating a Tree Control

To create a tree control:

1.     Attach tabular data to the tree control valueTable property.

2.     Specify the table format for the tree in the valueTableFormat property. There are two table format options for navigation controls. The Row-Leaf format is intended for use when the valueTable property is attached to an indexed table and all leaves in the navigation control are at the same depth. Otherwise, the Row-Node format is used. See “Navigation Control Objects” for details.

3.     Optionally, configure type icons.

4.     Optionally, configure status icons.

Type Icons

Type icons indicate the type of node in the tree. The type icon for each node is determined either by the value of a column in the valueTable property, or by the node position in the tree. By default, the type icon appears to the left of the node label. Also by default, a folder image is used for all non-leaf nodes, and a document image is used for all leaf nodes. If a node has a type icon and a status icon, the type icon appears to the left of the status icon.

You can optionally   assign images for type icons. For example, if you have groups of elements based on geographic location, you could assign an icon for the country, state and city (for example, US, California, San Francisco). Or, if you have groups of elements based on their function, you could assign an icon for each function (Purchases, Operations, Sales, and so forth). You can also assign images for each depth in the tree for a visual indication of where you are while navigating within the tree.

Configuring Type Icons

This section describes how to configure status icons for the navigation controls using the Node Properties dialog.

Note: Status icons can also be configured by Attaching a Status Icon To Data.

Use the nodeTypeProperties property to define a two-column table of data. Select the nodeTypeProperties property in the property sheet, then click the ellipse_button00030.gif button to open the Node Properties dialog.

nodetypeprops.gif

 

In the Node Properties dialog, the Node Depth or Type column lists the available nodes. The first two rows, non-leaf node and leaf node, indicate the default settings: non-leaf nodes in the tree use a folder image and leaf nodes use a document image. To change the default setting, click the ellipse_button00031.gif button in the Image column for the node and choose an icon from the Select Image dialog.

The next five rows, numbered 0 - 4, represent the node depth or level, zero (0) being the root node. The Image column lists the icons being used for each node. By default, the Image column for all of those rows is <blank>, indicating that the non-leaf node and leaf node icon assignments are used. Icon assignments override non-leaf node and leaf node assignments.

Mapping an Image to a Node Level

You can assign an image icon based on node level. The icon provides a visual indication of where you are while navigating in the tree. To assign an image to a specific node level in the tree, click the ellipse_button00032.gif button for one of the rows numbered 0 - 4 in the Image column and choose an icon from the Select Image dialog. Repeat for each node level.

Mapping an Image to a Node Type

You can assign an image icon based on node labels you create that describe the nodes as a group. For example, in the following illustration the Node Depth or Type column contains the string PRODUCTION with the tree_icon_square.gif image selected, and the string DEVELOPMENT with the tree_icon_star.gif image selected.

tree_icon_customtype.gif

 

This means that all nodes whose label matches the PRODUCTION string display the tree_icon_square00033.gif image in the tree, and all nodes whose label matches the DEVELOPMENT string display the tree_icon_star00034.gif image in the tree.

To assign an image to a specific node type in the tree, assign a column name in the nodeTypeColumnName property. Select the nodeTypeProperties property in the property sheet, then click on the ellipse_button00035.gif button to open the Node Properties dialog. Click New to add a custom row to the table. A drop-down list of values for the column assigned to the nodeTypeColumnName property appears in the Node Depth or Type column. Select a column name from the drop-down list. Click the ellipse_button00036.gif button in the Image column and choose an icon (to use for all nodes that have that column name in the valueTable row that corresponds to the node) from the Select Image dialog.

You can also type a string in the Node Depth or Type column and the Image column.

To not use an icon, in the Node Properties dialog, select the icon in the Image column, then click Clear.

Note: The root node is invisible if the rootNodeLabel property is blank.

For details about type icon determination, see Logic for determining type icon (below).

For details about creating an application with multiple panels, see “Multiple Display Panels”.

Attaching an Icon To Data 

For convenience, the type icon can be attached to data. Typically, an attachment to a static XML file containing the appropriate tables is used. To attach the type icon to data, use the nodeTypeProperties property. The data attachment must be a two-column table. The first column must contain string values of _node (for non-leaf nodes), _leaf (for leaf nodes), numeric values for depth, or string values that match the node labels, or the values from the column in valueTable specified by the nodeTypeColumnName property. The second column must be the path to the .png, .gif, or .jpg image. The default assignments are _node, rtvTreeNode16.png and _leaf, rtvTreeLeaf16.png. The column names are not important.

Note: A static XML file is only read once each time you run RTView. If you specify (or modify) an XML source using the Application Options dialog, you may specify whether that XML source is static. For details, see “Creating XML Sources”.

Background Properties

Specify how the background is displayed in the tree control.

Property Name

Description

bgBorderFlag

When checked, a one pixel dark border is drawn around the tree. If unchecked, no border is drawn. By default, the flag is checked and the border is visible.

Note: The border color and width are not configurable.

bgColor

Select the ellipse_button00037.gif button and choose a color from the palette to set the background color of the tree control.

Data Properties 

Specify how data is displayed in the tree control.

Property Name

Description

nodeIdColumnName

This property is available when the valueTableFormat is Row-Node. With the Row-Node format there are two table columns that define the tree structure: the nodeIdColumnName property and the parentIdColumnName property specify the two columns.

The nodeIdColumnName property specifies the table column containing the node ID string. The node ID string must be unique among all nodes with the same parent. Or, if the uniqueNodeIdFlag property is checked, each node ID string must be unique in the entire tree. By default, the node ID string is used as the node label in the tree.

nodeIndexColumnNames

This property is available when the valueTableFormat is Row-Leaf. Specifies the path to a leaf node (that is, the ancestor nodes of the leaf).

When the valueTable property is attached to the current table of an indexed RTView cache, the nodeIndexColumnNames property is typically set to the same columns that are specified for the cache index columns.

Enter a semicolon-separated list of column names, where the Nth column name in the list contains the labels for tree nodes at depth N. The labels for top-level nodes are defined by the first column in the nodeIndexColumnNames property, the labels for the second-level nodes are defined by the second column, and so forth.

 

For example:

AgentName;App Name;PID 

The labels for the top-level nodes are defined by the AgentName column, the labels for the second-level nodes are defined by the App Name column, and labels for the third-level nodes are defined by the PID column.

To specify node labels from a different set of valueTable columns, use the nodeLabelColumnNames property.

nodeLabelColumnName

This property is available when the valueTableFormat is Row-Node. By default, the node ID string is used as the node label in the tree. Use the nodeLabelColumnName property to specify a different valueTable column to provide the label.

nodeLabelColumnNames

This property is available when the valueTableFormat is Row-Leaf. Use the nodeLabelColumnNames property to specify a different set of valueTable columns to provide node labels. Enter a semicolon-separated list of column names, one for each level in the tree, where the Nth column name in the list contains the labels for tree nodes at depth N.

nodeStatusColumnName

This property applies to the status icon. Specifies the name of the valueTable column containing node status values. The column specified populates the Node Properties dialog Status Value column, in which you map node status values to image icons. The icons are displayed for any node whose value matches the value selected.

nodeTypeColumnName

This property applies to the type icon. Specifies the name of the valueTable column containing values to use for mapping icon images to node types in the tree. The column specified populates the list of available values in the Node Properties dialog Node Depth or Type column, in which you map node types to image icons. The icons are displayed for any node whose value matches the value selected.

parentIdColumnName

This property is available when the valueTableFormat is Row-Node. With the Row-Node format there are two table columns that define the tree structure: the parentIdColumnName property and the nodeIdColumnName property specify the two columns.

The parentIdColumnName property specifies the table column containing the parent node ID.

roleCheckColumnName

The name of a string column in the data table containing display the names to be checked against the user's role. The default value is Display. Use this property to show/hide tree nodes based on user role definitions. If a row's value in the specified column is the name of a display to which the user's role is denied access, the tree does not show a node for that row. For details about user roles and display access, see “Role Definitions”.

selectedValue

This column specifies the value of the currently selected node in the tree.

selectedValueColumnName

If specified, the values in this column will be compared to the selectedValue in order to set the tree selection. If not specified, the selectedValue will be compared to the values in the column specified in valueColumnName property.

uniqueNodeIdFlag

This property is available when the valueTableFormat is Row-Node.

When enabled, specifies that each node ID string must be unique in the entire tree. When disabled, specifies that each node ID string must be unique among all nodes with the same parent.

valueColumnName

Specifies the name of the column whose value is assigned to the $value variable when a node in the tree is selected. If not specified, the label string of the selected node is assigned to the $value variable. The $value variable is the only substitution that can be used in the Display Name field of a drill-down command.

valueTable

Attach your tabular input data to this property. There are two valueTable format options you can use to create your table:

§        Row-Leaf format: See “Navigation Control Objects” for details about creating the table.

§        Row-Node format: See Row-Node for details about creating the table. If you have an XML file that has the navtree.xml format you can convert it into a row-node format. For details, see “navtree.xml For Navigation Control Objects”.

Note: As with other table-driven objects, the drillDownColumnSubs property can be configured to set substitutions to column values from the row in the valueTable that corresponds to the selected tree node.

valueTableFormat

Specifies the format of the valueTable: Row-Leaf or Row-Node.

varToSet

Allows you to update the attached variable with the value from the control.

Interaction Properties

Specify interactions in the tree control.   

Property Name

Description

actionCommand

Use the actionCommand property to assign a command to the tree. You can configure the tree to open a drill-down display, set substitutions, or execute a command in response to a user click on a tree node.

The actionCommand can reference the value from the tree by using the keyword $value. When the command is executed, the variable attached to varToSet is updated with the selected node data.

The drillDownColumnSubs property can be configured to set substitutions to column values from the row in the valueTable that corresponds to the selected tree node.

If the execOnLeafOnlyFlag property is checked, the tree actionCommand property executes only when a leaf node is clicked (a click on a non-leaf node expands only the node). If unchecked, the tree actionCommand property executes on all nodes, not just the leaf.

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 ellipse_button00038.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownColumnSubs

Use the drillDownColumnSubs property to set substitutions to column values from the row in the valueTable that corresponds to the selected tree node.

Select the ellipse_button00039.gif button to open the “Drill Down Column Substitutions Dialog” to customize which substitutions are passed into drill-down displays.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

enabledFlag

If unchecked, the tree nodes are the color gray and do not respond to user input.

execOnLeafOnlyFlag

If checked, the tree actionCommand is executed only for leaf nodes, and a click on a non-leaf node only expands the node. Also, the mouseover tooltip only appears for leaf nodes.

If unchecked, the tree actionCommand property executes on all nodes, and the mouseover tooltip appears for all nodes.

menuItemGroup

Use the menuItemGroup property to extend RTView context menu items. For details, see “Extending the Context Menu”.

mouseOverFlag

Specifies whether a tooltip appears when the cursor is positioned over a node. The tooltip shows the node path (the node label preceded by the labels of all of its ancestors), the node status (if the nodeStatusColumnName property is specified), and its value (if the valueColumnName property is specified).

rightClickActionFlag

Use the rightClickActionFlag property to extend RTView context menu items. For details, see “Extending the Context Menu”.

tabIndex

Use the tabIndex property to define the order in which the tree receives focus when navigated from your keyboard. Initial focus is given to the object with the smallest tabIndex value, from there the tabbing order proceeds in ascending order. If multiple objects share the same tabIndex value, initial focus and tabbing order are determined by the alpha-numeric order of the table names. Tables with a tabIndex value of 0 are last in the tabbing order.

Note: The tabIndex property does not apply to tables in the Display Server, nor to objects that are disabled, invisible, or have a value of less than 0.

Label Properties 

Specify the label in the tree control.

Property Name

Description

labelTextColor

Select the ellipse_button00040.gif button and choose a color from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop-down menu.

labelTextSize

Set the height of the label text in pixels.

Node Properties 

Specify the node structure in the tree control.

Property Name

Description

initialExpandDepth

Specify the depth that nodes automatically expand (open) to when the tree is populated. All non-leaf nodes at a depth that is less than or equal to the initialExpandDepth property are expanded automatically. By default, the value is 0 (zero).

When calculating node depth, the root node has a depth of zero. (All trees have a root node but it is visible only if the rootNodeLabel property is set). Because the default value of initialExpandDepth is zero, only the root node is expanded automatically.

Changing the value of initialExpandDepth from a larger value to a smaller value has no effect until the display containing the tree is reopened.

Note: Use this property with caution on large trees as the automatic expansion of a large number of nodes can cause slow performance.

nodeClosedImage

This property specifies the name of the images to be shown to the left of a closed parent (non-leaf) tree node. This property is blank by default, which indicates that the default closed images should be used.

nodeOpenImage

This property specifies the name of the images to be shown to the left of an open parent (non-leaf) tree node. This property is blank by default, which indicates that the default open images should be used.

nodeSelectColor

This property sets the background color for the selected tree node. If set to Default, then the platform or browser default selection color is used.

nodeSelectTextColor

This property sets the text color for the selected tree node. If set to Default, then the platform or browser default selection color is used.

nodeStatusIconPos

Specify the status icon position in the tree: Left or Right. By default, the status icon appears on the left of the node label. If a node has both a type icon and a status icon, the type icon always appears to the left of the status icon. By default, no status icons appear in the tree.

nodeStatusProperties

This property applies to the status icon. Specifies the status icon for a node. By default, no status icon is displayed.

Select the ellipse_button00041.gif button to open the Node Properties dialog and map images to values, and set the status priority order for propagation up the tree.

Note: The nodeStatusProperties property is visible only if the nodeStatusColumnName property is non-blank.

You can also use the nodeStatusProperties property to attach a status icon to data. The data attachment must be a three-column table. Typically, a static XML file containing the table is used. The first column must contain string values that match values from the column in valueTable specified by the nodeStatusColumnName property. The second column must be the path to the .png, .gif, or .jpg image. The third column must contain the non-negative integer priority value.

Note: A static XML file is only read once each time you run RTView. If you specify (or modify) an XML source using the Application Options dialog, you may specify whether that XML source is static. For details, see “Creating XML Sources”.

nodeTypeProperties

This property applies to the type icon. Specifies the type icon for a node. By default, non-leaf nodes in the tree use a folder image and leaf nodes use a document image.

Select the ellipse_button00042.gif button to open the Node Properties dialog to map images to nodes. Mapping can be based on the node depth in the tree or the type of node.

You can also use the nodeTypeProperties property to attach a type icon to data. The data attachment must be a two-column table. Typically, a static XML file containing the table is used. The first column must contain string values of _node (for non-leaf nodes), _leaf (for leaf nodes), numeric values for depth, or string values that match the node labels, or the values from the column in valueTable specified by the nodeTypeColumnName property. The second column must be the path to the .png, .gif, or .jpg image. The default assignments are _node, rtvTreeNode16.png and _leaf, rtvTreeLeaf16.png. The column names are not important.

Logic for determining which type icon is used:

If the nodeTypeColumnName property specifies column C, and the value of C in the valueTable row that corresponds to N is V, and there is a row in nodeTypeProperties that assigns value V to image I1, I1 is used as the type icon for N. Otherwise:

§        if the label of node N is XYZ, and there is a row in the nodeTypeProperties property that assigns value XYZ to image I2, I2 is used. Otherwise,

§        if the depth of node N is D, and there is a row in the nodeTypeProperties property that assigns depth D to image I3, I2 is used. Otherwise,

§        if N is a leaf, and the leaf node image is I4, I4 is used. If I4 is blank no type icon appears. Otherwise,

§        if the non-leaf node image is I5, I5 is used. If I5 is blank no type icon appears.

Note: A static XML file is only read once each time you run RTView. If you specify (or modify) an XML source using the Application Options dialog, you may specify whether that XML source is static. For details, see “Creating XML Sources”.

rootNodeLabel

Specify whether the tree root node is visible. By default, this property is blank and the root node is not visible.

Object Properties 

Specify the layout in the tree control.   

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.

If the Resize Mode is set to Scale and an object is anchored on opposite sides, then the object with be moved rather than stretched to fill the available space.

dock

Specify the docking location of an object in the display.

Note: An object should not be docked if the Resize Mode is set to Scale.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

visFlag

Set the visibility of the object.

Unique Behavior

The following describes properties that behave uniquely with the tree control.

valueColumnName: This property specifies the name of the column whose value should be assigned to the $value variable when a node in the tree is clicked. If not specified, the label string of the selected node is assigned to $value. Note the $value is the only substitution that can be used in the Display Name field of a drill-down command.

mouseOverFlag: If this property is checked, a tooltip appears when the cursor is positioned over a leaf node. The tooltip shows the node path (the node label preceded by the labels of all of its ancestors), the node status (if the nodeStatusColumnName property is specified), and its value (if the valueColumnName property is specified).

execOnLeafOnlyFlag: If this property is checked, the tree actionCommand property executes only when a leaf node is clicked (a click on a non-leaf node expands only the node). If unchecked, the tree actionCommand property executes on all nodes, not just the leaf.

rootNodeLabel: This property specifies the tree root node (of which there is only one). By default, this property is blank and the root node is not visible.

Limitations 

§        In the Display Viewer, mouseover text is displayed only if the tree has focus.

§        If the valueTableFormat property for the tree control is Row-Leaf, the context menu feature applies to a right-click or a double-click on leaf nodes only. That is, a right-click on a non-leaf node does not add items to the menu and a double-click on a non-leaf node simply expands or collapses the tree node, it does not invoke the double-click action.

In the Thin Client: 

§        The tree node appearance, such as spacing and fonts, might vary slightly as compared to the Display Viewer, and also may vary slightly between different browsers.

§        A tree node cannot expand/collapse by double-clicking on it. The +/- icon must be clicked.

§        In Internet Explorer, nodes expand/collapse even if the tree enabledFlag property is unchecked. (However, the tree actionCommand cannot be invoked).

§        In Mozilla Firefox, the horizontal scrollbar might appear and disappear after each mouse click in the tree.

§        In iOS Safari (iPad), if the tree mouseOverFlag property is checked, a user must click a tree node twice to invoke the tree command. The first click only displays the node mouseover text.

§        In iOS Safari (iPad), scrollbars will not appear in a tree control. If the tree contains more nodes than are visible, use a two-finger drag gesture inside the tree area to scroll.

§        In iOS Safari, a click on the +/- icon expands/collapses the node as expected. However, if the execOnLeafOnlyFlag property is unchecked, the tree command is also executed.

§        In Internet Explorer, if you double-click directly on a leaf node the node is selected but the double-click action is NOT invoked. The double-click action is invoked only if you click on the empty space in the tree to the left or the right of the leaf node, or in the small hollow square located to the left of the leaf node.

Accordion Control

This section describes how to create an accordion control (class name: obj_c1accordion).

There are two methods for creating an accordion-driven multi-panel application: the static accordion navigation panel and the accordion control. Use the static accordion navigation panel method if you know the specific sources that are to populate the accordion and they remain constant for the life of the application. For example, if you know all the displays that compose your application and the static representation of an accordion will only be used for navigating those displays, the static accordion navigation panel is suitable (and is easier to configure). To configure the static accordion navigation panel, add the accordion using the rtvAccordionPanel tag to the PANELS.ini file. For details about configuring the accordion, see “Multiple Display Panels”.

Use the accordion control method if the number of nodes or leaves, labels or icons of the accordion change during the lifetime of the application. Data can be provided that will change the nodes and leaves of the accordion and also change the labels, and icon representations on the accordion with dynamic data.

When constructing an application with multiple panels using the accordion control, one panel displays an RTView file that has instanced the accordion control and the other contains the displays which are drilled down to by selecting items on the accordion. The following illustrates a two-panel application in which the accordion control in the left panel updates the display in the right panel:

accord_multipanel.gif

 

To see an example of a multi-panel layout that uses an accordion control to display live status information and perform navigation via drill-down in another panel, see the “Navigation Control Demo”.

For details about creating an application with multiple panels, see “Multiple Display Panels”.

Creating an Accordion Control

To create an accordion control:

1.     Attach tabular data to the accordion control valueTable property.

2.     Specify the table format for the accordion in the valueTableFormat property. There are two table format options for navigation controls. The Row-Leaf format is intended for use when the valueTable property is attached to an indexed table and all leaves in the navigation control are at the same depth. Otherwise, the Row-Node format is used. See “Navigation Control Objects” for details.

3.     Optionally, configure accordion icons.

4.     Optionally, configure status icons.

Accordion Icons 

Nodes in an accordion control appear as pushbuttons and a single branch is expanded at a time. Accordion control icons indicate whether an element is closed, open, or a leaf node.

Each node in an accordion is either a parent node or a leaf node. A parent node has one or more child nodes that are visible when the node is expanded (opened) and are invisible when the node is collapsed (closed). When a parent node is expanded, a small down arrow icon is displayed near the left edge of the button. When a parent node is collapsed, a small right arrow icon is displayed.

A leaf node has no children and thus cannot be expanded or collapsed.

Configuring Accordion Icons 

The images used for these icons are specified by the accordionOpenImage and accordionClosedImage properties, respectively. Note that a leaf node never displays either of these icons.

The color of accordion node buttons that are not selected is specified by the accordionColor property, the color of the accordion node button that is selected is specified by the accordionSelectColor property, the text color for the accordion node that is selected is specified by the accordionSelectTextColor property and the width for each accordion button is specified by the accordionWidth property.

Background Properties

Specify how the background is displayed in the accordion control.

Property Name

Description

bgBorderFlag

When checked, a one pixel dark border is drawn around the accordion. If unchecked, no border is drawn. By default, the flag is checked and the border is visible.

Note: The border color and width are not configurable.

bgColor

Select the ellipse_button00043.gif button and choose a color from the palette to set the background color of the accordion control.

Data Properties 

Specify how data is displayed in the accordion control.

Property Name

Description

nodeIdColumnName

This property is available when the valueTableFormat is Row-Node. With the Row-Node format there are two table columns that define the accordion structure: the nodeIdColumnName property and the parentIdColumnName property specify the two columns.

The nodeIdColumnName property specifies the table column containing the node ID string. The node ID string must be unique among all nodes with the same parent. Or, if the uniqueNodeIdFlag property is checked, each node ID string must be unique in the entire accordion. By default, the node ID string is used as the node label in the accordion.

nodeIndexColumnNames

This property is available when the valueTableFormat is Row-Leaf. Specifies the path to a leaf node (that is, the ancestor nodes of the leaf).

When the valueTable property is attached to the current table of an indexed RTView cache, the nodeIndexColumnNames property is typically set to the same columns that are specified for the cache index columns.

Enter a semicolon-separated list of column names, where the Nth column name in the list contains the labels for accordion nodes at depth N. The labels for top-level nodes are defined by the first column in the nodeIndexColumnNames property, the labels for the second-level nodes are defined by the second column, and so forth.

For example:

AgentName;App Name;PID

The labels for the top-level nodes are defined by the AgentName column, the labels for the second-level nodes are defined by the App Name column, and labels for the third-level nodes are defined by the PID column.

To specify node labels from a different set of valueTable columns, use the nodeLabelColumnNames property.

nodeLabelColumnName

This property is available when the valueTableFormat is Row-Node. By default, the node ID string is used as the node label in the accordion. Use the nodeLabelColumnName property to specify a different valueTablecolumn to provide the label.

nodeLabelColumnNames

This property is available when the valueTableFormat is Row-Leaf. Use the nodeLabelColumnNames property to specify a different set of valueTablecolumns to provide node labels. Enter a semicolon-separated list of column names, one for each level in the accordion, where the Nth column name in the list contains the labels for accordion nodes at depth N.

nodeStatusColumnName

This property applies to the status icon. Specifies the name of the valueTable column containing node status values. The column specified populates the Node Properties dialog Status Value column, in which you map node status values to image icons. The icons are displayed for any node whose value matches the value selected.

parentIdColumnName

This property is available when the valueTableFormat is Row-Node. With the Row-Node format there are two table columns that define the accordion structure: the parentIdColumnName property and the nodeIdColumnName property specify the two columns.

The parentIdColumnName property specifies the table column containing the parent node ID.

roleCheckColumnName

The name of a string column in the data table containing the display names to be checked against the user's role. The default value is Display. Use this property to show/hide accordion nodes based on user role definitions. If a row's value in the specified column is the name of a display to which the user's role is denied access, the accordion does not show a node for that row. For details about user roles and display access, see “Role Definitions”.

selectedValue

This column specifies the value of the currently selected node in the accordion.

selectedValueColumnName

If specified, the values in this column will be compared to the selectedValue in order to set the accordion selection. If not specified, the selectedValue will be compared to the values in the column specified in valueColumnName property.

uniqueNodeIdFlag

This property is available when the valueTableFormat is Row-Node.

When enabled, specifies that each node ID string must be unique in the entire accordion. When disabled, specifies that each node ID string must be unique among all nodes with the same parent.

valueColumnName

Specifies the name of the column whose value is assigned to the $value variable when a node in the accordion is selected. If not specified, the label string of the selected node is assigned to the $value variable. The $value variable is the only substitution that can be used in the Display Name field of a drill-down command.

valueTable

Attach your tabular input data to this property. There are two valueTable format options you can use to create your table:

§        Row-Leaf format: See “Navigation Control Objects” for details about creating the table.

§        Row-Node format: See “Navigation Control Objects” for details about creating the table. If you have an XML file that has the navtree.xml format you can convert it into a row-node format. For details, see “navtree.xml For Navigation Control Objects”.

Note: As with other table-driven objects, the drillDownColumnSubs property can be configured to set substitutions to column values from the row in the valueTable that corresponds to the selected accordion node.

valueTableFormat

Specifies the format of the valueTable: Row-Leaf or Row-Node.

varToSet

Allows you to update the attached variable with the value from the control.

Interaction Properties

Specify interactions in the accordion control.

Property Name

Description

accordionCollapseFlag

When checked, only one branch of the accordion will be open at a time. If you click a node to open another branch, then the previously open branch is automatically closed. If this flag is unchecked, opening another branch has no affect on other open branches. This flag is checked by default.

actionCommand

Use the actionCommand property to assign a command to the accordion. You can configure the accordion to open a drill-down display, set substitutions, or execute a command in response to a user click on an accordion node.

The actionCommand can reference the value from the accordion by using the keyword $value. When the command is executed, the variable attached to varToSet is updated with the selected node data.

The drillDownColumnSubs property can be configured to set substitutions to column values from the row in the valueTable that corresponds to the selected accordion node.

If the execOnLeafOnlyFlag property is checked, the accordion actionCommand property executes only when a leaf node is clicked (a click on a non-leaf node expands only the node). If unchecked, the accordion actionCommand property executes on all nodes, not just the leaf.

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 ellipse_button00044.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownColumnSubs

Use the drillDownColumnSubs property to set substitutions to column values from the row in the valueTable that corresponds to the selected accordion node.

Select the ellipse_button00045.gif button to open the “Drill Down Column Substitutions Dialog” to customize which substitutions are passed into drill-down displays.

enabledFlag

If unchecked, the accordion nodes are the color gray and do not respond to user input.

execOnLeafOnlyFlag

If checked, the accordion actionCommand is executed only for leaf nodes, and a click on a non-leaf node only expands the node. Also, the mouseover tooltip only appears for leaf nodes.

If unchecked, the accordion actionCommand property executes on all nodes, and the mouseover tooltip appears for all nodes.

mouseOverFlag

Specifies whether a tooltip appears when the cursor is positioned over a node. The tooltip shows the node path (the node label preceded by the labels of all of its ancestors), the node status (if the nodeStatusColumnName property is specified), and its value (if the valueColumnName property is specified).

tabIndex

Use the tabIndex property to define the order in which the accordion receives focus when navigated from your keyboard. Initial focus is given to the object with the smallest tabIndex value, from there the tabbing order proceeds in ascending order. If multiple objects share the same tabIndex value, initial focus and tabbing order are determined by the alpha-numeric order of the table names. Tables with a tabIndex value of 0 are last in the tabbing order.

Note: The tabIndex property does not apply to tables in the Display Server, nor to objects that are disabled, invisible, or have a value of less than 0.

Label Properties

Specify the label in the accordion control.

Property Name

Description

labelTextColor

Select the ellipse_button00046.gif button and choose a color from the palette to set the label text color. 

labelTextFont

Select font style of label text from the drop-down menu.

labelTextSize

Set the height of the label text in pixels.

Node Properties 

Specify the node structure in the accordion control.

Property Name

Description

accordionClosedImage

Specify the icon that appears to the left of the label for a closed (collapsed) accordion node. The default is a small right arrow.

accordionColor

Specify the color of the accordion node buttons that are not selected.

accordionOpenImage

Specify the icon that appears to the left of the label for an open (expanded) accordion node. The default is a small down arrow.

accordionSelectColor

Specify the color of the accordion node that is selected.

accordionSelectTextColor

Specify the text color for the accordion node that is selected (all unselected nodes use labelTextColor).

accordionWidth

Specify the width, in pixels, for each accordion button. If a value of zero (the default) is specified, the width of each node is computed automatically and might be different for each node. Specify a nonzero value if you want all buttons to have the same size, for a more uniform appearance.

nodeStatusIconPos

Specify the status icon position in the accordion: Left or Right. By default, the status icon appears on the left of the node label. By default, no status icons appear in the accordion.

nodeStatusProperties

This property applies to the status icon. Specifies the status icon for a node. By default, no status icon is displayed.

Select the ellipse_button00047.gif button to open the Node Properties dialog and map images to values, and set the status priority order for propagation up the accordion.

The nodeStatusProperties property is visible only if the nodeStatusColumnName property is non-blank.

You can also use the nodeStatusProperties property to attach a status icon to data. The data attachment must be a three-column table. Typically, a static XML file containing the table is used. The first column must contain string values that match values from the column in valueTable specified by the nodeStatusColumnName   property. The second column must be the path to the .png, .gif, or .jpg image. The third column must contain the non-negative integer priority value.

A static XML file is only read once each time you run RTView. If you specify (or modify) an XML source using the Application Options dialog, you may specify whether that XML source is static. For details, see “Creating XML Sources”.

rootNodeLabel

Specify whether the accordion root node is visible. By default, this property is blank and the root node is not visible.

Object Properties

Specify the layout in the accordion control.   

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.

Note: If the Resize Mode is set to Scale and an object is anchored on opposite sides, then the object with be moved rather than stretched to fill the available space.

dock

Specify the docking location of an object in the display.

Note: An object should not be docked if the Resize Mode is set to Scale.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used. See “Creating Style Sheets” for more information.

Note: The value entered must not contain spaces and cannot start with rtv-.

visFlag

Set the visibility of the object.

Unique Behavior

The following describes properties that behave uniquely with the accordion control.

valueColumnName: This property specifies the name of the column whose value should be assigned to the $value variable when a node in the accordion is clicked. If not specified, the label string of the selected node is assigned to $value. Note the $value is the only substitution that can be used in the Display Name field of a drill-down command.

mouseOverFlag: If this property is checked, a tooltip appears when the cursor is positioned over a leaf node. The tooltip shows the node path (the node label preceded by the labels of all of its ancestors), the node status (if the nodeStatusColumnName property is specified), and its value (if the valueColumnName property is specified).

execOnLeafOnlyFlag: If this property is checked, the accordion actionCommand property executes only when a leaf node is clicked (a click on a non-leaf node expands only the node). If unchecked, the accordion actionCommand property executes on all nodes, not just the leaf.

rootNodeLabel: This property specifies the accordion root node (of which there is only one). By default, this property is blank and the root node is not visible.

Limitations 

 In the Display Viewer, mouseover text is displayed only if the accordion has focus.

In the Thin Client: 

§        The accordion node appearance, such as spacing and fonts, might vary slightly as compared to the Display Viewer, and also may vary slightly between different browsers.

§        In iOS Safari (iPad), if the accordion mouseOverFlag property is checked, a user must click an accordion node twice to invoke the accordion command. The first click only displays the node mouseover text.

§        In iOS Safari (iPad), scrollbars will not appear in an accordion control. If the accordion contains more nodes than are visible, use a two-finger drag gesture inside the accordion area to scroll.

Extending the Context Menu

This section describes how to extend items in the RTView context menu. The context menu appears when you right-click on an object. The context menu can be extended for a table object (obj_table02), heatmap object (obj_heatmap), grid object (obj_objectgrid) or tree control (obj_c1tree). Configure the context menu if you want to click an element on a tabular object (for example, a row in a table, a cell in a heatmap or grid, or a node in a tree control) and then choose one of several possible actions from a menu. The context menu appears when you right-click on an object (illustrated in the following figure).

tree_extendmenu.gif

 

The extended context menu is not supported in the Thin Client in iOS Safari (iPad/iPhone).

To configure the context menu, you create a button for each of the possible actions (for example, an Ack button, an Unack button, and an Own button) and edit button control properties (menuItemIndex, menuItemGroup, and menuItemSubmenu). You also edit properties on the table, heatmap or grid object (menuItemGroup and rightClickActionFlag), which are referred to as the target object. The buttons in the menuItemGroup define the items that are added to the context menu, when the target object with the same menuItemGroup value on the same display is right-clicked. The context menu items are, effectively, shortcuts to the buttons. The buttons are not affected by the properties of the associated target object.

Context menu items can be organized into submenus. The target object can be configured to invoke the first associated menu item when the user double-clicks on the object.

Summary of Steps

1.     Verify that the following is your desired outcome: When a user selects an element on a tabular object (for example, a row in a table), several possible actions are available and the user can choose one to execute.

2.     Configure the target object to set drillDownColumnSubs as necessary to record the selected row. Typically, the rightClickActionFlag property is checked, too.

3.     Configure buttons on the display to perform each of the possible actions, using the drillDownColumnSubs set in step 2.

4.     Choose a name for the menuItemGroup property and specify that name on the target object and all of the buttons.

5.     Set the other menuItem* properties on each of the buttons as appropriate.

Example

To illustrate the how to configure the context menu, consider a display containing a table object.

Note: A heatmap object is configured similarly to a table object, and has the same behavior when a cell in the heatmap is right-clicked or double-clicked.

In our example, the table object shows the RTView AlertTable. A list of actions (Ack, Unack, and Own) are associated with each row in the table. The display also contains three buttons labeled Ack, Unack, and Own which execute different alert commands. A single left-click on a row could select the corresponding alert, or be followed by a click on the Ack (or Unack) button to acknowledge (or unacknowledge) the selected alert, or a click on the Own button could set the alert's owner to the current RTView username.

To configure the above described behavior, the table object's drillDownColumnSubs property is configured to set a substitution variable, $alertID, that is equal to the value of the ID column for the selected row. The table object's command property is configured to drill-down to the current display window. This simply means that each click on a row stores the ID of the selected alert in the $alertID substitution variable. Also, the actionCommand property of the Ack button is configured to execute an Acknowledge Alert on ID = $alertID. The actionCommand for the Unack and Own buttons is configured similarly. If necessary, the enabledFlag of each button is attached to a function that determines whether the button's action is appropriate for the current selection.

When an extended context menu is configured on the display:

        In addition to clicking on the button to execute an action, each action can also be executed from an item in the RTView context menu (selecting an extended context menu item is equivalent to clicking on the corresponding button.).

        By double-clicking on a row in a table (or a cell in a heatmap or grid), the object's drill-down can be executed or, if the object has no drill-down, the first action in the list can be executed.

The extra menu items appear at the top of the menu. One extra item appears in the menu for each button object (obj_c1button) on the display that meets these requirements:

        The button's visFlag property is set to 1.

        The button's menuItemIndex property has a nonzero value.

        If the menuItemGroup property of the currently selected table or heatmap object is set, it matches the menuItemGroup property of the button.

If multiple buttons meet the requirements above, they also appear in the context menu, ordered by the menuItemIndex property in increasing order.

Continuing with our example, let us assume we want context menu items for the Ack, Unack, and Own actions to appear in the context menu when the alert table object is selected, and in that order. To accomplish this, the menuItemIndex property of the Ack, Unack, and Own buttons is set to 1, 2, and 3 respectively. Also, to ensure that the menu items only appear when the alert table object is selected, the menuItemGroup property of the table object and all three buttons is set to the same string, for example "alert_group".

The extra menu items are added to the context menu by increasing order of their menuItemIndex property values. That is, if button X has its menuItemIndex set to a value that is less than the menuItemIndex of button Y, the item for X is situated above (nearer the top of the menu) the item for Y. Note that menuItemIndex can be assigned a value less than or greater than 0 (zero), but a value of 0 (zero) means that no item is added to the menu for that button.

The final required configuration step is to check the rightClickActionFlag property on the table object. This accomplishes two things:

1.     Ensures that the substitutions for the right-clicked row are set before the menu is opened.

2.     Enables the following double-click behavior on a table row:

        The table's command, if one is specified, is executed. Typically this sets substitutions on the current display for the selected row.

        The table's drill-down is executed. If the table has no drilldownTarget, the first enabled button on the display with the same menuItemGroup value is activated.

To summarize, configuring the table and buttons as described in our example, the table object behaves as follows:

        A single left-click or right-click on a row in the alert table executes the table's command, setting the $alertID substitution variable to the ID of the alert in that row.

        A right-click on a row in the alert table opens the context menu, in which the Ack, Unack, and Own menu items appear below the Drill Down item. (These menu items are either enabled or disabled, according to the state of the corresponding button).

        A double-left click on a row executes the Ack command on that row's alert, because the Ack button is the first button in the table's menuItemGroup property (it has the smallest menuItemIndex value in the group, 1 in this example).

Optionally, the extra menu items on the context menu can be organized into one or more submenus. This is done by assigning the same value to the menuItemSubmenu property of each button whose item is to appear in the same submenu. For example, to have the Ack, Unack, and Own menu items appear in a submenu (rather than the top-level context menu), we set the menuItemSubmenu property of the Ack, Unack, and Own buttons to (for example) "Alerts". This adds an item labeled "Alerts ->" to the top-level of the context menu, and selecting that item opens a cascading submenu with the Ack, Unack, and Own menu items.

If multiple submenus are defined, they are ordered by increasing value of the lowest menuItemIndex of the all the buttons in each submenu.

If a grid object is configured to use the context menu and the grid's cells contain a composite display, the behavior is as described above except when a user right-clicks or double-clicks an object in the composite display that has its own drillDownTarget or command property configured. In that case, the click is processed by the object inside the composite and not by the grid.

Limitations

The extended context menu is not supported in the Thin Client in iOS Safari (iPad/iPhone). All of the new properties (rightClickActionFlag, menuItemIndex, menuItemGroup, menuItemSubmenu) are ignored by the Thin Client on iOS Safari, therefore no menu items are added to the context menu and no double-click actions are supported. In particular, if a button is configured on the display so that it is off-screen but has a nonzero menuItemIndex, the button's command is not accessible on iOS Safari.

Extra menu items do not appear in the context menu in the main editing panel of the Builder. (They do appear in the Builder's preview window).

The double-click feature on the obj_table02, obj_heatmap, and obj_objectgrid objects does not work in any window in the Builder.

In the Thin Client, a double-click on a table, heatmap, or grid object that performs the first action in the menu group is sometimes ignored instead. This happens if the Display Server is slow to respond to the first click (which might enable the first button in the menu group), so the button is still disabled when the second click occurs. Its most likely to occur if the user double-clicks on several different cells in quick succession.

Fx Graphs

The Fx Graphs tab of Object Palette features Adobe® Flash graphs designed specifically for use in a Thin Client deployment. There are three Fx graphs available: Trend, Bar and Pie. Due to the fact that these objects use Adobe® Flash, they have additional requirements and limitations.

To enable developers to build displays using Flex objects without having to allow for deployment situations where Flex is unacceptable, it is possible to replace Fx graphs with corresponding standard graphs.

Note: In the Thin Client, Fx graphs are acceptable in any supported browser that has the Flash Player installed. If a display containing an Fx graph is loaded into the Thin Client and the Flash Player is not installed, a link to the Flash Player download page will appear.

Fx graphs are automatically replaced with standard graphs if:

§        A PDF file is generated from a display (.rtv) file using the Export menu or the RTView reporting tool. (Fx graphs do not support PDF generation.) Fx graphs are replaced and then restored to the display after the PDF file is generated.

§        The Flash player (or wrapper) is unavailable when a display (.rtv) file is opened in the:

      Display Viewer Application 

      Display Builder Preview Window: Fx graphs are only automatically replaced in the Preview window of the Display Builder in order to avoid inadvertently saving a file with replacement graphs.

      Display Viewer Applet: In order to replace unsupported Fx graphs with standard graphs, the applet's ARCHIVE parameter must include gmsjflash.jar.

To replace Fx graphs with standard graphs in all display (.rtv) files opened in the in the Display Builder, Display Viewer Application or Display Server, set the fxreplace option via the command line or in your OPTIONS.ini file.

Note: Once Fx graphs have been replaced, a file saved in the Display Builder will be saved with replacement (i.e. standard) graphs.

“Fx Trend Graph”

The Fx trend graph (obj_fxtrend) is generally used for tracing two types of data in one graph: real-time (i.e. live data) and archived data. Displaying these two types of traces in conjunction is useful for comparing data trends.

bgraphs_fx_trend.gif

 

“Fx Bar Graph”

The Fx bar graph (class name: obj_fxbar) is useful for comparing columns or rows of numeric data from a tabular data element returned by your data attachment.

bgraphs_fx_bar.gif

 

“Fx Pie Graph”

The Fx pie graph (class name: obj_fxpie) is useful for comparing values from a single column or a single row of the tabular data element returned by your data attachment.

bgraphs_fx_pie.gif

 

Requirements and Limitations

Requirements

§        The Fx graphs require version 9.0 or newer of the Adobe® Flash Player.

§        In the Thin Client, the Fx graphs are supported in any supported browser that has the Flash Player installed. If a display containing an Fx graph is loaded into the Thin Client and the Flash Player is not installed, a link to the Flash Player download page will appear on the display.

§        In the Display Viewer Applet, the ARCHIVE parameter must include gmsjflash.jar in order to replace unsupported Fx graphs with standard graphs.

Limitations

§        In the Display Builder and Display Viewer Application, Fx graphs are supported on Windows platforms only. In the Display Builder, the Fx Graphs tab will still be visible.

§        Fx graphs are not supported in the Display Viewer Applet on any platform.

§        Fx graphs can be resource intensive during display loading and updating. This should be kept in mind when designing displays. A display containing several Fx graphs may load slowly.

§        The Fx graphs are drawn inside a Flash Player window. This means that Fx graphs will be drawn above all other objects in a display, except other Fx objects, regardless of the object order. The Move to Front and Move to Back operations have no effect on Fx graphs. Also, in the Display Builder, if an Fx graph extends beyond the edges of the display, it will obscure other panels in the Display Builder, such as the object palette, property sheet, etc. When zooming or scrolling in the Display Builder or Display Viewer, Fx graphs will obscure any portion of the vertical and horizontal scrollbars that they overlap.

§        In the Thin Client, if the context menu is opened near an Fx graph, the menu will be partially hidden by the Fx object. Also, a right-click inside an Fx graph will open the Flash Player menu, not the Thin Client's context menu.

§        When moving an Fx graph in the Display Builder, it is best to grab and drag the object by one of its edges, just inside the selection highlight rectangle. The graph can't be dragged from within the plot area, since that will initiate a zoom. It can be dragged by other interior areas, but it may not move smoothly.

§        Fx graphs store RGB values for all colors, this causes two problems:

       If you assign a custom color to a Fx graph and then change the custom color definition, the Fx graph will not update since it stored the RGB value of the custom color instead of the Color Index number. The only way to update it is to manually pick a new color in the Display Builder. See “Custom Colors Tab” for more information.

       If you apply a custom color to the Fx graph with the same RGB value as a standard color, when you close and re-open the standard color will be selected not the custom color. Because Fx graphs store RGB values, the corresponding color in the standard palette will be selected first.

§        Replacement (i.e. standard) graphs do not exactly match the Fx graphs in appearance. There are minor differences in colors, gradients, fonts for legends/axis labels, tick marks, axis line style/thickness, spacing/placement of graph components, etc.

§        The following object properties of the Fx Trend Graph (obj_fxtrend) are not available in the standard Trend Graph (obj_trendgraph02): legendPosition, logAxisFlag, alarmGlow, traceNShadowFlag. Therefore, the replacement will always have a linear y-axis and its legend, if visible, will be on the right.

§        Interactive changes made to an Fx graph's scrollbar knob position, legend size, or time range are not applied to the replacement.

§        Current data applied to an Fx trend graph is not re-applied to the replacement. So, the trace data, legend position, scrollbar position, and time range will appear as though the display was opened.

§        The Fx pie graph (obj_fxpie) appears as a circle, the replacement (obj_pie) is drawn as an ellipse that fills the available rectangular area.

§        Custom Fx graphs cannot replaced by a standard graph.

Fx Trend Graph

The Fx trend graph (obj_fxtrend) is generally used for tracing two types of data in one graph: real-time (i.e. live data) and archived data. Displaying these two types of traces in conjunction is useful for comparing data trends. The Fx trend graph supports up to eight traces, set the traceCount to control the number of traces.

bgraphs_fx_trend00048.gif

 

Using Trace* Properties 

The Display Builder automatically creates a set of trace* properties according to the number you specify using the traceCount object property. Attach your data to trace*Value or trace*ValueTable, where * is the trace number. For example if you set the traceCount to three (3), you will have three traces in your graph (Trace01, Trace02 and Trace03) and a corresponding trace*Value (trace1Value, trace2Value and trace3Value) for each.   

All traces in the Fx trend graph have the option to display historical or current data:

Historical Data

To display historical data, attach to trace*ValueTable, where * is the trace number, and include two columns in your attachment. The first column must be the time value and the second column the value to plot.

Optionally, include a third (string) column in your attachment if you want to display a data label for each corresponding data value. See the Attach to Data section specific to your data source for details on how to use the Select Columns dialog.

Current Data

To display current data, attach to trace*Value, where * is the trace number. When you attach data to the trace*Value property, the time displayed on the Fx trend graph is automatically updated each time data is received. Your data attachment can contain either a single point of data or two columns of data. See the Attach to Data section specific to your data source for details on how to use the Select Columns dialog.

If your attachment contains a single point of data, RTView assigns a time stamp when the graph receives the data.

If your attachment contains two columns of data, the first column must be the time value and the second column the value to plot. Optionally, include a third (string) column in your attachment if you want to display a data label for each corresponding data value.

Supported formats for the time value column are: mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03), yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03), and the number of milliseconds since midnight, January 1, 1970 UTC. In order to view all available data, you must set the properties timeRange to -1 and timeShift to a negative value. This negative value will be used to round the start and end times for the y-axis. For example, if you specify -15 for the timeShift property, the start and end times for the y-axis will be rounded to the nearest 15 seconds.

Data labels will be displayed (enclosed in parentheses) in the fixed legend and in the popup legend, between the trace value and the trace label. If the cursorFlag property is selected, then the data label in the popup legend is for the data value that is directly under or to the left of the cursor.   

Alert Properties 

To set trace marker colors and styles based on a threshold value, select the corresponding value alarm or value warning flags.

Property Name

Description

alarmGlowFlag

If selected, the border of the trend graph will glow if a trace point exceeds an alarm or warning threshold.

Note: The visibility of the border glow is based on trace points that are currently visible.

The color of the border glow is the specified value*TraceColor. If multiple trace points have exceeded an alarm and/or warning threshold, whether they are on the same trace or multiple traces, the value*TraceColor of the border glow will be chosen in the following order: HighAlarm, LowAlarm, HighWarning, LowWarning.

Note: The color of the border glow is based on trace points that are currently visible.

If the yAxisMultiRangeMode selected is Strip Chart, then each chart will display its own border glow.

valueHighAlarmEnabledFlag

Select to enable the high alarm threshold and the following related properties:

valueHighAlarm - Set the value of the high alarm threshold.

valueHighAlarmLineVisFlag - Select to display a dotted line at the high alarm threshold. The color of the line is set to the valueHighAlarmMarkColor.

valueHighAlarmMarkColor/ valueHighAlarmMarkStyle - When a trace marker's value is greater than or equal to the valueHighAlarm property, the marker will change to the valueHighAlarmMarkColor and valueHighAlarmMarkStyle. If set to Default, the corresponding AlarmTraceColor and AlarmTraceStyle will be used.

valueHighAlarmTraceColor/ valueHighAlarmTraceStyle - When the value of any segment of a trace line is greater than or equal to the valueHighAlarm property, that segment of the trace line will change to the valueHighAlarmTraceColor and valueHighAlarmTraceStyle. If set to Default, the corresponding trace*LineColor and trace*LineStyle will be used.

valueHighWarningEnabledFlag

Select to enable the high warning threshold and the following related properties:

valueHighWarning - Set the value of the high warning threshold.

valueHighWarningLineVisFlag - Select to display a dotted line at the high warning threshold. The color of the line is set to the valueHighWarningMarkColor.

valueHighWarningMarkColor/valueHighWarningMarkStyle - When a trace marker's value is greater than or equal to the valueHighWarning property but less than the valueHighAlarm property, the marker will change to the valueHighWarningMarkColor and valueHighWarningMarkStyle. If set to Default, the corresponding WarningTraceColor and WarningTraceStyle will be used.

valueHighWarningTraceColor/valueHighWarningTraceStyle - When the value of any segment of a trace line is greater than or equal to the valueHighWarning property but less than the valueHighAlarm property, that segment of the trace line will change to the valueHighWarningTraceColor and valueHighWarningTraceStyle. If set to Default, the corresponding trace*LineColor and trace*LineStyle will be used.

valueLowAlarmEnabledFlag

Select to enable the low alarm threshold and the following related properties:

valueLowAlarm - Set the value of the low alarm threshold.

valueLowAlarmLineVisFlag - Select to display a dotted line at the low alarm threshold. The color of the line is set to the valueLowAlarmMarkColor.

valueLowAlarmMarkColor/valueLowAlarmMarkStyle - When the trace marker's value is less than or equal to the valueLowAlarm property, the marker will change to the valueLowAlarmMarkColor and valueLowAlarmMarkStyle. If set to Default, the corresponding AlarmTraceColor and AlarmTraceStyle will be used.

valueLowAlarmTraceColor/valueLowAlarmTraceStyle - When the value of any segment of a trace line is less than or equal to the valueLowAlarm property, that segment of the trace line will change to the valueLowAlarmTraceColor and valueLowAlarmTraceStyle. If set to Default, the corresponding trace*LineColor and trace*LineStyle will be used.

valueLowWarningEnabledFlag

Select to enable the low warning threshold and the following related properties:

valueLowWarning - Set the value of the low warning threshold.

valueLowWarningLineVisFlag - Select to display a dotted line at the low warning threshold. The color of the line is set to the valueLowWarningMarkColor.

 

valueLowWarningMarkColor/valueLowWarningMarkStyle - When the trace marker's value is less than or equal to the valueLowWarning property, but greater than the valueLowAlarm property, the marker will change to the valueLowWarningMarkColor or valueLowWarningMarkStyle. If set to Default, the corresponding WarningTraceColor or WarningTraceStyle will be used.

valueLowWarningTraceColor/valueLowWarningTraceStyle - When the value of any segment of a trace line is less than or equal to the valueLowWarning property, but greater than the valueLowAlarm property, that segment of the trace line will change to the valueLowWarningTraceColor and valueLowWarningTraceStyle. If set to Default, the corresponding trace*LineColor and trace*LineStyle will be used.

Background Properties 

Specify how the background is displayed in your graph.

Property Name

Description

bg3dFlag

Select to display a 3D edge on the background rectangle.

bgColor

Select the ellipse_button00049.gif button and choose from the palette to set the background color. The Default color is grey. Color properties are treated differently on Fx trend graph 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 

Specify how data is displayed in your graph.

Property Name

Description

historyOnlyFlag

If selected, the graph will plot only data that is applied to the trace*ValueTable properties and will ignore the timeShift property and any data that is applied to the trace*Value properties.

This is useful when same graph is used to view Historical data or Historical and Current data by setting substitutions on the display.

maxPointsPerTrace

The default is set to 1000. The maximum value for this property is 30000.

yValueMax

yValueMin

The yValueMin and yValueMax properties control the range of the y-axis if the yAxisAutoScaleMode property is Off.

Select On for the yAxisAutoScaleMode to calculate y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

Data Format Properties

Property Name

Description

yValuePrecision

Specify the number of digits displayed for y-axis values in the legend and data tips.

Interaction Properties

Specify how you interact with the data in your graph. See the “Thin Client Deployment - Additional Interactivity” section for more information on how to interact with this graph at runtime.

Property Name

Description

command

Assign a command to your trend graph. See “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 ellipse_button00050.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

cursorColor

Select the ellipse_button00051.gif button and choose from the palette to set the color of the cursor. The Default color is black. Color properties are treated differently on Fx trend graph than on other objects, see the “Fx Graph Colors” section below for more information.

cursorFlag

Select to enable the cursor. When the cursor is enabled, select the graph and point to a location on a trace to see a cursor line at that location and display the time and values of all traces at the cursor line on the legend. Hold down the control key to snap the cursor to the closest data point.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

When you double-click on a trace in the graph, the following predefined substitutions will be set on the specified drillDownTarget:

§        $traceNumber - number of the trace (1 to 8) that contains the selected point

§        $traceLabel - label of selected trace

§        $pointValue - data value of point

§        $pointTimestamp - timestamp of point

§        $pointLabel - data label (if any) of point

§        $pointIndex - position of point in trace data (0 to maxPointsPerTrace)

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00052.gif button to open the Edit Label dialog.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextColor

Select the ellipse_button00053.gif button and choose 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 size of the label text in pixels.

 

Legend Properties 

Specify the way the legend is displayed in your graph. Click and press a trace's entry in the legend to temporarily hide all other traces in the graph.

Property Name

Description

legendBgColor

Select the ellipse_button00054.gif button and choose from the palette to set the background color of the legend. The Default color is grey.

Note: Color properties are treated differently on Fx trend graph than on other objects, see the “Fx Graph Colors” section below for more information. 

legendBgGradientFlag

Select the legendBgGradientFlag to display a gradient in the legend background.

legendPosition

Select Top, Bottom, Left or Right to position the legend relative to the plot area.

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.

legendVisFlag

Select to display the legend.

legendWidthPercent

Set the percent of the total width of the object used for the legend.

Note: If the legend is positioned at the top or bottom, this will be a percentage of the height instead.

Marker Properties 

Specify the way markers are displayed in your trend graph.

Property Name

Description

markDefaultSize

Set markDefaultSize to specify the size of the markers in pixels.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

visFlag

Control visibility of the object.

Plot Area Properties 

Specify the way the plot area is displayed in your graph.

Property Name

Description

gridColor

Select the ellipse_button00055.gif button and choose from the palette to set the color of the grid. 

Note: Color properties are treated differently on Fx trend graph than on other objects, see the “Fx Graph Colors” section below for more information.

traceBgColor

Select the ellipse_button00056.gif button and choose from the palette to set the background color of your graph. The Default color is grey.

Note: Color properties are treated differently on Fx trend graph than on other objects, see the “Fx Graph Colors” section below for more information.

traceBgGradientFlag

Select to display a gradient in the plot background. Set the color of the plot background with the traceBgColor property.

Trace Groups

Specify trace groups displayed in your trend graph. The Display Builder automatically creates a set of traceGroup* properties (where * is the trace group number) according to the number of trace groups specified in the traceGroupCount property. A trace group is a collection of two or more traces. Trace groups are useful for identifying multiple traces sharing the same vertical axis (when yAxisMultiRangeMode is set to Strip Chart or Multi-Axis) or for identifying three traces combined as a banded trace.

Property Name

Description

traceGroupCount

Specify the number of traces in your trace group. The maximum is 5.

traceGroup*TraceNumbers

According to the number of traces specified in the traceCount property, enter a comma-separated list of the traces to include in this group (i.e. 1,3,5,6).

Note: If traceGroup*BandedFlag is selected, then the number of traces listed should be 3.

If the yAxisMultiRangeMode selected is Strip Chart or Multi-Axis:

§        All the traces in the group will share the same strip/axis, and

§        If yAxisShowTraceLabelsFlag is selected only the trace*Label of the first trace in the group will be displayed.

If the yAxisMultiRangeMode selected is Multi-Axis, the color of the axis for a trace group is determined by the specified trace*LineColor of the first visible trace in the group.

Note: In Multi-Axis mode it is recommended that you assign the same trace*LineColor/trace*LineStyle and trace*MarkColor/trace*MarkStyle to all traces included within a group.

Once a trace is included in a group, the following properties are no longer available: trace*YAxisAutoScaleMode, trace*YAxisValueMax, trace*YAxisValueMin. To scale the y-axis range of your trace group, use the yAxisAutoScaleMode, yValueMax, and yValueMin properties.

Note: All traces included in a group must have the trace*YAxisVisFlag, traceVisFlag and trace*YAxisGridVisFlag properties selected, otherwise the y-axis and/or the y-axis grid will not be visible.

traceGroup*BandedFlag

If selected, the plot area beneath the first trace (the low band trace) and the area above the third trace (the high band trace) will be filled. The second trace (the value trace) will not be filled.

Trace Properties 

Specify how traces are displayed in your graph.

Property Name

Description

multiTraceTableFlag

Select to plot multiple traces from a single data table.

multiTraceCurrentValueTable - Attach your current data. The first column in the attachment must contain a time value. The remaining columns can either contain numeric or string data. The first numeric value is used as the data point, the first string value is used as the first data point's data label. Within the attachment, columns can be arranged in any order (e.g.: numeric1, numeric2, string1, string2, numeric3, string3, string4, numeric4).

Unless a trace*Label is already specified, the attached trace* column names will be used as trace labels.

Note: If multiTraceHistoryValueTable is also attached to data, it must contain the same number and type of columns as the specified multiTraceCurrentValueTable.

multiTraceHistoryValueTable - Attach your historical data. The first column in the attachment must contain a time value. The remaining columns can either contain numeric or string data. The first numeric value is used as the data point, the first string value is used as the first data point's data label. Within the attachment, columns can be arranged in any order (e.g.: numeric1, numeric2, string1, string2, numeric3, string3, string4, numeric4).

Unless a trace*Label is already specified, the attached trace* column names will be used as trace labels.

Typically, the attached data table contains initial data points to be plotted (i.e. from a SQL attachment with Update Mode set to On Demand, or from a Cache attachment with Update Once selected.)

Note: If multiTraceCurrentValueTable is also attached to data, it must contain the same number and type of columns as the specified multiTraceHistoryValueTable.

Note: Once multiTraceTableFlag is selected, all trace data is expected to be provided via multiTraceCurrentValueTable or multiTraceHistoryValueTable. Therefore, the trace*Value and trace*ValueTable properties will no longer be available.

traceCount

Specify the number of traces in your graph. The maximum is 8. RTView automatically creates a set of properties (see “Trace* Properties”) for each trace.

Trace* Properties

The Display Builder automatically creates a set of trace* properties (where * is the trace number) according to the number of traces specified in the traceCount property. Attach your data to trace*Value or trace*ValueTable, see the Using Trace* Properties section for details.

Property Name

Description

trace*Label

Set a label for your trace.

trace*LineColor

Select the ellipse_button00057.gif button and choose from the palette to set the trace color. The default color is yellow. Color properties are treated differently on Fx trend graph than on other objects, see the “Fx Graph Colors” section below for more information.

trace*LineShadowFlag

Select to show a shadow for this trace.

trace*LineStyle

Select the style of the trace from the drop down menu: No Line, Solid, Dotted, Dashed, or Dot Dashed.

trace*LineThickness

Select the thickness of the trace from the drop down menu: Thin, Medium, or Thick.

trace*MarkColor

Select the ellipse_button00058.gif button and choose from the palette to set the trace marker color. Color properties are treated differently on Fx trend graph than on other objects, see the “Fx Graph Colors” section below for more information.

trace*MarkStyle

Select the style of the marker used on the trace from the drop down menu: No Marker, Dot, +, *, o, x, Filled Circle, Filled Diamond, Filled Triangle, Filled Square, or Filled Star.

trace*Type

Select the type of trace from the drop down menu: Line, Bar, or Event.

Line - Line connecting each data point.

Bar - Vertical bar for each data point, from zero to the data point's value. Use the trace*LineThickness property to control the width of the bar.

Note: If trace*MarkStyle is set to any value other than No Marker, the mark will be drawn at the end of the Bar trace.

Event - Small rectangle containing the first character of the corresponding data label for each data point. If no data label exists, then the first character of the specified trace*Label is used. Each Event trace is positioned vertically according to the data value for the corresponding data point.

The trace*LineColor property sets the color of rectangle's edges and the enclosed text character. The trace*MarkColor property sets the fill color of the rectangle. If trace*LineColor and trace*MarkColor are set to the same color, then traceBgColor is used to set the fill color of the rectangle.

Note: If the attached data contains data labels but no data values, then an Event trace will be plotted regardless of the specified trace*Type setting and Event trace rectangles will be drawn near the bottom of the trace area.

trace*Value

Attach your current data, either containing a single point of data or two columns of data.

If your attachment contains a single point of data, RTView will assign a time stamp when the graph receives the data.

If your attachment contains two columns of data, the first column must be the time value and the second column the value to plot.

Optionally, include a third (string) column in your attachment to display a data label for each corresponding data value. The data label will be displayed (enclosed in parentheses) in the fixed legend and in the popup legend, between the trace value and the trace label. If the cursorFlag property is selected, then the data label in the popup legend is for the data value that is directly under or to the left of the cursor.

trace*ValueDivisor

Enter a number. All traces will be divided by this value.

trace*ValueTable

Attach your historical data containing two columns: the first column must be the time value and the second column the value to plot.

Optionally, include a third (string) column in your attachment to display a data label for each corresponding data value. The data label will be displayed (enclosed in parentheses) in the fixed legend and in the popup legend, between the trace value and the trace label. If the cursorFlag property is selected, then the data label in the popup legend is for the data value that is directly under or to the left of the cursor.

trace*VisFlag

Select to control trace visibility. Click and hold on a trace's entry in the legend to temporarily hide all other traces in the graph.

Web Chart Properties

Property Name

Description

webChartFlag

Select to enable the html5 trend chart. When the display is opened in the Display Server, in an HTML5 compatible browser, the html5 trend chart will appear in place of the Fx trend graph.

webChartNavigatorTrace

Specify the number of traces (between 1 and the value of the traceCount property). By default, this property is disabled with a value of 0.

The navigator will be displayed at the bottom of the html5 chart, just below the x-axis, and highlight the time range currently visible in the chart. The highlighted section can be resized or dragged to zoom/pan to the time range of interest.

The color of the navigator trace will reflect the color of the corresponding trace as specified by the trace*LineColor property.

X-Axis Properties

Specify the way the x-axis is displayed in your graph.

Property Name

Description

timeFormat

Set the format for the time displayed in the x-axis using the following format characters:

y (year),

M (month),

d (day of month),

E (weekday),

a (am/pm marker),

H (hour 0-23 in day),

K (hour 0-11 in am/pm),

m (minute),

s (second).

Note: These format characters are not supported by Fx trend graph: G, w, W, D, S, z, Z.

For example, MMMM dd, yyyy KK:mm:ss a would result in the form August 30, 2003 05:32:12 PM. If no format is given, the date and time will not be displayed on the x-axis. Include a new line character ('\n') to display multiple line text in the time axis labels.

For example, MM\dd'\n'hh:mm:ss would result in the form 08\30 05:32:12.

timeRange

Control the total amount of time, in seconds, plotted on the graph. If you attach data to trace*ValueTable, set timeRange to -1 so the time range of the graph is driven by the time range in the data attachment.

Note: timeRange is ignored if both timeRangeBegin and timeRangeEnd are set.

timeRangeBegin

Set the start time value of the data to be plotted on the graph.

Supported formats are: mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03), yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03), and the number of milliseconds since midnight, January 1, 1970 UTC.

Note: If only the time is specified, then today's date will be used.

timeRangeEnd

Set the end time value of the data to be plotted on the graph.

Supported formats are: mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03), yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03), and the number of milliseconds since midnight, January 1, 1970 UTC.

Note: If only the time is specified, then today's date will be used.

timeShift

Control the amount of time, in seconds, the graph will shift to the left when the trace has filled the graph and controls the rounding of the start and end times. For example, if the timeShift is 15, the start and end times on the graph will be rounded to the nearest 15 second interval. By default, the end of the plot area corresponds with the current time. To only shift the graph when new data is received, set timeShift to a negative value and the end of the graph will display the most current data plotted. If you attach data to trace*ValueTable, you must set timeShift to a negative value.

Note: The timeShift property is ignored if either timeRangeBegin or timeRangeEnd is set.

xAxisColor

Select the ellipse_button00059.gif button and choose from the palette to set the x-axis color.

Note: Color properties are treated differently on Fx trend graph than on other objects, see the “Fx Graph Colors” section below for more information.

xAxisFlag

Select to display the x-axis.

xAxisGridVisFlag

Select to display a grid line for each major division along the x-axis.

xAxisLabelTextSize

Specify the size in pixels of the x-axis label.

xAxisMajorDivisions

Specify the number of major divisions on the x-axis.

xAxisThickness

Specify (in pixels) the thickness of the x-axis. Default is 8.

Y-Axis Properties 

Specify the way the y axis is displayed in your graph.

Property Name

Description

yAxisAutoScaleMode

The yValueMin and yValueMax properties control the range of the y-axis for if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

Note: yAxisAutoScaleMode is ignored if the yAxisLogFlag is selected.

yAxisAutoScaleVisDataOnlyFlag

Select to compute the y-axis scale according to the min & max y values of the visible data points only. This means that the y-axis scale may change as the user changes the visible time range by scrolling or zooming. By default, this property is not selected and the y axis is scaled according to the y values of all of data points, visible or not.

Note: This property is only available if webChartFlag is selected.

yAxisAutoScaleVisTracesOnlyFlag

Select to include only visible traces when calculating the y-axis range. By default all traces in the traceCount are used in the auto-scale calculation, including those that are invisible or unattached to data.

yAxisColor

Select the ellipse_button00060.gif button and choose from the palette to set the y-axis color.

Note: Color properties are treated differently on Fx trend graph than on other objects, see the “Fx Graph Colors” section below for more information.

Note: The yAxisColor property will be ignored when the yAxisMultiRangeFlag property is selected.

yAxisFlag

Select to display the y-axis.

yAxisGridVisFlag

Select to display a grid line for each major division along the y-axis.

yAxisLabel

Set a label for the y-axis.

yAxisLabelTextSize

Specify the size in pixels of the y-axis labels.

yAxisLogFlag

Select to enable the logarithmic (base 10) y-axis.

Note: Negative data points will not be plotted.

yAxisMajorDivisions

Specify the number of major divisions on the y-axis.

yAxisMinorDivisions

Specify the number of minor divisions on the y-axis.

yAxisMultiRangeMode

Select one of the following modes:

Off - All traces are plotted against a single y-axis.

Classic or Multiple Axis - One axis per trace, with each trace having its own range. Use the trace*YAxisAutoScaleMode, trace*YAxisValueMin, and trace*YAxisValueMax properties to control the range of the y-axis.    

Strip Chart - The trace area is divided into strips, one for each trace. Each trace has its own y-axis but all traces share the same x-axis. Use the trace*YAxisAutoScaleMode, trace*YAxisValueMin, and trace*YAxisValueMax properties to control the range of the y-axis.

Note: Some labels on the vertical axes may be dropped if the strips are not tall enough to display the labels without overlapping. To avoid this, decrease the value of the yAxisMajorDivisions property.

Stacked - The y-axis values for multiple traces displayed are "stacked". That is, the value of each successive data point is accumulated and the sum from lower numbered traces are plotted in the highest numbered trace.

Note: Actual (unstacked) values for each individual trace are shown in the legend.

Values for lower numbered traces are not included in the sum if a trace is invisible, has no data, all of its data points are older or newer than the x-axis value, or the y-axis value at the x-axis value is not a number (NaN).

If a lower numbered trace has no y-axis value at a particular x-axis data point, but has x-axis values before and after that data point, the y-axis value for the sum in that trace will be interpolated.

In Classic, Multiple Axis, and Strip Chart modes, a separate vertical axis is drawn for each trace using the color assigned in the trace*LineColor property. If the  yAxisShowTraceLabelsFlag property is selected, each axis will display the label assigned in the trace*Label property.

When a yAxisMultiRangeMode is selected, the yAxisThickness property is ignored and the width of each axis is set to 2 pixels.

For better performance when scrolling in a graph with many points, deselect yAxisShowTraceLabelsFlag and trace*LineShadowFlag.

yAxisPosition

Select one of the following to set the position of the y-axis on the graph.

Note: If yAxisMultiRangeMode is deselected, then the yAxisPosition setting will be ignored

Outer Left - Draw axis to the left of the trace area with tick marks extending out from the axis.

Outer Right - Draw axis to the right of the trace area with tick marks extending out from the axis.

Outer Mixed - Draw axis to the left of the trace area for odd numbered traces and to the right for even numbered traces with tick marks extending out from the axis.

Inner Left - Draw axis to the left of trace area with tick marks inside the axis line.

Inner Right - Draw axis to the right of trace area with tick marks inside the axis line.

Inner Mixed - Draw axis to the left of the trace for odd numbered traces and to the right for even numbered traces with tick marks inside the axis line.

yAxisShowTraceLabelsFlag

If selected, multiple axes will display the specified trace*Label of the trace associated with each axis.

yAxisThickness

Specify (in pixels) the thickness of the y-axis. Default is 8.

Note: The yAxisThickness property will be ignored when the yAxisMultiRangeMode property is selected.

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:

Standard Colors - Traditional palette of 252 indexed colors

Custom Colors - To define custom colors, select Tools>Options and click on the Custom Colors tab.

Swatches - Standard Java color palette

HSB - Color selection by hue, saturation, and brightness

RGB - Color selection by red, green, and blue intensity

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:

Zoom

§        Zoom-in by dragging in trace area, zoom-out by Shift+Click.

Note: Zooming out is not enabled in the main window of the Display Builder.

Scrolling

§        Live scrolling through time range

Cursor

§        Slide horizontally to see interpolated data values in legend

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

§        Click on trace entry in the legend to toggle the visibility of that trace in the display.

Fx Bar Graph

Bar graphs are useful for comparing columns or rows of numeric data from a tabular data element returned by your data attachment. The Fx bar graph (class name: obj_fxbar) has many features that standard bar graphs do not, such as:

§        Data tips that display detailed information about associated column data

§        Graph background with alternating row colors and a configurable grid color

§        Multi-position legend that can be resized interactively

bgraphs_fx_bar00061.gif

 

Using Data Properties 

To attach data to your graph, right-click in the Property Value field of the valueTable property. It is possible to graph multiple columns or rows of numeric data. If you include a label column in your data attachment for valueTable, it can be used to label either the x-axis or the legend, depending on whether the rowSeriesFlag is selected or deselected.   

The rowSeriesFlag controls how row and column data populate the graph:

If the rowSeriesFlag check box is selected, one group of bars will be shown for each numeric column in your data attachment. Within the group for each numeric column, there will be a bar for each row in that column. Column names will be used for the x-axis labels.

If the rowSeriesFlag check box is not selected, one group of bars will be shown for each row in your data attachment. Within the group for each row, there will be a bar for each column in that row. Column names will appear in the legend.

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 “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. 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 bar or trace marker in the graph 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 bar in the graph. See “Drill Down Displays” and “Drill Down Substitutions” for more information.

Tool Tips

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

Alert Properties 

To set bar colors based on a threshold value, select the corresponding value alarm or value warning flags.

Property Name

Description

valueHighAlarmEnabledFlag

Select to enable the high alarm threshold and the following related properties:

 

valueHighAlarm

Set the value of the high alarm threshold.

 

valueHighAlarmColor

When a bar's value is greater than or equal to the valueHighAlarm property, the color of the bar will change to the valueHighAlarmColor.

 

valueHighAlarmLineVisFlag

Select to display a dotted line at the high alarm threshold. The color of the line is set to the valueHighAlarmMarkColor.

 

valueHighAlarmMarkColor

Set the color of the dotted line displayed at the high alarm threshold.

valueHighWarningEnabledFlag

Select to enable the high warning threshold and the following related properties:

 

valueHighWarning

Set the value of the high warning threshold.

 

valueHighWarningColor

When a bar's value is greater than or equal to the valueHighWarning, but less than the valueHighAlarm, the color of the bar will change to the valueHighWarningColor.

 

valueHighWarningLineVisFlag

Select to display a dotted line at the high warning threshold. The color of the line is set to the valueHighWarningMarkColor.

 

valueHighWarningMarkColor

Set the color of the dotted line displayed at the high warning threshold.

valueLowAlarmEnabledFlag

Select to enable the low alarm threshold and the following related properties:

 

valueLowAlarm

Set the value of the low alarm threshold.

 

valueLowAlarmColor

When a bar's value is less than or equal to the valueLowAlarm property, the color of the bar will change to the valueLowAlarmColor.

 

valueLowAlarmLineVisFlag

Select to display a dotted line at the low alarm threshold. The color of the line is set to the valueLowAlarmMarkColor.

 

valueLowAlarmMarkColor

Set the color of the dotted line displayed at the low alarm threshold.

valueLowWarningEnabledFlag

Select to enable the low warning threshold and the following related properties:

 

valueLowWarning

Set the value of the low warning threshold.

 

valueLowWarningColor

When a bar's value is less than the valueLowWarning property, but greater than the valueLowAlarm property, the bar will change to the valueLowWarningColor.

 

valueLowWarningLineVisFlag

Select to display a dotted line at the low warning threshold. The color of the line is set to the valueLowWarningMarkColor.

 

valueLowWarningMarkColor

Set the color of the dotted line displayed at the low warning threshold.

Background Properties 

Specify how the background is displayed in your bar graph.

Property Name

Description

bg3dFlag

Select to display a 3D edge on the background rectangle.

bgColor

Select the ellipse_button00062.gif button and choose from the palette to set the background color.

Note: Color properties are treated differently on Fx graphs than on other objects, see the “Fx Graph Colors” section for more information.

bgGradientFlag

Select to display a gradient in the background rectangle.

Bar Properties 

Specify the way the bars are displayed in your graph.

Property Name

Description

barFitFlag

Select to stretch the bars to fit the available space in the plot area. If deselected, the minSpacePerBar property is used to determine bar width.

barImage

Type the name of the image to display in the bars or, select the ellipse_button00063.gif button to open the Select Image dialog containing up to three directories:

§        Current Directory - Contains images in the current directory and one level of subdirectories.

§        Custom Image Library - If you have specified a custom image library, this directory contains those images (.gif, .jpg or .png). See Creating a Custom Image Library (below) for details.

§        Symbol Library - Contains symbolic images (for example, symbols for various types of hardware, shapes, lights, arrows, etc.).

Navigate to the image you want to use and select it. A preview of the image appears in the pane to the right. Click OK or Apply to set the image on your object. If an image is not listed, enter the name of the file, including the relative path.

Note: If necessary, the image will be stretched to fit the bar size.

 

Creating a Custom Image Library 

The custom image library enables you to make your own images available in the Select Image dialog. To add your own image library, perform the following steps.

1.     Place your images .jar file and add it to the “RTV_USERPATH” environment variable. The images must be in a directory (not in the top level of the jar). They can be organized into subdirectories of one top level directory.

2.     In the Display Builder, select Tools/Builder Options and, in the Custom Image Library Path field, set the path to the directory containing your images .jar file.

For example, if you have a jar with this directory structure:

com/mycompany/Images

com/mycompany/Images/Blue Images

com/mycompany/Images/Red Images

com/mycompany/Images/Green Images

you would enter com/mycompany/Images. This adds a directory named Images to the tree in the Select Image dialog. The Images directory will have three subdirectories: Blue Images, Red Images, and Green Images. Only directories containing images are added to the Select Image dialog.

To access the images, you can edit any property that allows you to set an image on an object (for example, the image, barImage and filterProperties properties), or edit the File>Background Properties>Image Name field. See “Background Properties” for more information.

barOutlineFlag

If selected, an outline appears around each bar.

barProperties

Double-click on barProperties to specify the color and fill pattern to be used to display each bar in the graph. See “Bar Properties Window” for more information.

barShape

Select a bar shape from the drop down menu.

Note: If 3D Rectangle is selected, then use the Layout property draw3dDepth to set the width of the rectangle.

barTransparencyPercent

Set transparency of the bars. Enter a value between 0 and 100. A value of 0, the default, sets the bars to be completely opaque. A value of 100 will render the bars completely transparent.

barValueTextColor

Select the ellipse_button00064.gif button and choose from the palette to set text color inside the bars if barValueVisFlag is selected. 

Note: Color properties are treated differently on Fx graphs than on other objects, see the “Fx Graph Colors”section for more information.

barValueTextFont

Select font style of the text inside the bars if barValueVisFlag is selected.

barValueTextSize

Specify (in pixels) the size of the text inside the bars if barValueVisFlag is selected.

barValueVisFlag

Select to display a label containing the value for each bar.

Data Properties 

Property Name

Description

rowSeriesFlag

Controls how row and column data populate the graph.

§        If rowSeriesFlag is selected, one group of bars will be shown for each numeric column in your data attachment. Within the group for each numeric column, there will be a bar for each row in that column. Column names will be used for the x-axis labels.

§        If the rowSeriesFlag is not selected, one group of bars will be shown for each row in your data attachment. Within the group for each row, there will be a bar for each column in that row. Column names will appear in the legend.

traceRowSeriesMode

Allows the row-series behavior to be enabled or disabled on the traces independently of the rowSeriesFlag setting. Options include:

§        Use rowSeriesFlag (default) - row-series behavior is enabled or disabled on the bars and the traces based on the setting in the rowSeriesFlag property (see details on the rowSeriesFlag property above).

§        On - selecting this option and disabling the rowSeriesFlag enables row-series behavior on the traces but not the bars.

§        Off - selecting this option and enabling the rowSeriesFlag enables row-series behavior on the bars but not the traces.

valueDivisor

Divides bar and y-axis values by the number entered.

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 your data attachment for 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.

yValueMax

yValueMin

Controls the range of y-axis if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate the y-axis range according to data values being plotted.

Data Format Properties 

Specify the data format for your bar graph.

Property Name

Description

yValueFormat

Formats the numeric value shown on each bar, if barValueVisFlag is selected. Formats the numeric value that appears in each tool tip if mouseOverFlag is selected.

Data Label Properties 

Property Name

Description

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 specified labelColumnName are displayed either along the x-axis or in the legend, depending on whether or not rowSeriesFlag is selected.

rowNameVisFlag

If your data attachment does not contain a label column (i.e. a non-numeric text column) select the rowNameVisFlag check box 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 “Configuring the Historian” 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

Specify how you interact with the data in your graph. See the “Thin Client Deployment - Additional Interactivity” section for more information on how to interact with this graph at runtime.

Property Name

Description

command

Assign a command to your bar graph. See “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 ellipse_button00065.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownColumnSubs

Select the ellipse_button00066.gif 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 bar in the graph.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

mouseOverFlag

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

scrollbarMode

Select Never, As Needed, or Always to set the behavior of the x-axis scroll bar in the graph.

Note: If drawHorizontalFlag is selected, the x-axis is vertical. Never is the default setting. If set to Never, some bars may get clipped. Select Always to display a scroll bar at all times. Set to As Needed to display the scroll bar when there is not enough space to display all of the bars in the plot area. Each bar uses at least minSpacePerBar pixels along the x-axis.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00067.gif button to open the Edit Label dialog.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextColor

Select the ellipse_button00068.gif button and choose 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 the label text.

labelTextSize

Specify (in pixels) the size of the label text.

Layout Properties 

Specify how the background is displayed in your bar graph.

Property Name

Description

draw3dDepth

Specify width (in pixels) for the shadow of the bars or, if the barShape selected is 3D Rectangle, the width of the rectangle.

draw3dFlag

Select to change the display of the bars from 2D to 3D.

Note: This property does not apply if the barShape selected is 3D Rectangle.

drawHorizontalFlag

Select to have the bars in your graph displayed horizontally.

drawStackedFlag

Select to stack each bar group in your graph.

horizAxisLabelRotationAngle

Set the amount of rotation of labels on the horizontal axis. Values range from 0 to 90 degrees. A value of 0 causes the bar graph to automatically pick the optimum angle of rotation.

minSpaceBetweenBars

Set the minimum amount of space (in pixels) between adjacent bars in the same group.

minSpaceBetweenGroups

Set the minimum amount of space (in pixels) between the last bar in one group and the first bar in the next group.

minSpacePerBar

Set the minimum width (in pixels) for each bar. Default is 1.

Note: If drawHorizontalFlag is selected, minSpacePerBar will set the minimum height (in pixels) for each bar.

Legend Properties 

Specify the way the legend is displayed in your bar graph.

Property Name

Description

legendBgColor

Select the ellipse_button00069.gif button and choose from the palette to set the background 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.

legendBgGradientFlag

Select the legendBgGradientFlag to display a gradient in the legend background. If legendBgColor is set to Default then gradient will not display.

legendPosition

Specify the position of the legend.

legendTextColor

Select the ellipse_button00070.gif button and choose from the palette to set the color of the legend text. 

Note: Color properties are treated differently on Fx graphs than on other objects, see the “Fx Graph Colors” section for more information.

legendTextFont

Specify the font style of the legend text.

legendTextSize

Specify (in pixels) the size of the legend text.

legendVisFlag

Select to display the legend.

legendWidthPercent

Set default percentage of object designated 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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet (see “Creating Style Sheets” for more information). If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

visFlag

Control visibility of the object.

Plot Area Properties 

Property Name

Description

gridAltBgColor

Select the ellipse_button00071.gif button and choose from the palette to set one of the alternating row colors in the grid background. The color you specify for gridBgColor will be the other alternating row color. Default is transparent.

Note: Color properties are treated differently on Fx graphs than on other objects, see the “Fx Graph Colors” section for more information.

gridBgColor

Select the ellipse_button00072.gif button and choose from the palette to set the color of the grid background. Default is transparent.

Note: Color properties are treated differently on Fx graphs than on other objects, see the “Fx Graph Colors” section for more information.

gridBgImage

Select an image to display in the grid background of your graph.

Note: If necessary, the image will be stretched to fit the grid.

gridColor

Select the ellipse_button00073.gif button and choose from the palette to set the color of the grid lines. Default is white. 

Note: Color properties are treated differently on Fx graphs than on other objects, see the “Fx Graph Colors” section for more information.

Transition Properties 

Property Name

Description

barEntranceDuration

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 barEntranceType selected and the number of bars and series displayed.

barEntranceTrigger

Choose whether to display the bar entrance transition on each data update or only once when graph is initially displayed. Default is Once.

barEntranceType

Select the type of bar 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.

barExitDuration

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 barExitType selected and the number of bars and series displayed.

barExitTrigger

Choose whether to display the bar exit transition on each data update or only once when graph is initially displayed. Default is Once.

barExitType

Select the type of bar 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.

X-Axis Properties 

Specify how the x-axis is displayed in your bar graph.

Property Name

Description

xAxisColor

Select the ellipse_button00074.gif button and choose from the palette to set the color of the x-axis. 

Note: Color properties are treated differently on Fx bar graph than on other objects. See the “Fx Graph Colors” section below for more information.

xAxisFlag

Select to display the x-axis.

xAxisThickness

Specify (in pixels) the thickness of the x-axis. Default is 8.

Y-Axis Properties 

Specify how the y-axis is displayed in your bar graph.

Property Name

Description

yAxisAutoScaleMode

The yValueMin and yValueMax properties control the range of y-axis if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate the y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

yAxisColor

Select the ellipse_button00075.gif button and choose from the palette to set the color of the y-axis. 

Note: Color properties are treated differently on Fx bar graph than on other objects, see the “Fx Graph Colors” section below for more information.

yAxisFlag

Select to display the y-axis.

yAxisFormat

Select or enter the numeric format of values displayed on the y-axis. To enter a format, use syntax from the Java DecimalFormat class.

yAxisMajorDivisions

Specify the number of major divisions on the y-axis.

yAxisMinorDivisions

Specify the number of minor divisions on the y-axis.

yAxisThickness

Specify (in pixels) the thickness of the y-axis. Default is 8.

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:

Standard Colors - Traditional palette of 252 indexed colors

Custom Colors - To define custom colors, select Tools>Options and click on the Custom Colors tab.

Swatches - Standard Java color palette

HSB - Color selection by hue, saturation, and brightness

RGB - Color selection by red, green, and blue intensity

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:

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

Bar Properties Window

In the Object Properties window, double-click on barProperties in the Property Name field to display the Bar Properties dialog. In the Bar Properties dialog you can assign a Color and Fill Pattern to each bar in the graph.

Note: Before assigning attributes to bars in your bar graph, it is recommended that you first attach the graph to data.

bargraph_barprops.gif

 

Field Name

Description

Bar

There is one entry for each bar that is currently displaying data in the bar graph. The Color and Fill Pattern columns list the current settings for each bar.

Color

Select the ellipse_button00076.gif button in the Color column and choose from the palette to set the color of the bar. Close the Color Chooser window.

Fill Pattern

Select the ellipse_button00077.gif button in the Fill Pattern column and choose from the palette to set the fill pattern of the bar. Close the Fill Pattern window. 

Note: Fill patterns in your bar graph are ignored unless the barGradientStyle property is set to None.

Add Bar Property

Click to add a Bar Property entry. This does not add a bar to your graph, it allows you to set properties for bars that will display data that is not yet available. This is useful if the data attachment is not available when you setup your bar graph, or if the number of rows or columns returned by your data attachment varies.

Delete Bar Property

Removes the last bar property entry from the Bar Properties dialog.

The following describes the Bar Properties dialog commands:

Command

Description

OK

Applies values and closes the dialog.

Apply

Applies values without closing the dialog.

Reset

Resets all fields to last values applied.

Clear

Clears all fields. Detaches object from data source (once Apply or OK is selected).

Cancel

Closes the dialog with last values applied.

Fx Pie Graph

The pie graph (class name: obj_fxpie) is useful for comparing values from a single column or a single row of the tabular data element returned by your data attachment.

bgraphs_fx_pie00078.gif

 

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 check box 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 check box 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 “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. See “Substitutions” and “Drill Down Substitutions” for more information.

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 ellipse_button00079.gif button and choose a color from the palette to set the background color. The Default color is grey. 

Note: 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 (see “Column Display Names” for more information). 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 check box 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 (“Cache Definition File Configuration”) 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 “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 ellipse_button00080.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used. 

drillDownColumnSubs

Select the ellipse_button00081.gif 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 “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 ellipse_button00082.gif button to open the Edit Label dialog.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextColor

Select the ellipse_button00083.gif 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 ellipse_button00084.gif button and choose a color from the palette to set the background color of the legend. The Default color is grey. 

Note: 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 ellipse_button00085.gif 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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used. See “Creating Style Sheets” for more information.

Note: The value entered must not contain spaces and cannot start with rtv-.

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.

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 ellipse_button00086.gif 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.

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:

Standard Colors - Traditional palette of 252 indexed colors

Custom Colors - To define custom colors, select Tools>Options and click on the Custom Colors tab.

Swatches - Standard Java color palette

HSB - Color selection by hue, saturation, and brightness

RGB - Color selection by red, green, and blue intensity

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.

Column Display Names 

In many objects that display tabular data, it is possible to change the name that is displayed for a column in your data. In the Object Properties window, double-click on columnDisplayNames in the Property Name field to bring up the Column Display Name Properties dialog.

table_col_disp.gif

 

Field Name

Description

Column Name

This list is populated based on the table's data attachment. If you have not yet attached the table to data, this list will be empty.

Display Name

Enter the name to be displayed in the column header and press <Enter>.

Add Column

Enter the name of the column and click the Add Column button to insert a column into the table.

Clear

Click the Clear button to remove all Display Names listed.

Graph Objects

The Object Palette features several types of graph objects -- trend, bar, pie, radar, and XY graphs-- that are useful for comparing data. Trend graphs are used to display a single variable per trace over time. Bar, pie, radar, and XY graphs are designed to display information returned by a tabular element in your data attachment. Based on your data attachment, substitutions are created that will be passed into drill down displays. See “Drill Down Substitutions” for more information.

Note: Some graph objects (e.g.: the bar graph legend, pie wedges and legend) cache their colors and therefore do not update when a custom color definition changes (see “Custom Colors Tab” for more information). You will need to either to restart RTView or reload the display to see the color change for these objects.

“Trend Graphs” 

Trend graphs (class name: obj_trendgraph02) are useful for plotting a single value per trace over time and for displaying historical data stored by the “Historian”.

trend1_bgraphs.gif

 

“Bar Graphs”

Bar graphs (class name: obj_bargraph) are useful for comparing columns or rows of numeric data from a tabular data element returned by your data attachment.

bargraph1_bgraphs.gif

 

“Pie Graphs”

Pie graphs (class name: obj_pie) are useful for comparing values from a single column or a single row of the tabular data element returned by your data attachment.

pie1_bgraphs.gif

 

“Radar Graphs”

Radar graphs (class name: obj_radar) are useful for comparing columns or rows of numeric data from a tabular data element returned by your data attachment.

radar1_bgraphs.gif

 

“XY Graphs”

XY graphs (class name: obj_xygraph) are useful for comparing pairs of values from a tabular data element returned by your data attachment.

bgraphs_xy.gif

 

“Stock Chart”

Stock charts (class name: obj_stockchart) are useful for displaying live and archived stock data.

bgraphs_stock.gif

 

“Legend”

This object (class name: obj_legend) is useful for displaying a legend that is too lengthy for the built-in legends of the graph objects. The legend is easily resizable and can be used in conjunction with any object on the Graphs tab, excluding the Heatmap.

legend1_bgraphs.gif

 

“Heat Maps”

Heatmaps (class name: obj_heatmap) display indexed hierarchical data as a set of nested rectangles. A rectangle exists for each index and, when attached to data, each is filled with smaller rectangles representing sub-indexes, known as nodes.

bgraphs_heatmap.gif

 

“Sparkline”

Sparkline graphs (class name: obj_sparkline) are generally used to present trends and variations in a simple and condensed way.

bgraphs_sparkline.gif

 

“Status History”

Status History charts (class name: obj_statushistory) show discrete status values as horizontal bars drawn against a horizontal time axis. A label appears at the right edge of each bar along with a circular indicator displaying that bar's most recent status.

bgraphs_statushistory.gif

 

“Map Object”

The map object (class name: obj_gmap) is useful for showing a Google map with dynamically populated objects, navigation and drilldowns for the Thin Client.

bgraphs_googlemap_small.png

 

Trend Graphs

Trend graphs (class name: obj_trendgraph02) are generally used for tracing two types of data in one trend graph: real-time, or live data, and archived data. Displaying these two types of traces in conjunction is useful for comparing data trends. The trend graph supports up to ten traces, set the traceCount to control the number of traces.

trend1_bgraphs00087.gif

 

Using Trace* Properties - Trend Graphs

The Display Builder automatically creates a set of trace* properties according to the number you specify using the traceCount object property. Attach your data to trace*Value or trace*ValueTable, where * is the trace number. For example if you set the traceCount to three (3), you will have three traces in your graph (Trace01, Trace02 and Trace03) and a corresponding trace*Value (trace1Value, trace2Value and trace3Value) for each.   

All traces in the trend graph have the option to display historical and/or current data:

Historical Data

Current Data

Historical and Current Data

To display historical data, attach to trace*ValueTable, where * is the trace number, and include two columns in your attachment. The first column must be the time value and the second column the value to plot.

Optionally, include a third (string) column in your attachment if you want to display a data label for each corresponding data value. See the Attach to Data section specific to your data source for details on how to use the Select Columns dialog.

Note: In order to attach historical data to the trace*ValueTable property, the trace*ValueHistoryFlag must be deselected.

To display current data, attach to trace*Value, where * is the trace number. When you attach data to the trace*Value property, the time displayed on the trend graph is automatically updated each time data is received. Your data attachment can contain either a single point of data or two columns of data. See the Attach to Data section specific to your data source for details on how to use the Select Columns dialog.

If your attachment contains a single point of data, RTView assigns a time stamp when the graph receives the data.

If your attachment contains two columns of data, the first column must be the time value and the second column the value to plot. Optionally, include a third (string) column in your attachment if you want to display a data label for each corresponding data value.

To display both historical and current data in a single trace, attach your current data to trace*Value and select one of the following options for your historical data:

§        Select the trace*ValueHistoryFlag so that initial data is loaded from the Historian database

§        Attach your historical data to trace*ValueTable.

Note: The trace*ValueHistoryFlag must be deselected.

Supported formats for the time value column are: mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03), yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03), and the number of milliseconds since midnight, January 1, 1970 UTC. In order to view all available data, you must set the properties timeRange to -1 and timeShift to a negative value. This negative value will be used to round the start and end times for the y-axis. For example, if you specify -15 for the timeShift property, the start and end times for the y-axis will be rounded to the nearest 15 seconds.

Data labels will be displayed (enclosed in parentheses) in the fixed legend and in the popup legend, between the trace value and the trace label. If the cursorFlag property is selected, then the data label in the popup legend is for the data value that is directly under or to the left of the cursor.

Alert Properties 

To set trace marker colors and styles based on a threshold value, select the corresponding value alarm or value warning flags.

Property Name

Description

valueHighAlarmEnabledFlag

Select to enable the high alarm threshold and the following related properties:

 

valueHighAlarm

Set the value of the high alarm threshold.

 

valueHighAlarmLineVisFlag

Select to display a dotted line at the high alarm threshold. The color of the line is set to the valueHighAlarmMarkColor.

 

valueHighAlarmMarkColor/

valueHighAlarmMarkStyle

When a trace marker's value is greater than or equal to the valueHighAlarm property, the marker will change to the valueHighAlarmMarkColor and valueHighAlarmMarkStyle.

 

valueHighAlarmTraceColor/

valueHighAlarmTraceStyle

When the value of any segment of a trace line is greater than or equal to the valueHighAlarm property, that segment of the trace line will change to the valueHighAlarmTraceColor and valueHighAlarmTraceStyle.

Note: If valueHighAlarmTraceStyle is set to No Line, then valueHighAlarmTraceColor will not change.

valueHighWarningEnabledFlag

Select to enable the high warning threshold and the following related properties:

 

valueHighWarning

Set the value of the high warning threshold.

 

valueHighWarningLineVisFlag

Select to display a dotted line at the high warning threshold. The color of the line is set to the valueHighWarningMarkColor.

 

valueHighWarningMarkColor/

valueHighWarningMarkStyle

When a trace marker's value is greater than or equal to the valueHighWarning property but less than the valueHighAlarm property, the marker will change to the valueHighWarningMarkColor and valueHighWarningMarkStyle.

 

valueHighWarningTraceColor/

valueHighWarningTraceStyle

When the value of any segment of a trace line is greater than or equal to the valueHighWarning property but less than the valueHighAlarm property, that segment of the trace line will change to the valueHighWarningTraceColor and valueHighWarningTraceStyle.

valueLowAlarmEnabledFlag

Select to enable the low alarm threshold and the following related properties:

 

valueLowAlarm

Set the value of the low alarm threshold.

 

valueLowAlarmLineVisFlag

Select to display a dotted line at the low alarm threshold. The color of the line is set to the valueLowAlarmMarkColor.

 

valueLowAlarmMarkColor/

valueLowAlarmMarkStyle

When the trace marker's value is less than or equal to the valueLowAlarm property, the marker will change to the valueLowAlarmMarkColor and valueLowAlarmMarkStyle.

 

valueLowAlarmTraceColor/

valueLowAlarmTraceStyle

When the value of any segment of a trace line is less than or equal to the valueLowAlarm property, that segment of the trace line will change to the valueLowAlarmTraceColor and valueLowAlarmTraceStyle.

valueLowWarningEnabledFlag

Select to enable the low warning threshold and the following related properties:

 

valueLowWarning

Set the value of the low warning threshold.

 

valueLowWarningLineVisFlag

Select to display a dotted line at the low warning threshold. The color of the line is set to the valueLowWarningMarkColor.

 

valueLowWarningMarkColor/

valueLowWarningMarkStyle

When the trace marker's value is less than or equal to the valueLowWarning property, but greater than the valueLowAlarm property, the marker will change to the valueLowWarningMarkColor and valueLowWarningMarkStyle.

 

valueLowWarningTraceColor/

valueLowWarningTraceStyle

When the value of any segment of a trace line is less than or equal to the valueLowWarning property, but greater than the valueLowAlarm property, that segment of the trace line will change to the valueLowWarningTraceColor and valueLowWarningTraceStyle.

Background Properties 

Specify how the background is displayed in your trend graph.

Property Name

Description

bgBorderColor

Select the ellipse_button00088.gif 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 ellipse_button00089.gif 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 ellipse_button00090.gif 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 graph and the border.

Data Properties 

Specify how data is displayed in your graph.

Property Name

Description

historyOnlyFlag

If selected, the graph will plot only data that is applied to the trace*ValueTable properties and will ignore the timeShift property and any data that is applied to the trace*Value properties.

This is useful when same graph is used to view Historical data or Historical and Current data by setting substitutions on the display.

maxPointsPerTrace

The default is set to 1000. The maximum value for this property is 30000.

yValueMax

yValueMin

The yValueMin and yValueMax properties control the range of the y-axis for this trace if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

If yAxisMultiRangeMode is set to Multiple Axis or Strip Chart, then use the trace*YAxisAutoScaleMode, trace*YAxisValueMin, and trace*YAxisValueMax properties to control the range of the y-axis.

Data Format Properties 

Specify data format in your graph.

Property Name

Description

yValueFormat

Select or enter the numeric format of values displayed in the legend and popup legend. To enter a format, use syntax from the Java DecimalFormat class.

Historian Properties 

Property Name

Description

historyTableName

Specify name of table in your history database in which to store tabular data. See “Configuring the Historian” 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 trend graph. See “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 ellipse_button00091.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

cursorColor

Select the ellipse_button00092.gif button and choose a color from the palette to set the color of the cursor.

Note: This property is only available if cursorFlag is selected.

cursorFlag

Select to enable the cursor. When the cursor is enabled, point to a location on a trace to see a cursor line at that location and display the time and values of all traces at the cursor line on the legend. Hold down the control key to snap the cursor to the closest data point.

Select the legendPopupFlag to display the legend along the cursor.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

When you double-click on a trace in the graph, the following predefined substitutions will be set on the specified drillDownTarget:

§        $traceNumber - number of the trace (1 to 10) that contains the selected point

§        $traceLabel - label of selected trace

§        $pointValue - data value of point

§        $pointTimestamp - timestamp of point

§        $pointLabel - data label (if any) of point

§        $pointIndex - position of point in trace data (0 to maxPointsPerTrace)

Note: When drillDownSelectMode is set to Anywhere double-clicking anywhere on the graph will activate the specified drillDownTarget, however you must double-click on a trace in the graph to set the substitutions listed above.

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 trace in the graph.

legendPopupFlag

Select to display the legend along the cursor.

Note: This property is only available if cursorFlag is selected.

scrollbarMode

Select Never, As Needed, or Always from the scrollbarMode property to set the behavior of the scroll bar in the graph. Never is the default setting. Select Always to display a scroll bar at all times or As Needed to display the scroll bar when necessitated by zooming in the trace area or when you have more data loaded into the graph than you are displaying in the time range.

For example, if timeRangeOfHistory is greater than timeRange, setting scrollbarMode to As Needed will enable a scroll bar to view all historical data loaded into the graph.

scrollbarSize

Specify the height of the horizontal scroll bar and the width of the vertical scroll bar, in pixels. The default value is -1, which sets the size to the system default.

zoomEnabledFlag

Select to enable zooming within the graph. Click in the graph's trace area and drag the cursor until a desired range is selected. While dragging, a rectangle is drawn to show the zoom area. The rectangle's default color is yellow (this can be changed in the cursorColor property). After the zoom is performed, the graph stores up to four zoom operations in queue. To zoom out, press the shift key and click in the graph's trace area.

Note: The graph is paused after a zoom is performed and returns to updating with live data when the graph is zoomed back out to 100%.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00093.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to TabTop.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title Top - Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00094.gif button and choose a color from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

Set the height of the label text in pixels.

Legend Properties 

Specify the way the legend is displayed in your trend graph. Click and press a trace's entry in the legend to temporarily hide all other traces in the graph.

Property Name

Description

legendBgColor

Select the ellipse_button00095.gif button and choose a color from the palette to set the background color of the legend.

legendBgGradientColor2

Select the ellipse_button00096.gif button and choose a color for the second color in the gradient. Default is white.

Note: The legendBgColor property sets the first color in the gradient.

legendBgGradientMode

Display a gradient in the legend background. 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.

legendTimeFormat

Set the format for the time displayed in the legend using syntax from the Java SimpleDateFormat class.

For example, MMMM dd, yyyy hh:mm:ss a would result in the form August 30, 2003 05:32:12 PM. If no format is given, the timeFormat will be used.

legendValueMinSpace

Specify the minimum distance between values and labels in the legend.

legendVisFlag

Select to display the legend.

legendWidthPercent

Set the percent of the total width of the object used for the legend.

outlineColor

Select the ellipse_button00097.gif button and choose a color from the palette to set the color of the one-pixel outline around the legend area, around each color swatch within the legend, and around the plot area. The default value is black (color 7).

Marker Properties 

Specify the way markers are displayed in your trend graph.

Property Name

Description

markDefaultSize

Set markDefaultSize to specify the size of the markers in pixels.

markScaleMode

Set markScaleMode to scale markers according to the order of the data in your data attachment, e.g., the marker for the first data in the attachment is the smallest and the marker for the last data is the largest. Select one of the following from the drop down menu to set the scale mode: No Scale, Scale by Trace, or Scale Within Trace.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Plot Area Properties 

Specify the way the plot area is displayed in your trend graph.

Property Name

Description

gridColor

Select the ellipse_button00098.gif button and choose a color from the palette to set the color of the grid.

traceBgColor

Select the ellipse_button00099.gif button and choose a color from the palette to set the background color of your graph.

traceBgGradientColor2

Select the ellipse_button00100.gif button and choose a color for the second color in the gradient. Default is white. 

Note: The traceBgColor property sets the first color in the gradient.

traceBgGradientMode

Display a gradient in the plot background. 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.

traceBgImage

Select an image to display in the plot background of your graph. If necessary, the image will be stretched to fit the plot area.

Trace Groups 

Specify trace groups displayed in your trend graph. The Display Builder automatically creates a set of traceGroup* properties (where * is the trace group number) according to the number of trace groups specified in the traceGroupCount property. A trace group is a collection of two or more traces. Trace groups are useful for identifying multiple traces sharing the same vertical axis (when yAxisMultiRangeMode is set to Strip Chart or Multi-Axis) or for identifying three traces combined as a banded trace.

Property Name

Description

traceGroupCount

Specify the number of traces in your trace group. The maximum is 5.

traceGroup*TraceNumbers

According to the number of traces specified in the traceCount property, enter a comma-separated list of the traces to include in this group (i.e. 1,3,5,6).

Note: If traceGroup*BandedFlag is selected, then the number of traces listed should be 3.

If the yAxisMultiRangeMode selected is Strip Chart or Multi-Axis, all the traces in the group will share the same strip/axis. If the yAxisMultiRangeMode selected is Multi-Axis, the color of the axis for a trace group is determined by the specified trace*LineColor of the first visible trace in the group.

Note: In Multi-Axis mode it is recommended that you assign the same trace*LineColor/trace*LineStyle and trace*MarkColor/trace*MarkStyle to all traces included within a group.

Once a trace is included in a group, the following properties are no longer available: trace*YAxisAutoScaleMode, trace*YAxisValueMax, trace*YAxisValueMin. To scale the y-axis range of your trace group, use the yAxisAutoScaleMode, yValueMax, and yValueMin properties.

Note: All traces included in a group must have the trace*YAxisVisFlag, traceVisFlag, and trace*YAxisGridVisFlag properties selected, otherwise the y-axis and/or the y-axis grid will not be visible.

traceGroup*BandedFlag

If selected, the plot area beneath the first trace (the low band trace) and the area above the third trace (the high band trace) will be filled. The second trace (the value trace) will not be filled.

Trace Properties

Specify how traces are displayed in your trend graph.

Property Name

Description

multiTraceTableFlag

Select to plot multiple traces from a single data table.

 

multiTraceCurrentValueTable

Attach your current data. The first column in the attachment must contain a time value. The remaining columns can either contain numeric or string data. The first numeric value is used as the data point, the first string value is used as the first data point's data label. Within the attachment, columns can be arranged in any order (e.g.: numeric1, numeric2, string1, string2, numeric3, string3, string4, numeric4).

Unless a trace*Label is already specified, the attached trace* column names will be used as trace labels.

Note: If multiTraceHistoryValueTable is also attached to data, it must contain the same number and type of columns as the specified multiTraceCurrentValueTable.

 

multiTraceHistoryValueTable

Attach your historical data. The first column in the attachment must contain a time value. The remaining columns can either contain numeric or string data. The first numeric value is used as the data point, the first string value is used as the first data point's data label. Within the attachment, columns can be arranged in any order (e.g.: numeric1, numeric2, string1, string2, numeric3, string3, string4, numeric4).

Unless a trace*Label is already specified, the attached trace* column names will be used as trace labels.

Typically, the attached data table contains initial data points to be plotted (i.e. from a SQL attachment with Update Mode set to On Demand, or from a Cache attachment with Update Once selected.)

Note: If multiTraceCurrentValueTable is also attached to data, it must contain the same number and type of columns as the specified multiTraceHistoryValueTable.

 

Note: Once multiTraceTableFlag is selected, all trace data is expected to be provided via multiTraceCurrentValueTable or multiTraceHistoryValueTable. Therefore, the trace*Value and trace*ValueTable properties will no longer be available.

traceCount

Specify the number of traces in your graph. The maximum is 10. RTView automatically creates a set of properties (see Trace* Properties below) for each trace.

traceFillStyle

Set traceFillStyle to Solid, Transparent, Gradient, or Transparent Gradient to fill the area under the trace. Set to None to disable this feature. None is the default.

Trace* Properties 

The Display Builder automatically creates a set of trace* properties (where * is the trace number) according to the number of traces specified in the traceCount property. Attach your data to trace*Value or trace*ValueTable, see the “Using Trace* Properties - Trend Graphs” section for details.

Property Name

Description

trace*Label

Set a label for your trace.

trace*LineColor

Select the ellipse_button00101.gif button and choose a color from the palette to set the trace color.

trace*LineStyle

Select the style of the trace from the drop down menu: No Line, Solid, Dotted, Dashed, or Dot Dashed.

trace*LineThickness

Select the thickness of the trace from the drop down menu: Thin, Medium, or Thick.

trace*MarkColor

Select the ellipse_button00102.gif button and choose a color from the palette to set the trace marker color.

trace*MarkStyle

Select the style of the marker used on the trace from the drop down menu: No Marker, Dot, +, *, o, x, Filled Circle, Filled Diamond, Filled Triangle, Filled Square, or Filled Star.

trace*Type

Select the type of trace from the drop down menu: Line, Bar, or Event.

Line - Line connecting each data point.

Bar - Vertical bar for each data point, from zero to the data point's value. Use the trace*LineThickness property to control the width of the bar.

Note: If trace*MarkStyle is set to any value other than No Marker, the mark will be drawn at the end of the Bar trace.

Event - Small rectangle containing the first character of the corresponding data label for each data point. If no data label exists, then the first character of the specified trace*Label is used. Each Event trace is positioned vertically according to the data value for the corresponding data point.

The trace*LineColor property sets the color of rectangle's edges and the enclosed text character. The trace*MarkColor property sets the fill color of the rectangle. If trace*LineColor and trace*MarkColor are set to the same color, then traceBgColor is used to set the fill color of the rectangle.

Note: If the attached data contains data labels but no data values, then an Event trace will be plotted regardless of the specified trace*Type setting and Event trace rectangles will be drawn near the bottom of the trace area.

trace*Value

Attach your current data, either containing a single point of data or two columns of data.

If your attachment contains a single point of data, RTView will assign a time stamp when the graph receives the data.

If your attachment contains two columns of data, the first column must be the time value and the second column the value to plot.

Optionally, include a third (string) column in your attachment to display a data label for each corresponding data value. The data label will be displayed (enclosed in parentheses) in the fixed legend and in the popup legend, between the trace value and the trace label. If the cursorFlag property is selected, then the data label in the popup legend is for the data value that is directly under or to the left of the cursor.

trace*ValueAlarmStatus

Use if your trace is being driven by trace*Value. To apply an alarm status to a trace, enter an alarm status index which will be applied to any new points plotted.

Valid indexes are: 0 = use normal marker color and style, 1 = use low alarm marker color and style, 2 = use low warning marker color and style, 3 = use high warning marker color and style, 4 = use high alarm marker color and style, -1 = determine marker color and style by comparing the value to the enabled alarm thresholds.

trace*ValueAlarmStatusTable

Use if your trace is being driven by trace*ValueTable. Attach an alarm table containing status indexes to trace*ValueAlarmStatusTable to enable rule based alarm statuses for trace markers. This table must have a time column (formatted like the time value in the trace*ValueTable) and a value column where the value column contains alarm status values 0-4. The table must also have the same number of rows as the corresponding trace*ValueTable. For each data element in trace*ValueTable, the status index at the corresponding position in trace*valueAlarmStatusTable will be used to set the alarm status of the marker.

Valid indexes are: 0 = use normal marker color and style, 1 = use low alarm marker color and style, 2 = use low warning marker color and style, 3 = use high warning marker color and style, 4 = use high alarm marker color and style, -1 = determine marker color and style by comparing the value to the enabled alarm thresholds. If no data is attached to trace*ValueAlarmStatusTable, then the alarm status for a trace marker is determined by comparing the marker's value to the enabled thresholds.

trace*ValueDivisor

Enter a number. All traces will be divided by this value.

trace*ValueHistoryFlag

If selected, RTView will attempt to load initial data from the Historian database for the corresponding trace.

Note: Only data within the specified timeRange will be loaded and the graph will update as live data becomes available. See “Building a Display Using History Data” for more information.

trace*ValueTable

Attach your historical data containing two columns: the first column must be the time value and the second column the value to plot.

Note: In order to attach historical data to the trace*ValueTable property, the trace*ValueHistoryFlag must be deselected.

Optionally, include a third (string) column in your attachment to display a data label for each corresponding data value. The data label will be displayed (enclosed in parentheses) in the fixed legend and in the popup legend, between the trace value and the trace label. If the cursorFlag property is selected, then the data label in the popup legend is for the data value that is directly under or to the left of the cursor.

trace*VisFlag

Select to control trace visibility. Click and hold on a trace's entry in the legend to temporarily hide all other traces in the graph.

Web Chart Properties 

Property Name

Description

webChartFlag

Select to enable the html5 trend chart. When the display is opened in the Display Server, in an HTML5 compatible browser, the html5 trend chart will appear in place of the trend graph.

webChartNavigatorTrace

Specify the number of traces (between 1 and the value of the traceCount property). By default, this property is disabled with a value of 0.

The navigator will be displayed at the bottom of the html5 chart, just below the x-axis, and highlight the time range currently visible in the chart. The highlighted section can be resized or dragged to zoom/pan to the time range of interest.

The color of the navigator trace will reflect the color of the corresponding trace as specified by the trace*LineColor property.

X-Axis Properties 

Specify the way the x axis is displayed in your trend graph.

Property Name

Description

timeFormat

Set the format for the time displayed in the x-axis using syntax from the Java SimpleDateFormat class.

For example, MMMM dd, yyyy hh:mm:ss a would result in the form August 30, 2003 05:32:12 PM. If no format is given, the date and time will not be displayed on the x-axis. Include a new line character ('\n') to display multiple line text in the time axis labels.

For example, MM\dd'\n'hh:mm:ss would result in the form 08\30 05:32:12.

timeRange

Control the total amount of time, in seconds, plotted on the graph. If you attach data to trace*ValueTable, set timeRange to -1 so the time range of the graph is driven by the time range in the data attachment.

Note: timeRange is ignored if both timeRangeBegin and timeRangeEnd are set.

timeRangeBegin

Set the start time value of the data to be plotted on the graph.

Supported formats are: mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03), yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03), and the number of milliseconds since midnight, January 1, 1970 UTC.

Note: If only the time is specified, then today's date will be used.

timeRangeEnd

Set the end time value of the data to be plotted on the graph.

Supported formats are: mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03), yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03), and the number of milliseconds since midnight, January 1, 1970 UTC.

Note: If only the time is specified, then today's date will be used.

timeRangeOfHistory

Specify how much historical data is loaded into the graph, in seconds. If timeRangeOfHistory is set to zero or less (default is -1), or if it is less than the value of timeRange, then the timeRange property determines the amount of historical data to be loaded into the graph.

timeShift

Control the amount of time, in seconds, the graph will shift to the left when the trace has filled the graph and controls the rounding of the start and end times. For example, if the timeShift is 15, the start and end times on the graph will be rounded to the nearest 15 second interval. By default, the end of the plot area corresponds with the current time. To only shift the graph when new data is received, set timeShift to a negative value and the end of the graph will display the most current data plotted. If you attach data to trace*ValueTable, you must set timeShift to a negative value.

Note: The timeShift property is ignored if either timeRangeBegin or timeRangeEnd is set.

xAxisFlag

Select to display the x-axis.

xAxisGridVisFlag

Select to display a grid line for each major division along the x-axis.

xAxisLabelTextHeight

Specify the height in pixels of the x-axis labels.

xAxisMajorDivisions

Specify the number of major divisions on the x-axis.

xAxisMinorDivisions

Specify the number of minor divisions on the x-axis.

Y-Axis Properties 

Specify the way the y axis is displayed in your trend graph.

Property Name

Description

yAxisAutoScaleMode

The yValueMin and yValueMax properties control the range of the y-axis for this trace if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

If yAxisMultiRangeMode is set to Multiple Axis or Strip Chart, then use the trace*YAxisAutoScaleMode, trace*YAxisValueMin, and trace*YAxisValueMax properties to control the range of the y-axis.

yAxisAutoScaleVisDataOnlyFlag

Select to compute the y-axis scale according to the min & max y values of the visible data points only. This means that the y-axis scale may change as the user changes the visible time range by scrolling or zooming. By default, this property is not selected and the y axis is scaled according to the y values of all of data points, visible or not.

This property is only available if webChartFlag is selected.

yAxisAutoScaleVisTracesOnlyFlag

Select to include only visible traces when calculating the y-axis range. By default all traces in the traceCount are used in the auto-scale calculation, including those that are invisible or unattached to data.

yAxisFlag

Select to display the y-axis.

yAxisFormat

Select or enter the numeric format of values displayed on the y-axis. To enter a format, use syntax from the Java DecimalFormat class.

yAxisGridVisFlag

Select to display a grid line for each major division along the y-axis if yAxisMultiRangeMode is set to Off or Classic.

If yAxisMultiRangeMode is set to Multiple Axis or Strip Chart, grid visibility is set by selecting the trace*YAxisGridVisFlag.

yAxisLabelTextHeight

Specify the height in pixels of the y-axis labels.

yAxisMajorDivisions

Specify the number of major divisions on the y-axis. This is ignored if yAxisValueLabels is set.

yAxisMinLabelWidth

Specify the minimum width in pixels for the y-axis labels. If yAxisMultiRangeMode is set to Multiple Axis or Strip Chart, minimum width is set by trace*YAxisMinLabelWidth.

yAxisMinorDivisions

Specify the number of minor divisions on the y-axis. This is ignored if yAxisValueLabels is set.

yAxisMultiRangeMode

Select one of the following modes:

Off - All traces are plotted against a single y-axis.

Classic - One axis per trace, with each trace having its own range. The 1st trace is drawn on the outer left of the graph. The remaining traces are drawn on the inner left of the trace area.

Multiple Axis - One axis per trace, with each trace having its own range. Use the trace*YAxisAutoScaleMode, trace*YAxisValueMin, and trace*YAxisValueMax properties to control the range of the y-axis.

Strip Chart - The trace area is divided into strips, one for each trace. Each trace has its own y-axis but all traces share the same x-axis. Use the trace*YAxisAutoScaleMode, trace*YAxisValueMin, and trace*YAxisValueMax properties to control the range of the y-axis.

Stacked - The y-axis values for multiple traces displayed are "stacked". That is, the value of each successive data point is accumulated and the sum from lower numbered traces are plotted in the highest numbered trace.

Note: Actual (unstacked) values for each individual trace are shown in the legend.

Values for lower numbered traces are not included in the sum if a trace is invisible, has no data, all of its data points are older or newer than the x-axis value, or the y-axis value at the x-axis value is not a number (NaN).

If a lower numbered trace has no y-axis value at a particular x-axis data point, but has x-axis values before and after that data point, the y-axis value for the sum in that trace will be interpolated.

yAxisPosition

Select one of the following to set the position of the y-axis on the graph.

Note: The yAxisPosition setting is ignored if yAxisMultiRangeMode is set to Classic.

Outer Left - Draw axis to the left of the trace area.

Outer Right - Draw axis to the right of the trace area.

Outer Mixed - Draw axis to the left of the trace area for odd numbered traces and to the right for even numbered traces.

Inner Left - Draw axis on the inside left of the trace area.

Inner Right - Draw axis on the inside right of the trace area.

Inner Mixed - Draw axis on the inside left of the trace area for odd numbered traces and on the inside right of the trace area for even numbered traces.

yAxisValueLabels

Set to display a text label or tick mark on the y-axis in place of a numerical value. Include a value with no label to display a tick mark without a label. Use this format:

value1=label1,value2,value3=label2 (e.g., 0=Off,1,2=On)

If yAxisMultiRangeMode is set to Multiple Axis or Strip Chart mode, the y-axis labels are set using the trace*YAxisValueLabels property.

Bar Graphs

Bar graphs (class name: obj_bargraph) are useful for comparing columns or rows of numeric data from a tabular data element returned by your data attachment.

bargraph1_bgraphs00103.gif

 

Using Data and Data Label Properties 

To attach data to your graph, right-click in the Property Value field of the valueTable property and select Attach to Data. It is possible to graph multiple columns or rows of numeric data. If you include a label column in your data attachment for valueTable, it can be used to label either the x-axis or the legend, depending on whether the rowSeriesFlag is selected or deselected.   

The rowSeriesFlag controls how row and column data populate the graph:

 If the rowSeriesFlag check box is selected, one group of bars will be shown for each numeric column in your data attachment. Within the group for each numeric column, there will be a bar for each row in that column. Column names will be used for the x-axis labels. If your data attachment has a label column and the rowLabelVisFlag is selected, data from this column will be used in the legend. If your data attachment does not have a label column, select the rowNameVisFlag check box to use row names in the legend. 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.

 If the rowSeriesFlag check box is not selected, one group of bars will be shown for each row in your data attachment. Within the group for each row, there will be a bar for each column in that row. Column names will appear in the legend. If your data attachment has a label column and the rowLabelVisFlag is selected, data from this column will appear on the x-axis. If your data attachment does not have a label column, select the rowNameVisFlag check box to use row names on the x-axis. 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.

To add one or more traces to your bar graph, right-click in the Property Value field of the traceValueTable property and select Attach to Data. If you include a label column in your data attachment for traceValueTable, this is used to label either the x-axis or the legend (depending on the rowSeriesFlag) if no label is available from the valueTable data attachment. By default, the label column is the first non-numeric text column in your data. Specify a column name in the traceLabelColumnName 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 “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. 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 (see “Drill Down Substitutions” for more information). 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 bar or trace marker in the graph 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 bar in the graph.

Tool Tips

Select the mouseOverFlag to enable tool tips for your bar graph. To display a tool tip, point to a bar or marker with your mouse. The tool tip will contain information from your data attachment about that bar or marker. Select the mouseOverHighlightFlag to enable bar highlighting.

Alert Properties

To set bar colors, trace marker colors and trace marker styles based on a threshold value, select the corresponding value alarm or value warning flags.

Property Name

Description

traceValueAlarmStatusTable

Attach an alarm table containing status indexes to valueAlarmStatusTable to enable rule based alarm statuses for trace markers. The table attached to valueAlarmStatusTable must have the same number of rows and columns as traceValueTable. For each data element in traceValueTable, the status index at the corresponding position in valueAlarmStatusTable will be used to set the alarm status of the marker.   Valid indexes are:

0 = use normal marker color and style

1 = use low alarm marker color and style

2 = use low warning marker color and style

3 = use high warning marker color and style

4 = use high alarm marker color and style

-1 = determine marker color and style by comparing the value to the enabled alarm thresholds

If no data is attached to valueAlarmStatusTable, then the alarm status for a trace marker is determined by comparing the marker's value to the enabled thresholds.

valueHighAlarmEnabledFlag

Select to enable the high alarm threshold and the following related properties:

 

valueHighAlarm

Set the value of the high alarm threshold.

 

valueHighAlarmColor

When a bar's value is greater than or equal to the valueHighAlarm property, the color of the bar will change to the valueHighAlarmColor.

 

valueHighAlarmLineVisFlag

Select to display a dotted line at the high alarm threshold. The color of the line is set to the valueHighAlarmMarkColor.

 

valueHighAlarmMarkColor/

valueHighAlarmMarkStyle

When a trace marker's value is greater than or equal to the valueHighAlarm property, the marker will change to the valueHighAlarmMarkColor and valueHighAlarmMarkStyle.

valueHighWarningEnabledFlag

Select to enable the high warning threshold and the following related properties:

 

valueHighWarning

Set the value of the high warning threshold.

 

valueHighWarningColor

When a bar's value is greater than or equal to the valueHighWarning, but less than the valueHighAlarm, the color of the bar will change to the valueHighWarningColor.

 

valueHighWarningLineVisFlag

Select to display a dotted line at the high warning threshold. The color of the line is set to the valueHighWarningMarkColor.

 

valueHighWarningMarkColor/

valueHighWarningMarkStyle

When a trace marker's value is greater than or equal to the valueHighWarning property but less than the valueHighAlarm property, the marker will change to the valueHighWarningMarkColor and valueHighWarningMarkStyle.

valueLowAlarmEnabledFlag

Select to enable the low alarm threshold and the following related properties:

 

valueLowAlarm

Set the value of the low alarm threshold.

 

valueLowAlarmColor

When a bar's value is less than or equal to the valueLowAlarm property, the color of the bar will change to the valueLowAlarmColor.

 

valueLowAlarmLineVisFlag

Select to display a dotted line at the low alarm threshold. The color of the line is set to the valueLowAlarmMarkColor.

 

valueLowAlarmMarkColor/

valueLowAlarmMarkStyle

When the trace marker's value is less than or equal to the valueLowAlarm property, the marker will change to the valueLowAlarmMarkColor and valueLowAlarmMarkStyle.

valueLowWarningEnabledFlag

Select to enable the low warning threshold and the following related properties:

 

valueLowWarning

Set the value of the low warning threshold.

 

valueLowWarningColor

When a bar's value is less than the valueLowWarning property, but greater than the valueLowAlarm property, the bar will change to the valueLowWarningColor.

 

valueLowWarningLineVisFlag

Select to display a dotted line at the low warning threshold. The color of the line is set to the valueLowWarningMarkColor.

 

valueLowWarningMarkColor/

valueLowWarningMarkStyle

When the trace marker's value is less than or equal to the valueLowWarning property, but greater than the valueLowAlarm property, the marker will change to the valueLowWarningMarkColor and valueLowWarningMarkStyle.

Background Properties 

Specify how the background is displayed in your bar graph.

Property Name

Description

bgBorderColor

Select the ellipse_button00104.gif 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 ellipse_button00105.gif 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 ellipse_button00106.gif 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 graph and the border.

Bar Properties 

Specify the way the bars are displayed in your graph.

Property Name

Description

barGradientStyle

Select None, Shaded, or Rounded to set the gradient style of the bars. None is the default setting. Select Shaded to display bars with a flat gradient or Rounded to display bars with a rounded gradient.

barImage

Type the name of the image to display in the bars or, select the ellipse_button00107.gif button to open the Select Image dialog containing up to three directories:

§        Current Directory - Contains images in the current directory and one level of subdirectories.

§        Custom Image Library - If you have specified a custom image library, this directory contains those images (.gif, .jpg or .png). See Creating a Custom Image Library (below) for details.

§        Symbol Library - Contains symbolic images (for example, symbols for various types of hardware, shapes, lights, arrows, etc.).

Navigate to the image you want to use and select it. A preview of the image appears in the pane to the right. Click OK or Apply to set the image on your object. If an image is not listed, enter the name of the file, including the relative path.

Note: If necessary, the image will be stretched to fit the bar size.

 

Creating a Custom Image Library

The custom image library enables you to make your own images available in the Select Image dialog. To add your own image library, perform the following steps.

1. Place your images .jar file and add it to the “RTV_USERPATH” environment variable. The images must be in a directory (not in the top level of the jar). They can be organized into subdirectories of one top level directory.

2. In the Display Builder, select Tools/Builder Options and, in the Custom Image Library Path field, set the path to the directory containing your images .jar file.   

For example, if you have a jar with this directory structure:

com/mycompany/Images

com/mycompany/Images/Blue Images

com/mycompany/Images/Red Images

com/mycompany/Images/Green Images

you would enter com/mycompany/Images. This adds a directory named Images to the tree in the Select Image dialog. The Images directory will have three subdirectories: Blue Images, Red Images, and Green Images. Only directories containing images are added to the Select Image dialog.

To access the images, you can edit any property that allows you to set an image on an object (for example, the image, barImage and filterProperties properties), or edit the File>Background Properties>Image Name field. See “Background Properties” for more information.

barProperties

Double-click on barProperties to open the “Bar Properties” dialog and specify the color and fill pattern to be used to display each bar in the graph.

Note: Fill Patterns set in the Bar Properties dialog will be ignored unless the barGradientStyle property is set to None.

barValueVisFlag

Select to display a label containing the value for each bar.

Column Properties

Specify which columns are displayed in your bar graph.

Property Name

Description

columnsToHide

Specify columns from the data attachment to exclude from being used for plotted data or labels. Data from the labelColumnName column will be used for labels even if that column name is also specified in the columnsToHide property. Columns specified in the columnsToHide property can still be used in the drillDownColumnSubs property.

Data Properties 

Property Name

Description

rowSeriesFlag

Controls how row and column data populate the graph.

If rowSeriesFlag is selected, one group of bars will be shown for each numeric column in your data attachment. Within the group for each numeric column, there will be a bar for each row in that column. Column names will be used for the x-axis labels. If your data attachment has a label column and the rowLabelVisFlag is selected, data from this column will be used in the legend. If your data attachment does not have a label column, select the rowNameVisFlag check box to use row names in the legend. 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.

If rowSeriesFlag is not selected, one group of bars will be shown for each row in your data attachment. Within the group for each row, there will be a bar for each column in that row. Column names will appear in the legend. If your data attachment has a label column and the rowLabelVisFlag is selected, data from this column will appear on the x-axis. If your data attachment does not have a label column, select the rowNameVisFlag check box to use row names on the x-axis. 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.

traceValueDivisor

Divides trace values by the number entered.

traceValueTable

Attach your data to the traceValueTable property to add one or more traces to your bar graph. If you include a label column in data attached to traceValueTable, it can be used to label either the x-axis or the legend (depending on the rowSeriesFlag) if no label is available from the valueTable data attachment.

Note: By default, the label column is the first non-numeric text column in your data attachment. Enter a column name in the traceLabelColumnName property to set a specific label column.

traceYAxisValueMax

traceYAxisValueMin

Select the traceYAxisFlag to plot the traces against a separate y-axis than the bars.

Note: The traceYAxisFlag property is unavailable if the drawHorizontalFlag property is selected. The trace y-axis will be drawn to the right of the plot area. When the traceYAxisFlag is selected, the traceYAxisValueMin and traceYAxisValueMax properties are used to control the range of the trace y-axis if yAxisAutoScaleMode is set to Off or On-include Min/Max.

Select or enter the numeric format of trace values displayed on the y-axis with the traceYAxisFormat property. To enter a format, use syntax from the Java DecimalFormat class.

valueDivisor

Divides bar and y-axis values by the number entered.

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.

yValueMax

yValueMin

Controls the range of y-axis if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate the y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

Data Format Properties 

Specify the data format for your bar graph.

Property Name

Description

labelColumnFormat

Select or enter the format of numeric or date labels displayed on the x-axis, 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.

traceYValueFormat

Select or enter the numeric format of bar values displayed 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.

yValueFormat

Select or enter the numeric format of bar values displayed on bars, 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 bar 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 check box to use row names along the x-axis or in the legend, depending on whether or not rowSeriesFlag is selected.

traceLabelColumnName

Specify name of label column in your data attachment. If a traceLabelColumnName is not specified, then by default the first non-numeric text column in your data attachment will be used as the label column.

Historian Properties 

Property Name

Description

historyTableName

Specify name of table in your history database in which to store tabular data. See “Configuring the Historian” 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 bar graph. See “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 ellipse_button00108.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownColumnSubs

Select the ellipse_button00109.gif 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 bar in the graph.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

mouseOverFlag

Select to enable tool tips for your bar graph. To display a tool tip, point to a bar or marker with your mouse. The tool tip will contain information from your data attachment about that bar or marker.

mouseOverHighlightFlag

Select to enable bar highlighting. Once highlighting is enabled, point to a bar with your mouse to highlight that bar.

scrollbarMode

Select Never, As Needed, or Always from the scrollbarMode property to set the behavior of the x-axis scroll bar in the graph.

Note: If drawHorizontalFlag is selected, the x-axis is vertical. Never is the default setting. If set to Never, some bars may get clipped. Select Always to display a scroll bar at all times. Set to As Needed to display the scroll bar when there is not enough space to display all of the bars in the plot area. Each bar uses at least minSpacePerBar pixels along the x-axis.

scrollbarSize

Specify the height of the horizontal scroll bar and the width of the vertical scroll bar, in pixels. The default value is -1, which sets the size to the system default.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00110.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to Tab Top.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title Top - Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00111.gif button and choose a color from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

Set the height of the label text in pixels.

Layout Properties 

Specify how the background is displayed in your bar graph.

Property Name

Description

barCenterFlag

Select to center the bars in the plot area. If not selected, the bars will be left or top aligned, depending on the drawHorizontalFlag. The barCenterFlag property is only applicable if barFitFlag is not selected.

barFitFlag

Select to stretch the bars to fit the available space in the plot area. If deselected, the minSpacePerBar property is used to determine bar width.

draw3dDepth

Specify width (in pixels) for the shadow of the bars.

draw3dFlag

Select to change the display of the bars from 2D to 3D.

drawHorizontalFlag

Select to have the bars in your graph displayed horizontally.

drawStackedFlag

Select to stack each bar group in your graph.

drawWaterfallFlag

Select to stack each bar group in your graph with an offset between bar sections.

horizAxisLabelRotationAngle

Set the amount of rotation of labels on the horizontal axis. Values range from 0 to 90 degrees. A value of 0 causes the bar graph to automatically pick the optimum angle of rotation.

horizAxisMinLabelHeight

Set the minimum amount of space to reserve for labels on the horizontal axis. If axis labels vary over time, this property may be used to reserve a consistent amount of space to prevent overlapping.

minSpaceBetweenBars

Set the minimum amount of space (in pixels) between adjacent bars in the same group.

minSpaceBetweenGroups

Set the minimum amount of space (in pixels) between the last bar in one group and the first bar in the next group.

minSpacePerBar

Set the minimum width (in pixels) for each bar. Default is 1.

Note: If drawHorizontalFlag is selected, minSpacePerBar will set the minimum height (in pixels) for each bar.

vertAxisMinLabelWidth

Specify the minimum width in pixels for the vertical axis labels.

Legend Properties 

Specify the way the legend is displayed in your bar graph.

Property Name

Description

legendBgColor

Select the ellipse_button00112.gif button and choose a color from the palette to set the background color of the legend.

legendBgGradientColor2

Select the ellipse_button00113.gif button and choose a color for the second color in the gradient. Default is white.

Note: The legendBgColor property sets the first color in the gradient.

legendBgGradientMode

Display a gradient in the legend background. 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.

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.

outlineColor

Select the ellipse_button00114.gif button and choose a color from the palette to set the color of the one-pixel outline around the legend area, around each color swatch within the legend, around the plot area and each bar in the graph. The default value is black (color 7). 

Marker Properties 

Property Name

Description

markDefaultSize

Set to specify the size of the markers in pixels.

markScaleMode

Set to scale markers according to the order of the data in your data attachment. For example, the marker for the first data in the attachment is the smallest and the marker for the last data is the largest. Select one of the following options from the drop down menu: No Scale, Scale by Trace, or Scale Within Trace.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used. See “Creating Style Sheets” for more information.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Plot Area Properties 

Property Name

Description

gridBgColor

Select the ellipse_button00115.gif button and choose a color from the palette to set the color of the grid background.

gridBgGradientColor2

Select the ellipse_button00116.gif button and choose a color for the second color in the gradient. Default is white.

Note: The gridBgColor property sets the first color in the gradient.

gridBgGradientMode

Display a gradient in the grid background. 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.

gridBgImage

Select an image to display in the grid background of your graph.

Note: If necessary, the image will be stretched to fit the grid.

gridColor

Select the ellipse_button00117.gif button and choose a color from the palette to set the color of the grid lines. Default is white.

Trace Properties 

Specify the appearance of plotting traces in your bar graph. See “Using Data and Data Label Properties” for information on how to add traces to your bar graph.

Property Name

Description

traceFillStyle

Set traceFillStyle to Solid, Transparent, Gradient, or Transparent Gradient to fill the area under the trace. Set to None to disable this feature. None is the default.

traceProperties

Specify the line color, line style, line width, marker color and marker style of all traces.

traceShadowFlag

Select to enable trace shadows.

X-Axis Properties 

Specify how the x-axis is displayed in your bar graph.

Property Name

Description

xAxisFlag

Select to display the x-axis.

Y-Axis Properties 

Specify how the y-axis is displayed in your bar graph.

Property Name

Description

traceYAxisFlag

Select the traceYAxisFlag to plot the traces against a separate y-axis than the bars.

Note: The traceYAxisFlag property is unavailable if the drawHorizontalFlag property is selected. The trace y-axis will be drawn to the right of the plot area. When the traceYAxisFlag is selected, the traceYAxisValueMin and traceYAxisValueMax properties are used to control the range of the trace y-axis if yAxisAutoScaleMode is set to Off or On-include Min/Max.

traceYAxisFormat

Select or enter the numeric format of trace values displayed on the y-axis. To enter a format, use syntax from the Java DecimalFormat class.

traceYAxisMajorDivisions

Specify the number of major divisions on the trace y-axis. This option only applies if the traceYAxisFlag is on.

traceYAxisMinorDivisions

Specify the number of minor divisions on the trace y-axis. This option only applies if the traceYAxisFlag is on.

yAxisAutoScaleMode

The yValueMin and yValueMax properties control the range of y-axis if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate the y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

yAxisFlag

Select to display the y-axis.

yAxisFormat

Select or enter the numeric format of values displayed on the y-axis. To enter a format, use syntax from the Java DecimalFormat class.

yAxisGridMode

Controls the alignment of grid lines drawn to the left and right of the bar graph.

By default, yAxisGridMode is set to Bar Axis which aligns grid lines with the left y-axis. Select Trace Axis to align with the right y-axis. Select Bar and Trace Axis to draw two sets of grid lines, one aligned with the left y-axis and the other with the right y-axis.

yAxisMajorDivisions

Specify the number of major divisions on the y-axis.

yAxisMinorDivisions

Specify the number of minor divisions on the y-axis.

Pie Graphs

The pie graph (class name: obj_pie) is useful for comparing values from a single column or a single row of the tabular data element returned by your data attachment.

pie1_bgraphs00118.gif

 

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 check box 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 check box 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 “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. See “Drill Down Displays” for more information.

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, 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

bgBorderColor

Select the ellipse_button00119.gif 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 ellipse_button00120.gif 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 ellipse_button00121.gif 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 graph and the border.

Column Properties 

Specify which columns are displayed in your pie graph.

Property Name

Description

columnsToHide

Specify columns from the data attachment to exclude from being used for plotted data or labels. Data from the labelColumnName column will be used for labels even if that column name is also specified in the columnsToHide property. Columns specified in the columnsToHide property can still be used in the drillDownColumnSubs property.

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.

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 check box 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 “Configuring the Historian” 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 “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 ellipse_button00122.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownColumnSubs

Select the ellipse_button00123.gif 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 “Drill Down Displays” for information.

mouseOverFlag

Select to enable tool tips for your pie graph. To display a tool tip, 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 ellipse_button00124.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to TabTop.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title - Top Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00125.gif button and choose a color from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

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 ellipse_button00126.gif button and choose a background color for the legend.

legendBgGradientColor2

Select the ellipse_button00127.gif button and choose a color for the second color in the gradient. Default is white. 

Note: The legendBgColor property sets the first color in the gradient.

legendBgGradientMode

Display a gradient in the legend background. 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.

legendPercentVisFlag

Select to display the value percentages of your data in the legend.

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.

outlineColor

Select the ellipse_button00128.gif button and choose a color from the palette to set the color of the one-pixel outline around the legend area and around each color swatch within the legend. The default value is black (color 7).

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Wedge Properties

Specify the way wedges are displayed in your pie graph.

Property Name

Description

pieThickness

 

wedgeGradientFlag

Select the box to enable the gradient effect.

All wedges in the pie are affected by the wedgeGradientFlag property.

wedgeProperties

Specify the color of wedges in the pie graph. See “Wedge Properties Dialog” for more information.

Wedge Properties Dialog

In the Object Properties window, double-click on wedgeProperties in the Property Name field to bring up the Wedge Properties dialog. You can use the Wedge Properties dialog to assign the color to each wedge in a pie graph.

Note: Before assigning attributes to wedges in your pie graph, it is recommended that you first attach the pie graph to data.

piegraph_wedgeprops.gif

 

Field Name

Description

Wedge

Each wedge from the pie graph is listed. The Color column lists the current settings for the wedges.

Color

Select the ellipsis ellipse_button00129.gif button in the Color column and choose a color from the palette. Close the Color Chooser window.

Add Wedge Property

Click to add a wedge entry field. The data for the wedge does not have to be available yet. You may consider adding and assigning attributes to more wedges than your data currently needs for when you have more data to show.

Note: Before assigning attributes to wedges in your pie graph, it is recommended that you first attach the pie graph to data.

Delete Wedge Property

Removes the last wedge entry field from the Wedge Properties dialog.

The following describes the Wedge Properties dialog commands:

Command

Description

OK

Applies values and closes the dialog.

Apply

Applies values without closing the dialog.

Reset

Resets all fields to last values applied.

Clear

Clears all fields. Detaches object from data source (once Apply or OK is selected).

Cancel

Closes the dialog with last values applied.

Trace Properties 

In the Object Properties window, double-click on traceProperties in the Property Name field to bring up the Trace Properties dialog. In the Trace Properties dialog you can assign attributes to each plotting trace in your graph.

Note: Before assigning attributes to traces, it is recommended that you attach the graph to data.

trace_props_dialog.gif

 

Field Name

Description

Trace

One field for each trace that is currently in the graph. Current settings for each trace are shown.

Line Color

Select the ellipsis ellipse_button00130.gif button in the Color column and choose a color from the palette. Close the Color Chooser window.

Line Style

Select the ellipsis ellipse_button00131.gif button in the Line Style column and choose a style from the drop down menu. Choose either No Line, Solid, Dotted, Dashed, or Dot Dashed.

Line Width

Select the ellipsis ellipse_button00132.gif button in the Line Width column and choose a size from the drop down menu. Choose either Thin, Medium, or Thick.

Marker Color

Select the ellipsis ellipse_button00133.gif button in the Marker Color column and choose a color from the palette. Close the Color Chooser window.

Marker Style

Select the ellipsis ellipse_button00134.gif button in the Marker Style column and choose a style from the drop down menu. Choose either No Marker, Dot, +, *, o, x, Filled Circle, Filled Diamond, Filled Triangle, Filled Square, or Filled Star.

Add Trace Property

Click to add a trace property field. The data for the trace does not have to be available yet. You may consider adding and assigning attributes to more traces   than your data currently needs for when you have more data to show. It is not necessary to set properties for each trace you currently or subsequently have. This is optional and can be done after additional data is displayed in a subsequent new trace.

Delete Trace Property

Removes the last trace property field from the Trace Properties dialog.

The following describes the Trace Properties dialog commands:

Command

Description

OK

Applies values and closes the dialog.

Apply

Applies values without closing the dialog.

Reset

Resets all fields to last values applied.

Clear

Clears all fields. Detaches object from data source (once Apply or OK is selected).

Cancel

Closes the dialog with last values applied.

Radar Graphs

Radar graphs (class name: obj_radar) are useful for comparing columns or rows of numeric data from a tabular data element returned by your data attachment. The radar graph contains a value axis and a radial axis. The value axis is the vertical axis that displays the maximum and minimum values for the graph. The value axis grid lines are all of the rings except for the outer ring, which is the radial axis.

radar1_bgraphs00135.gif

 

Using Data and Data Label Properties 

To attach data to your graph, right-click in the Property Value field of the valueTable property and select Attach to Data. If you include a label column in your data attachment, this can be used to label either the radial axis or the legend depending on whether the rowSeriesFlag check box is selected or deselected.

The rowSeriesFlag controls how data populate the graph:

If the rowSeriesFlag is selected, the graph will display one trace per row of data and one radial axis per numeric column of data.

If you included a label column in your data attachment, select rowLabelVisFlag and the values from that column will be used as legend labels. By default, the label column is the first non-numeric text column in your data. To set the label column to a specific column, specify a column name using the labelColumnName property.

If your data attachment does not have a label column, select the rowNameVisFlag to use row names in the legend.

If the rowSeriesFlag is not selected, the graph will display one radial axis per row of data and one trace per column of numeric data.

If you included a label column in your data attachment, select rowLabelVisFlag and the values from that column will be used as radial axis labels. By default, the label column is the first non-numeric text column in your data. To set the label column to a specific column, specify a column name using the labelColumnName property.

If your data attachment does not have a label column, select the rowNameVisFlag to use row names on the radial axis.

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 “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. 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 trace marker in the graph 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. See “Drill Down Substitutions” for more information.

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 marker in the graph.

Tool Tips

Select the mouseOverFlag to enable tool tips for your graph. To display a tool tip, point to a trace marker with your mouse. The tool tip will contain information from your data attachment about that marker.

Alert Properties 

To set trace marker colors and styles based on a threshold value, select the corresponding value alarm or value warning flags.

Property Name

Description

valueAlarmStatusTable

Attach an alarm table containing status indexes to valueAlarmStatusTable to enable rule based alarm statuses for trace markers. The table attached to valueAlarmStatusTable must have the same number of rows and columns as valueTable. For each data element in valueTable, the status index at the corresponding position in valueAlarmStatusTable will be used to set the alarm status of the marker.

Valid indexes are: 0 = use normal marker color and style, 1 = use low alarm marker color and style, 2 = use low warning marker color and style, 3 = use high warning marker color and style, 4 = use high alarm marker color and style, -1 = determine marker color and style by comparing the value to the enabled alarm thresholds.

If no data is attached to valueAlarmStatusTable, then the alarm status for a trace marker is determined by comparing the marker's value to the enabled thresholds.

valueHighAlarmEnabledFlag

Select to enable the high alarm threshold.

valueHighAlarmLineVisFlag

Select to display a dotted line at the high alarm threshold. The color of the line is set to the valueHighAlarmMarkColor.

valueHighAlarmMarkColor/

valueHighAlarmMarkStyle

When a trace marker's value is greater than or equal to the valueHighAlarm property, the marker will change to the valueHighAlarmMarkColor and valueHighAlarmMarkStyle.

valueHighWarningEnabledFlag

Select to enable the high warning threshold.

valueHighWarningLineVisFlag

Select to display a dotted line at the high warning threshold. The color of the line is set to the valueHighWarningMarkColor.

valueHighWarningMarkColor/

valueHighWarningMarkStyle

When a trace marker's value is greater than or equal to the valueHighWarning property but less than the valueHighAlarm property, the marker will change to the valueHighWarningMarkColor and valueHighWarningMarkStyle.

valueLowAlarmEnabledFlag

Select to enable the low alarm threshold.

valueLowAlarmLineVisFlag

Select to display a dotted line at the low alarm threshold. The color of the line is set to the valueLowAlarmMarkColor.

valueLowAlarmMarkColor/

valueLowAlarmMarkStyle

When the trace marker's value is less than or equal to the valueLowAlarm property, the marker will change to the valueLowAlarmMarkColor and valueLowAlarmMarkStyle.

valueLowWarningEnabledFlag

Select to enable the low warning threshold.

valueLowWarningLineVisFlag

Select to display a dotted line at the low warning threshold. The color of the line is set to the valueLowWarningMarkColor.

valueLowWarningMarkColor/

valueLowWarningMarkStyle

When the trace marker's value is less than or equal to the valueLowWarning property, but greater than the valueLowAlarm property, the marker will change to the valueLowWarningMarkColor and valueLowWarningMarkStyle.

Background Properties 

Specify how the background is displayed in your radar graph.

Property Name

Description

bgBorderColor

Select the ellipse_button00136.gif button and choose 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 ellipse_button00137.gif button and choose 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 ellipse_button00138.gif 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 graph and the border.

Column Properties 

Specify which columns are displayed in your radar graph.

Property Name

Description

columnsToHide

Specify columns from the data attachment to exclude from being used for plotted data or labels. Data from the labelColumnName column will be used for labels even if that column name is also specified in the columnsToHide property. Columns specified in the columnsToHide property can still be used in the drillDownColumnSubs property.

Data Properties

Property Name

Description

rowSeriesFlag

Controls how data populate the graph:

If the rowSeriesFlag is selected, the graph will display one trace per row of data and one radial axis per numeric column of data.

If you included a label column in your data attachment, select rowLabelVisFlag and the values from that column will be used as legend labels. By default, the label column is the first non-numeric text column in your data. To set the label column to a specific column, specify a column name using the labelColumnName property.

 

If your data attachment does not have a label column, select the rowNameVisFlag to use row names in the legend.

If the rowSeriesFlag is not selected, the graph will display one radial axis per row of data and one trace per column of numeric data.

If you included a label column in your data attachment, select rowLabelVisFlag and the values from that column will be used as radial axis labels. By default, the label column is the first non-numeric text column in your data. To set the label column to a specific column, specify a column name using the labelColumnName property.

If your data attachment does not have a label column, select the rowNameVisFlag to use row names on the radial axis.

valueDivisor

Divides values by the number entered.

valueMin

valueMax

The valueMin and valueMax properties control the range of the value axis if the valueAxisAutoScaleMode is set to Off. Select On for the valueAxisAutoScaleMode to calculate the value axis range according to data values being plotted. To calculate the value axis range including valueMin and valueMax, select On - Include Min/Max.

valueTable

Attach your tabular data. If you include a label column in your data attachment, this can be used to label either the radial axis or the legend depending on whether rowSeriesFlag is selected or deselected.

Data Format Properties 

Property Name

Description

labelColumnFormat

Select or enter the format of numeric or date labels displayed on the radial axis, 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 trace values displayed 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 radar graph's data. Column names are displayed either along the x-axis or in the legend, depending on whether or not the rowSeriesFlag is selected.

labelColumnName

Specify a column in your data attachment to be the label column. If left blank, the first non-numeric text column in your data will be used.

Note: If you include a label column in your data attachment, this can be used to label the legend depending on whether rowSeriesFlag is selected or deselected.

rowLabelVisFlag

Control the visibility of labels that appear in the legend or on the radial axis, depending on whether rowSeriesFlag is selected or deselected.

rowNameVisFlag

Select to use row names from your data attachment to label either the radial axis or the legend, depending on whether rowSeriesFlag is selected or deselected.

Note: This is useful if your data attachment does not have a label column.

Historian Properties 

Property Name

Description

historyTableName

Specify name of table in your history database in which to store tabular data. See “Configuring the Historian” 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 graph. See “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 ellipse_button00139.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownColumnSubs

Select the ellipse_button00140.gif 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 marker in the graph.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

mouseOverFlag

Select to enable tool tips for your radar graph. To display a tool tip, point to a trace marker with your mouse. The tool tip will contain information from your data attachment about that marker.

Label Properties 

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00141.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to Tab Top.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title Top - Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00142.gif button and choose from the palette to set the label text color. 

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

Set the height of the label text in pixels.

Legend Properties 

Specify the way the legend is displayed in your radar graph.

Property Name

Description

legendBgColor

Select the ellipse_button00143.gif button and choose from the palette to set the background color of the legend.

legendBgGradientColor2

Select the ellipse_button00144.gif button and choose a color for the second color in the gradient. Default is white. 

Note: The legendBgColor property sets the first color in the gradient.

legendBgGradientMode

Display a gradient in the legend background. 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.

legendVisFlag

Select to display the legend.

legendWidthPercent

Set the percent of the total width of the object used for the legend.

outlineColor

Select the ellipse_button00145.gif button and choose a color from the palette to set the color of the one-pixel outline around the legend area and around each color swatch within the legend. The default value is black (color 7).

Marker Properties 

Property Name

Description

markDefaultSize

Specify (in pixels) the size of the markers.

markScaleMode

Scale markers according to the order of the data in your data attachment (i.e. The marker for the first data in the attachment is the smallest and the marker for the last data is the largest.)

Select from the following options: No Scale, Scale by Trace, Scale Within Trace.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Plot Area Properties 

Specify how the plot area is displayed in your radar graph.

Property Name

Description

gridColor

Select the ellipse_button00146.gif button and choose from the palette to set the color of the grid lines.

plotBgColor

Select the ellipse_button00147.gif button and choose from the palette to set the background color of the plot area.

plotBgGradientColor2

Select the ellipse_button00148.gif button and choose the second color in the gradient. Default is white. 

Note: The plotBgColor property sets the first color in the gradient.

plotBgGradientMode

Display a gradient in the plot background. 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.

plotBgImage

Select an image to display in the plot background of your graph. If necessary, the image will be stretched to fit the plot area.

Radial Axis Properties 

Specify how the radial axis is displayed in your radar graph. The radar graph contains a value axis and a radial axis. The value axis is the vertical axis that displays the maximum and minimum values for the graph. The value axis grid lines are all of the rings except for the outer ring, which is the radial axis. The radial axis grid lines are the spokes.

Property Name

Description

radialAxisColor

Select the ellipse_button00149.gif button and choose from the palette to set the color of the radial axis and radial axis labels. 

radialAxisLabelVisFlag

Select to display the radial axis labels.

radialAxisLineStyle

Select the line style of the radial axis from the drop down menu: No Line, Solid, Dotted, Dashed, or Dot Dashed.

radialAxisMinLabelWidth

Specify the minimum width in pixels for the radial axis labels.

radialAxisVisFlag

Select to display the radial axis.

radialGridLineStyle

Select the line style of the radial grid lines from the drop down menu: No Line, Solid, Dotted, Dashed, or Dot Dashed.

radialGridVisFlag

Select to display the radial grid lines.

Trace Properties 

Specify how traces are displayed in your radar graph.

Property Name

Description

traceFillStyle

Specify the style to fill the area under the trace. Select from the following options: Solid, Transparent, Gradient, or Transparent Gradient. Default is None.

traceProperties

Specify the line color, line style, line width, marker color, marker style, and fill style of all traces.

Value Axis Properties 

Specify how the value axis is displayed in your radar graph. The radar graph contains a value axis and a radial axis. The value axis is the vertical axis that displays the maximum and minimum values for the graph. The value axis grid lines are all of the rings except for the outer ring, which is the radial axis. The radial axis grid lines are the spokes.

Property Name

Description

valueAxisAutoScaleMode

The valueMin and valueMax properties control the range of the value axis if the valueAxisAutoScaleMode is set to Off. Select On for the valueAxisAutoScaleMode to calculate the value axis range according to data values being plotted. To calculate the value axis range including valueMin and valueMax, select On - Include Min/Max.

valueAxisColor

Select the ellipse_button00150.gif button and choose from the palette to set the color of the value axis and value axis labels.

valueAxisFlag

Select to display the value axis.

valueAxisFormat

Select or enter the numeric format of trace values displayed on the value axis. To enter a format, use syntax from the Java DecimalFormat class.

valueAxisLineStyle

Select the line style of the value axis from the drop down menu: No Line, Solid, Dotted, Dashed, or Dot Dashed.

valueAxisMajorDivisions

Specify the number of major divisions on the value axis.

valueAxisMinorDivisions

Specify the number of minor divisions on the value axis.

valueGridLineStyle

Select the line style of the grid line from the drop down menu: No Line, Solid, Dotted, Dashed, or Dot Dashed.

valueGridVisFlag

Select to display the grid lines.

XY Graphs

XY graphs (obj_xygraph) are useful for comparing pairs of values from a tabular data element returned by your data attachment. XY graphs plot quantitative data on both axes.

bgraphs_xy00151.gif

 

Using Data and Data Label Properties

To attach data to your graph, right-click in the Property Value field of the valueTable property and select Attach to Data. Your data attachment must contain numeric data for both the x and y axes. If you include a label column in your data attachment, this can be used to label the legend depending on whether the rowSeriesFlag check box is selected or deselected.

The rowSeriesFlag controls how data populate the graph:   

If the rowSeriesFlag check box is selected, your first row of data is used for the x-axis. The remainder will be plotted on the y-axis, with one trace per row of data containing one point for each column.

If you included a label column in your data attachment, select rowLabelVisFlag and values from that column will be used as legend labels. By default, the label column is the first non-numeric text column in your data. To set the label column to a specific column, specify a column name using the labelColumnName property.

If your data attachment does not have a label column, select the rowNameVisFlag check box to use row names in the legend.

If the rowSeriesFlag check box is not selected, your first column of data is used for the x-axis. The remainder will be plotted on the y-axis, with one trace per column of data containing one point per row.

If you included a label column in your data attachment, select rowLabelVisFlag and values from that column will be used as x-axis labels. Column names will appear in the legend.

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 “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. 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 trace marker 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. See “Drill Down Displays” for more information.

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 marker in the graph.

Tool Tips

Select the mouseOverFlag to enable tool tips for your XY graph. To display a tool tip, point to a trace marker with your mouse. The tool tip will contain information from your data attachment about that trace marker.

Alert Properties 

To set trace marker colors and styles based on a threshold value, select the corresponding value alarm or value warning flags.

Property Name

Description

valueAlarmStatusTable

Attach an alarm table containing status indexes to valueAlarmStatusTable to enable rule based alarm statuses for trace markers. The table attached to valueAlarmStatusTable must have the same number of rows and columns as valueTable. For each data element in valueTable, the status index at the corresponding position in valueAlarmStatusTable is used to set the alarm status of the marker.

Valid indexes are: 0 = use normal marker color and style, 1 = use low alarm marker color and style, 2 = use low warning marker color and style, 3 = use high warning marker color and style, 4 = use high alarm marker color and style, -1 = determine marker color and style by comparing the value to the enabled alarm thresholds.

If no data is attached to valueAlarmStatusTable, the alarm status for a trace marker is determined by comparing the marker's value to the enabled thresholds.

valueHighAlarmEnabledFlag

Select to enable the high alarm threshold.

valueHighAlarmLineVisFlag

Select to display a dotted line at the high alarm threshold. The color of the line is set to the valueHighAlarmMarkColor.

valueHighAlarmMarkColor/

valueHighAlarmMarkStyle

When a trace marker's value is greater than or equal to the valueHighAlarm property, the marker will change to the valueHighAlarmMarkColor and valueHighAlarmMarkStyle.

valueHighAlarmTraceColor/

valueHighAlarmTraceStyle

When the value of any segment of a trace line is greater than or equal to the valueHighAlarm property, that segment of the trace line will change to the valueHighAlarmTraceColor and valueHighAlarmTraceStyle.

Note: If valueHighAlarmTraceStyle is set to No Line, then valueHighAlarmTraceColor will not change.

valueHighWarningEnabledFlag

Select to enable the high warning threshold.

valueHighWarningLineVisFlag

Select to display a dotted line at the high warning threshold. The color of the line is set to the valueHighWarningMarkColor.

valueHighWarningMarkColor/

valueHighWarningMarkStyle

When a trace marker's value is greater than or equal to the valueHighWarning property but less than the valueHighAlarm property, the marker will change to the valueHighWarningMarkColor and valueHighWarningMarkStyle.

valueHighWarningTraceColor/

valueHighWarningTraceStyle

When the value of any segment of a trace line is greater than or equal to the valueHighWarning property but less than the valueHighAlarm property, that segment of the trace line will change to the valueHighWarningTraceColor and valueHighWarningTraceStyle.

valueLowAlarmEnabledFlag

Select to enable the low alarm threshold.

valueLowAlarmLineVisFlag

Select to display a dotted line at the low alarm threshold. The color of the line is set to the valueLowAlarmMarkColor.

valueLowAlarmMarkColor/

valueLowAlarmMarkStyle

When the trace marker's value is less than or equal to the valueLowAlarm property, the marker will change to the valueLowAlarmMarkColor and valueLowAlarmMarkStyle.

valueLowAlarmTraceColor/

valueLowAlarmTraceStyle

When the value of any segment of a trace line is less than or equal to the valueLowAlarm property, that segment of the trace line will change to the valueLowAlarmTraceColor and valueLowAlarmTraceStyle.

valueLowWarningEnabledFlag

Select to enable the low warning threshold.

valueLowWarningLineVisFlag

Select to display a dotted line at the low warning threshold. The color of the line is set to the valueLowWarningMarkColor.

valueLowWarningMarkColor/

valueLowWarningMarkStyle

When the trace marker's value is less than or equal to the valueLowWarning property, but greater than the valueLowAlarm property, the marker will change to the valueLowWarningMarkColor and valueLowWarningMarkStyle.

valueLowWarningTraceColor/

valueLowWarningTraceStyle

When the value of any segment of a trace line is less than or equal to the valueLowWarning property, but greater than the valueLowAlarm property, that segment of the trace line will change to the valueLowWarningTraceColor and valueLowWarningTraceStyle.

Background Properties 

Specify how the background is displayed in your XY graph.

Property Name

Description

bgBorderColor

Select the ellipse_button00152.gif 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 ellipse_button00153.gif 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 ellipse_button00154.gif 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 graph and the border.

Column Properties 

Specify which columns are displayed in your XY graph.

Property Name

Description

columnsToHide

Specify columns from the data attachment to exclude from being used for plotted data or labels. Data from the labelColumnName column will be used for labels even if that column name is also specified in the columnsToHide property. Columns specified in the columnsToHide property can still be used in the drillDownColumnSubs property.

Data Properties 

Property Name

Description

rowSeriesFlag

Controls how data populate the graph:    

§        If the rowSeriesFlag check box is selected, your first row of data is used for the x-axis. The remainder will be plotted on the y-axis, with one trace per row of data containing one point for each column.

§        If you included a label column in your data attachment, select rowLabelVisFlag and values from that column will be used as legend labels. By default, the label column is the first non-numeric text column in your data. To set the label column to a specific column, specify a column name using the labelColumnName property.

§        If your data attachment does not have a label column, select the rowNameVisFlag check box to use row names in the legend.

§        If the rowSeriesFlag check box is not selected, your first column of data is used for the x-axis. The remainder will be plotted on the y-axis, with one trace per column of data containing one point per row.

§        If you included a label column in your data attachment, select rowLabelVisFlag and values from that column will be used as x-axis labels. Column names will appear in the legend.

valueTable

Attach your tabular data. Your data attachment must contain numeric data for both the x and y axes. If you include a label column in your data attachment, this can be used to label the legend depending on whether rowSeriesFlag is selected or deselected.

xValueDivisor

The x-axis values are divided by the value entered.

xValueMin

xValueMax

The xValueMin and xValueMax properties control the range of x-axis if the xAxisAutoScaleMode is set to Off. Select On for the xAxisAutoScaleMode to calculate x-axis range according to data values being plotted. To calculate the x-axis range including xValueMin and xValueMax, select On - Include Min/Max.

yValueDivisor

The y-axis values are divided by the value entered.

yValueMin

yValueMax

The yValueMin and yValueMax properties control the range of y-axis if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

Data Format Properties 

Property Name

Description

labelColumnFormat

Select or enter the format of numeric or date labels displayed in the legend and popup legend.

To enter a format, use syntax from the Java DecimalFormat class for numeric labels and syntax from the Java SimpleDateFormat class for date labels.

xValueFormat

yValueFormat

Select or enter the numeric format of trace values displayed in the legend and popup legend.

To enter a format, use syntax from the Java DecimalFormat class.

Data Label Properties 

Property Name

Description

columnDisplayNames

Set alternate display names for column names in your XY graph's data. Column names are displayed either along the x-axis or in the legend, depending on whether or not the rowSeriesFlag is selected.

labelColumnName

Specify a column in your data attachment to be the label column. If left blank, the first non-numeric text column in your data will be used.

If you include a label column in your data attachment, this can be used to label the x-axis or the legend depending on whether rowSeriesFlag is selected or deselected.

Historian Properties 

Property Name

Description

historyTableName

Specify name of table in your history database in which to store tabular data. See Configuring the Historian 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 graph. See “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 ellipse_button00155.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used. 

cursorColor

Select the ellipse_button00156.gif button and choose a color from the palette. The default is yellow.

Note: This property is only available if cursorFlag is selected.

cursorFlag

Select to enable the cursor. When the cursor is enabled, point to a location on a trace to see a cursor line at that location and display the time and values of all traces at the cursor line on the legend. Hold down the Control key to snap the cursor to the closest data point.

Select the legendPopupFlag to display the legend along the cursor.

drillDownColumnSubs

Select the ellipse_button00157.gif 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 trace marker in the graph.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

legendPopupFlag

Select to display the legend along the cursor.

Note: This property is only available if cursorFlag is selected.

mouseOverFlag

Select to enable tool tips for your graph. To display a tool tip, point to a trace marker with your mouse. The tool tip will contain information from your data attachment about that trace marker.

outlineColor

Select the ellipse_button00158.gif button and choose a color from the palette to set the color of the one-pixel outline around the legend area, around each color swatch within the legend, and around the plot area. The default value is black (color 7).

scrollbarMode

Set whether and when the scroll bar appears in the graph. There are three options:

Never - This is the default.

Always - Displays a scroll bar at all times.

As Needed - Displays the scroll bar when necessitated by zooming in the trace area, or when you have x or y values that are outside of the min/max range.

scrollbarSize

Specify (in pixels) the height of the horizontal scroll bar and the width of the vertical scroll bar. The default value is -1, which sets the size to the system default.

zoomEnabledFlag

Select to enable zooming within the graph. Click in the graph's trace area and drag the cursor until a desired range is selected. While dragging, a yellow rectangle is drawn to show the zoom area. After the zoom is performed, the graph stores up to four zoom operations in queue. To zoom out, hold the Shift key and click in the graph's trace area.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00159.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to Tab Top.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title Top - Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00160.gif button and choose a color from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

Set the height of the label text in pixels.

Legend Properties 

Property Name

Description

legendBgColor

Select the ellipse_button00161.gif button and choose a color from the palette to set the background color of the legend.

legendBgGradientColor2

Select the ellipse_button00162.gif button and choose a color for the second color in the gradient. Default is white.

Note: The legendBgColor property sets the first color in the gradient.

legendBgGradientMode

Display a gradient in the legend background. 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.

legendValueMinSpace

Specify the minimum distance between values and labels in the legend.

legendVisFlag

Select to display the legend.

legendValueVisFlag

Select to display the numerical values of your data in the legend.

legendWidthPercent

Set the percent of the total width of the object used for the legend.

Marker Properties 

Property Name

Description

markDefaultSize

Specify (in pixels) the size of the markers.

markScaleMode

Scale markers according to the order of the data in your data attachment (i.e. The marker for the first data in the attachment is the smallest and the marker for the last data is the largest.)

Select from the following options: No Scale, Scale by Trace, or Scale Within Trace.

Object Properties

Property Name

Description

anchor

Specify where to anchor an object in the display.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Plot Area Properties

Property Name

Description

gridBgColor

Select the ellipse_button00163.gif button and choose a color from the palette to set the color of the grid background.

gridBgGradientColor2

Select the ellipse_button00164.gif button and choose a color for the second color in the gradient. Default is white. 

Note: The gridBgColor property sets the first color in the gradient.

gridBgGradientMode

Display a gradient in the grid background. 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.

gridBgImage

Select an image to display in the grid background of your graph.

Note: If necessary, the image will be stretched to fit the grid.

gridColor

Select the ellipse_button00165.gif button and choose from the palette to set the color of the grid lines. Default is white.

Trace Properties 

Property Name

Description

traceFillStyle

Specify the style to fill the area under the trace. Select from the following options: Solid, Transparent, Gradient, or Transparent Gradient. Default is None.

traceProperties

Specify the line color, line style, line width, marker color, marker style and fill style of all traces.

X-Axis Properties 

Specify how the x axis is displayed on your XY graph.

Property Name

Description

xAxisAutoScaleMode

The xValueMin and xValueMax properties control the range of x-axis if the xAxisAutoScaleMode is set to Off. Select On for the xAxisAutoScaleMode to calculate x-axis range according to data values being plotted. To calculate the x-axis range including xValueMin and xValueMax, select On - Include Min/Max.

xAxisAutoScaleRoundFlag

Select the xAxisAutoScaleRoundFlag to round values on the x-axis.

xAxisFlag

Select to display the x-axis.

xAxisFormat

Select or enter the numeric format of values displayed on the x-axis. To enter a format, use syntax from the Java DecimalFormat class.

xAxisLabel

Specify the x-axis label.

xAxisLabelTextHeight

Specify the height in pixels of the x-axis labels.

xAxisMajorDivisions

Specify the number of major divisions on the x-axis.

xAxisMinorDivisions

Specify the number of minor divisions on the x- axis.

xAxisReverseFlag

Select to reverse the order of the x-axis values and plot values decreasing from left to right.

xValueSortFlag

Select to sort data from lowest to highest x values.

Y-Axis Properties

Specify how the y axis is displayed on your XY graph.

Property Name

Description

yAxisAutoScaleMode

The yValueMin and yValueMax properties control the range of y-axis if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

yAxisFormat

Select or enter the numeric format of values displayed on the y-axis. To enter a format, use syntax from the Java DecimalFormat class.

yAxisFlag

Select to display the y-axis.

yAxisLabel

Specify the y-axis label.

yAxisLabelTextHeight

Specify the height in pixels of the y-axis labels.

yAxisMajorDivisions

Specify the number of major divisions on the y-axis.

yAxisMinLabelWidth

Specify the minimum width in pixels for the y-axis labels.

yAxisMinorDivisions

Specify the number of minor divisions on the y-axis.

yAxisMultiRangeFlag

Select to enable one axis per trace with each trace having its own range.

Stock Chart

Stock charts (class name: obj_stockchart) are useful for displaying live and archived stock data. Overlays can be used to compare this data against other stock, overall activity on the stock index, or to show periodic events such as stock splits and earnings announcements. The chart supports up to nineteen overlays.

bgraphs_stock00166.gif

 

Using Price Trace Properties 

To attach tabular data to your chart, right-click in the Property Value field of the priceTraceCurrentTable property or the priceTraceHistoryTable property and select Attach to Data.

Historical Data

Current Data

To display historical data, attach to priceTraceHistoryTable.

The attached historical data table must contain the following five columns (as described in the table below) in this specific order: Date, Open, High, Low, Close.

Note: See the Attach to Data section specific to your data source for details on how to use the Select Columns dialog.

The priceTraceHistoryTable property is used for viewing and analyzing archived data (data generated before the current moment). The table in your data attachment should contain multiple rows, each corresponding to a point on the graph.

To display current data, attach to priceTraceCurrentTable.   

The attached data table must contain the following five columns (as described in the table below) in this specific order: Date, Open, High, Low, Close.

Note: See the Attach to Data section specific to your data source for details on how to use the Select Columns dialog.

The priceTraceCurrentTable property is used for viewing live data and would most likely be used in conjunction with the priceTraceHistoryTable. The table in your data attachment should contain a single row that corresponds to and continually updates the last point on the graph.

Column Name

Description

Date

Supported formats for time column are:

mm/dd/yyyy hh:mm:ss (01/16/2004 12:30:03)

yyyy-mm-dd hh:mm:ss (2004-01-16 12:30:03)

The number of milliseconds since midnight, January 1, 1970 UTC

Open

Value of stock price at first market open for defined time period.

High

High value of stock price for defined time period.

Low

Low value of stock price for defined time period.

Close

Value of stock price at last market close for defined time period.

Using Trace* Properties 

The Display Builder automatically creates a set of overlay* properties according to the number you specify using the overlayCount object property. For example if you set the overlayCount to three (3), you will have three overlay traces in your graph (Trace 01, Trace 02 and Trace 03) and a corresponding set of overlay* properties for each.

The overlay*CurrentTable and overlay*HistoryTable properties are used in conjunction with the priceTraceHistoryTable or priceTraceCurrentTable properties to compare data (e.g. to compare the activity of several stocks). Tabular data attached to overlay*Table properties must have the following two columns: a Date column (as described in the table above) and a Value column (numeric). The overlay*HistoryTable property should contain multiple rows, each corresponding to a point on the graph.

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 “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. 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 bar or trace marker in the chart to activate the drill down. Drill down displays can be activated in the same window that contains the chart 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 chart. Set to Element Only to enable a drill down display only when you double-click on a bar in the chart.

Tool Tips

Select the mouseOverFlag to enable tool tips for your stock chart. To display a tool tip, point to a bar or marker with the mouse. The tool tip will contain information from your data attachment about that bar or marker.

Background Properties

Specify how the background is displayed in the stock chart.

Property Name

Description

bgBorderColor

Select the ellipse_button00167.gif button and choose 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 ellipse_button00168.gif button and choose 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 ellipse_button00169.gif button and choose from the palette to set 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 chart and the border.

Data Properties

Property Name

Description

yValueMax

yValueMin

Controls the range of y-axis if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate the y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

Data Format Properties 

Specify data format in your stock chart.

Property Name

Description

yValueFormat

Select or enter the numeric format of values displayed in the legend and popup legend. To enter a format, use syntax from the Java DecimalFormat class.

Historian Properties

Property Name

Description

historyTableName

Specify name of table in your history database in which to store tabular data. See “Configuring the Historian” 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 graph. See “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 ellipse_button00170.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used. 

cursorColor

Select the ellipse_button00171.gif button and choose from the palette. The default is yellow. 

Note: This property is only available if cursorFlag is selected.

cursorFlag

Select to enable the cursor. When the cursor is enabled, select the chart and point to a location on a trace to see a cursor line at that location and display the time and values of all traces at the cursor line on the legend. Select the legendPopupFlag to display the legend along the cursor.

drillDownColumnSubs

Select the ellipse_button00172.gif 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 bar in the graph.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

legendPopupFlag

Select to display the legend along the cursor.

Note: This property is only applicable if cursorFlag is selected.

mouseOverFlag

Select to enable tool tips for your stock chart. To display a tool tip, select the chart and point to a bar or marker with the mouse. The tool tip will contain information from your data attachment about that bar or marker.

scrollbarMode

Set whether and when the scroll bar appears in the chart. There are three options:

Never - This is the default.

Always - Displays a scroll bar at all times.

As Needed - Displays the scroll bar when necessitated by zooming in the trace area, or when more data is loaded into the chart than is displayed in the time range.

For example, if the time range of the data in your data attachment is greater than timeRange, setting scrollbarMode to As Needed will enable a scroll bar to view all data loaded into the chart.

scrollbarSize

Specify (in pixels) the height of the horizontal scroll bar and the width of the vertical scroll bar. The default value is -1, which sets the size to the system default.

zoomEnabledFlag

Select to enable zooming within the chart. Click in the chart's trace area and drag the cursor until a desired range is selected. While dragging, a yellow rectangle is drawn to show the zoom area. After the zoom is performed, the chart stores up to four zoom operations in queue. To zoom out, hold the Shift key and click in the chart's trace area.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00173.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to Tab Top.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title Top - Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00174.gif button and choose from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

Set the height of the label text in pixels.

Legend Properties 

Specify the way the legend is displayed in the stock chart.

Property Name

Description

legendBgColor

Select the ellipse_button00175.gif button and choose from the palette to set the background color of the legend.

legendBgGradientColor2

Select the ellipse_button00176.gif button and choose a color for the second color in the gradient. Default is white. 

Note: The legendBgColor property sets the first color in the gradient.

legendBgGradientMode

Display a gradient in the legend background. 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.

legendValueMinSpace

Specify the minimum distance between values and labels in the legend.

legendValueVisFlag

Select to display the numerical values of your data in the legend. If the cursorFlag is enabled, the numerical values are always shown in the legend.

legendVisFlag

Select to display the legend.

legendWidthPercent

Set the percent of the total width of the object used for the legend.

outlineColor

Select the ellipse_button00177.gif button and choose a color from the palette to set the color of the one-pixel outline around the legend area, around each color swatch within the legend, and around the plot area. The default value is black (color 7).

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Plot Area Properties 

Specify how the plot area is displayed in your stock chart.

Property Name

Description

gridBgColor

Select the ellipse_button00178.gif button and choose from the palette to set the background color of the plot area. 

gridBgGradientColor2

Select the ellipse_button00179.gif button and choose a color for the second color in the gradient. Default is white. 

Note: The gridBgColor property sets the first color in the gradient.

gridBgGradientMode

Display a gradient in the plot background. 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.

gridBgImage

Select an image to display in the plot background of your graph. If necessary, the image will be stretched to fit the plot area.

gridColor

Select the ellipse_button00180.gif button and choose from the palette to set the color of the grid line.

Price Trace Properties

Property Name

Description

priceTraceBarGainColor

Set the color to indicate that a stock price value at market close is greater than value at market open. Select the ellipse_button00181.gif button and choose from the palette. The default is green.

Note: This property does not apply if the selected priceTraceType is Line.

priceTraceBarLossColor

Set the color to indicate that a stock price value at market close is less than value at market open. Select the ellipse_button00182.gif button and choose from the palette. Default is red.

Note: This property does not apply if the selected priceTraceType is Line.

priceTraceCurrentTable

Attach your tabular data. The attached data table must contain the following five columns (Date, Open, High, Low, Close) as described in the “Using Price Trace Properties” section.

Note: The priceTraceCurrentTable is used for viewing live data and would most likely be used in conjunction with the priceTraceHistoryTable.

priceTraceFillStyle

Select the appearance of the price trace from the drop down menu: Solid, Transparent, Gradient, or Transparent Gradient. Set to None, the default, to disable.

The effects change based on the selected priceTraceType:

Line - Fills from the line to the bottom of the graph with the color and effect you choose.

Bar - Has no effect.

OHLC - Has no effect.

Candlestick - Fills the Candlestick icon with the color and effect you choose.

priceTraceHistoryTable

Attach your historical tabular data. The attached data table must contain the following five columns (Date, Open, High, Low, Close) as described in the “Using Price Trace Properties” section.

priceTraceLabel

Enter a label for the price trace line. Appears in legend and tool tip enabled by mouseOverFlag.

priceTraceLineColor

Select the ellipse_button00183.gif button and choose from the palette to set the price trace line color.

Note: This property does not apply if the selected priceTraceType is OHLC or Bar.

priceTraceLineStyle

Select the style of the price trace line from the drop down menu: No Line, Solid, Dotted, Dashed, or Dot Dashed.

Note: This property does not apply if the selected priceTraceType is OHLC or Bar.

priceTraceLineThickness

Select the thickness of the price trace line from the drop down menu: Thin, Medium, or Thick.   

Note: This property does not apply if the selected priceTraceType is OHLC or Bar.

priceTraceType

Select the appearance of the price trace:

Line - A line graph showing closing price values.

Bar - A bar graph showing closing price values.

OHLC - bgraphs_stock_ohlc.gif - A bar extending from the low to high price data points. A left flange indicates the opening price and the right flange indicates the closing price. The priceTraceBarLossColor and priceTraceBarGainColor properties show whether the stock closed at a higher or lower price than the opening price.

Candlestick - bgraphs_stock_candle.gif - A bar extending from the opening to closing price data points. The "wicks" on either end show the high and low for the day. The priceTraceBarLossColor and priceTraceBarGainColor properties show whether the stock closed at a higher or lower price than the opening price.

priceTraceVisFlag

Select to control price trace visibility.

Trace Properties 

Property Name

Description

overlayCount

Set the number of overlay traces you want to display. Maximum is 19.

RTView automatically creates a set of properties (see “Trace * Properties”) for each overlay.

overlayFillStyle

Select the fill style of the price trace from the drop down menu. Sets the appearance of the overlay*Type. Set to Solid, Transparent, Gradient, or Transparent Gradient. Set to None, the default, to disable.

The effects change based on the overlay*Type:

Line - Fills from the line to the bottom of the graph with the color and effect you choose.

Bar - Has no effect.

Event- Has no effect.

Trace * Properties

Number of overlay traces displayed depend on the specified overlayCount.

Property Name

Description

overlay*CurrentTable

Attach your tabular data. The attached data table must have a Date column (as described in the “Using Trace* Properties” section) and a Value (numeric) column.

overlay*HistoryTable

Attach your historical tabular data. The attached data table must have a Date column (as described in the “Using Trace* Properties” section) and a Value (numeric) column.

overlay*Label

Enter a label for the overlay line. Appears in legend and tool tip enabled by mouseOverFlag.

overlay*LineColor

Select the ellipse_button00184.gif button and choose from the palette to set the overlay line color.

overlay*LineStyle

Select the style of the overlay line:

No Line

Solid

Dotted

Dashed

Dot Dashed

Note: This property does not apply if the selected overlay*Type is Bar or Event.

overlay*LineThickness

Select the thickness of the overlay line:

No Line

Solid,

Dotted,

Dashed

Dot Dashed.

Note: This property does not apply if the selected overlay*Type is Bar or Event.

overlay*Type

Select the appearance of the overlay trace from the drop down menu:

Line - A line graph.

Bar - A bar graph.

Event - A series of markers representing company events such as stock splits, company merges, etc. The first letter of the overlay*Label is the letter that appears in each event marker.

overlay*VisFlag

Select to control overlay trace visibility.

X-Axis Properties 

Specify the way the x axis is displayed and set time values to control how much data is plotted in the stock chart.

Property Name

Description

timeFormat

Set the format for the time displayed in the x-axis using syntax from the Java SimpleDateFormat class.

For example, MMMM dd, yyyy hh:mm:ss a would result in the form August 30, 2003 05:32:12 PM. If no format is given, the date and time will not be displayed on the x-axis.

Include a new line character ('\n') to display multiple line text in the time axis labels.

For example, MM\dd'\n'hh:mm:ss would result in the form 08\30 05:32:12. If left blank, the axis is labeled with a default format based on the range.

Note: This property is only used when the timeRangeMode is Continuous.

timeRange

Sets the total amount of time, in seconds, plotted on the chart.

If timeRange is set to -1, the time range is determined by the first and last timestamp found in the priceTraceHistoryTable and priceTraceCurrentTable. If both tables are empty, the chart uses the first and last timestamp of the first overlay trace that has a non-empty overlay*HistoryTable and/or overlay*CurrentTable.

Note: timeRange is ignored if both timeRangeBegin and timeRangeEnd are set.

timeRangeBegin

Set the start time value of the data to be plotted on the chart. Supported formats are:

mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03)

yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03)

The number of milliseconds since midnight, January 1, 1970 UTC

Note: If only the time is specified, then today's date will be used.

timeRangeEnd

Set the end time value of the data to be plotted on the chart. Supported formats are:

mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03)

yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03)  

The number of milliseconds since midnight, January 1, 1970 UTC

Note: If only the time is specified, then today's date will be used.

timeRangeMode

Select the timeRangeMode from the drop down menu. Sets the interval between trace data points. timeRangeMode also determines the type of label to be used in a graph. For example, the label used on the x-axis could be the date or the time depending on the time interval specified for the data to be displayed. There are eight modes:

Auto - Selects the setting that best matches the time intervals in the price trace data table.

Intra-Day - Time intervals are less than one day: hourly, every 15 minutes, etc.

Daily - Time intervals are days.

Weekly - Time intervals are weeks.

Monthly - Time intervals are months.

Quarterly - Time intervals are quarters.

Yearly - Time intervals are annual.

Continuous - Plots each point using the corresponding timestamp from the data table. This data can vary in time intervals.

Note: If the price trace data is more granular than the time interval specified in your data attachment, the price trace data will be aggregated to match the timeRangeMode.

xAxisFlag

Select to display the x-axis.

xAxisLabel

Specify label to display below the x-axis.

xAxisLabelTextHeight

Specify the height in pixels of the x-axis labels.

xAxisMajorDivisions

Specify the number of major divisions on the x-axis.

xAxisMinorDivisions

Specify the number of minor divisions on the x-axis.

Note: This property applies when the timeRangeMode property is set to Continuous.

Y-Axis Properties 

Specify the way the x and y axes are displayed in the stock chart.

Property Name

Description

tradeDayBegin

Defines the daily start time of the trading day. This property is only used with intraday data (time intervals less than one day: hourly, every 15 minutes, etc.). The default value is 09:30.

tradeDayEnd

Defines the daily end time of the trading day. This property is only used with intraday data (time intervals less than one day: hourly, every 15 minutes, etc.). The default value is 16:00.

tradeDayEndLabelFlag

Select to show the last data point of a day and the first data point of the next day (which are equal values) with a unique point on the chart.

Otherwise, they are shown together at one point on the chart.

This property is only used with intraday data.

The default is disabled.

yAxisAutoScaleMode

Select how the y-axis range is calculated from the drop down menu:

Off - The yValueMin and yValueMax properties control the range of y-axis.

On - The yAxisAutoScaleMode calculates the y-axis range according to data values being plotted.

On - Include Min/Max - The yAxisAutoScaleMode calculates the y-axis range including yValueMin and yValueMax.

yAxisFlag

Select to display the y-axis.

yAxisFormat

Select or enter the numeric format of values displayed on the y-axis. To enter a format, use syntax from the Java DecimalFormat class.

yAxisLabel

Specify label to display to the left of the y-axis.

yAxisLabelTextHeight

Specify the height of the y-axis labels in pixels.

yAxisMajorDivisions

Specify the number of major divisions on the y-axis.

yAxisMinLabelWidth

Specify the minimum width of the y-axis labels in pixels.

yAxisMinorDivisions

Specify the number of minor divisions on the y-axis.

yAxisMultiRangeFlag

Select to have one axis per trace, with each trace having its own range. The first trace is drawn on the outer left of the graph. The remaining traces are drawn on the inner left of the trace area.

Otherwise, all traces are plotted against a single y-axis.

The default is enabled.

yAxisPercentFlag

Select to show the percent changed from the first data point instead of values for the y-axis.

Legend

The Legend object (class name: obj_legend) is useful for displaying a legend that is too lengthy for the built-in legends of graph objects. The Legend can be used in conjunction with any object on the Graphs tab, excluding the Heatmap, by entering the objName property of the graph object in the Legend's graphName property. The Legend reflects information from the graph object to which it is connected. All formatting should be setup using the properties of the connected graph object.

legend1_bgraphs00185.gif

 

Using Interaction Properties 

Commands

To assign a command, 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 “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. 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. Once a drill down target has been set, double-click to activate the drill down. Drill down displays can be activated in the same window that contains the legend or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Background Properties 

Specify how the background is displayed in your legend.

Property Name

Description

bgBorderColor

Select the ellipse_button00186.gif 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 ellipse_button00187.gif 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 ellipse_button00188.gif 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 legend and the border.

Data Properties 

Property Name

Description

graphName

Enter the objName property of the graph object to which you want to attach a legend.

Historian Properties 

Property Name

Description

historyTableName

Specify name of table in your history database in which to store tabular data. See “Configuring the Historian” 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 legend. See “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 ellipse_button00189.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00190.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab.This property is only applies if labelTextAlignY is set to Tab Top.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title Top - Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00191.gif button and choose a color from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

Set the height of the label text in pixels.

Legend Properties

Property Name

Description

legendBgColor

Select the ellipse_button00192.gif button and choose a background color for the legend.

legendBgGradientColor2

Select the ellipse_button00193.gif button and choose a color for the second color in the gradient. Default is white.

Note: The legendBgColor property sets the first color in the gradient.

legendBgGradientMode

Display a gradient in the legend background. 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.

legendTextColor

Select the ellipse_button00194.gif button and choose from the palette to set the legend text color.

legendTextFont

Select font style of legend text from the drop down menu.

legendTextHeight

Set the height (in pixels) of the legend text.

legendValueMinSpace

Specify the minimum distance between values and labels in the legend.

legendValueVisFlag

Select to display the numerical values of your data in the legend.

outlineColor

Select the ellipse_button00195.gif button and choose a color from the palette to set the color of the one-pixel outline around the legend area and around each color swatch within the legend. The default value is black (color 7).

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Heat Maps

Heat maps (class name: obj_heatmap) display indexed hierarchical data as a set of nested rectangles. A rectangle exists for each index and, when attached to data, each is filled with smaller rectangles representing sub-indexes, known as nodes. The size and color of a node's rectangle reflects its value, relative to the total of all values for that index. Heat maps are useful because the color and size of the nodes allow you to see patterns that would be difficult to spot in other ways. They also make efficient use of space and therefore can legibly display a large amount of data.

bgraphs_heatmap00196.gif

 

Using Data Properties

To attach data to the heat map, right-click in the Property Value field of the valueTable property and select Attach to Data. Tabular data attached to the valueTable property must contain one or more index columns and at least one data column. The heat map will display one level of nodes for each index column specified. Use the nodeIndexColumnNames property to specify column names. The first non-index numeric data column is used to control the size of the node. The second non-index numeric data column is used to control the color of the node. If only one data column is specified, it will control both node size and color.

Data attached to valueTable are aggregated by unique index value.

Note: Negative aggregated values are treated as 0. By default, both size and color data is subtotaled. Alternately, you can specify aggregation types using the colorValueGroupType and sizeValueGroupType properties.

Using Interaction Properties

Commands

To assign a command, right-click in the Property Value field of the command property and select Define Command.   See “Define/Execute Command” for information on how to set up commands.

Drill Down Displays

Since data in a heat map is aggregated, the value shown in a node might not be the same as the value passed down to a drill down display. For example, suppose your heat map is attached to a table where the index column is Plant and the size column is Units Completed. If you have two rows where the Plant is San Francisco, then the node size is based on the total of the Units Completed values for both rows. However when you drill down, the drill down value for Units Completed will be the value in the first row in the table where the Plant is San Francisco.

To specify a drill down display, double click on the drillDownTarget property. Any display (.rtv) file can be targeted as a drill down. Based on your data attachment, substitutions are created that are passed into drill down displays. To customize which substitutions are 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 to activate the drill down. Drill down displays can be activated in the same window that contains the heat map 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 map. Set to Element Only to enable a drill down display only when you double-click on a node in map. See “Drill Down Displays” for more information.

Tool Tips

Select the mouseOverFlag to enable tool tips for your heat map. To display a tool tip, point to a node with your mouse. The tool tip will contain information from your data attachment about that node.

Use the mouseOverAdditionalColumns property to select which columns to include in tool tips and, optionally, specify a date format (or other numeric format) and value divisor (for numeric columns) for each column displayed. In the tool tip, the name and value for each selected column is displayed. If the mouseOverDefaultColumnsFlag is selected, then columns you include are inserted following the default columns in the tool tip. If specified, columnDisplayNames are applied to the columns you selected to include.

Background Properties 

Specify how the background is displayed in your heat map.

Property Name

Description

bgBorderColor

Select the ellipse_button00197.gif button and choose 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 ellipse_button00198.gif button and choose 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 ellipse_button00199.gif 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 graph and the border.

Data Properties

Property Name

Description

colorValueAutoScaleMode

Nodes are colored according to the value in the color column of the valueTable data attachment. The colors range from minColor to maxColor (around the color wheel) according to their relative value.

If colorValueAutoScaleMode is On the color range will auto-scale according to the values in the data. If Off, use colorValueMin and colorValueMax to control the color range. If On - Include Min/Max, include both colorValueMin and colorValueMax along with the values from the data to control the color range.

Note: If the linearColorMappingFlag is selected, then nodes will display a gradient from minColor to maxColor.

colorValueDivisor

Divides color value by the number entered.

Note: If colorValueDivisor is specified, it will also be applied to the colorValueMin and colorValueMax properties.

colorValueGroupType

Select the group type to use for color data. Valid choices are: sum, average, count, min, and max.

colorValueMax

Set the maximum value for the color data. This value is not applicable if colorValueAutoScaleMode is On.

colorValueMin

Set the minimum value for the color data. This value is not applicable if colorValueAutoScaleMode is On.

nodeIndexColumnNames

Specify a semicolon (;) delimited list of index column names. If not specified, the first text column in the table attached to valueTable is used as the index column and the first two numeric columns are used as data columns.

sizeValueDivisor

Divides color value by the size entered.

sizeValueGroupType

Select the group type to use for size data. Valid choices are: sum, average, count, min, and max.

valueTable

Tabular data attached to the valueTable property must contain one or more index columns and at least one data column. The heat map will display one level of nodes for each index column specified. Use the nodeIndexColumnNames property to specify column names. The first non-index numeric data column is used to control the size of the node. The second non-index numeric data column is used to control the color of the node. If only one data column is specified, it will control both node size and the color.

Data attached to valueTable are aggregated by unique index value.

Note: Negative aggregated values are treated as 0. By default, both size and color data is subtotaled. Alternately, you can specify aggregation types using the colorValueGroupType and sizeValueGroupType properties.

Data Format Properties 

Specify the data format for your heat map.

Property Name

Description

colorValueFormat

Select or enter the numeric format of the color value displayed in tool tips.

To enter a format, use syntax from the Java DecimalFormat class. To enable tool tips, select the mouseOverFlag.

linearColorMappingFlag

If selected, the color of nodes will display a gradient from minColor to maxColor. If deselected, the color of nodes will range from minColor and maxColor around the color wheel.

maxColor

Select the ellipse_button00200.gif button and choose from the palette to set the maximum color value. Node colors will range from the minColor to the maxColor according to their color values. 

Note: Use the linearColorMappingFlag to display a gradient from minColor to maxColor.

minColor

Select the ellipse_button00201.gif button and choose from the palette to set the minimum color value. Node colors will range from the minColor to the maxColor according to their color values.

Note: Use the linearColorMappingFlag to display a gradient from minColor to maxColor.

sizeValueFormat

Select or enter the numeric format of the size value displayed 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 heatmap data. Column names are displayed in tool tips.

Historian Properties 

Property Name

Description

historyTableName

Specify name of table in your history database in which to store tabular data. See “Configuring the Historian”for information.

historyTableRowNameFlag

Select to store data from the row name field in the first column of the table specified in historyTableName.

Interaction Properties

Property Name

Description

command

Assign a command to your heat map. See “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 ellipse_button00202.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property is used.

drillDownColumnSubs

Select the ellipse_button00203.gif button to open the “Drill Down Column Substitutions Dialog” to customize which substitutions are 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 map.

Element Only - Enable a drill down display only when you double-click on a node in the map.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

Note: Heat maps containing large data sets may run slowly on the Display Server if a drillDownTarget is specified.

menuItemGroup

Use the menuItemGroup property to extend RTView context menu items. For details, see “Extending the Context Menu”.

mouseOverAdditionalColumns

Select the ellipse_button00204.gif button to open a dialog to select which columns to include in tool tips and, optionally, specify a date format (or other numeric format) and value divisor (for numeric columns) for each column displayed. In the tool tip, the name and value for each selected column is displayed. If the mouseOverDefaultColumnsFlag is selected, then columns you include are inserted following the default columns in the tool tip. If specified, columnDisplayNames are applied to the columns you selected to include.

mouseOverDefaultColumnsFlag

Select to include column names and values from valueTable (for index column(s) and data columns) in tool tips. If columnDisplayNames are specified, they will be applied to all column names.

mouseOverFlag

Select to enable tool tips for your heat map. To display a tool tip, point to a node with your mouse. The tool tip will contain information from your data attachment about that node.

Note: Heat maps containing large data sets may run slowly on the Display Server if mouseOverFlag is selected.

rightClickActionFlag

Use the rightClickActionFlag property to extend RTView context menu items. For details, see “Extending the Context Menu”.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00205.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to Tab Top.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title Top - Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00206.gif button and choose from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

Set the height of the label text in pixels.

Layout Properties 

Specify how the background is displayed in your heat map.

Property Name

Description

adjustSizeForLabelFlag

Select to compress the ratio between the smaller nodes and larger nodes so that the size of smaller nodes is increased to accommodate labels.

This property only applies to nodes that display labels.

layoutStyle

Select from the following layout styles:

Squarified - Nodes are more square in shape and ordered according to the size of the value from the top-left to the bottom-right.

Strip - Nodes are more square in shape and ordered according to the order of the rows in the valueTable.

Slice Horizontal - Nodes are short and wide and ordered according to the order of the rows in the valueTable.

Slice Vertical - Nodes are tall and narrow and ordered according to the order of the rows in the valueTable.

Slice Best - Nodes are laid out either like Slice Horizontal or Slice Vertical based on what fits best in the available space.

 

Slice Alternate Horizontal - The layout alternates between Slice Horizontal and Slice Vertical based on the node depth. The top level nodes use Slice Horizontal.

Slice Alternate Vertical - The layout alternates between Slice Horizontal and Slice Vertical based on the node depth. The top level nodes use Slice Vertical.

Node Properties 

Property Name

Description

nodeBgBorderHighlightMode

Select from the following options:

None - No highlight.

Thin - Single pixel highlight.

Thick - Two pixel thick highlight with the inner pixel a shade lighter than the outer pixel.

Note: This property is ignored if nodeBgBorderSize is set to 0 or 1.

nodeBgBorderNestDepth

Specify the number of nest levels to display node borders. If set to 0, then no borders are displayed. If set to -1, then borders are displayed on all levels.

nodeBgBorderSize

Specify (in pixels) the size of the border between nodes. If set to -1, the deepest nested level of nodes has a one pixel border and the border increases by two pixels for each level of nesting.

nodeBgColor

Select the ellipse_button00207.gif button and choose from the palette to set the background color for the nodes.

nodeLabelNestDepth

Specify the number of nest levels to display node labels. If set to 0, then no labels are displayed.

nodeLabelTextColor

Select the ellipse_button00208.gif button and choose from the palette to set the text color for the node labels.

nodeLabelTextFont

Select the font to use for the node labels.

nodeLabelTextHeight

Specify the text height for the node labels.

nodeLabelVisFlag

Select to display labels on the nodes.

Note: This property is ignored if the nodeLabelNestDepth is set to 0.

nodeLabelVisIfEmtpyFlag

Select to display the background for empty node labels.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

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.

Quality Properties 

Property Name

Description

valueQuality

Specify a value to compare to settings for the valueQualityLostData and valueQualityNoData properties. If the specified valueQuality matches, the selected corresponding valueDataQuality*Color will be applied to all nodes in the heat map.

Note: The valueQuality property is ignored if the valueQualityEnabledFlag is deselected.

valueQualityColumnName

Specify a column in the valueTable to compare, per row, to settings for the valueQualityLostData and valueQualityNoData properties. If values in the specified valueQualityColumnName matches, the selected corresponding valueQuality*Color will be selectively applied to each node in the heat map. If the valueTable contains multiple rows for a single index, the highest data quality value is used.

Note: The valueQualityColumnName property is ignored if the valueQualityEnabledFlag is deselected.

valueQualityEnabledFlag

If selected, nodes are colored based on data quality.

valueQualityLostData

Enter the lost data value.

valueQualityLostDataColor

Select the ellipse_button00209.gif button and choose from the palette to set the node color if the value matches the specified valueQualityLostData.

valueQualityNoData

Enter the no data value.

valueQualityNoDataColor

Select the ellipse_button00210.gif button and choose from the palette to set the node color if the value matches the specified valueQualityNoData.

Sparkline

Sparkline charts (class name: obj_sparkline) are generally used to present trends and variations in a simple and condensed way. As the name implies there is a line associated with data, but no background or axis. It is possible to add labels at the beginning and ending points of the line, which then can be toggled on and off.

bgraphs_sparkline00211.gif

 

Using Data Properties

To attach data to your sparkline chart, right-click in the Property Value field of the value or valueTable property and select Attach to Data. Attach scalar data to the value property and tabular data to the valueTable property. Tabular data attached to the valueTable property should have two columns: the first must contain numeric values or time stamps (x-axis values) and the second column should contain the corresponding (y-axis) numeric values.

Alert Properties 

To set marker colors and styles based on a threshold value, select the corresponding value alarm flags.

Property Name

Description

valueHighAlarmEnabledFlag

Select to enable the high alarm threshold and the following related properties:

 

valueHighAlarm

Set the value of the high alarm threshold.

 

valueHighAlarmLineVisFlag

Select to display a dotted line at the high alarm threshold. The color of the line is set to the valueHighAlarmMarkColor.

 

valueHighAlarmMarkColor/

valueHighAlarmMarkStyle

When a trace marker's value is greater than or equal to the valueHighAlarm property, the marker will change to the valueHighAlarmMarkColor and valueHighAlarmMarkStyle.

 

valueHighAlarmTraceColor/

valueHighAlarmTraceStyle

When the value of any segment of a trace line is greater than or equal to the valueHighAlarm property, that segment of the trace line will change to the valueHighAlarmTraceColor and valueHighAlarmTraceStyle.

Note: If valueHighAlarmTraceStyle is set to No Line, then valueHighAlarmTraceColor will not change.

valueLowAlarmEnabledFlag

Select to enable the low alarm threshold and the following related properties:

 

valueLowAlarm

Set the value of the low alarm threshold.

 

valueLowAlarmLineVisFlag

Select to display a dotted line at the low alarm threshold. The color of the line is set to the valueLowAlarmMarkColor.

 

valueLowAlarmMarkColor/

valueLowAlarmMarkStyle

When the trace marker's value is less than or equal to the valueLowAlarm property, the marker will change to the valueLowAlarmMarkColor and valueLowAlarmMarkStyle.

 

valueLowAlarmTraceColor/

valueLowAlarmTraceStyle

When the value of any segment of a trace line is less than or equal to the valueLowAlarm property, that segment of the trace line will change to the valueLowAlarmTraceColor and valueLowAlarmTraceStyle.

Background Properties 

Specify how the background is displayed in your chart.

Property Name

Description

bgBorderColor

Select the ellipse_button00212.gif 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 ellipse_button00213.gif 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 ellipse_button00214.gif 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 chart and the border.

Data Properties

Specify how data is displayed in your chart.

Property Name

Description

maxPointsPerTrace

The default is set to 1000. The maximum value for this property is 30000.

value

Attach your scalar data to the value property.

valueDivisor

Divides y-axis values by the number entered.

valueTable

Attach your tabular data to the valueTable property. Tabular data attached must have two columns: the first must contain numeric values or time stamps (x-axis values) and the second column should contain the corresponding (y-axis) numeric values.

yValueMax

yValueMin

Controls the range of y-axis if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate the y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

Data Format Properties 

Specify data format in your chart.

Property Name

Description

yValueFormat

Select or enter the numeric format of values displayed in the legend and popup legend. To enter a format, use syntax from the Java DecimalFormat class.

Historian Properties 

Property Name

Description

historyTableName

Specify name of table in your history database in which to store tabular data. See “Configuring the Historian” 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 chart. See “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 ellipse_button00215.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used. 

cursorColor

Select the ellipse_button00216.gif button and choose a color from the palette to set the color of the cursor.   

Note: This property is only available if cursorFlag is selected.

cursorFlag

Select to enable the cursor. When the cursor is enabled, point to a location on a trace to see a cursor line at that location and display the time and values of all traces at the cursor line on the legend. Hold down the control key to snap the cursor to the closest data point.

Select the legendPopupFlag to display the legend along the cursor.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

legendPopupFlag

Select to display the legend along the cursor.

Note: This property is only available if cursorFlag is selected.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00217.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to Tab Top.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title Top - Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00218.gif button and choose a color from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

Set the height of the label text in pixels.

Legend Properties

Specify the way the legend is displayed in your chart.

Property Name

Description

legendBgColor

Select the ellipse_button00219.gif button and choose a color from the palette to set the background color of the legend. 

legendBgGradientColor2

Select the ellipse_button00220.gif button and choose a color for the second color in the gradient. Default is white. 

Note: The legendBgColor property sets the first color in the gradient.

legendBgGradientMode

Display a gradient in the legend background. 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.

legendTimeFormat

Set the format for the time displayed in the legend using syntax from the Java SimpleDateFormat class.

For example, MMMM dd, yyyy hh:mm:ss a would result in the form August 30, 2003 05:32:12 PM. If no format is given, the timeFormat will be used.

legendValueMinSpace

Specify the minimum distance between values and labels in the legend.

legendVisFlag

Select to display the legend.

legendWidthPercent

Set the percent of the total width of the object used for the legend.

Marker Properties 

Specify the way markers are displayed in your chart.

Property Name

Description

markDefaultSize

Set markDefaultSize to specify the size of the markers in pixels.

Object Properties 

Property Name

Description

anchor

Specify where to anchor an object in the display.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Plot Area Properties 

Specify the way the plot area is displayed in your chart.

Property Name

Description

traceBgColor

Select the ellipse_button00221.gif button and choose a color from the palette to set the background color of your chart.

Trace Properties

Specify how traces are displayed in your chart.

Property Name

Description

traceLabel

Set a label for your trace.

traceLineColor

Select the ellipse_button00222.gif button and choose a color from the palette to set the trace line color.

traceLineStyle

Select the style of the line used to display the trace from the drop down menu: No Line, Solid, Dotted, Dashed, or Dot Dashed.

traceLineThickness

Select the thickness of the line used to display the trace from the drop down menu: Thin, Medium, or Thick.

traceMarkColor

Select the ellipse_button00223.gif button and choose a color from the palette to set the trace marker color.

traceMarkStyle

Select the style of the marker used on the trace from the drop down menu: No Marker, Dot, +, *, o, x, Filled Circle, Filled Diamond, Filled Triangle, Filled Square, or Filled Star.

valueHistoryFlag

If you enable this property, RTView will attempt to load initial data from the Historian database for the corresponding trace.

Note: Only data within the specified timeRange will be loaded and the chart will update as live data becomes available.

X-Axis Properties 

Specify the way the x axis is displayed in your chart.

Property Name

Description

timeRange

Control the total amount of time, in seconds, plotted on the chart. If you attach data to trace*ValueTable, set timeRange to -1 so the time range of the chart is driven by the time range in the data attachment.

Note: timeRange is ignored if both timeRangeBegin and timeRangeEnd are set.

timeRangeBegin

Set the start time value of the data to be plotted on the chart.

Supported formats are: mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03), yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03), and the number of milliseconds since midnight, January 1, 1970 UTC.

Note: If only the time is specified, then today's date will be used.

timeRangeEnd

Set the end time value of the data to be plotted on the chart.

Supported formats are: mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03), yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03), and the number of milliseconds since midnight, January 1, 1970 UTC.

Note: If only the time is specified, then today's date will be used.

timeRangeOfHistory

Specify how much historical data is loaded into the chart, in seconds. If timeRangeOfHistory is set to zero or less (default is -1), or if it is less than the value of timeRange, then the timeRange property determines the amount of historical data to be loaded into the chart.

Y-Axis Properties 

Specify the way the y axis is displayed in your chart.

Property Name

Description

yAxisAutoScaleMode

The yValueMin and yValueMax properties control the range of the y-axis for this trace if the yAxisAutoScaleMode is set to Off. Select On for the yAxisAutoScaleMode to calculate y-axis range according to data values being plotted. To calculate the y-axis range including yValueMin and yValueMax, select On - Include Min/Max.

If yAxisMultiRangeMode is set to Multiple Axis or Strip Chart, then use the trace*YAxisAutoScaleMode, trace*YAxisValueMin, and trace*YAxisValueMax properties to control the range of the y-axis.

Status History

Status History charts (class name: obj_statushistory) show discrete status values as horizontal bars drawn against a horizontal time axis. A label appears at the right edge of each bar along with a circular indicator displaying that bar's most recent status. If there are more horizontal bars of data than can be drawn in the allocated area, vertical scroll bars will appear to the right. If there is more data than can be displayed in the current time frame, a horizontal scroll bar will appear at the bottom of the chart.

bgraphs_statushistory00224.gif

 

Using Data Properties 

To attach tabular data to your chart, right-click in the Property Value field of the valueCurrentTable property or the valueHistoryTable property and select Attach to Data.

Historical Data

Current Data

To display historical data, attach to valueHistoryTable.

The attached historical data table should contain a timestamp column, a status (value) column and one or more index columns. The timestamp column should be the first column in the data table.

A horizontal bar is displayed in the chart for each unique combination of index column values. The value of the status column is used to determine the color and fill pattern of the bar segment at the corresponding time interval.

When data is attached to valueHistoryTable, any previously plotted data is removed and the entire chart is replotted.

Typically valueHistoryTable is attached to the history table of a Cache object. See “Caches” for more information.

To display current data, attach to   valueCurrentTable.   

The attached data table should contain at least two columns: a status (value) column and one or more index columns. If it does not contain a timestamp column, then the current time will be assumed for each row in the table.

A horizontal bar is displayed for each unique combination of index column values. The value of the status column is used to determine the color and fill pattern of the bar segment at the corresponding time interval.

Data attached to valueCurrentTable is assumed to be the most recent data and other previously plotted data is appended to it.

Typically valueCurrentTable is attached to the current table of a Cache object. See “Caches” for more information.

For example, consider a data table that holds time-based status information for two nodes on a network. It has three columns: time_stamp, node_name, and status. The time_stamp column contains the timestamp for the row. The node_name string is unique for each node so it is used as the index column for the table. The status column contains either up, down, or unknown.

Here is a portion of the contents of that data table:

12:00, Node01, up

12:00, Node02, up

12:01, Node01, up

12:01, Node02, down

12:02, Node01, up

12:02, Node02, up

This table could be attached to the valueHistoryTable property. The barProperties property would be configured to assign a color and fill pattern that corresponds to the status column (e.g. up = solid green and down = crosshatch red. The chart would display two horizontal bars, one for Node01 and another for Node02, and each bar would contain a segment for each time interval. For example if the chart was observed at 12:03, each bar would contain two segments: one for the 12:00 - 12:01 interval and another for the 12:01 - 12:02 interval. The color and fill pattern of the segment would correspond to the status at the start of that interval, as determined by the barProperties settings. Note that no segment would be displayed for the interval starting at 12:02, since there is no end point for that interval in the data table. Instead, the status value for the last data value is always used to control the color and fill pattern of the circular indicator that appears at the right end of each bar.

Note: : Supported formats for the timestamp column are: mm/dd/yyyy hh:mm:ss (e.g., 01/16/2004 12:30:03), yyyy-mm-dd hh:mm:ss (e.g., 2004-01-16 12:30:03), and the number of milliseconds since midnight, January 1, 1970 UTC. In order to view all available data, you must set the properties timeRange to -1 and timeShift to a negative value. This negative value will be used to round the start and end times for the y-axis. For example, if you specify -15 for the timeShift property, the start and end times for the y-axis will be rounded to the nearest 15 seconds.

Using Interaction Properties

Commands

To assign a command to your chart, 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 “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. 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 a bar segment or a bar label in the chart to activate the drill down. If a bar segment is clicked, substitutions will be set to match the data row that corresponds to the left edge of the segment. If a bar label is clicked, the substitutions will be set to match the most recent data row for that bar.

Drill down displays can be activated in the same window that contains the chart or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Right-Click Options

Select the rightClickActionFlag property so that a right-click by the user executes actions (a drill down or execute command) normally performed only with a left-click, before the right-click popup menu is shown. This is useful when you have a command string configured to set substitutions in the current window, and the drill down target is configured to drill down using those substitutions. In that case, the command is executed when you left-click and when you right-click so the substitutions are guaranteed to be set before you select Drill Down from the popup menu. This option should not be used if the left click is configured to drill down to another display.

Note: This property is ignored in the Thin Client on iOS Safari (iPad/iPhone).

Use the menuItemGroup and rightClickActionFlag properties to extend RTView context menu items. For details, see “Extending the Context Menu”.

Tool Tips

Select the mouseOverFlag to enable tool tips for your chart. To display a tool tip, point to a bar segment or bar label with your mouse. When you point to a bar segment, the tool tip will show information about the data row that corresponds to the left edge of the segment. When you point to a bar label, the tool tip will show information about the most recent data row for that bar.

Note: Use the descriptionColumnName property to identify a column in the attached value*Table that contains additional tool tip information for each row.

Background Properties 

Specify how the background is displayed in your chart.

Property Name

Description

bgBorderColor

Select the ellipse_button00225.gif button and choose 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 ellipse_button00226.gif button and choose 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 ellipse_button00227.gif 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 chart and the border.

Bar Properties 

Specify the way the bars are displayed in your chart.

Property Name

Description

barCellBorderFlag

If selected, vertical lines are drawn between each segment of each bar corresponding to the location of data points that mark the start and end of each segment. Depending on whether data is updated at regular intervals, these lines may or may not be evenly spaced.

Note: Use the gridColor property to set the color of these lines.

barGradientStyle

Set the type of gradient to display when filling a bar. Select from the following options:

Shaded - Display bars with a flat gradient

Rounded - Display bars with a rounded gradient

None - No gradient displayed.

Note: The barGradientStyle property is ignored for bars with Fill Patterns patterns specified using barProperties.

barHeightFitFlag

If selected, each bar will be stretched vertically to fill additional space if the chart's plot area is taller than necessary to accommodate minimum height of each bar as determined by the larger of two properties: barHeightMin and barLabelTextHeight.

barHeightMin

Set the height of the bar in pixels.

Note: Minimum height of each bar is determined by the larger of two properties: barHeightMin and barLabelTextHeight.

If the chart's plot area is not tall enough to display each bar at its minimum height, then a vertical scrollbar will appear to show remaining bars. If the chart's plot area is taller than needed and if the barFitFlag property is checked, then each bar will be stretched vertically to fill the additional space.

barHeightSpacing

Set the vertical space, in pixels, between the bottom of each bar and the top of the bar below it.

Note: The value must be an even number, greater than or equal to 2.

barLabelBgColor

Select the ellipse_button00228.gif button and choose from the palette to set the background color of the label for the top (first) bar and every other bar below it.

barLabelBgColor2

Select the ellipse_button00229.gif button and choose from the palette to set the background color of the label for the second bar from the top and every other bar below it.

barLabelMaxLength

Maximum length, in pixels, for each bar label. If the label is longer than the specified length it will be clipped. Enter a value of 0 to indicate no maximum length.

Note: If a value is specified for both barLabelMaxLength and barLabelMaxLengthPct, then the smaller of the two values will be used.

barLabelMaxLengthPct

Maximum length for each bar label, specified as a percentage of the plot area width. If the label is longer than the specified length it will be clipped. Default is 0 to indicate no maximum length.

Note: If a value is specified for both barLabelMaxLength and barLabelMaxLengthPct, then the smaller of the two values will be used.

barLabelTextColor

Select the ellipse_button00230.gif button and choose from the palette to set the bar label text color.

barLabelTextFont

Select font style of bar label text from the drop down menu.

barLabelTextHeight

Set the height of the bar label text in pixels.

Note: Minimum height of each bar is determined by the larger of two properties: barLabelTextHeight and barHeightMin.

If the chart's plot area is not tall enough to display each bar at its minimum height, then a vertical scrollbar will appear to show remaining bars. If the chart's plot area is taller than needed and if the barFitFlag property is checked, then each bar will be stretched vertically to fill the additional space.

barOutlineFlag

If selected, each bar will be outlined in the specified gridColor.

barProperties

Double-click on barProperties to specify the color and fill pattern to correspond with each value in the chart. See “Bar Properties - Status History” for more information.

Data Properties 

Property Name

Description

descriptionColumnName

Name of the column in the attached value*Table that contains additional tool tip information for each row. Within the specified column, use \n to denote a new line.

Note: The mouseOverFlag must be selected to enable tool tips.

indexColumnNames

Enter a semicolon (;) separated list of column names from the attached value*Table to be used as index columns. This list will be used to uniquely identify which rows should be plotted on the same horizontal bar.

If left blank, the second column in your data attachment will be used.

labelColumnName

Name of the column in the attached value*Table that contains labels for each bar.

If left blank, the first non-numeric text column in your data attachment will be used.

maxNumberofRows

Maximum number of rows (historical plus current data) that the chart will maintain. Older rows will be discarded as necessary, which may cause bar segments to be removed from the left edge of the chart.

timestampColumnName

Enter name of the column in the attached value*Table that contains the timestamp for each row.

If left blank, RTView will look for a column named time_stamp in your data attachment. If no column named time_stamp is found and the first column in your data attachment contains timestamp data then it will be used.

Note: If no timestamp column can be located, then the current time will be used.

valueColumnName

Enter name of the column in the attached value*Table containing the status value used to determine the color and fill pattern of each bar segment. This column can contain a string, number or boolean value.

If left is blank, the third column (if any) in the your data attachment will be used.

Note: This column will be compared to the barProperties to find the corresponding color and fill pattern. See “Bar Properties - Status History” for more information.

valueCurrentTable

Right-click in the Property Value field and select Attach to Data.

The attached data table should contain a status (value) column and one or more index columns. Refer to the “Using Data Properties” section for more information.

Typically, valueCurrentTable will be attached to the current table of a Cache object.

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.

valueHistoryTable

Attach historical data table containing a timestamp column, one or more index columns, and a status (value) column. Refer to the “Using Data Properties” section for more information.

valueQualityBadValuesList

Sets a color and pattern for plotting when data quality is bad. Use this property in conjunction with valueQualityColumnName. The valueQualityBadValuesList property can be set to a string containing value,label pairs with each pair separated by semicolons. This is used to assign a label to a numeric bad quality value, for example "-1,no data;0,stale data". The default value for valueQualityBadValuesList is blank, which means that the feature is disabled.

valueQualityColumnName

Sets a color and pattern for plotting when data quality is bad. Use this property in conjunction with valueQualityBadValuesList.

The valueQualityColumnName property can be set to the name of the table column that contains a value indicating the data quality for each row. The column can contain string, integer, or boolean values.

The default value for valueQualityColumnName is blank, which means that the feature is disabled. In this mode, the color and pattern for each bar is determined by getting the value for that row from the column specified by valueColumnName and looking up that value in the chart's barProperties. (This is the behavior in all Core releases prior to 6.6).

If valueQualityColumnName is not blank, then for each row (R), the row's value to be plotted is determined as follows:

§        let Q = value of quality column for row R, and V = value of value column for row R

§        if Q is blank, then the quality is considered good and V is used at the row value, as normal.

§        else if the valueQualityBadValuesList property is blank, then Q is used as the row value.

§        else if valueQualityBadValuesList contains an entry "Q,X" then X is used as the row value.

§        else the quality is considered good (since no match was found in valueQualityBadValuesList) and V is used at the row value.

Then the row value is looked up in barProperties, as usual, to determine the color and fill pattern. That value is also shown in the mouseover text.

For example, consider the following data table:

Plant Status Quality

----- ------ -------

A online 1

B offline 1

C online -1

D offline 0

... where 1 = data OK, -1 = no data, and 0 = stale data.

 

Next, consider a status history chart with these properties:

indexColumnNames = Plant

valueColumnName = Status

valueQualityColumnName = Quality

valueQualityBadValuesList = -1,no Data;0,stale data

barProperties =

online : green

offline : blue

no data : red

stale data : orange

Note that valueQualityBadValuesList has no entry for quality = 1, because that is the "good" quality value.

 

With that configuration, when the data table shown above is applied to the chart, it will plot a segment for each Plant as follows:

A green (since Status = online and Quality = 1 / OK)

B blue (since Status = online and Quality = 1 / OK)

C red (since Quality = -1 / no data)

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 (“Configuring the Historian”) 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 chart. See “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 ellipse_button00231.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used. 

drillDownColumnSubs

Select the ellipse_button00232.gif button to open the “Drill Down Column Substitutions Dialog” to customize which substitutions will be passed into drill down displays. 

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

menuItemGroup

Use the menuItemGroup and rightClickActionFlag properties to extend RTView context menu items. For details, see “Extending the Context Menu”.

mouseOverFlag

Select to enable tool tips for your chart. To display a tool tip, point to a bar or bar label with your mouse. When you point to a bar, the tool tip will show information about the data row that corresponds to the left edge of the segment. When you point to a bar label, the tool tip will show information about the most recent data row for that bar.

Note: Use the descriptionColumnName property to identify a column in the attached value*Table that contains additional tool tip information for each row.

rightClickActionFlag

Select to enable right-click actions (e.g.: drill down or execute command) normally performed with a left-click. For details, see “Using Interaction Properties”.

Note: This option should not be used if the left click is configured to drill down to another display.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00233.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab. This property is only applies if labelTextAlignY is set to Tab Top.

labelTextAlignX

Select x-axis position of label text from the drop down menu.

labelTextAlignY

Select y-axis position of label text from the drop down menu.

Outside Top - Position label well above the background rectangle.

Top - Position label just above the background rectangle.

Title Top - Position label along the top line of the background rectangle.

Tab Top - Position label tab just above the background rectangle. Height and width of the tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

Inside Top - Position label inside the top of the background rectangle.

labelTextColor

Select the ellipse_button00234.gif button and choose from the palette to set the label text color.

labelTextFont

Select font style of label text from the drop down menu.

labelTextHeight

Set the height of the label text in pixels.

Legend Properties 

Specify the way the legend is displayed in your chart.

Property Name

Description

legendTextFont

Select font style of legend text from the drop down menu.

legendTextHeight

Set the height of the legend text in pixels.

legendVisFlag

Select to display 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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Plot x-axis position of object.

objY

Plot y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Plot Area Properties 

Property Name

Description

gridBgColor

Select the ellipse_button00235.gif button and choose from the palette to set the color of the grid background. 

gridColor

Select the ellipse_button00236.gif button and choose from the palette to set the color of the grid lines. Default is white.

gridFlag

Select to display the grid.

gridStripedFlag

If selected, then the alternating background color of each label (as determined by barLabelBgColor and barLabelBgColor2) is extended into the plot area background. Otherwise, the plot area background color is determined by gridBgColor.

Sort Properties 

Property Name

Description

sortAscendingFlag

If selected, bars are sorted alphabetically. Otherwise, bars are sorted in reverse alphabetical order.

sortByLabelsFlag

Deselect to sort bars by a column name from the data attachment. Otherwise, if selected, bars are sorted by label.

sortColumnName

Enter the name of a column in the attached value*Table. Bars are sorted by comparing the last (most recent) row from the specified sortColumnName for each bar. If left blank, bars are left in their natural (unsorted) order. The natural order of the bars is the order in which the first row for each bar was encountered in the attached value*Table.

Note: If sortColumnName if left blank, the sortAscendingFlag property has no effect.

X-Axis Properties 

Specify how the x-axis is displayed in your chart.

Property Name

Description

timeFormat

Set the format for the time displayed in the x-axis using syntax from the Java SimpleDateFormat class.

For example, MMMM dd, yyyy hh:mm:ss a would result in the form August 30, 2003 05:32:12 PM. If no format is given, the date and time will not be displayed on the x-axis. Include a new line character ('\n') to display multiple line text in the time axis labels.

For example, MM\dd'\n'hh:mm:ss would result in the form 08\30 05:32:12.

timeRange

Control the total amount of time, in seconds, plotted on the graph. If you attach data to valueCurrentTable, set timeRange to -1 so the time range of the chart is driven by the time range in the data attachment.

timeShift

Control the amount of time, in seconds, the graph will shift to the left when the trace has filled the graph and controls the rounding of the start and end times. For example, if the timeShift is 15, the start and end times on the graph will be rounded to the nearest 15 second interval. By default, the end of the plot area corresponds with the current time. To only shift the graph when new data is received, set timeShift to a negative value and the end of the graph will display the most current data plotted. If you attach data to currentValueTable, you must set timeShift to a negative value.

xAxisColor

Select the ellipse_button00237.gif button and choose from the palette to set the color of the x-axis. Default is black.

xAxisFlag

Select to display the x-axis.

xAxisRotationAngle

Angle by which the x-axis label text will be rotated.

xAxisLabelTextFont

Select font style of x-axis label text from the drop down menu.

xAxisLabelTextHeight

Set the height of the x-axis label text in pixels.

xAxisMajorDivisions

Specify the number of major divisions on the x-axis.

Bar Properties - Status History

In the Object Properties window, double-click on barProperties in the Property Name field to bring up the Bar Properties dialog to assign a Color and Fill Pattern to each value in your status history chart.

Note: Before assigning attributes to values in your status history chart, it is recommended that you first attach the chart to data.

stathist_barprops.gif

 

Field Name

Description

Value

There is one entry for each value that is currently displaying data in the status history chart. The Color and Fill Pattern columns list the current settings for each value.

Color

Select the ellipse_button00238.gif button in the Color column and choose from the palette to set the corresponding color of the value. Close the Color Chooser window.

Fill Pattern

Select the ellipse_button00239.gif button in the Fill Pattern column and choose from the palette to set the corresponding fill pattern of the value. Close the Fill Pattern window.

New

Click to add a new Value. A value of * can be entered to specify a default Color and Fill Pattern for any rows in your data attachment that don't have a matching value.

Note: This does not add a value to your data attachment, it allows you to set properties for values that will display data that is not yet available. This is useful if the data attachment is not available when you setup your chart or if values returned by your data attachment vary.

Remove

Removes selected Value entry from the Bar Properties dialog.

The following describes the Bar Properties dialog commands:

Command

Description

OK

Applies values and closes the dialog.

Apply

Applies values without closing the dialog.

Clear

Clears all fields. Detaches object from data source (once Apply or OK is selected).

Cancel

Closes the dialog with last values applied.

Map Object   

The map object (class name: obj_gmap) displays an embedded Google map in Thin Client displays.

bgraphs_googlemap.png

 

In the Builder, an obj_gmap instance appears as a gray rectangle which you use to set the size and position of the map object on your display, and also configure the latitude, longitude, zoom level and other map object properties via the Builder's property sheet. The Google map is only rendered when the display is opened in the Thin Client.

In the Builder and Viewer, an obj_gmap instance appears as an empty gray rectangle (as shown in the following illustration). The Viewer does not support the map object.

bgraphs_googlemap_tab.PNG

 

Using the map object properties and RTView data attachments, the map object can be populated with marker objects at specific latitude/longitude positions, and also links between the markers. RTView drilldown and command operations can be triggered by clicks on the map object, as well as on its markers and links. Double-click, right-click and drillDownColumn substitutions are supported as on other RTView table-driven objects. Operations such as zoom, pan and marker selection can be tied to RTView variables.

The Thin Client must have internet access in order to download the Google Maps JavaScript API and map data. The Thin Client supports Google Maps in Internet Explorer version 9 or newer, and any other RTView-supported browsers (Firefox, Chrome, iOS Safari).

The Thin Client loads the Google Maps Javascript API to render and manipulate the map. In most cases a key or license must be obtained from Google for business use of the Google Maps Javascript API. For details, see the “Licensing” section.

Using Data Properties

To attach data to the map object, right-click in the Property Value field of the valueTable property and select Attach to Data. The valueTable property can be used to place markers (icons) on the map, at specific locations. The property must be attached to a table that contains one row for each marker. The column names are unimportant, but the column order and type must be as follows. The first three columns are required, the others are optional.

column 1 (string): The name.

column 2 (number): The latitude.

column 3 (number): The longitude.

column 4 (string): The icon name/path.

column 5 (integer): The icon height in pixels.

The marker name must be unique as it is used in drilldowns to indicate the selected ("clicked") marker, and can also be used to select a marker.

If column 4 (icon name) is omitted or empty, the default Google Maps marker is used. If column 5 (icon height) exists and its value is > 0, the value is used to center the icon on the marker's latitude/longitude position, otherwise the 0,0 pixel of the icon will be placed on the marker's latitude/longitude position.

Use the valueTableForLinks property to draw links between markers on the map. The property must be attached to a table that contains one row for each link, with the columns shown below. The column names are unimportant, but the column order and type must be as follows. The first 2 columns are required, the others are optional.

column 1 (string): The name of marker at start of link.

column 2 (string): The name of marker at end of link.

column 3 (string): The link line color, as a css color name or #rrggbb hex value.

column 4 (integer): The link line width.

column 5 (integer): The arrow mode.

The first two columns specify the names of the markers at the start and end of the link. These must correspond to the names of markers in the valueTable. If column 3 is omitted the link color is black. If column 4 is omitted the link width is 2 pixels. The arrow mode values are 1 (one arrow, pointing to start marker), 2 (one arrow, pointing to end marker) and 3 (two markers, at each end of link). If column 5 is omitted the default mode of 3 is used.

Using Interaction Properties

Use the command property to invoke behavior when the user clicks on the map, a marker, or a link.

The drillDownColumnSubs property is treated the same as for other table-driven objects. If a marker is clicked, the drillDownColumnSubs are set using values from the valueTable row that corresponds to that marker. If a link is clicked, the drillDownColumnSubs are set using values from the valueTableForLinks row that corresponds to that link. In addition, the following predefined substitutions are also set when a drilldown is executed:

§        $mapSelLat: The latitude of the map location or marker clicked.

§        $mapSelLng: The longitude of the map location or marker clicked.

§        $mapLat: The latitude of the map's current center location.

§        $mapLng: The longitude of the map's current center location.

§        $mapZoom: The current zoom level of the map, a value between 0 and 21.

The drillDownSelectMode property can be set to the following values:

§        Anywhere: A click anywhere on the map triggers the object's command or drilldown.

§        Markers: Only a click on a marker triggers the command or drilldown.

§        Links: Only a click on a link triggers the command or drilldown.

§        Markers & Links: Only a click on a marker or a link triggers the command or drilldown.

Using Map Properties

If the labelsZoomThreshold property is set to a value > 0 a label balloon appears next to each marker when the zoom level is greater than or equal to that value. The label text in the balloon is the name assigned to the marker, by the first column in the valueTable. A label can be closed by clicking its "x" button. The label reappears if the display is closed and reopened or if the zoom threshold is crossed again later. The default value of labelsZoomThreshold is zero which disables the labels.

The latitude property specifies the latitude of the point on which the map is to be centered. The longitude property specifies the longitude of the point on which the map is to be centered. The selectedMarker property specifies the name of the marker to select. The zoom property specifies the zoom level of the map, between 0 and 21.

The other properties supported by the map object but not listed here are common to all display objects, and have the same purpose and behavior as on the other display objects.

Licensing

Business use of the Google Maps Javascript API typically requires a key or license from Google. For more information, see the following: https://developers.google.com/maps/licensing

SL does not provide a key or license for the Google Maps Javascript API. However, the Thin Client can be configured to download the API using a custom URL that contains specific key or license information obtained from Google. The custom URL is defined by modifying the rtv_custom.js file contained in rtvdisplay.war. Refer to the “Customization” section for details about modifying rtvdisplay.war.

To specify a custom URL to download the Google Maps Javascript API, add the following line to rtv_custom.js:

rtv.customGoogleMapsApiBaseURL = 'url';

For example, to specify a URL containing a Google API key:

rtv.customGoogleMapsApiBaseURL = "https://maps.googleapis.com/maps/api/js?key=YOUR_GOOGLE_API_KEY";

Or, to specify a "Google Maps API for Work" client ID and release version 3.20:

rtv.customGoogleMapsApiBaseURL = "https://maps.googleapis.com/maps/api/js?client=YOUR_GOOGLE_CLIENT_ID&v=3.20";

If no rtv.customGoogleMapsApiBaseURL value is specified, the Thin Client uses the following public URL to download the latest "experimental" version of the API with no key or license information: https://maps.googleapis.com/maps/api/js.

Data Properties

Specify how data is displayed in the map object.

Property Name

Description

valueTable

Attach data to the map object using this property. The valueTable property can be used to place markers (icons) on the map, at specific locations. The property must be attached to a table that contains one row for each marker. The column names are unimportant, but the column order and type must be as follows. The first three columns are required, the others are optional.

column 1 (string): The name.

column 2 (number): The latitude.

column 3 (number): The longitude.

column 4 (string): The icon name/path.

column 5 (integer): The icon height in pixels.

 

The marker name must be unique as it is used in drilldowns to indicate the selected ("clicked") marker, and can also be used to select a marker.

If column 4 (icon name) is omitted or empty, the default Google Maps marker is used. If column 5 (icon height) exists and its value is > 0, the value is used to center the icon on the marker's latitude/longitude position, otherwise the 0,0 pixel of the icon will be placed on the marker's latitude/longitude position.

valueTableForLinks

This property can be used to draw links between markers on the map. The property must be attached to a table that contains one row for each link, with the columns shown below. The column names are unimportant, but the column order and type must be as follows. The first 2 columns are required, the others are optional.

column 1 (string): The name of marker at start of link.

column 2 (string): The name of marker at end of link.

column 3 (string): The link line color, as a css color name or #rrggbb hex value.

column 4 (integer): The link line width.

column 5 (integer): The arrow mode.

 

The first two columns specify the names of the markers at the start and end of the link. These must correspond to the names of markers in the valueTable. If column 3 is omitted the link color is black. If column 4 is omitted the link width is 2 pixels. The arrow mode values are 1 (one arrow, pointing to start marker), 2 (one arrow, pointing to end marker) and 3 (two markers, at each end of link). If column 5 is omitted the default mode of 3 is used.

Interaction Properties

Specify interactions in the map object.

Property Name

Description

command

Assign a command to your map object. See “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 ellipse_button00240.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownColumnSubs

Select the ellipse_button00241.gif 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: A click anywhere on the map triggers the object's command or drilldown.

§        Markers: Only a click on a marker triggers the command or drilldown.

§        Links: Only a click on a link triggers the command or drilldown.

§        Markers & Links: Only a click on a marker or a link triggers the command or drilldown.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

menuItemGroup

Use the menuItemGroup property to extend RTView context menu items. For details, see “Extending the Context Menu”.

Label Properties 

Specify the label in the map object.

Property Name

Description

label

Specifies the label string for the map placeholder object. This is visible only in the Builder. Edit label text directly in the Property Value field or select the ellipse_button00242.gif button to open the Edit Label dialog.

Map Properties

Specify the position, zoom level and label behavior in the map object.

Property Name

Description

labelsZoomThreshold

If the labelsZoomThreshold property is set to a value > 0 a label balloon appears next to each marker when the zoom level is greater than or equal to that value. The label text in the balloon is the name assigned to the marker, by the first column in the valueTable. A label can be closed by clicking its "x" button. The label reappears if the display is closed and reopened or if the zoom threshold is crossed again later. The default value of labelsZoomThreshold is zero which disables the labels.

latitude

The latitude of the point on which the map is to be centered.

longitude

The longitude of the point on which the map is to be centered.

selectedMarker

The name of the marker to select.

zoom

The zoom level of the map, between 0 and 21.

Object Properties

Specify the layout in the map object.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x-axis position of object.

objY

Set the y-axis position of object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

visFlag

Controls visibility of the object.

Indicator Objects

The Object Palette features four types of indicators:

“Indicator Objects - Discrete”

Supports 3 discrete comparisons.

bindicator_discrete.gif

 

“Indicator Objects - Limits”

Supports 2 high and 2 low thresholds.

bindicator_limits.gif

 

“Indicator Objects - Multi”

Supports an unlimited number of comparison values. For each comparison, you can specify whether the value property must be equal, not equal, greater than or less than the comparison value.

bindicator_multi.gif

 

“Indicator Objects - Panel”

Panel of 2 or 3 indicator lights. Each indicator light supports a discrete comparison.

bindicator_panel.gif

 

Image Property

Labels objects that feature the image property can be customized to display your image (.gif, .jpg, or .png) file. Click in the image Property Value field and type the name of the image. Or, select the ellipse_button00243.gif button to open the Select Image dialog containing up to three directories:  

        Current Directory - Contains images in the current directory and one level of subdirectories.

        Custom Image Library - If you have specified a custom image library, this directory contains those images. See Creating a Custom Image Library for details.

        Symbol Library - Contains symbolic images (for example, symbols for various types of hardware, shapes, lights, arrows, etc.).

Navigate to the image you want to use and select it. A preview of the image appears in the pane to the right. Click OK or Apply to set the image on your object. If an image is not listed, enter the name of the file, including the relative path.

To scale your image to the size of the object, check the imageScaleFlag. The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object.

Note: The sample display file general_objects.rtv (located in demos/tutorials) features information on working with objects from the General tab.

Creating a Custom Image Library 

The custom image library enables you to make your own images available in the Select Image dialog. To add your own image library, perform the following steps.

1.     Place your images .jar file and add it to the RTV_USERPATH environment variable. The images must be in a directory (not in the top level of the jar). They can be organized into subdirectories of one top level directory.

2.     In the Display Builder, select Tools/Builder Options and, in the Custom Image Library Path field, set the path to the directory containing your images .jar file.   

For example, if you have a jar with this directory structure:

 com/mycompany/Images

 com/mycompany/Images/Blue Images

 com/mycompany/Images/Red Images

 com/mycompany/Images/Green Images

With this directory structure, you would enter com/mycompany/Images. This adds a directory named Images to the tree in the Select Image dialog. The Images directory will have three subdirectories: Blue Images, Red Images, and Green Images. Only directories containing images are added to the Select Image dialog.

To access the images, you can edit any property that allows you to set an image on an object (for example, the image, barImage, and filterProperties properties), or edit the File>Background Properties>Image Name field.

 

Indicator Objects - Discrete

The Object Palette features three types of discrete indicators:

bindicator_discrete00244.gif

 

obj_ind_discrete

This is an indicator that allows you to set up to three comparison values (valueLowAlert, valueMediumAlert, and valueHighAlert). When the value equals one of the enabled comparisons, the color of the background and the background image will change to the color and image specified for that comparison.

2 Alert State Indicator

This is obj_ind_discrete configured to indicate two discrete alert states: valueHighAlert = 2 and valueLowAlert = 1. The valueQualityEnabledFlag is selected with valueQualityNoData = 1 and valueQualityLostData = 2. This object uses the image property instead of background colors. The label is positioned to the right of the indicator.

Boolean Indicator

This is obj_ind_discrete configured to show one discrete alert state: valueHighAlert = 0. The valueQualityEnabledFlag is selected with valueQualityNoData = 1 and valueQualityLostData = 2. This object uses the image property instead of background colors. The label is shown to the right of the indicator.

Using Interaction Properties

Commands

To assign a command to your indicator, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the indicator to activate the drill down. Drill down displays can be activated in the same window that contains the indicator or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Tool Tips

Select the mouseOverFlag to enable tool tips for your indicator. To display a tool tip, point to the indicator with your mouse. The tool tip will contain information from your data attachment.

Note: The property iconVisFlag must be selected in order to display tool tips.

Alert Properties

Property Name

Description

 

valueHighAlertEnabledFlag

Select to enable the valueHighAlert properties.

 

valueHighAlert

Enter the value that the value property must equal for the valueHighAlert properties to be applied. This may be a number or text.

 

valueHighAlertColor

Select the ellipse_button00245.gif button and choose a color from the palette to use for the background if value equals valueHighAlert.

 

valueHighAlertGradientColor2

Select the ellipse_button00246.gif button and choose a color from the palette to use for the second gradient color of the background if value equals valueHighAlert.

 

valueHighAlertImage

Select the image to display if value equals valueHighAlert.

valueLowAlertEnabledFlag

Select to enable the valueLowAlert properties.

 

valueLowAlert

Enter the value that the value property must equal for the valueLowAlert properties to be applied. This may be a number or text.

 

valueLowAlertColor

Select the ellipse_button00247.gif button and choose a color from the palette to use for the background if value equals valueLowAlert.

 

valueLowAlertGradientColor2

Select the ellipse_button00248.gif button and choose a color from the palette to use for the second gradient color of the background if value equals valueLowAlert.

 

valueLowAlertImage

Select the image to display if value equals valueLowAlert.

valueMediumAlertEnabledFlag

Select to enable the valueMediumAlert properties.

 

valueMediumAlert

Enter the value that the value property must equal for the valueMediumAlert properties to be applied. This may be a number or text.

 

valueMediumAlertColor

Select the ellipse_button00249.gif button and choose a color from the palette to use for the background if value equals valueMediumAlert.

 

valueMediumAlertGradientColor2

Select the ellipse_button00250.gif button and choose a color from the palette to use for the second gradient color of the background if value equals valueMediumAlert.

 

valueMediumAlertImage

Select the image to display if value equals valueMediumAlert.

Background Properties

Property Name

Description

bgBorderColor

Select the ellipse_button00251.gif button and choose from the palette to set the color of the edge on the background. This property is only applicable if bgBorderFlag is selected.

bgBorderFlag

If selected, a border is drawn around the background rectangle.

bgClipTextFlag

If selected, then the label and/or its valueString (whichever is drawn within the background rectangle) will be clipped by the object’s background rectangle. You might use this option if you have a very long label or valueString and do not want to have the label/valuestring extend past the edges of the rectangle.

Note: You must enable bgVisFlag for this option to work. 

For example, with bgClipTextFlag disabled and bgVisFlag enabled (and labelTextPosX set to Inside Left), your object and long text would look like this:

bgClipTextFlagIndicatorDisabled.gif

 

With both bgClipTextFlag and bgVisFlag enabled (and labelTextPosX set to Inside Left), the same object and long text would look like this:

bgClipTextFlagIndicatorEnabled.gif

 

If you want to view the full text/valueString, you can copy the full text/valueString into the Interaction> mouseOverText field to display the full string when hovering over the object. For example:

bgClipTextFlagIndiatorMouseOver.gif

 

Note: By default, this flag is unchecked and is only applicable when bgStyle is set to 0 (rectangle), 1 (3D Rectangle), or 2 (Round Rectangle).

bgColor

Select the ellipse_button00252.gif button and choose 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 ellipse_button00253.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient.

Note: This property will be ignored if bgGradientMode is set to None.

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.

Circle - Select to display a background circle.

Diamond - Select to display a background diamond.

bgVisFlag

Select to display the background.

Data Properties 

Property Name

Description

value

Attach your data. This value is compared to the enabled alert comparisons. This can be a number or a string.

valueDivisor

If specified and the value is a number, this divisor is applied to the value.

Data Format Properties

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value label. To enter a format, use syntax from the Java DecimalFormat class. This is only used if value is a number.

valueTextColor

Select the ellipse_button00254.gif button and choose from the palette to set the color of the value label.

valueTextFont

Select the font to use for the value label.

valueTextHeight

Specify the height for the value label.

valueTextPosX

Set x-axis position of value label. Select from the following options:

§        Left - Position outside the left side of the background.

§        Inside Left - Position inside the left side of the background.

§        Center - Position in the center of the background.

§        Inside Right - Position inside the right side of the background.

§        Right - Position outside the right side of the background.

valueTextPosY

Set y-axis position of value label. Select from the following options:

§        Outside Top - Position well above the background.

§        Top - Position just above the background.

§        Inside Top - Position inside the top of the background.

§        Center - Position in the center of the background.

§        Inside Bottom - Position inside the bottom of the background.

§        Bottom - Position just below the background.

§        Outside Bottom - Position well below the background.

valueVisFlag

Control visibility of the value label and related properties.

Image Properties

Property Name

Description

image

Specify an image to use in the background. This image will be used unless a comparison with an image is active. In that case, the comparison's image will be used instead.

imageAnimatedFlag

When selected, this property allows animated .gif images in the indicator object. If the object’s label string overlaps the animated image, you can modify the labelTextPosY and/or labelTextPosX properties to reposition the label.

Note: This feature is only supported in the Thin Client. In the builder/viewer, the animation will only update once every two seconds or after a mouse event.

imageScaleFlag

If selected, scale the image to the size of the background. Otherwise, the image is drawn at its original size.

Interaction Properties

Property Name

Description

command

Assign a command to your indicator. See “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 ellipse_button00255.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

Note: When drillDownSelectMode is set to Anywhere, double-clicking anywhere on the scale will activate the specified drillDownTarget; however, you must double-click on a trace in the scale to set the substitutions listed above.

mouseOverText

Enter a tool tip for this indicator. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nscale).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00256.gif button to open the Edit Label dialog.

labelTextColor

Select the ellipse_button00257.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label and related properties.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Value Quality Properties

Property Name

Description

valueQualityEnabledFlag

Select to enable the valueQuality properties:

 

valueQuality

Attach this value to data that indicates the quality of the data attached to value. This value must be a number.

 

valueQualityLostData

Enter a number that valueQuality will equal if the data has been lost.

 

valueQualityLostDataColor

Select the ellipse_button00258.gif button and choose a color from the palette to use for the background if valueQuality equals valueQualityLostData.

 

valueQualityLostDataGradientColor2

Select the ellipse_button00259.gif button and choose a color from the palette to use for the second color of the background gradient if valueQuality equals valueQualityLostData.

 

valueQualityLostDataImage

Select the image to display if valueQuality equals valueQualityLostData.

 

valueQualityNoData

Enter a number that valueQuality will equal if no data is available.

 

valueQualityNoDataColor

Select the ellipse_button00260.gif button and choose a color from the palette to use for the background if valueQuality equals valueQualityLostData.

 

valueQualityNoDataGradientColor2

Select the ellipse_button00261.gif button and choose a color from the palette to use for the second color of the background gradient if valueQuality equals valueQualityNoData.

 

valueQualityNoDataImage

Select the image to display if valueQuality equals valueQualityLostData.

Indicator Objects - Limits

The Object Palette features three types of limits indicators:

bindicator_limits00262.gif

 

obj_ind_limits

This is an indicator that allows you to set up to 4 comparison thresholds. When the value is greater than one of the high thresholds or less than one of the low thresholds, the color of the background and the background image will change to the color and image specified for that threshold.

High Value Indicator

This is obj_ind_limits configured to show two high thresholds (valueHighAlarm = 95, valueHighWarning = 75). The valueQualityEnabledFlag is selected with valueQualityNoData = 1 and valueQualityLostData = 2. This object uses images instead of background colors. The label is shown to the right of the indicator, and the value is shown to the left.

Low Value Indicator

This is obj_ind_limits configured to show two low thresholds (valueLowAlarm = 5, valueLowWarning = 15. The valueQualityEnabledFlag is selected with valueQualityNoData = 1 and valueQualityLostData = 2. This object uses images instead of background colors. The label is shown to the right of the indicator and the value is shown to the left.

Using Interaction Properties

Commands

To assign a command to your indicator, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the indicator to activate the drill down. Drill down displays can be activated in the same window that contains the indicator or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Tool Tips

Select the mouseOverFlag to enable tool tips for your indicator. To display a tool tip, point to the indicator with your mouse. The tool tip will contain information from your data attachment.

Note: The property iconVisFlag must be selected in order to display tool tips.

Alert Properties

Property Name

Description

 

valueHighAlarmEnabledFlag

Select to enable valueHighAlarm and related properties:

 

valueHighAlarm

Enter the value that the value property must be greater than for the valueHighAlarm properties to be applied. This must be a number.

 

valueHighAlarmColor

Select the ellipse_button00263.gif button and choose a color from the palette to use for the background if value is greater than valueHighAlarm.

 

valueHighAlertGradientColor2

Select the ellipse_button00264.gif button and choose a color from the palette to use for the second gradient color of the background if value is greater than valueHighAlarm.

 

valueHighAlarmImage

Select the image to display if value is greater than valueHighAlarm.

valueHighWarningEnabledFlag

Select to enable valueHighWarning and related properties:

 

valueHighWarning

Enter the value that the value property must be greater than for the valueHighWarning properties to be applied. This must be a number.

 

valueHighWarningColor

Select the ellipse_button00265.gif button and choose a color from the palette to use for the background if value is greater than valueHighWarning.

 

valueHighWarningGradientColor2

Select the ellipse_button00266.gif button and choose a color from the palette to use for the second gradient color of the background if value is greater than valueHighWarning.

 

valueHighWarningImage

Select the image to display if value is greater than valueHighWarning.

valueLowAlarmEnabledFlag

Select to enable valueLowAlarm and related properties:

 

valueLowAlarm

Enter the value that the value property must be less than for the valueLowAlarm properties to be applied. This must be a number.

 

valueLowAlarmColor

Select the ellipse_button00267.gif button and choose a color from the palette to use for the background if value is less than valueLowAlarm.

 

valueLowAlarmGradientColor2

Select the ellipse_button00268.gif button and choose a color from the palette to use for the second gradient color of the background if value is less than valueLowAlarm.

 

valueLowAlarmImage

Select the image to display if value is less than valueLowAlarm.

valueLowWarningEnabledFlag

Select to enable valueLowWarning and related properties:

 

valueLowWarning

Enter the value that the value property must be less than for the valueLowWarning properties to be applied. This must be a number.

 

valueLowWarningColor

Select the ellipse_button00269.gif button and choose a color from the palette to use for the background if value is less than valueLowWarning.

 

valueLowWarningGradientColor2

Select the ellipse_button00270.gif button and choose a color from the palette to use for the second gradient color of the background if value is less than valueLowWarning.

 

valueLowWarningImage

Select the image to display if value is less than valueLowWarning.

Background Properties 

Property Name

Description

bgBorderColor

Select the ellipse_button00271.gif button and choose from the palette to set the color of the edge on the background. This property is only applicable if bgBorderFlag is selected.

bgBorderFlag

If selected, a border is drawn around the background rectangle.

bgClipTextFlag

If selected, then the label and/or its valueString (whichever is drawn within the background rectangle) will be clipped by the object’s background rectangle. You might use this option if you have a very long label or valueString and do not want to have the label/valuestring extend past the edges of the rectangle.

Note: You must enable bgVisFlag for this option to work. 

For example, with bgClipTextFlag disabled and bgVisFlag enabled (and labelTextPosX set to Inside Left), your object and long text would look like this:

bgClipTextFlagIndicatorDisabled00272.gif

 

With both bgClipTextFlag and bgVisFlag enabled (and labelTextPosX set to Inside Left), the same object and long text would look like this:

bgClipTextFlagIndicatorEnabled00273.gif

 

If you want to view the full text/valueString, you can copy the full text/valueString into the Interaction> mouseOverText field to display the full string when hovering over the object. For example:

bgClipTextFlagIndiatorMouseOver00274.gif

 

Note: By default, this flag is unchecked and is only applicable when bgStyle is set to 0 (rectangle), 1 (3D Rectangle), or 2 (Round Rectangle).

bgColor

Select the ellipse_button00275.gif button and choose 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 ellipse_button00276.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient. 

Note: This property will be ignored if bgGradientMode is set to None.

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.

Circle - Select to display a background circle.

Diamond - Select to display a background diamond.

bgVisFlag

Select to display the background.

Data Properties 

Property Name

Description

value

Attach your data. This value is compared to the enabled alert thresholds. This must be a number.

valueDivisor

If specified, this divisor is applied to the value.

valueEqualTriggersThresholdFlag

If selected, the indicator changes color (or image) when the value is greater than or equal to the high thresholds (valueHighAlarm or valueHighWarning) or less than or equal to the low thresholds (valueLowAlarm or valueLowWarning).

If deselected, the indicator only changes when the value is greater than the high thresholds or less than the low thresholds.

Data Format Properties

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value label. To enter a format, use syntax from the Java DecimalFormat class.

valueTextColor

Select the ellipse_button00277.gif button and choose from the palette to set the color of the value label.

valueTextFont

Select the font to use for the value label.

valueTextHeight

Specify the height for the value label.

valueTextPosX

Set x-axis position of value label. Select from the following options:

§        Left - Position outside the left side of the background.

§        Inside Left - Position inside the left side of the background.

§        Center - Position in the center of the background.

§        Inside Right - Position inside the right side of the background.

§        Right - Position outside the right side of the background.

valueTextPosY

Set y-axis position of value label. Select from the following options:

§        Outside Top - Position well above the background.

§        Top - Position just above the background.

§        Inside Top - Position inside the top of the background.

§        Center - Position in the center of the background.

§        Inside Bottom - Position inside the bottom of the background.

§        Bottom - Position just below the background.

§        Outside Bottom - Position well below the background.

valueVisFlag

Control visibility of the value label and related properties.

Image Properties

Property Name

Description

image

Specify an image to use in the background. This image will be used unless a comparison with an image is active. In that case, the comparison's image will be used instead.

imageAnimatedFlag

When selected, this property allows animated .gif images in the indicator object. If the object’s label string overlaps the animated image, you can modify the labelTextPosY and/or labelTextPosX properties to reposition the label.

Note: This feature is only supported in the Thin Client. In the builder/viewer, the animation will only update once every two seconds or after a mouse event.

imageScaleFlag

If selected, scale the image to the size of the background. Otherwise, the image is drawn at its original size.

Interaction Properties

Property Name

Description

command

Assign a command to your indicator. See “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 ellipse_button00278.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays”for information.

Note: When drillDownSelectMode is set to Anywhere double-clicking anywhere on the scale will activate the specified drillDownTarget, however you must double-click on a trace in the scale to set the substitutions listed above.

mouseOverText

Enter a tool tip for this indicator. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nscale).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00279.gif button to open the Edit Label dialog.

labelTextColor

Select the ellipse_button00280.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label and related properties.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Value Quality Properties

Property Name

Description

valueQualityEnabledFlag

Select to enable the valueQuality properties:

 

valueQuality

Attach this value to data that indicates the quality of the data attached to value. This value must be a number.

 

valueQualityLostData

Enter a number that valueQuality will equal if the data has been lost.

 

valueQualityLostDataColor

Select the ellipse_button00281.gif button and choose a color from the palette to use for the background if valueQuality equals valueQualityLostData.

 

valueQualityLostDataGradientColor2

Select the ellipse_button00282.gif button and choose a color from the palette to use for the second color of the background gradient if valueQuality equals valueQualityLostData.

 

valueQualityLostDataImage

Select the image to display if valueQuality equals valueQualityLostData.

 

valueQualityNoData

Enter a number that valueQuality will equal if no data is available.

 

valueQualityNoDataColor

Select the ellipse_button00283.gif button and choose a color from the palette to use for the background if valueQuality equals valueQualityLostData.

 

valueQualityNoDataGradientColor2

Select the ellipse_button00284.gif button and choose a color from the palette to use for the second color of the background gradient if valueQuality equals valueQualityNoData.

 

valueQualityNoDataImage

Select the image to display if valueQuality equals valueQualityLostData.

Indicator Objects - Multi

The object obj_ind_multi is an indicator that allows you to enable an unlimited number of comparison values (Alert State 01, Alert State 02, etc.). When the value property meets one of the enabled Alert State conditions, then the background color and background image will change to the specified alertState* color and image.

bindicator_multi00285.gif

 

Note: When the value meets the conditions of more than one Alert State, then the properties of the highest Alert State are used (e.g. AlertState 02 is higher than AlertState 01).

Using Interaction Properties

Commands

To assign a command to your indicator, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the indicator to activate the drill down. Drill down displays can be activated in the same window that contains the indicator or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Tool Tips

Select the mouseOverFlag to enable tool tips for your indicator. To display a tool tip, point to the indicator with your mouse. The tool tip will contain information from your data attachment.

Note: The property iconVisFlag must be selected in order to display tool tips.

Alert Properties 

Property Name

Description

numAlertStates

Specify the number of Alert State comparisons to enable (Alert State 01, Alert State 02, etc.). The following alertState properties will be listed for each:

 

alertStateN

Enter a value (numeric or text) to compare to the value property for the alertStateN properties to be applied.

 

alertStateNColor

Select the ellipse_button00286.gif button and choose a color from the palette to use for the background if value and alertStateN meet alertStateNCondition.

 

alertStateNCondition

Comparison condition to use for this alert state. Select from the following:

Equal - The value must equal alertStateN for alertStateN properties to be applied

Not Equal - The value must not equal alertStateN for alertStateN properties to be applied

Greater Than - The value must be greater than alertStateN for alertStateN properties to be applied. Note: This option is only supported if value and alertStateN are both numeric values.

Less Than - The value must be less than alertStateN for alertStateN properties to be applied. Note: This option is only supported if value and alertStateN are both numeric values.

Greater Than or Equal To - The value must be greater than or equal to alertStateN for alertStateN properties to be applied. Note: This option is only supported if value and alertStateN are both numeric values.

Less Than or Equal To - The value must be less than or equal to alertStateN for alertStateN properties to be applied.   Note: This option is only supported if value and alertStateN are both numeric values.

 

alertStateNGradientColor2

Select the ellipse_button00287.gif button and choose a color from the palette to use for the second gradient color of the background if value and alertStateN meet alertStateNCondition.

 

alertStateNImage

Select the image to display if value and alertStateN meet alertStateNCondition.

Background Properties

Property Name

Description

bgBorderColor

Select the ellipse_button00288.gif button and choose from the palette to set the color of the edge on the background. This property is only applicable if bgBorderFlag is selected.

bgBorderFlag

If selected, a border is drawn around the background rectangle.

bgClipTextFlag

If selected, then the label and/or its valueString (whichever is drawn within the background rectangle) will be clipped by the object’s background rectangle. You might use this option if you have a very long label or valueString and do not want to have the label/valuestring extend past the edges of the rectangle.

Note: You must enable bgVisFlag for this option to work. 

For example, with bgClipTextFlag disabled and bgVisFlag enabled (and labelTextPosX set to Inside Left), your object and long text would look like this:

bgClipTextFlagIndicatorDisabled00289.gif

 

With both bgClipTextFlag and bgVisFlag enabled (and labelTextPosX set to Inside Left), the same object and long text would look like this:

bgClipTextFlagIndicatorEnabled00290.gif

 

If you want to view the full text/valueString, you can copy the full text/valueString into the Interaction> mouseOverText field to display the full string when hovering over the object. For example:

bgClipTextFlagIndiatorMouseOver00291.gif

 

Note: By default, this flag is unchecked and is only applicable when bgStyle is set to 0 (rectangle), 1 (3D Rectangle), or 2 (Round Rectangle).

bgColor

Select the ellipse_button00292.gif button and choose 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 ellipse_button00293.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient. 

Note: This property will be ignored if bgGradientMode is set to None.

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.

Circle - Select to display a background circle.

Diamond - Select to display a background diamond.

bgVisFlag

Select to display the background and related properties.

Data Properties 

Property Name

Description

value

Attach your data (numeric or string). This data is compared to all specified alertState* values.

valueDivisor

If the specified value is numeric, then this divisor is applied.

Data Format Properties

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value label. To enter a format, use syntax from the Java DecimalFormat class. This is only used if value is a number.

valueTextColor

Select the ellipse_button00294.gif button and choose from the palette to set the color of the value label.

valueTextFont

Select the font to use for the value label.

valueTextHeight

Specify the height for the value label.

valueTextPosX

Set x-axis position of value label. Select from the following options:

§        Left - Position outside the left side of the background.

§        Inside Left - Position inside the left side of the background.

§        Center - Position in the center of the background.

§        Inside Right - Position inside the right side of the background.

§        Right - Position outside the right side of the background.

valueTextPosY

Set y-axis position of value label. Select from the following options:

§        Outside Top - Position well above the background.

§        Top - Position just above the background.

§        Inside Top - Position inside the top of the background.

§        Center - Position in the center of the background.

§        Inside Bottom - Position inside the bottom of the background.

§        Bottom - Position just below the background.

§        Outside Bottom - Position well below the background.

valueVisFlag

Control visibility of the value label and related properties.

Image Properties 

Property Name

Description

image

Specify an image to use in the background. This image will be used unless a comparison with an image is active. In that case, the comparison's image will be used instead.

imageAnimatedFlag

When selected, this property allows animated .gif images in the indicator object. If the object’s label string overlaps the animated image, you can modify the labelTextPosY and/or labelTextPosX properties to reposition the label.

Note: This feature is only supported in the Thin Client. In the builder/viewer, the animation will only update once every two seconds or after a mouse event.

imageScaleFlag

If selected, scale the image to the size of the background. Otherwise, the image is drawn at its original size.

Interaction Properties 

Property Name

Description

command

Assign a command to your indicator. See “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 ellipse_button00295.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

Note: When drillDownSelectMode is set to Anywhere double-clicking anywhere on the scale will activate the specified drillDownTarget, however you must double-click on a trace in the scale to set the substitutions listed above.

mouseOverText

Enter a tool tip for this indicator. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nscale).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties   

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00296.gif button to open the Edit Label dialog.

labelTextColor

Select the ellipse_button00297.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label and related properties.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Value Quality Properties   

Property Name

Description

valueQualityEnabledFlag

Select to enable the valueQuality properties:

 

valueQuality

Attach this value to data that indicates the quality of the data attached to value. This value must be a number.

 

valueQualityLostData

Enter a number that valueQuality will equal if the data has been lost.

 

valueQualityLostDataColor

Select the ellipse_button00298.gif button and choose a color from the palette to use for the background if valueQuality equals valueQualityLostData.

 

valueQualityLostDataGradientColor2

Select the ellipse_button00299.gif button and choose a color from the palette to use for the second color of the background gradient if valueQuality equals valueQualityLostData.

 

valueQualityLostDataImage

Select the image to display if valueQuality equals valueQualityLostData.

 

valueQualityNoData

Enter a number that valueQuality will equal if no data is available.

 

valueQualityNoDataColor

Select the ellipse_button00300.gif button and choose a color from the palette to use for the background if valueQuality equals valueQualityLostData.

 

valueQualityNoDataGradientColor2

Select the ellipse_button00301.gif button and choose a color from the palette to use for the second color of the background gradient if valueQuality equals valueQualityNoData.

 

valueQualityNoDataImage

Select the image to display if valueQuality equals valueQualityLostData.

Indicator Objects - Panel

The Object Palette features two panel indicators:

bindicator_panel00302.gif

obj_ind_panel

This is an indicator that allows you to set up to 3 comparison values (indicator1,   indicator2 and indicator3). When the value equals one of the enabled comparisons, the color of the corresponding indicator in the panel will change to the color and image specified for that comparison.

Using Interaction Properties

Commands

To assign a command to your indicator, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the indicator to activate the drill down. Drill down displays can be activated in the same window that contains the indicator or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Tool Tips

Select the mouseOverFlag to enable tool tips for your indicator. To display a tool tip, point to the indicator with your mouse. The tool tip will contain information from your data attachment.

Note: The property iconVisFlag must be selected in order to display tool tips.

Alert Properties

Property Name

Description

indicator1

Enter the value that the value property must equal for the indicator1 properties to be applied. This may be a number or text.

indicator1Color

Select the ellipse_button00303.gif button and choose a color from the palette to use for the indicator if value equals indicator1.

indicator1GradientColor2

Select the ellipse_button00304.gif button and choose a color from the palette to use for the second gradient color of the indicator if value equals indicator1.

indicator1VisFlag

Controls visibility of indicator1 and related object properties.

indicator2

Enter the value that the value property must equal for the indicator2 properties to be applied. This may be a number or text.

indicator2Color

Select the ellipse_button00305.gif button and choose a color from the palette to use for the indicator if value equals indicator2.

indicator2GradientColor2

Select the ellipse_button00306.gif button and choose a color from the palette to use for the second gradient color of the indicator if value equals indicator2.

indicator2VisFlag

Controls visibility of indicator2 and related object properties.

indicator3

Enter the value that the value property must equal for the indicator3 properties to be applied. This may be a number or text.

indicator3Color

Select the ellipse_button00307.gif button and choose a color from the palette to use for the indicator if value equals indicator3.

indicator3GradientColor2

Select the ellipse_button00308.gif button and choose a color from the palette to use for the second gradient color of the indicator if value equals indicator3.

indicator3VisFlag

Controls visibility of indicator3 and related object properties.

Background Properties 

Property Name

Description

bgBorderColor

Select the ellipse_button00309.gif button and choose from the palette to set the color of the edge on the background. This property is only applicable if bgBorderFlag is selected.

bgBorderFlag

If selected, a border is drawn around the background rectangle.

bgColor

Select the ellipse_button00310.gif button and choose 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 ellipse_button00311.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient. 

Note: This property will be ignored if bgGradientMode is set to None.

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.

borderPixels

The number of pixels between the edge of the background and the indicators.

Data Properties

Property Name

Description

value

Attach your data. This value is compared to the enabled indicators. This can be a number or a string.

valueDivisor

If specified and the value is a number, this divisor is applied to the value.

Interaction Properties

Property Name

Description

command

Assign a command to your indicator. See “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 ellipse_button00312.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

Note: When drillDownSelectMode is set to Anywhere double-clicking anywhere on the scale will activate the specified drillDownTarget, however you must double-click on a trace in the scale to set the substitutions listed above.

mouseOverText

Enter a tool tip for this indicator. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nscale).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00313.gif button to open the Edit Label dialog.

labelTextColor

Select the ellipse_button00314.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Value Quality Properties

Property Name

Description

valueQualityEnabledFlag

Select to enable the valueQuality properties:

 

valueQuality

Attach this value to data that indicates the quality of the data attached to value. This value must be a number.

 

valueQualityLostData

Enter a number that valueQuality will equal if the data has been lost.

 

valueQualityLostDataColor

Select the ellipse_button00315.gif button and choose a color from the palette to use for the background if valueQuality equals valueQualityLostData.

 

valueQualityLostDataGradientColor2

Select the ellipse_button00316.gif button and choose a color from the palette to use for the second color of the background gradient if valueQuality equals valueQualityLostData.

 

valueQualityNoData

Enter a number that valueQuality will equal if no data is available.

 

valueQualityNoDataColor

Select the ellipse_button00317.gif button and choose a color from the palette to use for the background if valueQuality equals valueQualityLostData.

 

valueQualityNoDataGradientColor2

Select the ellipse_button00318.gif button and choose a color from the palette to use for the second color of the background gradient if valueQuality equals valueQualityNoData.

Labels Objects

“Value Labels”

The value and label properties are used, respectively, to display numeric and text data, either from a data attachment or static values.

Value Labels that feature Alert properties can be designed to change color according to numeric values from your data attachment.

label_v_rect.gif

 

label_v.gif

 

“Vu Labels”

Similar to Value Labels, Vu Labels contain the value and label properties as well as featuring vu meters to display numeric values from your data attachment.

label_vu.gif

 

“ValueString Labels”

The valueString and label properties are both used to display text data, either from a data attachment or static values.

label_vs_rect.gif

 

label_vs.gif

 

“Text Only Label” / “ValueString Only Label”

The Text Only Label can be rotated at any angle and is limited to a static value.

The ValueString Only Label can display text data, either from a data attachment or a static value.

label_text_vs.gif

 

Image Property

Labels objects that feature the image property can be customized to display your image (.gif, .jpg, or .png) file. Click in the image Property Value field and type the name of the image. Or, select the ellipse_button00319.gif button to open the Select Image dialog containing up to three directories:  

        Current Directory - Contains images in the current directory and one level of subdirectories.

        Custom Image Library - If you have specified a custom image library, this directory contains those images. See Creating a Custom Image Library for details.

        Symbol Library - Contains symbolic images (for example, symbols for various types of hardware, shapes, lights, arrows, etc.).

Navigate to the image you want to use and select it. A preview of the image appears in the pane to the right. Click OK or Apply to set the image on your object. If an image is not listed, enter the name of the file, including the relative path.

To scale your image to the size of the object, check the imageScaleFlag. The visFlag property controls the visibility of the object. The transparencyPercent property controls the transparency of the object.

Note: The sample display file general_objects.rtv (located in demos/tutorials) features information on working with objects from the General tab.

Creating a Custom Image Library 

The custom image library enables you to make your own images available in the Select Image dialog. To add your own image library, perform the following steps.

1.     Place your images .jar file and add it to the RTV_USERPATH environment variable. The images must be in a directory (not in the top level of the jar). They can be organized into subdirectories of one top level directory.

2.     In the Display Builder, select Tools/Builder Options and, in the Custom Image Library Path field, set the path to the directory containing your images .jar file.   

For example, if you have a jar with this directory structure:

 com/mycompany/Images

 com/mycompany/Images/Blue Images

 com/mycompany/Images/Red Images

 com/mycompany/Images/Green Images

With this directory structure, you would enter com/mycompany/Images. This adds a directory named Images to the tree in the Select Image dialog. The Images directory will have three subdirectories: Blue Images, Red Images, and Green Images. Only directories containing images are added to the Select Image dialog.

To access the images, you can edit any property that allows you to set an image on an object (for example, the image, barImage, and filterProperties properties), or edit the File>Background Properties>Image Name field.

 

Value Labels

label_v_rect00320.gif

 

label_v00321.gif

 

Using Interaction Properties

Commands

To assign a command to your label, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the label to activate the drill down. Drill down displays can be activated in the same window that contains the label or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Tool Tips

Select the mouseOverFlag to enable tool tips for your label. To display a tool tip, point to the label with your mouse. The tool tip will contain information from your data attachment.

Alert Properties 

Note: Not all Value Labels feature Alert Properties.

Property Name

Description

valueHighAlarmEnabledFlag

Select to enable the high alarm and set the following related properties:

 

valueHighAlarm

Specify the minimum value for the High Alarm.

 

valueHighAlarmColor

Select the ellipse_button00322.gif button and choose from the palette to set the color of the High Alarm.

valueHighWarningEnabledFlag

Select to enable the high alarm and set the following related properties:

 

valueHighWarning

Specify the minimum value for the High Warning.

 

valueHighWarningColor

Select the ellipse_button00323.gif button and choose from the palette to set the color of High Warning.

Background Properties 

Property Name

Description

bgBorderColor

Select the ellipse_button00324.gif button and choose a color from the palette to set the color of the edge on the background rectangle.

Note: This property is only applicable if bgBorderFlag is selected.

bgBorderFlag

If selected, a border is drawn around the background rectangle.

bgClipTextFlag

If selected, then the label and/or its valueString (whichever is drawn within the background rectangle) will be clipped by the object’s background rectangle. You might use this option if you have a very long label or valueString and do not want to have the label/valuestring extend past the edges of the rectangle.

Note: You must enable bgVisFlag for this option to work. 

For example, with bgClipTextFlag disabled and bgVisFlag enabled (and labelTextPosX set to Inside Left), your object and long text would look like this:

bgClipTextFlagDisabled.gif

 

With both bgClipTextFlag and bgVisFlag enabled (and labelTextPosX set to Inside Left), the same object and long text would look like this:

bgClipTextFlagEnabled.gif

 

If you want to view the full text/valueString, you can copy the full text/valueString into the Interaction> mouseOverText field to display the full string when hovering over the object. For example:

bgClipTextFlagMouseOver.gif

 

Note: By default, this flag is unchecked and is only applicable for obj_rect_il, obj_rect_ilv, and obj_rect_ilvs.

bgColor

Select the ellipse_button00325.gif 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.

Note: This property is only available if the bgStyle selected is 3D Rectangle.

bgGradientColor2

Select the ellipse_button00326.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient. 

Note: This property will be ignored if bgGradientMode is set to None.

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.

Note: 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

Controls visibility of background.

Note: This property only applies to obj_rect_ilv.

Data Properties 

Property Name

Description

value

Attach your data.

valueDivisor

If specified, this divisor is applied to the value.

Data Format Properties 

Note: Not all Data Format Properties apply to all Value Labels.

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value text. To enter a format, use syntax from the Java Decimal Format class.

valueTextAlignX

Set the position of value text on the x-axis. Select from the following options:

§        Left

§        Center

§        Right

valueTextAlignY

Set the position of value text on the y-axis. Select from the following options:

§        Inside Top

§        Center

§        Inside Bottom

valueTextColor

Select the ellipse_button00327.gif button and choose from the palette to set the color of the value text. 

valueTextFont

Select the font to use for the value text.

valueTextHeight

Specify (in pixels) the height for the value text.

valueTextPosX

Set x-axis position of value text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

valueTextPosY

Set y-axis position of value text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

valueVisFlag

Control visibility of the value.

Image Properties 

Property Name

Description

image

Enter the name of an image or click on the ellipse_button00328.gif button to open the Select Image dialog. See “Labels Objects” for more information.

Note: This property only applies to obj_rect_ilv.

imageAnimatedFlag

When selected, this property allows animated .gif images in the label object. If the object’s label string overlaps the animated image, you can modify the labelTextPosY and/or labelTextPosX properties to reposition the label.

Note: This property only applies to the Thin Client and only applies to obj_rect_il. In the builder/viewer, the animation will only update once every two seconds or after a mouse event.

imageScaleFlag

Select to scale your image to the size of the object.

Note: This property only applies to obj_rect_ilv.

Interaction Properties 

Property Name

Description

command

Assign a command to your vu label. See “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 ellipse_button00329.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used. 

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

mouseOverText

Enter a tool tip for this label. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nlabel).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties

Note: Not all Label Properties apply to all Value Labels.

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00330.gif button to open the Edit Label dialog.

labelBgColor

Select the ellipse_button00331.gif button and choose a color from the palette to set the background color.

labelBgGradientColor2

Select the ellipse_button00332.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient. 

Note: This property will be ignored if bgGradientMode is set to None.

labelBgGradientMode

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.

labelMinTabWidth

Specify minimum width of the label tab.

Note: This property only applies if labelTextPosY is set to Tab Top.

labelTextAlignX

Set the position of label text on the x-axis. Select from the following options:

§        Left

§        Center

§        Right

labelTextAlignY

Set the position of label text on the y-axis. Select from the following options:

§        Inside Top

§        Center

§        Inside Bottom

labelTextColor

Select the ellipse_button00333.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Tab Top - Position tab just above the background rectangle.

Note: Height and width of the label tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

§        Title Top - Position along the top line of the background rectangle.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label.

labelWidth

Set the width (in pixels) of the background area of the label text.

Note: This property only applies to obj_label11.

labelWordWrapMode

Text will be wrapped to fit the width of the object depending on the mode selected. Default is None.

Space - Whenever possible, only add line breaks at whitespaces. If a single word is longer than the object is wide, the line break will be added to the word so that the text fits within the width of the object.

Space and Punctuation - Whenever possible, only add line breaks at whitespaces and punctuation characters. Supported punctuation characters are: comma(,), period(.), semi-colon(;), colon (:), hyphen(-), question mark(?), asterisk(*), ampersand(&), greater than(<), less than(>), backslash(\), forward slash(/), pipe(|), plus(+), exclamation point(!), and at(@).

If a single word is longer than the object is wide and none of these characters is in the word, the line break will be added to the word so that the text fits within the width of the object.

Note: The labelWordWrapMode property is ignored, and text will not be wrapped, if:

§        labelTextPosX is set to Outside Right or Outside Left

§        labelTextPosY is set to Tab Top or Title Top.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Vu Labels

label_vu00334.gif

 

Using Interaction Properties

Commands

To assign a command to your label, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the label to activate the drill down. Drill down displays can be activated in the same window that contains the label or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Tool Tips

Select the mouseOverFlag to enable tool tips for your label. To display a tool tip, point to the label with your mouse. The tool tip will contain information from your data attachment.

Alert Properties 

Property Name

Description

valueHighAlarm

Specify the minimum value for the High Alarm range.

valueHighAlarmColor

Select the ellipse_button00335.gif button and choose from the palette to set the color of the High Alarm.

valueHighWarning

Specify the minimum value for the High Warning range.

valueHighWarningColor

Select the ellipse_button00336.gif button and choose from the palette to set the color of High Warning.

valueNoAlarmColor

Select the ellipse_button00337.gif button and choose from the palette to set the color of the No Alarm.

Background Properties 

Property Name

Description

bgBorderColor

Select the ellipse_button00338.gif button and choose a color from the palette to set the color of the edge on the background rectangle. 

Note: This property is only applicable if bgBorderFlag is selected.

bgBorderFlag

If selected, a border is drawn around the background rectangle.

bgColor

Select the ellipse_button00339.gif 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.

Note: This property is only available if the bgStyle selected is 3D Rectangle.

bgGradientColor2

Select the ellipse_button00340.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient.

Note: This property will be ignored if bgGradientMode is set to None.

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.

Note: 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.

Data Properties 

Property Name

Description

value

Attach your data.

valueDivisor

If specified, this divisor is applied to the value, valueMin, and valueMax.

valueMax

Set the maximum range for the label. This value must be larger than valueMin.

valueMin

Set the minimum range for the label. This value must be smaller than valueMax.

Data Format Properties 

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value text. To enter a format, use syntax from the Java DecimalFormat class.

valueTextAlignX

Set the position of value text on the x-axis. Select from the following options:

§        Left

§        Center

§        Right

valueTextAlignY

Set the position of value text on the y-axis. Select from the following options:

§        Inside Top

§        Center

§        Inside Bottom

valueTextColor

Select the ellipse_button00341.gif button and choose from the palette to set the color of the value text.

valueTextFont

Select the font to use for the value text.

valueTextHeight

Specify (in pixels) the height for the value text.

vuMeterMinWidth

Set (in pixels) the minimum width of the vu meter.

Interaction Properties 

Property Name

Description

command

Assign a command to your vu label. 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 ellipse_button00342.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

mouseOverText

Enter a tool tip for this label. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nlabel).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00343.gif button to open the Edit Label dialog.

labelBgColor

Select the ellipse_button00344.gif button and choose a color from the palette to set the background color.

labelBgGradientColor2

Select the ellipse_button00345.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient. 

Note: This property will be ignored if bgGradientMode is set to None.

labelBgGradientMode

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.

labelTextAlignX

Set the position of label text on the x-axis. Select from the following options:

§        Left

§        Center

§        Right

labelTextAlignY

Set the position of label text on the y-axis. Select from the following options:

§        Inside Top

§        Center

§        Inside Bottom

labelTextColor

Select the ellipse_button00346.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelWidth

Set the width (in pixels) of the background area of the label text.

Note: This property only applies to obj_vulabel02.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

ValueString Labels

label_vs_rect00347.gif

 

label_vs00348.gif

 

Using Interaction Properties

Commands

To assign a command to your label, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the label to activate the drill down. Drill down displays can be activated in the same window that contains the label or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Tool Tips

Select the mouseOverFlag to enable tool tips for your label. To display a tool tip, point to the label with your mouse. The tool tip will contain information from your data attachment.

Background Properties 

Property Name

Description

bgBorderColor

Select the ellipse_button00349.gif button and choose a color from the palette to set the color of the edge on the background rectangle. 

Note: This property is only applicable if bgBorderFlag is selected.

bgBorderFlag

If selected, a border is drawn around the background rectangle.

bgClipTextFlag

If selected, then the label and/or its valueString (whichever is drawn within the background rectangle) will be clipped by the object’s background rectangle. You might use this option if you have a very long label or valueString and do not want to have the label/valuestring extend past the edges of the rectangle.

Note: You must enable bgVisFlag for this option to work. 

For example, with bgClipTextFlag disabled and bgVisFlag enabled (and labelTextPosX set to Inside Left), your object and long text would look like this:

bgClipTextFlagDisabled00350.gif

 

With both bgClipTextFlag and bgVisFlag enabled (and labelTextPosX set to Inside Left), the same object and long text would look like this:

bgClipTextFlagEnabled00351.gif

 

If you want to view the full text/valueString, you can copy the full text/valueString into the Interaction> mouseOverText field to display the full string when hovering over the object. For example:

bgClipTextFlagMouseOver00352.gif

 

Note: By default, this flag is unchecked and is only applicable for obj_rect_il, obj_rect_ilv, and obj_rect_ilvs.

bgColor

Select the ellipse_button00353.gif 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.

Note: This property is only available if the bgStyle selected is 3D Rectangle.

bgGradientColor2

Select the ellipse_button00354.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient.

Note: This property will be ignored if bgGradientMode is set to None.

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.

Note: 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

Controls visibility of background.

Note: This property only applies to obj_rect_ilvs.

Data Properties 

Property Name

Description

valueString

Attach your data.

Data Format Properties 

Note: Not all Data Format Properties apply to all Value String Labels.

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value text. To enter a format, use syntax from the Java DecimalFormat class.

Note: This property only applies to obj_rect_ilvs.

valueTextAlignX

Set the position of value text on the x-axis. Select from the following options:

§        Left

§        Center

§        Right

valueTextAlignY

Set the position of value text on the y-axis. Select from the following options:

§        Inside Top

§        Center

§        Inside Bottom

valueTextColor

Select the ellipse_button00355.gif button and choose from the palette to set the color of the value text.

valueTextFont

Select the font to use for the value text.

valueTextHeight

Specify (in pixels) the height for the value text.

valueTextPosX

Set x-axis position of value text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

valueTextPosY

Set y-axis position of value text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

valueVisFlag

Control visibility of the value text.

valueWordWrapMode

Value text will be wrapped to fit the width of the object depending on the mode selected. Default is None.

Space - Whenever possible, only add line breaks at whitespaces. If a single word is longer than the object is wide, the line break will be added to the word so that the text fits within the width of the object.

Space and Punctuation - Whenever possible, only add line breaks at whitespaces and punctuation characters. Supported punctuation characters are: comma(,), period(.), semi-colon(;), colon (:), hyphen(-), question mark(?), asterisk(*), ampersand(&), greater than(<), less than(>), backslash(\), forward slash(/), pipe(|), plus(+), exclamation point(!), and at(@).

If a single word is longer than the object is wide and none of these characters is in the word, the line break will be added to the word so that the text fits within the width of the object.

Note: The valueWordWrapMode property is ignored, and text will not be wrapped, if valueTextPosX is set to Left or Right.

Image Properties

Property Name

Description

image

Enter the name of an image or click on the ellipse_button00356.gif button to open the Select Image dialog. See “Labels Objects” for more information.

Note: This property only applies to obj_rect_ilvs.

imageScaleFlag

Select to scale your image to the size of the object.

Note: This property only applies to obj_rect_ilvs.

Interaction Properties 

Property Name

Description

command

Assign a command to your vu label. See “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 ellipse_button00357.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

mouseOverText

Enter a tool tip for this label. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nlabel).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties

Note: Not all Label Properties apply to all Value String Labels.

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00358.gif button to open the Edit Label dialog.

labelBgColor

Select the ellipse_button00359.gif button and choose a color from the palette to set the background color.

labelBgGradientColor2

Select the ellipse_button00360.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient. 

Note: This property will be ignored if bgGradientMode is set to None.

labelBgGradientMode

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.

labelMinTabWidth

Specify minimum width of the label tab.

Note: This property only applies if labelTextPosY is set to Tab Top.

labelTextAlignX

Set the position of label text on the x-axis. Select from the following options:

§        Left

§        Center

§        Right

labelTextAlignY

Set the position of label text on the y-axis. Select from the following options:

§        Inside Top

§        Center

§        Inside Bottom

labelTextColor

Select the ellipse_button00361.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Tab Top - Position tab just above the background rectangle.

Note: Height and width of the label tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

§        Title Top - Position along the top line of the background rectangle.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label.

labelWidth

Set the width (in pixels) of the background area of the label text.

Note: This property only applies to obj_label11s.

labelWordWrapMode

Text will be wrapped to fit the width of the object depending on the mode selected. Default is None.

Space - Whenever possible, only add line breaks at whitespaces. If a single word is longer than the object is wide, the line break will be added to the word so that the text fits within the width of the object.

Space and Punctuation - Whenever possible, only add line breaks at whitespaces and punctuation characters. Supported punctuation characters are: comma(,), period(.), semi-colon(;), colon (:), hyphen(-), question mark(?), asterisk(*), ampersand(&), greater than(<), less than(>), backslash(\), forward slash(/), pipe(|), plus(+), exclamation point(!), and at(@).

If a single word is longer than the object is wide and none of these characters is in the word, the line break will be added to the word so that the text fits within the width of the object.

Note: The labelWordWrapMode property is ignored, and text will not be wrapped, if:

§        labelTextPosX is set to Outside Right or Outside Left

§        labelTextPosY is set to Tab or Title.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Text Only Label

label_to.gif

 

Using Interaction Properties

Commands

To assign a command to your label, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the label to activate the drill down. Drill down displays can be activated in the same window that contains the label or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Interaction Properties 

Property Name

Description

command

Assign a command to your vu label. See “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 ellipse_button00362.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used. 

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays”for information.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00363.gif button to open the Edit Label dialog.

labelTextAlignX

Set the position of label text on the x-axis. Select from the following options:

§        Left

§        Center

§        Right

labelTextAlignY

Set the position of label text on the y-axis. Select from the following options:

§        Inside Top

§        Center

§        Inside Bottom

labelTextColor

Select the ellipse_button00364.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

rotationAngle

Set the angle at which the label text will be rotated.

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.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used. See “Style Sheets” for more information.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

ValueString Only Label

label_vso.gif

 

Using Interaction Properties

Commands

To assign a command to your label, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the label to activate the drill down. Drill down displays can be activated in the same window that contains the label or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Tool Tips

Select the mouseOverFlag to enable tool tips for your label. To display a tool tip, point to the label with your mouse. The tool tip will contain information from your data attachment.

Background Properties 

Property Name

Description

bgBorderColor

Select the ellipse_button00365.gif button and choose a color from the palette to set the color of the edge on the background rectangle.

Note: This property is only applicable if bgBorderFlag is selected.

bgBorderFlag

If selected, a border is drawn around the background rectangle.

bgClipTextFlag

If selected, then the label and/or its valueString (whichever is drawn within the background rectangle) will be clipped by the object’s background rectangle. You might use this option if you have a very long label or valueString and do not want to have the label/valuestring extend past the edges of the rectangle.

Note: You must enable bgVisFlag for this option to work. 

For example, with bgClipTextFlag disabled and bgVisFlag enabled (and labelTextPosX set to Inside Left), your object and long text would look like this:

bgClipTextFlagDisabled00366.gif

 

With both bgClipTextFlag and bgVisFlag enabled (and labelTextPosX set to Inside Left), the same object and long text would look like this:

bgClipTextFlagEnabled00367.gif

 

If you want to view the full text/valueString, you can copy the full text/valueString into the Interaction> mouseOverText field to display the full string when hovering over the object. For example:

bgClipTextFlagMouseOver00368.gif

 

Note: This property is only applicable for obj_rect_ilvs.

bgColor

Select the ellipse_button00369.gif 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.

Note: This property is only available if the bgStyle selected is 3D Rectangle.

bgGradientColor2

Select the ellipse_button00370.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient.

Note: This property will be ignored if bgGradientMode is set to None.

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.

Note: 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

Controls visibility of background.

Image Properties 

Property Name

Description

image

Enter the name of an image or click on the ellipse_button00371.gif button to open the Select Image dialog.

imageScaleFlag

Select to scale your image to the size of the object.

Interaction Properties

Property Name

Description

command

Assign a command to your vu label. See “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 ellipse_button00372.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used. 

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

mouseOverText

Enter a tool tip for this label. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nlabel).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00373.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab.

Note: This property only applies if labelTextPosY is set to Tab Top.

labelTextColor

Select the ellipse_button00374.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Tab Top - Position tab just above the background rectangle.

Note: Height and width of the label tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

§        Title Top - Position along the top line of the background rectangle.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label.

labelWordWrapMode

Text will be wrapped to fit the width of the object depending on the mode selected. Default is None.

Space - Whenever possible, only add line breaks at whitespaces. If a single word is longer than the object is wide, the line break will be added to the word so that the text fits within the width of the object.

Space and Punctuation - Whenever possible, only add line breaks at whitespaces and punctuation characters. Supported punctuation characters are: comma(,), period(.), semi-colon(;), colon (:), hyphen(-), question mark(?), asterisk(*), ampersand(&), greater than(<), less than(>), backslash(\), forward slash(/), pipe(|), plus(+), exclamation point(!), and at(@).

If a single word is longer than the object is wide and none of these characters is in the word, the line break will be added to the word so that the text fits within the width of the object.

Note: The labelWordWrapMode property is ignored, and text will not be wrapped, if:

§        labelTextPosX is set to Outside Right or Outside Left

§        labelTextPosY is set to Tab Top or Title Top.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Link Objects

The Object Palette features three links, each offers a different way to display the connection between two linked objects. These three links share the same class name (link_basic) and their properties are identical. Once two objects are linked in a display, you may switch between these three link types by modifying the linkPathType property.

Direct

Draws a straight line between the objects it connects.

blinks_direct.gif

 

Direct Offset

Attaches to the object at a right angle, but draws a diagonal line for the remainder of the link.

blinks_offset.gif

 

Orthogonal

Draws a line at right angles between the objects it connects.

blinks_ortho.gif

 

Using Interaction Properties

Commands

To assign a command to your link, 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 “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. Any display (.rtv) file can be targeted as a drill down. Once a drill down target has been set, double-click on the link to activate the drill down. Drill down displays can be activated in the same window that contains the link or open in a separate window. This allows you to build a customizable hierarchy of displays. See “Drill Down Displays” for more information.

Tool Tips

Select the mouseOverFlag to enable tool tips for your link. To display a tool tip, point to the link with your mouse. The tool tip will contain information from your data attachment.

Note: The property iconVisFlag must be selected in order to display tool tips.

Alert Properties

Property Name

Description

valueAlertMode

Discrete Alerts

Color of the link will change when the value property equals the specified value*Alert.

 

 

 

valueHighAlert -- Specify the value that the input value must be equal to for the high alert to execute.

valueHighAlertColor -- Select the ellipse_button00375.gif button and choose a color for the high alert.

valueLowAlert -- Specify the value that the input value must be equal to for the low alert to execute.

valueLowAlertColor -- Select the ellipse_button00376.gif button and choose a color for the low alert.

valueMediumAlert -- Specify the value that the input value must be equal to for the medium alert to execute.

valueMediumAlertColor -- Select the ellipse_button00377.gif button and choose a color for the medium alert.

valueNoAlert -- Specify the value that the input value must be equal to for the no alert to execute.

valueNoAlertColor -- Select the ellipse_button00378.gif button and choose a color for no alert.

Range Alerts

Color of the link will change when the value property is greater than the valueHighAlarm or valueHighWarning or less than the valueLowAlarm or valueLowWarning.

 

valueHighAlarm -- Specify the value that the input value must exceed to activate the high alarm.

valueHighAlarmColor -- Select the ellipse_button00379.gif button and choose a color for the high alarm.

valueHighWarning -- Specify the value that the input value must exceed to activate the high warning.

valueHighWarningColor -- Select the ellipse_button00380.gif button and choose a color for the high warning.

valueLowAlarm -- Specify the value that the input value must go below to activate the low alarm.

valueLowAlarmColor -- Select the ellipse_button00381.gif button and choose a color for the low alarm.

valueLowWarning Specify the value that the input value must go below to activate the low warning.

valueLowWarningColor -- Select the ellipse_button00382.gif button and choose a color for the low warning.

 

No Alerts 

Disable all alert and alarm properties.

Arrow Properties 

Property Name

Description

arrow1Color

Select the ellipse_button00383.gif button and choose a color for the source arrow.

arrow1VisFlag

Controls the visibility of the source arrow.

arrow2Color

Select the ellipse_button00384.gif button and choose a color for the target arrow.

arrow2VisFlag

Controls the visibility of the target arrow.

Data Properties 

Property Name

Description

value

Data value used to display the value text and to evaluate any alert definitions.

valueDivisor

If specified, this divisor is applied to the value.

Data Format Properties

Property Name

Description

valueFormat

Select or enter the numeric format of values displayed on the link and in tool tips. To enter a format, use syntax from the Java DecimalFormat class.

Note: To enable tool tips, select the mouseOverFlag.

valueTextColor

Select the ellipse_button00385.gif button and choose the color of the value text.

valueTextFont

Select the font to use for the value text.

valueTextHeight

Specify the height for the value text.

valueTextPosX

Set x-axis position of value text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

valueTextPosY

Set the y-axis position of value text . Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

valueVisFlag

Control visibility of the value text.

Note: This property is only applicable if iconVisFlag is selected.

Icon Properties

Property Name

Description

iconBgBorderColor

Select the ellipse_button00386.gif button and choose a color for the border of the background rectangle. This property is only applicable if iconBgBorderFlag is selected.

iconBgBorderFlag

If selected, a border is drawn around the background rectangle.

iconBgColor

Select the ellipse_button00387.gif button and choose a fill color for the background rectangle.

iconBgEdgeWidth

Set the width of the 3D edge on the background rectangle. This property is only available if the iconBgStyle selected is 3D Rectangle.

iconBgGradientColor2

Select the ellipse_button00388.gif button and choose a color for the second color in the gradient. Default is white.

Note: The iconBgColor property sets the first color in the gradient.

iconBgGradientMode

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.

iconBgRaisedFlag

Reverses the direction of the gradient, as well as that of the 3D edge if the iconBgStyle selected is 3D Rectangle.

iconBgRoundness

Set the arc length of the rounded corners. This property is only available if the iconBgStyle selected is Round Rectangle.

Note: The value of iconBgRoundness cannot exceed half the value of the iconWidth or the iconHeight. If iconBgRoundness does exceed that value, then half (of the smaller of the two values) of iconWidth or iconHeight will be used instead. For example if iconWidth is 100 and iconHeight is 50, then the value of iconBgRoundness cannot exceed 25. If it does, then half the value of iconHeight (25) will be used instead.

iconBgShadowFlag

Select to display a drop shadow on the background rectangle.

iconBgStyle

Select from the following options:

Rectangle -- Select to display a background rectangle.

3D Rectangle -- Select to display a 3D edge on the background rectangle. If selected, use iconBgEdgeWidth to set the width of the 3D edge.

Round Rectangle -- Select to display a background rectangle with rounded edges. If selected, use iconBgRoundness to set the arc length of the rounded corners.

Circle -- Select to display a background circle.

iconBgVisFlag

Select to display a background rectangle.

Note: This property is only applicable if iconVisFlag is selected.

iconConstantSizeFlag

If selected, when the display is zoomed the icon size will remain constant.

iconHeight

Set height of the icon in pixels.

iconVisFlag

Control the visibility of an icon displaying the value of the link.

iconWidth

Set width of the object in pixels.

Interaction Properties

Property Name

Description

command

Assign a command to your link. See “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 ellipse_button00389.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

connectEdgeFlag

If the specified linkPathType is Direct, then select the connectEdgeFlag to attach the link to the center of the side of the target object that is closest to the source object (instead of connecting to the center of the target object).

Note: Orthogonal and Direct Offset links always attach to the center of the side closest to the source object.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

mouseOverFlag

Enter a tool tip for this link. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nlink).

Note: The property iconVisFlag must be selected in order to display tool tips.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00390.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab.

Note: This property is only applies if labelTextPosY is set to TabTop.

labelTextColor

Select the ellipse_button00391.gif button and choose the color of the label text.

labelTextFont

Select the font to use for the label text.

labelTextHeight

Specify the height for the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Title Top - Position along the top line of the background rectangle.

§        Tab Top - Position tab just above the background rectangle. Note: Height and width of the label tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label.

Note: This property is only applicable if iconVisFlag is selected.

Link Line Properties 

Property Name

Description

linkColor

Select the ellipse_button00392.gif button and choose a color for the link line.

linkPathType

Select from the following options:

§        Direct - Draws a straight line between the objects it connects.

§        Direct Offset - Attaches to objects at a right angle, but draws a diagonal line for the remainder of the link.

§        Orthogonal - Draws a line at right angles between the objects it connects.

linkSize

Set (in pixels) the thickness of the link line.

Object Properties 

Property Name

Description

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used. See “Style Sheets” for more information.

The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the link. Enter a value between 0 and 100. A value of 0, the default, sets the link to be completely opaque. A value of 100 will render the link completely transparent.

visFlag

Control visibility of the link line.

Scale Objects

The Object Palette features several types of scales: bar, indicator, vu, pie, and bullet.

“Bar Scales” 

Bar scales (class name: obj_barscale) display the value using the fill percent of the bar.

bscales_bar.gif

 

“Indicator Scales” 

Indicator scales (class name: obj_indscale) display the value using the position of the indicator against an axis.

bscales_ind.gif

 

“Vu Scales”

Vu scales (class name: obj_vuscale) display the value using the fill percent of the bar. The bar is drawn striped instead of solid.

bscales_vu.gif

 

“Pie Scales” 

Pie scales (class name: obj_piescale) display the value using the fill percent of the pie.

bscales_pie.gif

 

“Bullet Scales”

Bullet scales (class name: obj_bulletscale) display the value using the fill percent of the bar. (The bar look and functionality are based on Steven Few's bullet graph).

bscales_bullet.gif

 

Bar Scales

bscales_bar00393.gif

 

Alert Properties 

Property Name

Description

thresholdColorBarFlag

If selected, the portion of the bar that exceeds a threshold will be painted in the threshold color. This property is only used if either the valueHighAlarmEnabledFlag or the valueHighWarningEnabledFlag is selected.

thresholdLineThickness

Select Thin, Medium, or Thick to set the thickness of the threshold lines. This property is only used if the thresholdLineVisFlag is selected.

thresholdLineVisFlag

Select to draw a line across the bar at the level of each enabled threshold. This line will be the same color as the threshold color. This property is only used if the valueHighAlarmEnabledFlag or valueHighWarningEnabledFlag is selected.

valueHighAlarmEnabledFlag

Select to enable the high alarm range and the following related properties:

valueHighAlarm - Specify the minimum value for the high alarm range. This value must be equal to or greater than valueMin and equal to or less than valueMax.

Note: If the valueHighWarningEnabledFlag is selected, this value must also be greater than valueHighWarning.

If the valueHighAlarm is greater than valueMax or less than valueMin, the valueHighAlarm will be disabled and the scale will draw without that threshold. An error will print to the console.

valueHighAlarmColor - Specify the color for the high alarm range.

valueHighWarningEnabledFlag

Select to enable the high warning range and the following related properties:

valueHighWarning - Specify the minimum value for the high warning range. This value must be equal to or greater than valueMin and equal to or less than valueMax.

Note: If the valueHighAlarmEnabledFlag is selected, this value must also be less than valueHighAlarm.

If the valueHighWarning is greater than valueMax or less than valueMin, the valueHighWarning will be disabled and the scale will draw without that threshold. An error will print to the console.

valueHighWarningColor - Specify the color for the high warning range.

Axis Properties 

Property Name

Description

axisColor

Select the ellipse_button00394.gif button and choose from the palette to set the color of the axis line and tick marks.

axisDirection

Select the direction of the axis:

§        Bottom to Top - Vertical axis with valueMin at the bottom and valueMax at the top.

§        Left to Right - Horizontal axis with valueMin at the left and valueMax at the right.

§        Top to Bottom - Vertical axis with valueMax at the bottom and valueMin at the top.

§        Right to Left - Horizontal axis with valueMin at the right and valueMax at the left

axisMinLabelWidth

Specify the minimum width (in pixels) for the axis labels.

axisFormat

Select or enter the numeric format of values displayed on the axis.

Note: To enter a format, use syntax from the Java DecimalFormat class.

axisLineThickness

Select Thin, Medium, or Thick to specify the thickness of the axis line and tick marks.

Note: This property only applies if the specified axisStyle is any of the Classic styles or Ticks and Labels.

axisMajorDivisions

Specify the number of major divisions on the axis.

axisMinorDivisions

Specify the number of minor divisions on the axis.

axisOnTopOrRightFlag

If selected, a horizontal axis will be positioned above the scale or a vertical axis will be positioned to the right of the scale.

axisStyle

Select the axis style from the drop down menu:

§        Classic with Labels - Classic style axis with an axis line, tick marks and labels at the major divisions.

§        Classic without Labels - Classic style axis with an axis line and tick marks but without labels.

§        Classic with End Labels - Classic style axis with an axis line and tick mark. Maximum and minimum value labels will be positioned at the ends of the scale.

§        Ticks and Labels - Axis with only tick marks and labels.

§        Bar with Labels - Axis with labels at the major divisions.

§        Bar without Labels - Bar style axis without labels.

§        Bar with End Labels - Bar style axis with maximum and minimum value labels at the ends of the scale.

§        Labels Only - Show labels at the major divisions, but show no axis lines or tick marks.

§        End Labels Only - Show minimum and maximum value labels at the ends of the scale.

axisTextColor

Select the ellipse_button00395.gif button and choose from the palette to set the color of the axis labels. 

axisTextFont

Select a font to use the for the axis labels.

axisTextHeight

Specify a size for the axis labels.

axisVisFlag

Control visibility of the axis.

centerMinMaxAxisLabelsFlag

If selected, minimum and maximum value labels are centered on the axis tick marks. If not selected, these axis labels will be justified so they don't extend past the end of the axis.

Note: This property only applies if the specified axisStyle displays labels next to tick marks.

Background Properties 

Property Name

Description

bgBorderColor

Select the ellipse_button00396.gif button and choose 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 ellipse_button00397.gif button and choose 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 ellipse_button00398.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient. 

Note: This property will be ignored if bgGradientMode is set to None.

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 scale and the border.

Bar Properties

Property Name

Description

barBgColor

Select the ellipse_button00399.gif button and choose from the palette to set the color of the bar background. 

Note: This property only used applies if barBgOpaqueFlag is selected.

barBgOpaqueFlag

If selected, the bar background is filled in. Otherwise, it is transparent.

barBorderColor

Select the ellipse_button00400.gif button and choose from the palette to set the color of the border of the bar. 

Note: This property only applies if barBgBorderFlag is selected.

barBorderFlag

If selected, a border is displayed around the bar.

barColor

Select the ellipse_button00401.gif button and choose from the palette to set the color of the bar. 

barGradientColor2

Select the ellipse_button00402.gif button and choose from the palette to set the second color in the gradient. The barColor property sets the first color in the gradient. 

Note: This property will be ignored if barGradientMode is set to None.

barGradientMode

Display a gradient in the bar background. 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.

§        Diagonal Center - Gradient is drawn at a 45 degree angle from the center to the top left and the bottom right corners.

§        Horizontal Edge - Gradient is drawn horizontally from the top to the bottom.

§        Horizontal Center - Gradient is drawn horizontally from the center to the top and bottom.

§        Vertical Edge - Gradient is drawn vertically from the left to the right.

§        Vertical Center - Gradient is drawn vertically from the center to the left and right.

barRaisedFlag

Reverses the direction of the gradient, as well as that of the 3D edge if the selected barStyle is 3D Rectangle.

barRoundness

Set the arc length of the rounded corners.

Note: This property is only applies if the selected barStyle is Round Rectangle.

barStyle

Choose one of the following three options from the drop down menu:

§        Rectangle - Display the bar as a rectangle.

§        3D Rectangle - Display a 3D edge on the bar.

§        Round Rectangle - Display the bar with rounded edges. If selected, use the bgRoundness property to set the arc length of the rounded corners.

Data Properties 

Property Name

Description

value

Attach your data.

valueDivisor

If specified, this divisor is applied to the value, valueMin, and valueMax.

valueMax

Set the maximum range for the scale. This value must be larger than valueMin.

valueMin

Set the minimum range for the scale. This value must be smaller than valueMax.

Data Format Properties

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value label. To enter a format, use syntax from the Java DecimalFormat class.

valueTextColor

Select the ellipse_button00403.gif button and choose from the palette to set the color of the value label. 

valueTextFont

Select the font to use for the value label.

valueTextHeight

Specify the height for the value label.

valueTextPosition

Set the position of value label. Select from the following options:

§        Outside Max - Position outside the maximum value.

§        Inside Max - Position inside the maximum value.

§        Outside Current - Position outside the current value.

§        Inside Current - Position inside the current value.

§        Center - Position at the center of the scale.

§        Inside Min - Position inside the minimum value.

§        Outside Min - Position outside the minimum value.

valueVisFlag

Control visibility of the value label.

Interaction Properties

Property Name

Description

command

Assign a command to your bar scale. See “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 ellipse_button00404.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

When you double-click on a trace in the scale, the following predefined substitutions will be set on the specified drillDownTarget:

§        $traceNumber - number of the trace (1 to 10) that contains the selected point

§        $traceLabel - label of selected trace

§        $pointValue - data value of point

§        $pointTimestamp - timestamp of point

§        $pointLabel - data label (if any) of point

§        $pointIndex - position of point in trace data (0 to maxPointsPerTrace)

Note: When drillDownSelectMode is set to Anywhere, double-clicking anywhere on the scale will activate the specified drillDownTarget; however, you must double-click on a trace in the scale to set the substitutions listed above.

mouseOverText

Enter a tool tip for this scale. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nscale).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00405.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab.

Note: This property is only applies if labelTextPosY is set to Tab Top.

labelTextColor

Select the ellipse_button00406.gif button and choose from the palette to set the color of the label text. 

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Title Top - Position along the top line of the background rectangle.

§        Tab Top - Position tab just above the background rectangle.

Note: Height and width of the label tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Indicator Scales

bscales_ind00407.gif

 

Alert Properties 

Property Name

Description

thresholdColorIndicatorFlag

If selected, the indicator will display the threshold color when it exceeds that threshold. This property only applies if either the valueHighAlarmEnabledFlag or the valueHighWarningEnabledFlag is selected.

thresholdLineThickness

Select Thin, Medium, or Thick to set the thickness of the threshold lines. This property is only used if the thresholdLineVisFlag is selected.

thresholdLineVisFlag

Select to draw a line across the bar at the level of each enabled threshold. This line will be the same color as the threshold color. This property is only used if the valueHighAlarmEnabledFlag or valueHighWarningEnabledFlag is selected.

valueHighAlarmEnabledFlag

Select to enable the high alarm range and the following related properties:

valueHighAlarm -Specify the minimum value for the high alarm range. This value must be equal to or greater than valueMin and equal to or less than valueMax.

Note: If the valueHighWarningEnabledFlag is selected, this value must also be greater than valueHighWarning.

If the valueHighAlarm is greater than valueMax or less than valueMin, the valueHighAlarm will be disabled and the scale will draw without that threshold. An error will print to the console.

valueHighAlarmColor - Specify the color for the high alarm range.

valueHighWarningEnabledFlag

Select to enable the high warning range and the following related properties:

valueHighWarning - Specify the minimum value for the high warning range. This value must be equal to or greater than valueMin and equal to or less than valueMax.

Note: If the valueHighAlarmEnabledFlag is selected, this value must also be less than valueHighAlarm.

If the valueHighWarning is greater than valueMax or less than valueMin, the valueHighWarning will be disabled and the scale will draw without that threshold. An error will print to the console.

valueHighWarningColor - Specify the color for the high warning range.

Axis Properties

Property Name

Description

axisColor

Select the ellipse_button00408.gif button and choose from the palette to set the color of the axis line and tick marks.

axisDirection

Select the direction of the axis:

§        Bottom to Top - Vertical axis with valueMin at the bottom and valueMax at the top.

§        Left to Right - Horizontal axis with valueMin at the left and valueMax at the right.

§        Top to Bottom - Vertical axis with valueMax at the bottom and valueMin at the top.

§        Right to Left - Horizontal axis with valueMin at the right and valueMax at the left

axisMinLabelWidth

Specify the minimum width (in pixels) for the axis labels.

axisFormat

Select or enter the numeric format of values displayed on the axis.

Note: To enter a format, use syntax from the Java DecimalFormat class.

axisLineThickness

Select Thin, Medium, or Thick to specify the thickness of the axis line and tick marks.

Note: This property only applies if the specified axisStyle is any of the Classic styles or Ticks and Labels.

axisMajorDivisions

Specify the number of major divisions on the axis.

axisMinorDivisions

Specify the number of minor divisions on the axis.

axisOnTopOrRightFlag

If selected, a horizontal axis will be positioned above the scale or a vertical axis will be positioned to the right of the scale.

axisStyle

Select the axis style from the drop down menu:

§        Classic with Labels - Classic style axis with an axis line, tick marks and labels at the major divisions.

§        Classic without Labels - Classic style axis with an axis line and tick marks but without labels.

§        Classic with End Labels - Classic style axis with an axis line and tick mark. Maximum and minimum value labels will be positioned at the ends of the scale.

§        Ticks and Labels - Axis with only tick marks and labels.

§        Bar with Labels - Axis with labels at the major divisions.

§        Bar without Labels - Bar style axis without labels.

§        Bar with End Labels - Bar style axis with maximum and minimum value labels at the ends of the scale.

§        Labels Only - Show labels at the major divisions, but show no axis lines or tick marks.

§        End Labels Only - Show minimum and maximum value labels at the ends of the scale.

axisTextColor

Select the ellipse_button00409.gif button and choose from the palette to set the color of the axis labels.

axisTextFont

Select a font to use the for the axis labels.

axisTextHeight

Specify a size for the axis labels.

axisVisFlag

Control visibility of the axis.

centerMinMaxAxisLabelsFlag

If selected, minimum and maximum value labels are centered on the axis tick marks. If not selected, these axis labels will be justified so they don't extend past the end of the axis.

Note: This property only applies if the specified axisStyle displays labels next to tick marks.

Background Properties 

Property Name

Description

bgBorderColor

Select the ellipse_button00410.gif 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 ellipse_button00411.gif 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 ellipse_button00412.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient. 

Note: This property will be ignored if bgGradientMode is set to None.

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 scale and the border.

Data Properties

Property Name

Description

value

Attach your data.

valueDivisor

If specified, this divisor is applied to the value, valueMin, and valueMax.

valueMax

Set the maximum range for the scale. This value must be larger than valueMin.

valueMin

Set the minimum range for the scale. This value must be smaller than valueMax.

Data Format Properties

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value label. To enter a format, use syntax from the Java DecimalFormat class.

valueTextColor

Select the ellipse_button00413.gif button and choose from the palette to set the color of the value label.

valueTextFont

Select the font to use for the value label.

valueTextHeight

Specify the height for the value label.

valueTextPosition

Set the position of value label. Select from the following options:

§        Outside Max - Position outside the maximum value on the axis.

§        Center - Position to the side of the indicator.

§        Outside Min - Position outside the minimum value on the axis.

valueVisFlag

Control visibility of the value label.

Indicator Properties

Property Name

Description

indicatorColor

Select the ellipse_button00414.gif button and choose from the palette to set the color of the indicator. 

indicatorOnAxisFlag

If selected, draw the indicator on the axis. Otherwise, it is drawn to the side of the axis.

indicatorSize

Set the size of the indicator: Small, Medium, or Large.

indicatorStyle

Set the style of the indicator: Triangle, Circle, or Line.

Interaction Properties

Property Name

Description

command

Assign a command to your indicator scale. See “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 ellipse_button00415.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

When you double-click on a trace in the scale, the following predefined substitutions will be set on the specified drillDownTarget:

§        $traceNumber - number of the trace (1 to 10) that contains the selected point

§        $traceLabel - label of selected trace

§        $pointValue - data value of point

§        $pointTimestamp - timestamp of point

§        $pointLabel - data label (if any) of point

§        $pointIndex - position of point in trace data (0 to maxPointsPerTrace)

Note: When drillDownSelectMode is set to Anywhere double-clicking anywhere on the scale will activate the specified drillDownTarget, however you must double-click on a trace in the scale to set the substitutions listed above.

mouseOverText

Enter a tool tip for this scale. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nscale).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties 

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00416.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab.

Note: This property is only applies if labelTextPosY is set to Tab Top.

labelTextColor

Select the ellipse_button00417.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Title Top - Position along the top line of the background rectangle.

§        Tab Top - Position tab just above the background rectangle.

Note: Height and width of the label tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.\

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Vu Scales

bscales_vu00418.gif

 

Alert Properties 

Property Name

Description

thresholdColorBarFlag

If selected, the portion of the bar that exceeds a threshold will be painted in the threshold color. This property is only used if either the valueHighAlarmEnabledFlag or the valueHighWarningEnabledFlag is selected.

thresholdLineVisFlag

Select to draw thresholds behind the active bar in paler versions of the threshold colors.

valueHighAlarmEnabledFlag

Select to enable the high alarm range and the following related properties:

valueHighAlarm - Specify the minimum value for the high alarm range. This value must be equal to or greater than valueMin and equal to or less than valueMax.

Note: If the valueHighWarningEnabledFlag is selected, this value must also be greater than valueHighWarning.

If the valueHighAlarm is greater than valueMax or less than valueMin, the valueHighAlarm will be disabled and the scale will draw without that threshold. An error will print to the console.

valueHighAlarmColor - Specify the color for the high alarm range.

valueHighWarningEnabledFlag

Select to enable the high warning range and the following related properties:

valueHighWarning - Specify the minimum value for the high warning range. This value must be equal to or greater than valueMin and equal to or less than valueMax.

Note: If the valueHighAlarmEnabledFlag is selected, this value must also be less than valueHighAlarm.

If the valueHighWarning is greater than valueMax or less than valueMin, the valueHighWarning will be disabled and the scale will draw without that threshold. An error will print to the console.

valueHighWarningColor - Specify the color for the high warning range.

Axis Properties 

Property Name

Description

axisColor

Select the ellipse_button00419.gif button and choose from the palette to set the color of the axis line and tick marks.

axisDirection

Select the direction of the axis:

§        Bottom to Top - Vertical axis with valueMin at the bottom and valueMax at the top.

§        Left to Right - Horizontal axis with valueMin at the left and valueMax at the right.

§        Top to Bottom - Vertical axis with valueMax at the bottom and valueMin at the top.

§        Right to Left - Horizontal axis with valueMin at the right and valueMax at the left

axisMinLabelWidth

Specify the minimum width (in pixels) for the axis labels.

axisFormat

Select or enter the numeric format of values displayed on the axis.

Note: To enter a format, use syntax from the Java DecimalFormat class.

axisLineThickness

Select Thin, Medium, or Thick to specify the thickness of the axis line and tick marks.

Note: This property only applies if the specified axisStyle is any of the Classic styles or Ticks and Labels.

axisMajorDivisions

Specify the number of major divisions on the axis.

axisMinorDivisions

Specify the number of minor divisions on the axis.

axisOnTopOrRightFlag

If selected, a horizontal axis will be positioned above the scale or a vertical axis will be positioned to the right of the scale.

axisStyle

Select the axis style from the drop down menu:

§        Classic with Labels - Classic style axis with an axis line, tick marks and labels at the major divisions.

§        Classic without Labels - Classic style axis with an axis line and tick marks but without labels.

§        Classic with End Labels - Classic style axis with an axis line and tick mark. Maximum and minimum value labels will be positioned at the ends of the scale.

§        Ticks and Labels - Axis with only tick marks and labels.

§        Bar with Labels - Axis with labels at the major divisions.

§        Bar without Labels - Bar style axis without labels.

§        Bar with End Labels - Bar style axis with maximum and minimum value labels at the ends of the scale.

§        Labels Only - Show labels at the major divisions, but show no axis lines or tick marks.

§        End Labels Only - Show minimum and maximum value labels at the ends of the scale.

axisTextColor

Select the ellipse_button00420.gif button and choose from the palette to set the color of the axis labels.

axisTextFont

Select a font to use the for the axis labels.

axisTextHeight

Specify a size for the axis labels.

axisVisFlag

Control visibility of the axis.

centerMinMaxAxisLabelsFlag

If selected, minimum and maximum value labels are centered on the axis tick marks. If not selected, these axis labels will be justified so they don't extend past the end of the axis.

Note: This property only applies if the specified axisStyle displays labels next to tick marks.

Background Properties 

Property Name

Description

bgBorderColor

Select the ellipse_button00421.gif 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 ellipse_button00422.gif 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 ellipse_button00423.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient. 

Note: This property will be ignored if bgGradientMode is set to None.

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 scale and the border.

Bar Properties

Property Name

Description

barBgColor

Select the ellipse_button00424.gif button and choose from the palette to set the color of the bar background. 

Note: This property only used applies if barBgOpaqueFlag is selected.

barBgOpaqueFlag

If selected, the bar background is filled in. Otherwise, it is transparent.

barBorderColor

Select the ellipse_button00425.gif button and choose from the palette to set the color of the border of the bar.

Note: This property only applies if barBgBorderFlag is selected.

barBorderFlag

If selected, a border is displayed around the bar.

barColor

Select the ellipse_button00426.gif button and choose from the palette to set the color of the bar.

barInsets

Specify the insets (in pixels) between the edge of the bar and the bar lines.

 

Data Properties 

Property Name

Description

value

Attach your data.

valueDivisor

If specified, this divisor is applied to the value, valueMin and valueMax.

valueMax

Set the maximum range for the scale. This value must be larger than valueMin.

valueMin

Set the minimum range for the scale. This value must be smaller than valueMax.

Data Format Properties 

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value label. To enter a format, use syntax from the Java DecimalFormat class.

valueTextColor

Select the ellipse_button00427.gif button and choose from the palette to set the color of the value label.

valueTextFont

Select the font to use for the value label.

valueTextHeight

Specify the height for the value label.

valueTextPosition

Set the position of value label. Select from the following options:

§        Outside Max - Position outside the maximum value.

§        Inside Max - Position inside the maximum value.

§        Outside Current - Position outside the current value.

§        Inside Current - Position inside the current value.

§        Center - Position at the center of the scale.

§        Inside Min - Position inside the minimum value.

§        Outside Min - Position outside the minimum value.

valueVisFlag

Control visibility of the value label.

Interaction Properties 

Property Name

Description

command

Assign a command to your vu scale. See “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 ellipse_button00428.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

When you double-click on a trace in the scale, the following predefined substitutions will be set on the specified drillDownTarget:

§        $traceNumber - number of the trace (1 to 10) that contains the selected point

§        $traceLabel - label of selected trace

§        $pointValue - data value of point

§        $pointTimestamp - timestamp of point

§        $pointLabel - data label (if any) of point

§        $pointIndex - position of point in trace data (0 to maxPointsPerTrace)

Note: When drillDownSelectMode is set to Anywhere double-clicking anywhere on the scale will activate the specified drillDownTarget, however you must double-click on a trace in the scale to set the substitutions listed above.

mouseOverText

Enter a tool tip for this scale. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nscale).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00429.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab.

Note: This property is only applies if labelTextPosY is set to Tab Top.

labelTextColor

Select the ellipse_button00430.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Title Top - Position along the top line of the background rectangle.

§        Tab Top - Position tab just above the background rectangle.

Note: Height and width of the label tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Pie Scales

bscales_pie00431.gif

 

Alert Properties 

Property Name

Description

thresholdColorPieFlag

If selected, a portion of the pie will display the threshold color when it exceeds that threshold. This property only applies if either the valueHighAlarmEnabledFlag or the valueHighWarningEnabledFlag is selected.

thresholdLineThickness

Select Thin, Medium, or Thick to set the thickness of the threshold lines. This property is only used if the thresholdLineVisFlag is selected.

thresholdLineVisFlag

Select to draw a line across the bar at the level of each enabled threshold. This line will be the same color as the threshold color. This property is only used if the valueHighAlarmEnabledFlag or valueHighWarningEnabledFlag is selected.

valueHighAlarmEnabledFlag

Select to enable the high alarm range and the following related properties:

valueHighAlarm - Specify the minimum value for the high alarm range. This value must be equal to or greater than valueMin and equal to or less than valueMax.

Note: If the valueHighWarningEnabledFlag is selected, this value must also be greater than valueHighWarning.

If the valueHighAlarm is greater than valueMax or less than valueMin, the valueHighAlarm will be disabled and the scale will draw without that threshold. An error will print to the console.

valueHighAlarmColor - Specify the color for the high alarm range.

valueHighWarningEnabledFlag

Select to enable the high warning range and the following related properties:

valueHighWarning - Specify the minimum value for the high warning range. This value must be equal to or greater than valueMin and equal to or less than valueMax.

Note: If the valueHighAlarmEnabledFlag is selected, this value must also be less than valueHighAlarm.

If the valueHighWarning is greater than valueMax or less than valueMin, the valueHighWarning will be disabled and the scale will draw without that threshold. An error will print to the console.

valueHighWarningColor - Specify the color for the high warning range.

Background Properties 

Property Name

Description

bgBorderColor

Select the ellipse_button00432.gif 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 ellipse_button00433.gif 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 ellipse_button00434.gif button and choose from the palette to set the second color in the gradient. The bgColor property sets the first color in the gradient.

Note: This property will be ignored if bgGradientMode is set to None.

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.

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 scale and the border.

Data Properties 

Property Name

Description

value

Attach your data.

valueDivisor

If specified, this divisor is applied to the value, valueMin, and valueMax.

valueMax

Set the maximum range for the scale. This value must be larger than valueMin.

valueMin

Set the minimum range for the scale. This value must be smaller than valueMax.

Data Format Properties

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value label. To enter a format, use syntax from the Java DecimalFormat class.

valueTextColor

Select the ellipse_button00435.gif button and choose from the palette to set the color of the value label.

valueTextFont

Select the font to use for the value label.

valueTextHeight

Specify the height for the value label.

valueTextPosition

Set the position of value label. Select from the following options:

§        Outside Max - Position outside the maximum value.

§        Inside Max - Position inside the maximum value.

§        Outside Current - Position outside the current value.

§        Inside Current - Position inside the current value.

§        Center - Position at the center of the scale.

§        Inside Min - Position inside the minimum value.

§        Outside Min - Position outside the minimum value.

valueVisFlag

Control visibility of the value label.

Interaction Properties

Property Name

Description

command

Assign a command to your pie scale. See “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 ellipse_button00436.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See “Drill Down Displays” for information.

When you double-click on a trace in the scale, the following predefined substitutions will be set on the specified drillDownTarget:

§        $traceNumber - number of the trace (1 to 10) that contains the selected point

§        $traceLabel - label of selected trace

§        $pointValue - data value of point

§        $pointTimestamp - timestamp of point

§        $pointLabel - data label (if any) of point

§        $pointIndex - position of point in trace data (0 to maxPointsPerTrace)

Note: When drillDownSelectMode is set to Anywhere double-clicking anywhere on the scale will activate the specified drillDownTarget, however you must double-click on a trace in the scale to set the substitutions listed above.

mouseOverText

Enter a tool tip for this scale. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nscale).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties 

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00437.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab.

Note: This property is only applies if labelTextPosY is set to Tab Top.

labelTextColor

Select the ellipse_button00438.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Title Top - Position along the top line of the background rectangle.

§        Tab Top - Position tab just above the background rectangle.

Note: Height and width of the label tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Pie Properties 

Property Name

Description

clockWiseFlag

If selected, the pie is drawn from the start angle in a clockwise direction. Otherwise, it is drawn counter-clockwise.

pie3dThickness

Specify the thickness of the 3D edge of the pie. If the value is 0, the pie will be drawn 2D.

pieBgColor

Select the ellipse_button00439.gif button and choose from the palette to set the color of the background color of the pie.

Note: This property only applies if pieBgOpaqueFlag is selected.

pieBgOpaqueFlag

If selected, the pie background is filled in. Otherwise, it is transparent.

pieBorderColor

Select the border color for the pie.

Note: This property only applies if pieBorderFlag is selected.

pieBorderFlag

If selected, a border is displayed around the edge of the pie.

pieColor

Select the ellipse_button00440.gif button and choose from the palette to set the color of the pie.

pieGradientColor2

Select the ellipse_button00441.gif button and choose from the palette to set the second color in the gradient. The pieColor property sets the first color in the gradient. 

Note: This property will be ignored if pieGradientMode is set to None.

pieGradientMode

Display a gradient in the pie. 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.

§        Diagonal Center - Gradient is drawn at a 45 degree angle from the center to the top left and the bottom right corners.

§        Horizontal Edge - Gradient is drawn horizontally from the top to the bottom.

§        Horizontal Center - Gradient is drawn horizontally from the center to the top and bottom.

§        Vertical Edge - Gradient is drawn vertically from the left to the right.

§        Vertical Center - Gradient is drawn vertically from the center to the left and right.

pieRaisedFlag

Reverses the direction of the gradient.

startAngle

Set the start angle of the pie. Start angles range from 0 to 360, with 0 pointing straight to the right and increasing clockwise around the circle. Default is 180 (pointing straight to the left).

Bullet Scales

bscales_bullet00442.gif

 

Alert Properties

Property Name

Description

compValue1

Set the value of the first comparison line. This value must be equal to or greater than valueMin and equal to or less than valueMax. If compValue1 is greater than valueMax or less than valueMin, that threshold will be disabled and the scale will draw without that threshold. An error will print to the console. This property is only used if the compValue1EnabledFlag is selected.

compValue1EnabledFlag

Enable the first comparison line.

compValue1LineColor

Set the color of the first comparison line.

compValue1LineThickness

Select Thin, Medium, or Thick to set the thickness of the first comparison line.

compValue2

Set the value of the second comparison line. This value must be equal to or greater than valueMin and equal to or less than valueMax. If compValue2 is greater than valueMax or less than valueMin, that threshold will be disabled and the scale will draw without that threshold. An error will print to the console. This property is only used if the compValue2EnabledFlag is selected.

compValue2EnabledFlag

Enable the second comparison line.

compValue2LineColor

Set the color of the second comparison line.

compValue2LineThickness

Select Thin, Medium, or Thick to set the thickness of the second comparison line.

valueHighAlarmEnabledFlag

Select to enable the high alarm range and the following related properties:

valueHighAlarm - Specify the minimum value for the high alarm range. This value must be equal to or greater than valueMin and equal to or less than valueMax.

Note: If the valueHighWarningEnabledFlag is selected, this value must also be greater than valueHighWarning.

If the valueHighAlarm is greater than valueMax or less than valueMin, the valueHighAlarm will be disabled and the scale will draw without that threshold. An error will print to the console.

valueHighAlarmColor - Specify the color for the high alarm range.

valueHighWarningEnabledFlag

Select to enable the high warning range and the following related properties:

valueHighWarning - Specify the minimum value for the high warning range. This value must be equal to or greater than valueMin and equal to or less than valueMax.

Note: If the valueHighAlarmEnabledFlag is selected, this value must also be less than valueHighAlarm.

If the valueHighWarning is greater than valueMax or less than valueMin, the valueHighWarning will be disabled and the scale will draw without that threshold. An error will print to the console.

valueHighWarningColor - Specify the color for the high warning range.

valueNoAlarmColor

Specify the color for the no alarm range.

Axis Properties 

Property Name

Description

axisColor

Select the ellipse_button00443.gif button and choose from the palette to set the color of the axis line and tick marks.

axisDirection

Select the direction of the axis:

§        Bottom to Top - Vertical axis with valueMin at the bottom and valueMax at the top.

§        Left to Right - Horizontal axis with valueMin at the left and valueMax at the right.

§        Top to Bottom - Vertical axis with valueMax at the bottom and valueMin at the top.

§        Right to Left - Horizontal axis with valueMin at the right and valueMax at the left

axisMinLabelWidth

Specify the minimum width (in pixels) for the axis labels.

axisFormat

Select or enter the numeric format of values displayed on the axis.

Note: To enter a format, use syntax from the Java DecimalFormat class.

axisLineThickness

Select Thin, Medium, or Thick to specify the thickness of the axis line and tick marks.

Note: This property only applies if the specified axisStyle is any of the Classic styles or Ticks and Labels.

axisMajorDivisions

Specify the number of major divisions on the axis.

axisMinorDivisions

Specify the number of minor divisions on the axis.

axisOnTopOrRightFlag

If selected, a horizontal axis will be positioned above the scale or a vertical axis will be positioned to the right of the scale.

axisStyle

Select the axis style from the drop down menu:

§        Classic with Labels - Classic style axis with an axis line, tick marks and labels at the major divisions.

§        Classic without Labels - Classic style axis with an axis line and tick marks but without labels.

§        Classic with End Labels - Classic style axis with an axis line and tick mark. Maximum and minimum value labels will be positioned at the ends of the scale.

§        Ticks and Labels - Axis with only tick marks and labels.

§        Bar with Labels - Axis with labels at the major divisions.

§        Bar without Labels - Bar style axis without labels.

§        Bar with End Labels - Bar style axis with maximum and minimum value labels at the ends of the scale.

§        Labels Only - Show labels at the major divisions, but show no axis lines or tick marks.

§        End Labels Only - Show minimum and maximum value labels at the ends of the scale.

axisTextColor

Select the ellipse_button00444.gif button and choose from the palette to set the color of the axis labels.

axisTextFont

Select a font to use the for the axis labels.

axisTextHeight

Specify a size for the axis labels.

axisVisFlag

Control visibility of the axis.

centerMinMaxAxisLabelsFlag

If selected, minimum and maximum value labels are centered on the axis tick marks. If not selected, these axis labels will be justified so they don't extend past the end of the axis.

Note: This property only applies if the specified axisStyle displays labels next to tick marks.

Background Properties 

Specify how the background is displayed in your bullet scale.

Property Name

Description

bgBorderColor

Select the ellipse_button00445.gif 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 ellipse_button00446.gif 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 ellipse_button00447.gif button and choose from the palette to set the second color in the gradient. The first color in each gradient is determined by value*Color properties specified in the Alert Properties section.

Note: This property will be ignored if bgGradientMode is set to None.

bgGradientMode

Display a separate gradient in each of the three ranges of 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 scale and the border.

Bar Properties

Property Name

Description

barBgBorderColor

Select the ellipse_button00448.gif button and choose from the palette to set the color of the bar background. 

Note: This property only applies if barBgBorderFlag is selected.

barBgBorderFlag

If selected, border is displayed around the bar background.

barBgGradientColor2

Select the ellipse_button00449.gif button and choose from the palette to set the second color in the gradient. The barColor property sets the first color in the gradient.

Note: This property will be ignored if barBgGradientMode is set to None.

barBgGradientMode

Display a gradient in the bar background. 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.

§        Diagonal Center - Gradient is drawn at a 45 degree angle from the center to the top left and the bottom right corners.

§        Horizontal Edge - Gradient is drawn horizontally from the top to the bottom.

§        Horizontal Center - Gradient is drawn horizontally from the center to the top and bottom.

§        Vertical Edge - Gradient is drawn vertically from the left to the right.

§        Vertical Center - Gradient is drawn vertically from the center to the left and right.

barBgRaisedFlag

Reverses the direction of the gradient, as well as that of the 3D edge if the selected barStyle is 3D Rectangle.

barColor

Select the ellipse_button00450.gif button and choose from the palette to set the color of the bar.

barRoundness

Set the arc length of the rounded corners.

Note: This property is only applies if the selected barStyle is Round Rectangle.

barStyle

Choose one of the following three options from the drop down menu:

§        Rectangle - Display the bar as a rectangle.

§        3D Rectangle - Display a 3D edge on the bar.

§        Round Rectangle - Display the bar with rounded edges. If selected, use the bgRoundness property to set the arc length of the rounded corners.

barInsets

Specify the insets (in pixels) between the edge of the bar and the bar lines.

Data Properties 

Specify how data is displayed in your scale.

Property Name

Description

value

Attach your data.

valueDivisor

If specified, this divisor is applied to the value, valueMin and valueMax.

valueMax

Set the maximum range for the scale. This value must be larger than valueMin.

valueMin

Set the minimum range for the scale. This value must be smaller than valueMax.

Data Format Properties 

Specify data format in your scale.

Property Name

Description

valueFormat

Select or enter the numeric format of value displayed in the value label. To enter a format, use syntax from the Java DecimalFormat class.

valueTextColor

Select the ellipse_button00451.gif button and choose from the palette to set the color of the value label.

valueTextFont

Select the font to use for the value label.

valueTextHeight

Specify the height for the value label.

valueTextPosition

Set the position of value label. Select from the following options:

§        Outside Max - Position outside the maximum value.

§        Inside Max - Position inside the maximum value.

§        Outside Current - Position outside the current value.

§        Inside Current - Position inside the current value.

§        Center - Position at the center of the scale.

§        Inside Min - Position inside the minimum value.

§        Outside Min - Position outside the minimum value.

valueVisFlag

Control visibility of the value label.

Interaction Properties

Property Name

Description

command

Assign a command to your bullet scale. See “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 ellipse_button00452.gif button to open the Edit commandConfirmText dialog. If commandConfirmText is not specified, then text from the command property will be used.

drillDownTarget

Name of display (.rtv) file targeted as a drill down. See Building Displays>Drill Down Displays for information.

When you double-click on a trace in the scale, the following predefined substitutions will be set on the specified drillDownTarget:

§        $traceNumber - number of the trace (1 to 10) that contains the selected point

§        $traceLabel - label of selected trace

§        $pointValue - data value of point

§        $pointTimestamp - timestamp of point

§        $pointLabel - data label (if any) of point

§        $pointIndex - position of point in trace data (0 to maxPointsPerTrace)

Note: When drillDownSelectMode is set to Anywhere double-clicking anywhere on the scale will activate the specified drillDownTarget, however you must double-click on a trace in the scale to set the substitutions listed above.

mouseOverText

Enter a tool tip for this scale. To display the tool tip, move your mouse over the object. To enter a multi-line tool tip, use \n to delimit the lines (e.g. my\nscale).

Note: The object must be visible (i.e. visFlag property is selected), in order for the tool tip to be visible.

Label Properties

Property Name

Description

label

Edit label text directly in the Property Value field or select the ellipse_button00453.gif button to open the Edit Label dialog.

labelMinTabWidth

Specify minimum width of the label tab.

Note: This property is only applies if labelTextPosY is set to Tab Top.

labelTextColor

Select the ellipse_button00454.gif button and choose from the palette to set the color of the label text.

labelTextFont

Select the font style of the label text from drop down menu.

labelTextHeight

Set the height (in pixels) of the label text.

labelTextPosX

Set x-axis position of label text. Select from the following options:

§        Left - Position outside the left side of the background rectangle.

§        Inside Left - Position inside the left side of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Right - Position inside the right side of the background rectangle.

§        Right - Position outside the right side of the background rectangle.

labelTextPosY

Set y-axis position of label text. Select from the following options:

§        Outside Top - Position well above the background rectangle.

§        Top - Position just above the background rectangle.

§        Title Top - Position along the top line of the background rectangle.

§        Tab Top - Position tab just above the background rectangle.

Note: Height and width of the label tab is dependent on the height and width of the text. Use the labelMinTabWidth property to specify a minimum tab width.

§        Inside Top - Position inside the top of the background rectangle.

§        Center - Position in the center of the background rectangle.

§        Inside Bottom - Position inside the bottom of the background rectangle.

§        Bottom - Position just below the background rectangle.

§        Outside Bottom - Position well below the background rectangle.

labelVisFlag

Control visibility of the label.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Table Objects

The Object Palette features three types of table objects--standard table, rotated table and object grid--that offer the ability to display large amounts of data. While most objects are driven by a single variable, table objects are driven by one or two dimensional arrays of data. Table objects are designed to display all the information returned by a tabular element in your data attachment. The necessary number of columns and rows are automatically created. Preset substitutions are created based on your data attachment as well, which are passed into drill down displays. See “Drill Down Substitutions” for more information.

“Standard Table”

In a standard table (class name: obj_table02), data returned is displayed in a series of rows and columns. Row names and column headers depend on your data attachment. If the table is not large enough to display all of the data, scroll bars are automatically added.

“Web Grid”

The web grid is an advanced HTML implementation of obj_table02 which provides enhanced filtering (for the Thin Client only).

std_table_xml.gif

 

“Rotated Table”

The rotated table (class name: obj_table03) is a standard table in which the rows and columns have been flipped. Row names are assigned the name of the column displayed in that row.

rot_table_gen.gif

 

“Object Grid”

The object grid (class name: obj_objectgrid)   displays returned data as multiple objects, called icon objects, in a scrollable grid. Each icon object in the grid is analogous to a row of data in the standard table. Icon objects display the data using graphic attributes (e.g., color, dimension, orientation, etc.).

obj_grid_table_gen.gif

 

Standard Table

Display your data in a standard table (class name: obj_table02) by attaching it to the valueTable property. In a standard table, data returned is displayed in a series of rows and columns. Row names and column headers depend on your data attachment. If the table is not large enough to display all of the data, scroll bars are automatically added.   

To add or remove rows and columns, or edit the value of existing cells to easily update data throughout the enterprise, see the “Table Edits” section for information.

Using the Thin Client in Internet Explorer, you can copy data to the system clipboard for pasting into another application. In the standard table, right-click and select Copy Cell Value. If the selected cell contains multi-line text, each new line is converted to a tab. If the selected cell displays an image, the underlying text value is copied. Also, the security option "Scripting: Allow programmatic clipboard access" must be enabled in the security level that applies to the Thin Client's URL (otherwise, the copy will fail). The IE security level is configured on the Security tab of Internet Explorer's Internet Options dialog.

std_table_xml00455.gif

 

Alert Properties 

Use the value of individual columns, rows and cells to set font color, background color, row visibility or replace a cell value with an image. In the Object Properties window double-click on filterProperties in the Property Name field, or select the ellipse_button00456.gif button to open the Filter Properties dialog. See “Table Filters” for more information.

Background Properties 

Specify how the background is displayed in a table.

Property Name

Description

bgBorderColor

Select the ellipse_button00457.gif button and choose 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 ellipse_button00458.gif button and choose from the palette to set the background color of the table.

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 ellipse_button00459.gif 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 table and the border.

tableBgColor

Select the ellipse_button00460.gif button and choose from the palette to set the color of empty space in the table area. 

Cell Properties 

Property Name

Description

cellBgColor

Select the ellipse_button00461.gif button and choose from the palette to set the background color of the cells.

cellBgStripeContrast

Set the contrast level for alternating row colors.

Note: This property is only applicable if cellBgStripedFlag is selected.

cellBgStripedFlag

Select to display alternating row colors.

cellTextColor

Select the ellipse_button00462.gif button and choose from the palette to set the color of the cell text.

cellTextFont

Select a font for the cell text.

cellTextSize

Specify (in pixels) the size of the cell text or enter -1 to use the default size.

Column Properties 

To specify the alignment of a column, select the ellipsis button ellipse_button00463.gif in the columnAlignment property. Select the alignment from the drop down menu in the Alignment column: Default, Left, Center, or Right. The default setting depends on the type of column. To hide a column, select the ellipsis button ellipse_button00464.gif in the columnsToHide property and select the check box under Hide Column.

To specify numerical or date formats for columns, select the ellipsis button ellipse_button00465.gif in the columnFormat property (see “Column Format Properties”). Select the format from the drop down menu in the Column Format column. Use the columnFormatDate property to specify the format for all time and date columns in the table that do not have the columnFormat property specified. For example, if a table instance contains a date column named X, and the columnFormat property contains a valid date/time format for column X, then the columnFormat property is applied to column X. If the columnFormat property does not contain a valid date/time format for column X, and the columnFormatDate property does, then the columnFormatDate property format is applied to column X. If neither property contains a valid date/time format the default date/time format for the current locale, as returned by java.text.DateFormat.getDateTimeInstance(), is applied to column X. As with any object property, an rtview stylesheet entry can be used to set columnFormatDate globally on all obj_table02 instances. For example:

obj_table02 {

columnFormatDate: "yyyy-MMM-dd HH:mm:ss"

}

By default the columnFormatDate property's value is blank.

If the columnResizeEnabledFlag is selected, table columns can be resized by dragging the vertical separators between the column headers. The columnResizeEnabledFlag cannot be toggled in the Display Server.

Use the indexColumns property to maintain the highlight of selected rows after data updates or table sorts are executed. Specify the name of one or more columns that contain data to uniquely identify a row. Selected rows then remain highlighted even if the order or number of rows in the table changes.

Data Format Properties 

Use the removeLineBreaksFlag property to remove line breaks within text in table cells. This option does not remove line breaks from drill-down values. For example, if your drillDownColumnSubs property targets a substitution from a cell that contains a line break, the drill-down value will contain the line break regardless of the removeLineBreaksFlag property setting.

Note: In the Thin Client, the drill-down value will contain the line break regardless of the removeLineBreaksFlag property setting.

Interaction Properties 

Select Never, As Needed, or Always from the scrollbarMode property to set the behavior of the scroll bar in the table.

To specify a drill down target for the table, double-click on the drillDownTarget property in the Object Properties window. Based on your data attachment, preset substitutions are created automatically and passed into your drill down display. To customize which substitutions will be passed into drill down displays, in the Object Properties window double-click on drillDownColumnSubs in the Property Name field. See “Drill Down Column Substitutions Dialog” and “Drill Down Displays” for more information.

Use drillDownSelectMode to control how a drill down display is activated. The standard table (class name: obj_table02) supports three modes for drillDownSelectMode:

§        Set to Anywhere (0) to activate a drill down display by double-clicking anywhere on the table.

§        Set to Element Only (1) to enable a drill down display only when you double-click on a cell in a table. Note that when set to Element Only, a drill down display can not be activated by double-clicking in the row label column, since this column does not correspond to an actual data column in the tabular data.

§        Set to Element Only + Auto Update (2) to enable a drill down display (Element Only mode) and execute its command automatically, without a user click, when the row selection changes after a data update. This mode requires that the table's command property be configured to perform a drill down to the current display in the current window, and the table's indexColumns property be set to a non-empty string. This mode is useful in cases where the substitutions set by the table's drill down command need to be updated if some of the selected rows in the table are removed by a subsequent data update.

Use the multiSelectFlag property to enable the selection of multiple rows. When the user selects multiple rows and drills down, the drill down substitution values contain a semi colon delimited list of values, one value for each row that can be used with most data sources in the Filter Value field of the Attach To Data dialog.

The tabIndex property allows you to define the order in which table and control objects will receive focus when navigated from your keyboard. Initial focus is given to the object with the smallest tabIndex value, from there the tabbing order proceeds in ascending order. If multiple objects share the same tabIndex value, then initial focus and tabbing order are determined by the alpha-numeric order of the table names. Tables with a tabIndex value of 0 are last in the tabbing order.

Note: The tabIndex property does not apply to tables in the Display Server or to objects that are disabled, invisible, or have a value of less than 0.

Use the rightClickActionFlag property so that a right-click by the user executes actions (a drill down or execute command) normally performed only with a left-click, before the right-click popup menu is shown. This is useful when you have a command string configured to set substitutions in the current window, and the drill down target is configured to drill down using those substitutions. In that case, the command is executed when you left-click and when you right-click so the substitutions are guaranteed to be set before you select Drill Down from the popup menu. This option should not be used if the left click is configured to drill down to another display.

Note: This property is ignored in the Thin Client on iOS Safari (iPad/iPhone).

Use the menuItemGroup and rightClickActionFlag properties to extend RTView context menu items. For details, see “Extending the Context Menu”.

Use the clearSelection property to enable a user to clear multiple selected rows in a table. Typically, the table's clearSelection property is attached to a local variable and the local variable is set by a control object on the same display. For example, to add a "Clear Selection" button to a display containing a table that supports multiple row selection you could configure as follows:

1.     Add a local variable named $clearSelection with an initial value of 0.

2.     Create a button object, with these property values:

label : "Clear Selection"

valueToSet : 1

varToSet : <attached to the $clearSelection variable>

3.     Set the table object's properties:

clearSelection : <attached to the $clearSelection variable>

4.     If the table object has a drilldown command or a drillDownTarget configured, add this to its Drill Down Substitutions:

$clearSelection : 0

(This step is required to reset value of the $clearSelection variable to zero when the user selects a row in the table.)

When the property is set to a value of 1, all rows in the table are deselected. When the property is set to a value of 2, all rows are deselected and either the table's action or its drillDownTarget is invoked.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

visFlag

Control visibility of the object.

webGridFlag

Set the table for HTML implementation. The web grid is available in the Thin Client only. For details, see “Web Grid”.

Row Header Properties

To lock the first column in a table, select the rowHeaderEnabledFlag property. The rowHeaderEnabledFlag cannot be toggled in the Display Server. When enabled, you can set the appearance of the row header column using the rowHeaderBgColor, rowHeaderTextColor, rowHeaderTextFont, and rowHeaderTextSize properties. The rowHeaderFilterColorsEnabledFlag property sets whether the row filter colors are applied to the row header. Row visibility filters are applied to the row header regardless of the rowHeaderFilterColorsEnabledFlag setting. Resize the row header column by selecting the ellipsis button ellipse_button00466.gif in the columnProperties property. The row header column cannot be hidden using the columnsToHide property and a warning message is displayed if this is attempted.

Sort Properties 

Select the showSortIconFlag check box to enable column sorting. To sort a table by a specific column, click on the column header. table_sort_arrow.gifTo reverse the sort order, click on the column header again. table_sortrev_arrow.gif To clear the sort, click on the empty column header at the top left of the table or delete the Property Value of sortColumnName in the Object Properties window.

Note: Sorting is disabled if the sort icon is not visible in the column header.

Table Edits

In the Standard Table (class name: obj_table02), it is possible to add or remove rows and columns or edit the value of existing cells. To utilize table editing features, a Custom Message Handler must be implemented. Once the Custom Message Handler has been created, anyone can use RTView to easily update data throughout the enterprise. See “Table Edits - Custom Message Handler” for more information.

Enable Editing 

To enable editing, you must set a variable and attach the table to data.

The editDataEnabledFlag allows you to control whether a table can be edited. In the Object Properties window when you select the editDataEnabledFlag, the editDataLocalVarName property will appear. In the Property Value field of editDataLocalVarName enter the name of the variable you would like to update with changes made to the editable table. This will allow you to identify the table in the Custom Message Handler as well as attach other objects in this display to your edited data.

Note: The property editDataLocalVarName cannot be changed while the table is in Edit mode.

Attach data to the valueTable property to populate the table with initial data in order to enable editing. The table will not display data updates while in Edit mode, however once you save or cancel table edits current data for the valueTable attachment will be displayed.

Edit Table 

To put the table in Edit mode, right-click on the table and select Edit Table from the popup menu. If the Edit Table option is not listed, the editDataAllowFlag has not been selected. If Edit Table is listed in the menu but is not active, the valueTable property is not attached to data.

To indicate your table is in Edit mode, the background rectangle of the table as well as the column headers will switch foreground and background colors.

table_edit_menu.gif

 

To edit an existing cell value, double-click within a cell and enter a new value. When you are finished editing within a cell, you must press <Enter> or click on another cell before saving your edits. If the data entered is not the correct type (int, double, etc.) for that cell, the cell border will turn red and you will not be able to continue editing until the correct type of value is entered.

Right-click to access the following menu options:

Copy Cell Value

Select a cell and right-click to Copy Cell Value.

Paste Cell Value

Select a cell and right-click to Paste Cell Value.

Insert Row

Select a cell in the row that is immediately above or below where you want to insert a new row and right-click to Insert Row. A dialog will appear asking you to enter a row name and specify whether to insert the new row above or below the selected row. Click OK to exit the dialog and add the new row.

Note: If the Property Value of rowLabelMode is 0, row names will not appear in the table.

Insert Column

Select a cell in the column that is immediately to the right or left of where you want to insert a new column and right-click to Insert Column. A dialog will appear asking you to enter a column name, column type, and specify whether to insert the new column to the right or left of the selected column. Click OK to exit the dialog and add the new column.

Remove Row(s)

Select one or more cells and right-click to Remove Row(s) containing the selected cell(s).

Remove Column(s)

Select one or more cells and right-click to Remove Column(s) containing the selected cell(s).

Note: The column that contains row names cannot be deleted. The table will only contain a column with row names if the Property Value of rowLabelMode is greater than 0.

Save/Cancel Edits

Right-click on the table to Save or Cancel Edits.

Save or Cancel Edits 

If you exit a display while tables are in Edit mode without saving or canceling changes, a dialog will appear (for each table with unsaved changes) asking if you would like to save your table edits.

Once you save or cancel your changes, the table will display current values for the valueTable data attachment and return to its original color scheme to indicate you are out of Edit mode.

If you edit a table within an applet and do not save your changes, you will not be prompted to save when exiting.

Table Edits - Custom Message Handler

Note: This section assumes you have a working knowledge of writing, compiling and deploying Java classes.

The Custom Message Handler is a Java class that allows you to extend the functionality of RTView by implementing code to update your system when the table is edited. Once the Custom Message Handler has been created, it can be deployed with your displays so that end users who are editing tables do not need to be familiar with the systems they are updating.

To implement a Custom Message Handler, you must create a Java class named MyMessageHandler.java that extends GmsRtViewCustomMessageHandler.

Note: If you will be using the Custom Message Handler with the Display Viewer Applet, pack the Java class you create into one of the applet .jar files before deploying.

Define the following method in MyMessageHandler.java:

public boolean invokeMessage (String messageString, Object value)

The invokeMessage method will get called while the table is being edited. The messageString argument will contain one of the messages listed below. The value argument will be a 4 element Object array. The first two arguments in the Object array are constant, the rest vary based on the corresponding message.

The invokeMessage method must return true when it receives any of the following messages, otherwise it must return false.

Note: The MessageHandler will receive other messages, but the method should not return true or implement code when receiving anything other than the messages listed below.

The following lists messages and corresponding value arguments:

Message

Description

Object Array Values

table_edit_start

The invokeMessage method will get called with this message when Edit Table is selected from the popup menu.

Argument

Definition

Type

value[0]

Table object being edited.

GmsAppObject

value[1]

Name of the variable assigned to editDataLocalVarName.

String

value[2]

Initial table data prior to editing.

GmsTabularData

value[3]

Null

Null

table_edit_save

The invokeMessage method will get called with this message when Save Edits is selected from the popup menu or when Yes is selected if prompted to save while exiting.

value[0]

Table object being edited.

GmsAppObject

value[1]

Name of variable assigned to editDataLocalVarName.

String

value[2]

Table data containing table edits.

GmsTabularData

value[3]

Null

Null

table_edit_cancel

The invokeMessage method will get called with this message when Cancel Edits is selected from the popup menu or when No is selected if prompted to save while exiting.

value[0]

Table object being edited.

GmsAppObject

value[1]

Name of variable assigned to editDataLocalVarName.

String

value[2]

Table data containing the current value of valueTable. If data for the valueTable attachment was updated during editing, this may not be the same as data sent with the table_edit_start message. This message does not contain table edits.

GmsTabularData

value[3]

Null

Null

table_edit_remove_row

This message is sent when Remove Row or Remove Rows is selected from the popup menu.

value[0]

Table object being edited.

GmsAppObject

value[1]

Name of variable assigned to editDataLocalVarName.

String

value[2]

GmsTabularData object with one or more data rows that were deleted.

GmsTabularData

value[3]

Each entry is the index of a deleted row.

int[]

table_edit_insert_row

This message is sent when Insert Row is selected from the popup menu.

value[0]

Table object being edited.

GmsAppObject

value[1]

Name of variable assigned to editDataLocalVarName.

String

value[2]

GmsTabularData object with one row that contains the row data that was inserted.

GmsTabularData

value[3]

Value is the index of the inserted row.

Integer

table_edit_update_row

This message is sent when a cell from the table is edited.

value[0]

Table object being edited.

GmsAppObject

value[1]

Name of variable assigned to editDataLocalVarName.

String

value[2]

GmsTabularData object with two rows. Row[0] contains row data before the cell was edited, Row[1] contains row data after the cell was edited.

GmsTabularData

value[3]

Element[0] is the row number of the cell. Element[1] is the column number of the cell or the value -1 for the row label column.

int[]

table_edit_remove_column

This message is sent when Remove Column or Remove Columns is selected from the popup menu.

value[0]

Table object being edited.

GmsAppObject

value[1]

Name of variable assigned to editDataLocalVarName.

String

value[2]

GmsTabularData object with columns that existed before the column was removed and no rows.

GmsTabularData

value[3]

Each entry is the index of a deleted column.

int[]

table_edit_insert_column

This message is sent when Insert Column is selected from the popup menu.

value[0]

Table object being edited.

GmsAppObject

value[1]

Name of variable assigned to editDataLocalVarName.

String

value[2]

GmsTabularData object with columns that existed after the column was inserted and no rows.

GmsTabularData

value[3]

Value is the index of the inserted column.

Integer

Table Filters

In the Standard Table (class name: obj_table02), it is possible to set font color, background color, row visibility and replace a cell value with an image based on the value of individual columns, rows and cells.

Note: It is recommended that you attach the table to data before attempting to define filters.

In the Object Properties window, double-click on filterProperties in the Property Name field to bring up the Filter Properties dialog. To create a filter, click on the Add button. Double-click on an existing filter to edit. Click the Remove button to delete a filter. Click Clear to remove all filters. Use the Move Up and Move Down buttons to control in what order filters will be applied to the table.

table_filter_prop.gif

 

Filters are applied to the table in the order they are listed in the Filter Properties dialog. For example, in the table below, cells that are marked On Site are set to display a background color of green. However, table rows that are marked On Site and contain the SOLARIS system have a background color of gray throughout the entire row. The setting for the SOLARIS row background color overrides the setting for the On Site cell background color because the filters are being applied in the order they are listed above.

Create a Filter 

In the Object Properties dialog, double-click in the Property Name field to open the Filter Properties dialog, then click Add. The Edit Filter dialog opens. Each filter is composed of three elements: Condition, Action, and Target:

table_filter_edit.gif

 

Condition 

Define the condition a cell must meet for the filter to be applied. Select a comparison field from the first drop down menu. The comparison field is typically the name of a column (e.g.: On Site) that contains the value (e.g.: true) to which you would like to apply a filter. The comparison field menu is populated with column names based on the table's data attachment, along with the options Row Name and Column Header. You may enter the name of a substitution or variable to use as the value of this field. Select Row Name to filter based on the value of a row name. Select Column Header to filter based on the value of a column header.   

Note: If you have not attached the table to data, the only values listed in this menu will be Row Name and Column Header.

In the second drop down menu, select an operator (e.g.: =, >, <, etc.) for the comparison.

In the third drop down menu, select what value the comparison field must correspond to in order for the cell to meet the condition. The comparison value menu is populated with values from the table's data attachment, based on the selected comparison field, along with the options top(5) and bottom(5). Select top (5) to apply the filter to rows or cells that contain the five highest values in the selected comparison field. Select bottom(5) to apply the filter to rows or cells that contain the five lowest values in the selected comparison field. Once a selection is made from the comparison value menu, it is possible to edit the number of rows you would like to filter. You may enter the name of a substitution or variable to use as the value of this field.

Note: If you have not attached the table to data, the only values listed in this menu will be top(5) and bottom(5).

Action 

Define the action that will be applied to cells, columns, or rows that meet the condition. Select one of four actions from the first drop down menu. Select Set Background Color to control the color of cells. Select Set Font Color to control the color of text. Select Hide Rows to control the visibility of rows. Select Display Image to replace a cell value with an image.

Note: The Hide Rows action only targets rows.

The second drop down menu is populated with options based on which action is chosen in the first drop down menu. Depending on the action you select; choose which color to apply to the background or font, enter the name of a variable or substitution to use as the value of this field, or select an image from the Select Image dialog. The Select Image dialog contains up to three directories:    

§        Current Directory - Contains images in the current directory and one level of subdirectories.

§        Custom Image Library - If you have specified a custom image library, this directory contains those images (.gif, .jpg or .png). See Creating a Custom Image Library (below) for details.

§        Symbol Library - Contains symbolic images (for example, symbols for various types of hardware, shapes, lights, arrows, etc.).

Navigate to the image you want to use and select it. A preview of the image appears in the pane to the right. Click OK or Apply to set the image on your object. If an image is not listed, enter the name of the file, including the relative path.

Target 

Control how the filter is applied. There are three targets available. Select Rows to apply the filter to the entire row, if the cell from the comparison field in that row meets the condition. Select Cells to apply the filter to individual cells from the comparison field that meet the condition. Select Columns to apply the filter to the entire comparison field column, if any cell in that column meets the condition.

Note: The target does not apply if you chose Hide Rows as an action.

Creating a Custom Image Library 

The custom image library enables you to make your own images available in the Select Image dialog. To add your own image library, perform the following steps.

1.     Place your images .jar file and add it to the “RTV_USERPATH” environment variable. The images must be in a directory (not in the top level of the jar). They can be organized into subdirectories of one top level directory.

2.     In the Display Builder, select Tools/Builder Options and, in the Custom Image Library Path field, set the path to the directory containing your images .jar file.   

For example, if you have a jar with this directory structure:

com/mycompany/Images

com/mycompany/Images/Blue Images

com/mycompany/Images/Red Images

com/mycompany/Images/Green Images

you would enter com/mycompany/Images. This adds a directory named Images to the tree in the Select Image dialog. The Images directory will have three subdirectories: Blue Images, Red Images, and Green Images. Only directories containing images are added to the Select Image dialog.

To access the images, you can edit any property that allows you to set an image on an object (for example, the image, barImage, and filterProperties properties), or edit the File>Background Properties>Image Name field.

Note: You can use animated .gif files in Standard Tables, but only in the Thin Client. In the builder/viewer, the animation will only update once every two seconds or after a mouse event.

Column Format Properties

In the Object Properties window, double-click on columnFormat in the Property Name field to display the Column Format Properties dialog. In the Column Format Properties dialog you can assign numerical and date formats to columns.

column_format00467.gif

 

Field Name

Description

Column Name

This list is populated based on the table's data attachment. If you have not yet attached the table to data, this list will be empty.

Column Format

Enter or select a format from the drop down menu and press <Enter>. Specify numerical formats using the Java format specification, or with the following shorthand: $ for US dollar money values, $$ for US dollar money values with additional formatting, () for non-money values, formatted similar to money, or # for positive or negative whole values. Specify date formats using the Java date specification.

Add Column

Enter the name of the column and click the Add Column button to insert a column into the table.

Clear

Click the Clear button to remove all Column Formats listed.

Note: Text columns containing data where all the values represent numbers are treated as if they are numeric columns, so number formats can be applied.

Web Grid

The web grid is an advanced HTML implementation of obj_table02 which provides enhanced filtering. The web grid is available in the Thin Client only.

webgrid_table.gif

 

To display your data in a web grid, select the obj_table02 instance in the Builder and check its webGridFlag property in the property sheet. By default, the webGridFlag property is unchecked, which specifies use of the "classic" HTML grid in the Thin Client.

Alternatively, the web grid can be enabled on all obj_table02 instances by adding the following rule to an rtview stylesheet (.rts) file loaded by the Display Server:

obj_table02 {

webGridFlag : 1

}

Requirements

If webGridFlag is true the web grid appears in the Thin Client in any modern version of a supported browser. No plugin is required. For Internet Explorer users, version 9 or newer is required and version 11 is recommended for best performance. In IE8 or older, the web grid is not supported so the classic grid is used regardless of the webGridFlag setting. In this release the web grid is not supported on iPad but might be supported in the future.

Features

The web grid supports advanced, interactive table features in the Thin Client: sorting on multiple columns, filtering on multiple columns, column resizing, column reordering, and hiding columns. In addition, you can unsort a previously selected sort column and, in a grid with rowHeaderEnabledFlag = true, additional columns can be locked into the row header. You can save all of those column settings permanently so that they are restored when you return to the display later. Many of these features are accessed from the column menu, shown in the screen shot above, opened by clicking on the menu icon in each column's header.

Also, for improved performance and usability, if a data table contains more than 200 rows the web grid displays it in pages of 200 rows, using a page control that appears at the bottom of the grid:

webgrid_pagecontrol.gif

 

Column Sorting

You can click on a column header to sort the table by that column. On the first click, the column is sorted in ascending order (smallest value at the top), on the second click the sort is in descending order, and on the third click, the column is returned to its original unsorted state. A sort on a string column is case-insensitive.

You can select multiple sort columns. In that case, the sorting is performed in the order that the column headers were clicked. Multiple column sorting is a very useful feature, but can also cause confusion if you intend to sort on a single column, but forget to "unsort" any previously selected sort columns first. You should check for the up/down sort icon in other column headers if a sort gives unexpected results.

Column sorting is reflected in an export to HTML and Excel.

Column Visibility

You can hide or show columns in the table by clicking on any column's menu icon, and choosing Columns from the menu. This opens a submenu with a check box for each column that toggles the visibility of the column. All columns in the data table appear in the Columns menu, even those that are initially hidden by the obj_table02 property columnsToHide.

webgrid_columnvisib.gif

 

If the grid has the rowHeaderEnabledFlag property checked then the leftmost column (the row header column) cannot be hidden.

Column visibility changes are NOT reflected in an export to HTML and Excel.

Column Filtering

You can create a filter on any column. If filters are created on multiple columns, then only the rows that pass all of the filters are displayed. That is, if there are multiple filters they are logically "ANDed" together to produce the final result.

The background of a column's menu icon changes to white to indicate that a filter is defined on that column. This is intended to remind you which columns are filtered.

You can configure a filter on any column by clicking on the column's menu icon and choosing Filter from the menu. This opens the Column Filter dialog:

webgrid_columnfilter.gif

 

Options in the Column Filter dialog vary according to the data type of the selected column:

§        String columns: You can enter a filter string such as "abc" and, from the dropdown list, select the operator (equal to, not equal to, starts with, contains, etc) to be used when comparing the filter string to each string in the column. All of the filter comparisons on strings are case-insensitive. You can optionally enter a second filter string (e.g. "xyz") and specify if an AND or OR combination should be used to combine the first and second filter results on the column.

§        Numeric columns: You can enter numeric filter values and select arithmetic comparison operators, (=, !=, >, >=, <, <=). You can optionally enter a second filter value and comparison operator, and specify if an AND or OR combination should be used to combine the first and second filter results.

§        Boolean columns: You simply select whether matching items should be true or false.

The numeric and boolean filter dialogs are shown below.

webgrid_filterdialogs.gif

 

  

§        Date columns: You can select a date and time and choose whether matching items should have a timestamp that is the same as, before, or after the filter time. The date is selected by clicking on the calendar icon and picking a date from a calendar dialog. The time is selected by clicking on the time icon and picking a time from a dropdown list:

webgrid_filterDateDialog.gif

 

Alternatively, a date and time can be typed into the edit box. See the “Unsupported obj_table02 Features” section for a note on time filtering when the client and server are located in different time zones.

Data updates to the grid are suspended while the filter menu is opened. The updates are applied when the menu is closed.

Column filtering is reflected in an export to HTML and Excel.

Column Locking

This feature is available only if the obj_table02 instance has the row header feature enabled (rowHeaderEnabledFlag is checked). If so, the leftmost column is "locked" in position, meaning that it does not scroll horizontally with the other columns in the table. If the row header is enabled, then two items labeled Lock and Unlock appear in the column menu. These can be used to add or remove additional columns from the non-scrolling row header area.

webgrid_columnlock.gif

 

If the row header is enabled, at least one column must remain locked.

Column locking is NOT reflected in an export to HTML and Excel.

Column Reordering

You can reorder the grid columns by dragging and dropping a column's header into another position. If the grid has rowHeaderEnabledFlag checked, then dragging a column into or out of the row header area (the leftmost columns) is equivalent to locking or unlocking the column.

Column reordering is NOT reflected in an export to HTML and Excel.

Paging

If the data table contains more than one page of rows, the page controls are displayed at the bottom of the grid. The default page size is 200 but can be set on each obj_table02 instance via the new property named webGridRowsPerPage. The default value of that property is zero, which indicates that the default size (200) should be used. If the height of the grid is less than about 64 pixels, there is insufficient space to display the page controls so only the rows on the first page is viewable.

Row Mouseover

A new property named webGridHoverColor is available on obj_table02. It is visible only if webGridFlag = true. The default value of webGridHoverColor is checked. If it is set to any other color index value, then that color is used to highlight the row that is under the mouse cursor. But if the obj_table02 filterProperties feature is used to color rows, that color takes precedence, so the webGridHoverColor may not be useful in those cases. Also, if the row header is enabled, the row header column and the other columns are highlighted separately, according to which section of the grid the mouse is over.

Saving Settings

You can permanently save all of the custom settings made to the grid, including filtering, sorting, column size (width), column order, column visibility, and column locking. This is done by opening any column menu, clicking Settings, and then clicking Save All:

webgrid_saveSets.gif

 

The grid's settings are written as an item in the browser's local storage. The item's value is a string containing the grid's settings. The item uses a unique key comprised of the URL path name, the display name, and the obj_table02 instance's RTView object name. If the Thin Client's login feature is enabled, the key will also include the username and role, so different settings can be saved for each user and role for a grid on any given display, in the same browser and host.

If the user saves the grid settings and navigates away from the display or closes the browser, then the next time the user returns to the display in the same browser the settings are retrieved from the browser's local storage and applied to the grid. The browser's local storage items are persistent, so the grid settings are preserved if the browser is closed and reopened or if the host system is restarted.

If the obj_table02 has autoResizeFlag = true then the column widths are not restored from the saved settings, and the values computed by the auto-resize feature is used instead. This is by design.

You can delete the grid's item from local storage by clicking Settings> Clear All in any column menu. This permanently deletes the saved settings for the grid and returns the grid to the state defined in the display file.

Note that each browser has its own local storage on each host. The local storage items are not shared between browsers on the same host or on different hosts. So, if a user logs in as Joe with role = admin, in Internet Explorer on host H1, and saves grid settings for display X, then those grid settings are restored each time a user logs in as Joe, role admin, on host H1 and opens display X in Internet Explorer. But if all the same is true except that the browser is Chrome, then the settings saved in Internet Explorer are not applied. Or if the user is Joe and role is admin and the browser is IE and the display is X, but the host system is H2 not H1, then the grid settings saved on H1 are not applied.

Support for Large Tables

The web grid can support data tables with many rows and columns. However, for best performance the display server's cellsperpage property should be specified so that the server sends large tables to the client in pages, rather than sending all of the rows. In this server paging mode, large tables are also filtered and sorted in the Display Server, to improve performance and decrease data traffic. The cellsperpage option is not new or specific to the web grid, it has been available for several years. See the RTView documentation for a description of the cellsperpage property, and the related cellsperexport and cellsperreport properties. A typical value for cellsperpage is 20000.

Unsupported obj_table02 Features

The following are existing features of obj_table02 that are not supported by the web grid.

§        The rowHeaderEnabledFlag property is supported, but rowHeaderBgColor, rowHeaderTextColor, rowHeaderTextFont, rowHeaderTextSize are ignored. Instead the row header column is rendered like all other columns.

§        The columnResizeEnabledFlag is ignored if it is false, the web grid always allows column resizing.

§        The editDataEnabledFlag is ignored, the table editing feature using custom commands is currently not supported.

Other limitations, and differences between the new and classic grids:

§        Time zones: The strings shown in a date column are formatted by the display server using its time zone. But if a filter is specified on a date column, the date and time for the filter are computed using the client system's time zone. This can be confusing if the display server and client are in different time zones.

§        Selected rows: The grid's row selection is cleared if the sort is changed or if columns are resized or reordered.

§        Scrollbars: In general the grid only displays scrollbars when they are needed. However, the web grid and the classic grid use different algorithms for deciding when to show or hide scrollbars, and do not use identical row heights and column widths. So the web grid may sometimes display scrollbars when the classic grid does not, for a grid instance with a given width and height.

§        Keyboard traversal: In the classic grid, selecting a row and then using the up/down arrow keys changes the selection to the previous/next row. In the web grid, the arrow keys moves the keyboard focus to another row, as indicated by a highlight border around the focused table cell, but the user must press the space bar to select the row that contains the highlighted (focused) cell.

§        Column widths: On a web grid with no locked columns (rowHeaderEnabledFlag = false), columns expand to fill any unused width in the table, even if autoResizeFlag = false. That is, if the total width of the columns is less than the grid width (i.e. the columns don't use all of the available width) then each column is expanded proportionally to fill the table. In contrast, the classic and Swing (Viewer) grids just leave unused space at the right edge of the grid. If the grid has locked columns (rowHeaderEnabledFlag = true), then the web grid behaves the same as the classic and Swing grids.

§        Export: The export to HTML and Export to excel features are supported on the web grid, and behave much the same as on the classic grid. The exported table respects the grid's filter and sort settings but ignores any column reordering, sizing, or hiding changes made by the user.

§        Data updates to the grid are suspended while the filter menu is opened. The updates are applied when the menu is closed.

Implementation Note for Custom Web Page Developers

The RTView Thin Client now uses two versions of the jQuery JavaScript library:

§        jQuery 1.3.2, to support the jQuery UI components used for panels, layout, and (some) navigation controls.

§        jQuery 1.9.1, to support the web grid.

Version 1.3.2 is bundled into the Thin Client js file named rtvNav1.js, while version 1.9.1 is loaded as a separate js file. To prevent conflicts between the two libraries, the jQuery $ alias is no longer used by RTView and is intentionally removed. Instead the jQuery 1.3.2 library is referenced by the alias rtv.jqNav as needed, and the jQuery 1.9.1 library is referenced by the alias rtv.jq as needed.

This could affect existing custom JavaScript code that users have written. For example, the following is a snippet of JavaScript from a custom html page that uses jQuery UI tabs for navigation

<script src="rtvNav1.js"></script>

<script>

$(document).ready(function () {

var outerLayout = $('body').layout({

north__size:64, north__spacing_open: 0,

});

$('#tabs').tabs();

...

The code above uses the jQuery $ alias, which it assumes is defined in the rtvNav1.js file. But that is no longer true, so the custom code should be rewritten to use the rtv.jqNav alias for jQuery in place of the $ alias, as follows:

<script src="rtvNav1.js"></script>

<script>

rtv.jqNav(document).ready(function () {

var outerLayout = rtv.jqNav('body').layout({

north__size:64, north__spacing_open: 0,

});

rtv.jqNav('#tabs').tabs();

...

Rotated Table

Display your data in a rotated table (class name: obj_table03) by attaching it to the valueTable property. The rotated table is a standard table in which the rows and columns have been flipped. Row names are assigned the name of the column displayed in that row.

rot_table_gen00468.gif

 

Background Properties 

Specify how the background is displayed in a table.

Property Name

Description

bgBorderColor

Select the ellipse_button00469.gif button and choose 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 ellipse_button00470.gif button and choose from the palette to set the background color of the table.

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 ellipse_button00471.gif 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 table and the border.

tableBgColor

Select the ellipse_button00472.gif button and choose from the palette to set the color of empty space in the table area.

Cell Properties 

Property Name

Description

cellBgColor

Select the ellipse_button00473.gif button and choose from the palette to set the background color of the cells.

cellBgStripeContrast

Set the contrast level for alternating row colors.

Note: This property is only applicable if cellBgStripedFlag is selected.

cellBgStripedFlag

Select to display alternating row colors.

cellTextColor

Select the ellipse_button00474.gif button and choose from the palette to set the color of the cell text.

cellTextFont

Select a font for the cell text.

cellTextSize

Specify (in pixels) the size of the cell text or enter -1 to use the default size.

Column Properties 

To resize a column in a rotated table, you must specify the size of each column. Select the ellipsis button ellipse_button00475.gif in the columnProperties property and enter a width for each column.

Interaction Properties 

To specify a drill down target for the table, double-click on the drillDownTarget property in the Object Properties window. Based on your data attachment, preset substitutions are created automatically and passed into your drill down display. To customize which substitutions will be passed into drill down displays, in the Object Properties window double-click on drillDownColumnSubs in the Property Name field. See “Drill Down Properties” and “Drill Down Column Substitutions Dialog” for more information.

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 table. Set to Element Only to enable a drill down display only when you double-click on a cell in a table.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

visFlag

Control visibility of the object.

Object Grid

Display your data in an object grid (obj_objectgrid) by attaching it to the valueTable property. An object grid displays returned data as multiple objects, called icon objects, in a scrollable grid. Each icon object in the grid is analogous to a row of data in the standard table. Icon objects display the data using graphic attributes (e.g., color, dimension, orientation, etc.). The default icon object displayed in the object grid is obj_circ2d_ilvx_ra4 (shown below).

obj_grid_table_gen00476.gif

 

Any object that appears in the Object Palette (with the exception of tables and graphs) can be used as an icon object. To specify which object to use in the object grid, in the Object Properties window, double-click on iconProperties in the Icon category. See “Icon Properties” for more information.

Background Properties 

Specify how the background is displayed in the object grid.

Property Name

Description

bgBorderColor

Select the ellipse_button00477.gif 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 ellipse_button00478.gif button and choose a color from the palette to set the background color of the table.

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 ellipse_button00479.gif 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 table and the border.

Foreground Properties 

Property Name

Description

fgColor

Set the color of the space between the objects. Select the ellipse_button00480.gif button and choose a color from the palette.

fgGradientColor2

Select the ellipse_button00481.gif button and choose a color for the second color in the gradient. Default is white. 

Note: The fgColor property sets the first color in the gradient.

fgGradientMode

Display a gradient in the space between the objects. 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 Top - 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.

Interaction Properties 

To specify a drill down target for the table, double-click on the drillDownTarget property in the Object Properties window. Based on your data attachment, preset substitutions are created automatically and passed into your drill down display. To customize which substitutions will be passed into drill down displays, in the Object Properties window double-click on drillDownColumnSubs in the Property Name field. See “Drill Down Displays” and “Drill Down Column Substitutions Dialog” for more information.

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 object grid. Set to Element Only to enable a drill down display only when you double-click on an object in the grid.

Use the menuItemGroup and rightClickActionFlag properties to extend RTView context menu items. For details, see “Extending the Context Menu”.

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

Sets the height (in pixels) of the object.

objName

Name given to facilitate object management via the Object List dialog. Select Tools>Object List.

objWidth

Sets the width (in pixels) of the object.

objX

Set the x position of the object.

objY

Set the y position of the object.

styleClass

Enter the style class name for this object as defined in your style sheet. If not specified, the object class name is used.

Note: The value entered must not contain spaces and cannot start with rtv-.

transparencyPercent

Set transparency of the object. Enter a value between 0 and 100. A value of 0, the default, sets the object to be completely opaque. A value of 100 will render the object completely transparent.

visFlag

Control visibility of the object.

Sort Properties 

To sort the object grid by a column from the data attachment, enter the name of that column as the Property Value for sortColumnName in the Object Properties window. The column used to sort the object grid must be also be entered as a Property Value for iconProperties (e.g., PERCENTCOMPLETED). See “Icon Properties” (next) for more information.

Icon Properties

In the Object Properties window, double-click on iconProperties in the Property Name field to bring up the Icon Properties dialog. Icon objects in the Object Grid display data using graphic attributes (e.g., color, dimension, orientation, etc.). In the Icon Properties dialog you can assign the icon object(s) you want to use in an Object Grid, and the attributes for each icon object.

Before assigning attributes to icon objects, it is recommended that you attach the Object Grid to data and determine which object(s) you want to use. Objects can be seen in the Object Palette of the Display Builder. All objects in the Object Palette, with the exception of tables and graphs, can be used as an icon object.

Note: If you use a Composite object as the icon, then the bgOpaqueFlag property must be selected on the Object Grid.

Object class names appear in the status bar at the bottom of the window when an object is selected. For custom objects that are not in the standard palette, type in the class name. The object class name is what you need to specify the icon object.

obj_grid_table_iconprops.gif

 

Property Name

Description

Icon Class Name

Select an object from the drop down menu. The default icon object displayed in the Object Grids obj_circ2d_ilvx_ra4. For custom objects that are not in our standard palette, type in the class name.

Property Names

Property Names are populated based on the icon object you choose from the Icon Class Name drop down list. Properties appear in the Property Names column that are associated with the icon object selected from the Icon Class Name drop down list.

Map

Select one of three Map column options:

Default - Select to use the default value for this property. In this case, you do not need to set the Property Value. If the default value for this property changes in future releases of RTView, your icon object will reflect the new default value.   

Value - Select to specify a value. In this case, you need to set the value in Property Value.

Column - Select to specify a column in the data source attached to the Object Grid's valueTable property. In this case, you need to select a column in Property Value.

Property Value

Select a value for the property from the drop down list. Options are populated based on the selections you make for Property Name and Map. For instance, when Map is set to Column, the Property Value drop down lists all columns from the table in valueTable as options to map to.

Allow multiple icon types

Check the box to enable. The Add Icon button appears. This allows you to use different graphic objects to represent different cells of data from each single row of data.

Add Icon

Click Add Icon, select an icon object from the Add Icon dialog drop down menu and click OK. The icon object is added to the list of available icon objects for the Object Grid.

Delete Icon

Removes the icon object from the list available to the Object Grid. If there are multiple icon objects in the list, properties of the selected icon is shown.

See the “Examples” section for an example of how to create an Object Grid with multiple icon objects.

The following describes the Icon Properties dialog commands:

Command

Description

OK

Applies values and closes the dialog.

Apply

Applies values without closing the dialog.

Reset

Resets all fields to last values applied.

Clear

Clears all fields. Detaches object from data source (once Apply or OK is selected).

Cancel

Closes the dialog with last values applied.

Examples

iconProperties

Objective: Create an object grid table using multiple icon objects

obj_grid_table_iconexample2.gif

 

In this example, the object grid table will contain two icon objects. One icon object will display two columns of data from the data source: the Units Completed column and Plant name column. The other icon object will display data from the On Schedule column. The object grid table will look like this:

The data attachment for this exercise contains the following:

Plant

Units Completed

On Schedule

San Francisco

95

true

San Jose

51

false

Dallas

66

true

Chicago

55

false

New York

64

true

Detroit

7

true

To create the object grid table:

1.     Attach an object grid table to the valueTable property.

2.     Double-click on iconProperties (category: Icon). In the Icon Properties dialog:

value - Select Column from the Map drop down menu. Select Units Completed from the Property Value drop down menu.

label - Select Column from the Map drop down menu. Select Plant from the Property Value drop down menu.

Click OK.

We get the following results.

obj_grid_table_iconexample.gif

 

Notice that information from the On Schedule column is not displayed. We have not mapped it to an icon object. Also, notice that the numeric values have changed. This is because we are attaching to live data.

3.     To add another icon object, double click on iconProperties (category: Icon).

4.     In the Icon Properties dialog:

Check the Allow multiple icon types box and click Add Icon.

Select an icon object from the Icon Class Name drop down menu (in this example, obj_indstatus_light) and click OK. The icon object appears in the list of available icon objects for this object grid table.

With the icon object you just added selected in the list of available icon objects, edit the following properties:

label - Select Column from the Map drop down menu. Select On Schedule from the Property Value drop down menu.

status - Select Column from the Map drop down menu. Select On Schedule from the Property Value drop down menu.

Click OK.

We get the following results.

obj_grid_table_iconexample200482.gif

 

The display now shows three columns of data: the Plant and Units Completed columns are shown in the first icon object and the On Schedule column is shown in the second icon object.