Focus_Mode - cUIObject
Determines the conditions under which the object will take the focus
Type: Property
Access: Read/Write
Data Type: Integer
Parameters: None
Syntax
Property Integer Focus_Mode
| Access Type | Syntax |
|---|---|
| Read Access: | Get Focus_Mode to IntegerVariable |
| Write Access: | Set Focus_Mode to IntegerVariable/Value |
Description
Focus_Mode determines the conditions under which the object will take the focus.
| Option | Description |
|---|---|
| Valid OptionsOptionDescription | FocusableWhen set to Focusable (default), the object will accept the focus whenever it receives the Activate message. Most objects in an application are set this way and will respond normally to the Activate message. |
| NonFocusable | When set to NonFocusable, the object will refuse to accept the focus. This mode is typically used for objects that need to be placed on the screen but are never allowed to take the focus. Object classes such as TextBoxes and LineControls are activated in this way. |
| No_Activate | When set to No_Activate, the object will always refuse to accept the focus, unless the Popup_State is True and the object is activated via the Popup message. |
Sample
Set Focus_Mode to Focusable
Set Focus_Mode to NonFocusable
Set Focus_Mode to No_Activate
| Col 1 | Col 2 |
|---|---|
| Note: | The Pointer_Only option is not supported under Windows. |
See Also