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