Workbench User Guide : Creating and Using Basic Fields : Scalar Fields : Bar Fields
 
Share this page          
Bar Fields
A bar field is a form field that appears as a rectangle that represents a numeric value. The bar is displayed against a background, and the bar size compared to the background size illustrates the proportional value of the field. You specify the background size, and OpenROAD calculates the bar size based on the field's current value. Typically, a bar is sed for display only.
Bars are especially useful for creating bar graphs. Another effective way to use a bar is as a “percentage completed” indicator. A bar used in this manner provides feedback to the user about the progress of an activity.
Create a Bar Field
You can create a bar field on a form.
To create a bar field
1. Open your frame in the Frame Editor (see Open an Existing Frame).
2. Select the Bar Field icon on the field palette.
3. Position and size the bar field.
4. Set the properties for the bar field.
For complete descriptions of each field property, see Bar Field Properties and Common Field Properties.
Bar Field Properties
All the properties for bar fields are described under Common Field Properties, with the exception of the following properties that are specific to the bar field type:
FgBitmap
If set to Bitmap, specifies the graphic image that is to be used for the bar's foreground when FgPattern is set to FP_BITMAP.
Default: No Bitmap
FgPattern
Specifies a foreground pattern for a bar field only. Valid options are:
FP_BITMAP*
FP_BITMAPCLEAR*
FP_CLEAR
FP_CROSSHATCH
FP_DARKSHADE
FP_HORIZONTAL
FP_LIGHTSHADE
FP_SHADE
FP_SOLID
FP_VERTICAL
FP_DEFAULT
Default: FP_DEFAULT
Note:  *If you set this property to FP_BITMAP, you also must set the BgBitmap property to a bitmap image. If the file is a transparent bitmap, set this property to FP_BITMAPCLEAR.
GrowFrom
Specifies the starting position for the bar. As the value of the field increases, the bar grows from the specified edge to the opposite edge. Valid options are:
GF_DEFAULT (system default value)
GF_TOP
GF_BOTTOM
GF_LEFT
GF_RIGHT
Default: GF_BOTTOM
MaxValue
Specifies the highest possible value for the field
MinValue
Specifies the lowest possible value for the field