|
SET_FOCUS |
Set Input Focus |
|
1. |
SET_FOCUS ctl_id | |
|
2. |
SET_FOCUS RETRY ctl_id | |
|
3. |
SET_FOCUS READ ctl_id |
|
ctl_id |
Unique control ID of the custom control (button, list_box, drop_box, etc.) to which to direct subsequent input. Numeric expression. |
Use the SET_FOCUS directive to set the focus on the custom control you want to receive the next user input. PxPlus returns an Error #65: Window element does not exist or already exists if you use SET_FOCUS for a non-existent or disabled control item.
Set Focus On
SET_FOCUS ctl_id
Setting the focus to a control directs subsequent terminal input to it unless the user overrides it with the mouse. If the value of the ctl_id is 0, input is directed to the screen
INPUT directive.
button 100,@(10,10,10,2)="Write"
button 101,@(15,10,10,2)="Delete"
set_focus 100
The next keyboard input will be directed to the Write button.
Retry
SET_FOCUS RETRY ctl_id
Use the SET_FOCUS RETRY format to set an internal "modified" flag on the control.
If the user attempts to Tab away from the control, it will retry its associated CTL event. You can use this in input validation (i.e. when an application detects invalid input). You can issue a SET_FOCUS RETRY directive to have PxPlus reprocess the input field whether the user changes something or attempts to Tab away from it.
Read CTL Value
SET_FOCUS READ ctl_id
Use SET_FOCUS READ to obtain the CTL value of the control which currently has focus. The CTL value is 0 if no control has focus.