ENABLED property (PropertyGrid)
Description
Enables or disables mouse and keyboard input to the entire Property Grid control or an individual property item when specifying an index value.
Property Value
The ENABLED property is a Boolean value of "0" (FALSE) or "1" (TRUE).
Property Traits
Development | Runtime | Indexed | Scaled | Synthetic |
---|---|---|---|---|
Get/Set | Get/Set | ItemPosition, PropertyName | No | No |
Remarks
At runtime an individual property may be referenced via a row index value using the normal Get/Set_Property index parameter. The index value may be the Name of the property item (case-insensitive) or the Position of the property item in the fully-expanded property list.
If the index is omitted the ENABLED property applies to the entire Property Grid control, as per the common ENABLED property.
Example
$Insert Logical CtrlEntID = @Window : ".PRG_MAIN" // Example - Disabling the currently selected property via a position // value. // // Get the currently selected property index (in the fully expanded // list ) SelPos = Get_Property( CtrlEntID, "SELPOSX" ) If ( SelPos ) Then PropIdx = 0 : @Fm : SelPos ; // Column index is ignored Call Set_Property_Only( CtrlEntID, "ENABLED", FALSE$, PropIdx ) End // Example - Enabling the BackColor property by name Call Set_Property_Only( CtrlEntID, "ENABLED", TRUE$, "BackColor" )
See Also
Common ENABLED property