interface entity modify
Is used to modify the 'enabled' and 'display' attributes of any GUI entity, such as a label, push button, filed or even a dialog box.
Format:
interface entity modify |
|---|
entity_name = | GRAPHIC_USER_INTERFACE |
enabled = | YES_NO_NO_OPINION |
displayed = | YES_NO_NO_OPINION |
Example:
interface entity modify & |
|---|
entity_name = | .gui.spline_cremod.c_tabular & |
enabled = | NO & |
displayed = | No_OPINION |
Description:
Parameter | Value Type | Description |
|---|
entity_name | AN EXISTING GRAPHIC_USER_INTERFACE | Specifies the name of an existing Graphic User Interface such as a push button, field, label, dialog box and so on. |
enabled | YES_NO_NO_OPINION | Specifies if the entity is editable or otherwise. A no-opinion means that the enabled state of the entity is maintained "as-is". |
displayed | YES_NO_NO_OPINION | Specifies if the entity is visible or otherwise. A no-opinion means that the enabled state of the entity is maintained "as-is". |
Extended Definition:
1. The command is used to modify the "enabled" and "displayed" attributes of GUI entities such as a field, push button dialog and so on.
2. Remember that the rules of hierarchy apply here. For example, if a container is disabled (enabled is set to 'no'), then all elements on the container become disabled as well. When the container is enabled thereafter, the elements on the container, will regain their previous states. For example, if a field on the container were disabled (explicitly) before the container was disabled, it will remain so, even after the container is enabled again.
3. A no-opinion for the displayed/enabled attributes means that the attribute of the entity in consideration will remain unchanged. This is particularly useful, when only one of the attributes (either "displayed" or "enabled") needs to be changed, without altering the other.