DlgFocus Statement, DlgFocus() function

DlgFocus Identifier
DlgFocus()

The DlgFocus statement is used within a dialog function to set the focus on the dialog box control identified by Identifier while the dialog box is displayed. When a dialog box control has the focus, it is active and responds to keyboard input. For example, if a text box has the focus, any text you type appears in that text box.

The DlgFocus() function returns the string identifier for the dialog box control that currently has the focus.

This example sets the focus on the control MyControl1 when the dialog box is initially displayed. (The main subroutine that contains the dialog box definition is not shown.)

Function MyDlgFunction( identifier, action, suppvalue )
Select Case action
   Case 1   ' The dialog box is displayed
      DlgFocus MyControl1
   Case 2   ' Statements that perform actions based on which control
            ' is selected.
   End Select
End Function