ControlContext :: activated - Activated property
The activated property indicates, whether a control is connected with its data (true) source or not (false). The active state is a hierarchical state, i.e. activating or deactivating a control will activate/deactivate all subordinated controls.
Deactivating a control becomes necessary, when the data source changes. Usually, property(rProperty) is called in order to set a new data source. In this case, deactivate and activate is done by the property() function. When, however, just re-opening the data source (Property::open()), the application explicitly must deactivate the control before re-opening the property handle and activating it afterwards calling activated().
... fragment ( ControlContext control, String new_path ) {
control.activated(false); // deactivate control
// reopen datasource
control.property.open(control.database,new_path);
control.activated(true); // activate control
}
A State true indicates, that the function was executed successfully. Otherwise state is false.
Implementation overview
- Is conbtrol activated?
ControlContext :: activated (  ) - Change active state for control
ControlContext :: activated ( bEnable )
Implementation details
-
Is conbtrol activated?
bool ControlContext  :: activated (  )
The function returns, whether the control is activated (true) or not (false).
to list
-
Change active state for control
bool ControlContext  :: activated ( bool bEnable )
In order to reactivate the control, true should be passed in bEnable. Activating a control will re-open the data source for the control and activate all subordinated controls.
In order to deactivate the control, false has to be passed in bEnable. Deactivating a control will close the data source for the control and deactivate all subordinated controls. One should activated(true) in order to re-activate the control. Deactivated controls are visible but not filled and appear similar as disabled controls.
- bEnable
- Enable resource
In order to enable the referenced resource true should be passed. Passing false will disable the resource.
to list
- bEnable
- Enable resource