SetFocus

Description

Sets the focus on the specified object or control.

Applies to

Any object

Syntax

objectname.SetFocus ( )

Argument

Description

objectname

The name of the object or control in which you want to set the focus

Returns

Integer. Returns 1 if it succeeds and -1 if an error occurs. If objectname is null, SetFocus returns null.

Usage

If objectname is a ListBox, SetFocus displays the focus rectangle around the first item. If objectname is a DropDownListBox, SetFocus highlights the edit box. To select an item in a ListBox or DropDownListBox, use SelectItem.

Drawing objects cannot have focus. Therefore, you cannot use SetFocus to set focus to in a Line, Oval, Rectangle, or RoundRectangle.

Examples

Example 1

This statement in the script for the Open event in a window moves the focus to the first item in lb_Actions:

lb_Actions.SetFocus()

See also