2.6 .active

This attribute can be used to define and query the Application object to determine whether the application is currently running. Changing this attribute from false to true starts the application. Changing this attribute from true to false terminates the application.

Edittext

The Attribute .active defines, if the editable text has a focus.

Notepage

For a notepage, .active = true for the page that is currently the topmost notepage; for all other notepages, .active = false. This means that this attribute can only have the value true for one notepage at a time.

The notepage label of this notepage is stored in the .activeobject attribute of the notebook.

Control

Activation state of an OLE object.

OLE controls can be activated or deactivated using the .active attribute.

Timer

This attribute can be used to define and query whether the Timer is currently running. Changing this attribute from false to true starts the timer. Changing this attribute from true to false resets the timer and is no longer active.

Image

For an image, .style = checkbox determines whether the object is displayed as active (pressed) or inactive, or it can read the object's current state. In conjunction with .picture[enum], the currently displayed tile resource can be determined.

.style = menubox , the object is active when the context menu is open.

Menuitem

For a menuitem with .style = checkbox, the active attribute determines whether the menu item is enabled (check mark is visible) or not. In .style = radiobutton, only the value true for enabled is allowed; however, both states (enabled or disabled) can be read.

Tablefield

To activate input mode by the application, the tablefield object provides the indexed (.active[I,J]) and non-indexed (.active) attributes. Setting the non-indexed .active attribute results in the following behavior:

Action	current state	Reaction
active := true	Focus on sensitive field	Input mode will be enabled if it isn't already active. If input mode is already active, nothing happens.
active := false	Focus on sensitive field	Input mode is disabled if it is active. Otherwise nothing happens
active := true / false	Focus on not sensitive field	No response from the object. .active is reset to false by the Dialog Manager
active := true / false	Focus on no field in the tablefield but in the corner or on one of the scrollbars	No response from the object. .active is reset to false by the Dialog Manager
active := true	Tablefield doesn't have	.active is reset to false by the Dialog Manager. Otherwise, no reaction
User activates input		.active is set to true

See also

Attribute .activeitem