RTView® 
User Guide


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 multiline 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.

 

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 s
elect the  button to open the Filter Properties dialog.

Background Properties
Specify how the background is displayed in a table.
 
Property Name Description
bgBorderColor Select the  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  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  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  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  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  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 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  in the columnsToHide property and select the checkbox under Hide Column.

To specify numerical or date formats for columns, select the ellipsis button in the columnFormat property. Select the format from the drop down menu in the Column Format column.

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.

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  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.

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.

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. NOTE: If drillDownSelectMode is 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.

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.

Object Properties
 
Property Name Description
anchor  Specify where to anchor an object in the display. NOTE: If an object has the dock property set, the anchor property will be ignored.

The anchor property is only applied when the dimensions of the display are modified, either by editing Background Properties or resizing the window in Layout mode

Select None, or one or more the following options:

None Object not anchored. This is the default.
Top Anchor top of object at top of display.
Left Anchor left side of object at left of display.
Bottom Anchor bottom of object at bottom of display.
Right Anchor right side of object at right of display.

When a display is resized, the number of pixels between an anchored object and the specified location remain constant. If an object is anchored on opposite sides (i.e. Top and Bottom or Left and Right), the object will be stretched to fill the available space.

dock Specify the docking location of an object in the display.

Select from the following options:

None Object is not docked. This is the default.
Top Dock object at top of display.
Left Dock object at left of display.
Bottom Dock object at bottom of display.
Right Dock object at right of display.
Fill Dock object in available space remaining in the display after all docked objects are positioned.

If the dimensions of the display are modified, either by editing Background Properties or resizing the window in Layout mode, the properties (objX, objY, objWidth and objHeight) of docked objects will automatically adapt to match the new size of the display.

When multiple objects are docked to the same side of the display, the first object is docked against the side of the display, the next object is docked against the edge of the first object, and so on.

When objects are docked to multiple sides of the display, the order in which objects were added to the display controls docking position. For example, let's say the first object added to the display is docked at the Top and the second object is docked at the Left. Consequently, the first object will fill the entire width of the display and the second object will fill the left side of the display from the bottom of the first object to the bottom of the display.

Objects in a display have the dock property set to Fill, are laid out across a grid in the available space remaining after all docked objects are positioned. By default, the grid has one row and as many columns as there are objects in the display. You can modify the grid in the Background Properties dialog.

Once an object is docked, there are some limitations on how that object can be modified.

  • Docked objects cannot be dragged or repositioned using objX and objY properties.
  • Docked objects cannot be resized using the objWidth or objHeight properties. To resize you must drag on the resize handle.
  • Docked objects can only be resized toward the center of the display (e.g. If an object is docked at the Top, only its height can be increased by dragging down toward the center of the display).
  • Docked objects set to Fill cannot be resized at all.
  • Docked objects cannot be moved using Align. Non-docked objects can be aligned against a docked object, but a docked object will not move to align against another object.
  • Docked objects are ignored by Distribute.
objHeight  Set height of the object in pixels.
objName Name given to facilitate object management via the Object List dialog. Select Tools>Object List.
objWidth Set width of the object in pixels.
objX 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.

Sort Properties
Select the showSortIconFlag checkbox to enable column sorting. To sort a table by a specific column, click on the column header.  To reverse the sort order, click on the column header again.  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.
 


 
SL, SL-GMS, GMS, RTView, SL Corporation, and the SL logo are trademarks or registered trademarks of Sherrill-Lubinski Corporation in the United States and other countries. Copyright © 1998-2012 Sherrill-Lubinski Corporation. All Rights Reserved.

 

JMS, JMX and Java are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries. They are mentioned in this document for identification purposes only. 

 

Third Party Notice Requirements