363
V_SCROLLBAR Directive
Control Vertical Scrollbar
Formats
1. Define/Create: V_SCROLLBAR ctl_id,@(col,ln,wth,ht)=contents$[,ctrlopt]
2. Define at Edge of Window: V_SCROLLBAR ctl_id WINDOW [,ctrlopt]
3. Remove: V_SCROLLBAR REMOVE ctl_id[,ERR=stmtref]
4. Disable/Enable: V_SCROLLBAR {ENABLE | DISABLE} ctl_id[,ERR=stmtref]
5. Hide/Show: V_SCROLLBAR {HIDE | SHOW} ctl_id[,ERR=stmtref]
6. Force Focus: V_SCROLLBAR GOTO ctl_id[,ERR=stmtref]
7. Read: V_SCROLLBAR READ ctl_id,setting,max,[rgn_chg][,arrow_chg][,ERR=stmtref]
8. Update: V_SCROLLBAR WRITE ctl_id,marker,max[,ERR=stmtref]
Where
@(col,ln,
Position and size of the vertical scrollbar region. Numeric expressions.
wth,ht)
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 V_SCROLLBAR setting when the user
selects the arrow at the top/bottom edge of the vertical scrollbar.
Numeric expression. (Default: 1)
ctl_id
Unique logical identifier for a vertical 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 Variable List
Control options. Supported options for V_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 scrollbar.
"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.
Relative position to set as the V_SCROLLBAR marker. Numeric
marker
expression between 1 and the maximum.
Logical maximum value of the V_SCROLLBAR. Numeric expression.
max
Amount to increase/decrease the V_SCROLLBAR setting when the user
rgn_chg
selects the region left/right of the marker. Numeric expression. (Default:
max/width.)
setting
Numeric variable to receive the current scrollbar setting.