Background
Options
Select File>Background Properties
to modify the following settings.

|
Model
Name |
Current background
model. Default model is com.sl.gmsjrtview.m_basemodel.
NOTE: SL-GMS J/Developer and J/Net customers may import subclasses of GmsModelCode
and access renamed variables via the Model Properties dialog. |
Model Width |
Model width and height
in pixels. If you set the model height to a size larger than the display
area, a dialog will appear to confirm whether to add space to the top or
bottom of the display area. If you decrease the size of the model height,
a dialog will appear asking you whether to take space from the top or the
bottom of the display area. In addition, if you decrease the model size
and the objects no longer fit within the display area, you will be asked
to confirm this in a separate dialog.
NOTE: Model Width/Height options are
disabled if you are not using the default model com.sl.gmsjrtview.m_basemodel. |
Model Height |
Model Properties |
Select to open the Model Properties dialog, which lists
attributes of the background model and enables you to edit property
values. Model properties are applied immediately
and cannot be cancelled or reverted to defaults. If the Model Name does
not match the model in the display, the Model Properties dialog is not
accessible. To access Model Properties directly, select Edit>Model Properties. NOTE: See the Object
Properties section for details on editing property values.
If you are using the default
model com.sl.gmsjrtview.m_basemodel the Model Properties are:
Background |
bg3dFlag |
Control visibility
of bevel on background. |
bgBorderColor |
Select the
button and choose a color from the
palette to set the color of the background outline. This property is only
applicable if bgBorderFlag
is selected. |
bgBorderFlag |
Control
visibility of outline on background. |
bgColor |
Select the
button and choose a background color from the palette. |
bgGradientColor2
|
Select the
button and choose a
second color for
background gradient. Default is white. NOTE: The
bgColor property sets
the first color in the gradient. |
bgGradientMode |
Control
style of gradient
fill on background. Select from the following options:
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. |
|
Display Server |
rtvRefreshInterval |
Specify the interval (in seconds) to refresh a display in the client
browser. Minimum interval is 5 seconds. If left blank, the interval defined
in the rtvdisplay.properties
file will be
used. Set to 0 if you do not want displays automatically refreshed. It is
also possible to enter a substitution or attach rtvRefreshInterval
to data. NOTE: The refresh rate specified in the
URL
or DIV tag used to
open a display will override the rtvRefreshInterval property.
|
Interaction
|
onCloseCommand |
Select
Define
Command and choose
SYSTEM, ALERT,
MULTIPLE or your data source.
The specified command will be
activated when this display (.rtv) file is opened/loaded.
NOTE:
When
this property is defined by a
SYSTEM drill down command, this functionality is
not supported in the Display Server. |
onOpenCommand |
Select
Define
Command and choose
SYSTEM, ALERT,
MULTIPLE or your data source.
The specified command will be
activated when this display (.rtv) file is closed/replaced.
NOTE:
When
this property is defined by a
SYSTEM drill down command, this functionality is
not supported in the Display Server. |
resizeHeightMin resizeWidthMin |
Specify (in pixels) the minimum height and width of a display. Default value
for each property is 0, which means the display has no minimum size.
In the Display Viewer Application, a panel
cannot be resized smaller than the minimum size of the display in that
panel.
In the Thin Client, a panel can be resized
smaller than the minimum size of the display in that panel, but (since the
default Resize Mode is Crop) scrollbars will be added.
To set the minimum size for multiple
displays, resizeWidthMin and resizeHeightMin could be specified
in a style sheet, as follows:
m_basemodel {resizeWidthMin:600;
resizeHeightMin:400}
NOTE: If resizeWidthMin or
resizeHeightMin are set to values larger than the specified Model
Width and Model Height, then no minimum size will be enforced on
the display. |
|
Use Background Image |
Select this checkbox to specify a
model file or a bitmap image (.gif,
.jpg or .png) as the display background.
NOTE: If you select to use a background
image, all background model properties will be disabled. |
Image Name |
Use Background Image must be
selected in order to place an image
(.gif, .jpg or .png)
in the background of your display.
Enter the name
(including relative path) of the file or
select the
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 (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 relative path).
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.
NOTE: You can also access your custom image
library by editing any property that allows you to set an image on an object
(e.g. image, barImage and filterProperties properties). |
Resize Mode |
Control object layout when a window
is resized in the current display (.rtv) file. It is also possible to globally
specify a Window Resize Mode, select
Tools>Options>General or set -resizemode on the command line.
In the Display Builder, the selected Resize Mode is
only applied to drill down windows. The main window of the Display Builder is
always in Crop mode.
Select from the
following options:
Default |
Use application
level default mode. Defaults are: Scale for for the Display Builder,
Display Viewer Application and Display Viewer Applet and Crop for the
Thin Client, |
Crop |
When the window is
resized, the display stays the same size. If the window is bigger than the
display, empty space will show around the display. If the window is smaller
than the display, scrollbars will be added. The window is not forced to
maintain its aspect ratio. This is the default for the Thin Client.
|
Scale |
When the window is
resized, the display and all of the objects in it are scaled to fit the
available space. The window is forced to maintain its aspect ratio. This is
the default for the Display Builder, Display Viewer Application and Display
Viewer Applet. |
Layout |
When the window is
resized, the display is resized to fit the available space. The objects in
the display are positioned according to their anchor and dock
properties. The window is not forced to maintain its aspect ratio.
Objects that are not docked or anchored will
move relative to their offset from the top left corner of the display. For
example, if the object is centered on the display, the object will move 50%
of the resize amount. If the object is centered at 3/4 of the display, it
will move 75% of the resize amount.
NOTE: To prevent objects from overlapping,
set resizeWidthMin and
resizeHeightMin. If a panel containing a display is resized, the display
will not reduce smaller than the specified minimum size. |
NOTE: All three resize modes support zooming the
display (right-click -> zoom). In both Scale and Layout modes if
the window is resized while the display is zoomed, then the resize will further
zoom the display. |
Dock Fill Rows
|
Objects in a display that
have the dock property set to Fill are laid out across a grid in
the available space remaining in the display after all docked objects have been
positioned. By default, the grid has one row and as many columns as objects.
If Dock Fill Rows is set to 0 and the Doc
Fill Columns value is specified, then the number of rows will be calculated
based on the number of objects. If a value is specified for both Dock Fill
Rows and Doc Fill Columns, the row value will be used and the number
of columns will be calculated based on the number of objects. If both are set to
0, the default will be used.
Objects are positioned left to right, top to
bottom according to the order in which objects were added to the display. |
Doc Fill Columns |
The following describes the Background
Properties dialog commands:
Command |
Description |
OK |
Applies values
and closes the dialog. |
Apply |
Applies values
without closing the dialog. |
Use
Defaults |
Resets all fields
to default values (once Apply or OK is selected). |
Cancel |
Closes the dialog
with last values applied. |
|