The Field_GetBooleanProperty() function retrieves a specified boolean property for a field.
Field_GetBooleanProperty(field_name, property)
• field_name – The name of a window field.
• property – An integer constant indicating the property to retrieve. The value corresponds to one of the following constants:
![[spacer]](1p.gif){kind=small}
|
Constant |
Description |
|---|---|
|
FIELD_PROP_AUTOCOMPLETE |
True if the string field has AutoComplete enabled. False if it does not. |
|
FIELD_PROP_BDL_DROP_INDICATOR |
True if the drop indicator for a button drop list is displayed. False if it is not. |
|
FIELD_PROP_CANCEL |
True if the field is the Default Cancel for the window. False if it is not. |
|
FIELD_PROP_DEFAULT |
True if the field is the Default OK field for the window. False if it is not. |
|
FIELD_PROP_DISABLED |
True if the field is disabled. False if it is not. |
|
FIELD_PROP_EDITABLE |
True if the field is editable. False otherwise. |
|
FIELD_PROP_FOCUS |
True if the field currently contains the focus. False if it does not. This property is independent of whether the window is active or inactive. |
|
FIELD_PROP_HYPERSPACE |
True if the field is marked as Hyperspace. False if it is not. |
|
FIELD_PROP_LOCKED |
True if the field is locked. False if it is not. |
|
FIELD_PROP_REQUIRED |
True if the field is required. False if it is not. |
|
FIELD_PROP_TAB_STOP |
True if the field is in the tab sequence. False if it is not. |
|
FIELD_PROP_VISIBLE |
True if the field is visiable. False if it is not. |
A boolean indicating how the property is set.
Use the Field_GetBooleanProperty() and Field_SetBooleanProperty() functions to dynamically control which fields in a window are the Default OK and Default Cancel.
Be aware that the required() function will not consider disabled fields required, even though they have the Required property set to true. However, the value retrieved from the FIELD_PROP_REQUIRED property will be true, even if the field is disabled.