152
H_SCROLLBAR Directive
Control Horizontal Scrollbar
Formats
1. Define/Create: H_SCROLLBAR ctl_id,@(col,ln,wth,ht)[,ctrlopt]
2. Define at Edge of Window: H_SCROLLBAR ctl_id WINDOW[,ctrlopt]
3. Remove: H_SCROLLBAR REMOVE ctl_id[,ERR=stmtref]
4. Disable/Enable: H_SCROLLBAR {DISABLE | ENABLE} ctl_id [,ERR=stmtref]
5. Hide/Show: H_SCROLLBAR {HIDE | SHOW} ctl_id[,ERR=stmtref]
6. Force Focus: H_SCROLLBAR GOTO ctl_id[,ERR=stmtref]
7. Read: H_SCROLLBAR READ ctl_id,setting,max,[rgn_chg][,arrow_chg][,ERR=stmtref]
8. Update: H_SCROLLBAR WRITE ctl_id,marker,max[,ERR=stmtref]
Where:
@(col,ln,
Position and size of the horizontal scrollbar region. Numeric
wth,ht)
expressions. Column and line coordinates for top left corner, width in
number of columns and height in number of lines.
arrow_chg Amount to increase/decrease the H_SCROLLBAR setting when the user
selects the arrow at the left/right edge of the horizontal scrollbar.
Numeric expression. (Default: 1)
ctl_id
Unique logical identifier for a horizontal scrollbar (any integer -32000 to
+32000). Avoid integers that conflict with keyboard definitions (e.g., 4
this value with the apostrophe operator to access various Horizontal
Control options. Supported options for H_SCROLLBAR include
ctrlopt
ERR=stmtref Error transfer
OWN=name$ Name assigned for automated testing of this control.
OPT=char$ Attribute/behaviour settings:
"D" - Disabled. User cannot access the scroll bar.
"G" - Global. Keep active on focus change to new/non-concurrent window.
"H" - Hide. Do not display the scroll bar.
"A" - Auto. Generate CTL signal for each movement.
"s" - Scroll. Allow scroll within resizable/scrollable dialogue box.
Some characters may be combined. Invalid settings are ignored.
H_SCROLLBAR setting. Numeric expression between 1 and the
marker
maximum, max.
Logical maximum value of the H_SCROLLBAR. Numeric expression.
max
Amount to increase/decrease the H_SCROLLBAR setting when the user
rgn_chg
selects the region left/right of the marker. Numeric expression. (Default:
max width.)