SET-FOCUS Action

This document covers the following topics:


Description

Selects a dialog element so that the end user can enter data with the keyboard. You can use this action with handles of the following dialog elements: Bitmap Control, Edit Area Control, Input Field Control, List Box Control, Push Button Control, Radio Button Control, Scrollbar Control, Selection Box Control, Toggle Button Control. You can also use this action with a dialog's window handle, for example, with "#DLG$WINDOW".

Note:
It is not recommended to execute the SET-FOCUS action from the leave event, because the leave event implies that the focus is to be set to yet another part of the application.

Parameters

Name/Data Type Explanation
HANDLE OF GUI Input

Any dialog element of the above-mentioned type that is supposed to get the focus.

Response (I4) Output

Natural error (if applicable).

Example:

 
#INPUT := #IF-1 
PROCESS GUI ACTION SET-FOCUS WITH #INPUT 
GIVING #RESPONSE