Group |
The Group control is used for grouping multiple controls. A Group control have its own layout, independent of its parent control or XForm. Unlike the Groupbox control, the Group control is not visible during runtime.
The Group control is an autoextent
Properties and Methods of the Control
The Group control has certain properties and methods associated with it. They define the behavior of the control and can be set through the property page of the control or programmatically using the APIs.
Table 1. List of Properties
Design-time property |
Runtime property |
Description |
---|---|---|
|
Sets the string that identifies the control on an XForm. If not specified, a unique ID is automatically generated. |
|
|
Sets the ID of the data model from which the data (specified using the Reference property) is displayed in the control. If model is not specified, it is inherited from the parent control's model. |
|
|
Sets the location or expression for the XPath that contains the data (value) displayed in the control. The XPath refers to the child node or descendants of the immediate parent control's reference. |
|
Parent | Specifies the data binding from the parent. The selected parent is used as the starting point for data references. |
|
Sets or retrieves the class name applied on the control. |
||
Sets the tool tip that appears on a control when the mouse is moved over it. Programmatically, this property is set by specifying the title property of the control. |
||
Task Part |
|
Creates a task part for the control. Selecting the check box, displays the Task Part pane. |
|
Retrieves the root node of the XML data associated with the control; the location of the data is specified by the Reference property. |
|
|
Retrieves the immediate parent of the data that the control represents. This data is the child node of the business object. |
|
|
Retrieves the view object of the data model bound to the control. |
|
|
Retrieves the XML node of the data (value) that the control represents. The location (XPath) of this XML inside the business object is set through the Reference property. |
Event |
Description |
---|---|
This event is activated before the data is bound to a control. |
Table 3. List of Methods
Method |
Description |
---|---|
This method registers the control to receive notifications for an event. |
|
This method is available for data-bound controls only. It creates an instance of the business object for the control. |
|
This method disables the control on which it is invoked. |
|
This method enables the control on which it is invoked. |
|
This method displays the Find dialog box. This is equivalent to clicking in the navigation bar. |
|
This method retrieves data or business object. |
|
This method clears the current model's data and retrieves the first set of records from the application service. |
|
This method clears the current model's data and retrieves the last set of records from the application service. |
|
This methods sends a request to the application service for the next set of records, if available. |
|
This methods sends a request to the application service for the previous set of records, if available. |
|
This method hides controls and all associated child controls. |
|
This method retrieves the value that denotes whether the control is enabled or not. |
|
This method is available for all controls bound to a model. This method refreshes the control with data from the business object that is passed as a parameter. If no parameter is passed, the business object of the model's activeTuple node is used and the control is refreshed. |
|
This method reverts the latest unsaved changes, and binds the control to the latest business object. |
|
This method is available only for data-bound controls. It removes the instances marked for deletion. |
|
This method the unregisters the control to cease receiving notifications for its events. |
|
This method makes the control and its children controls visible. |
|
This method causes an element to receive focus. |