Properties of the TREE VIEW Object

Specifies the element to which an event affecting the object is applied.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the horizontal bar below the object, or when he/she resizes the window below and when the split bar expands (VERTICAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_HEIGHT) and if the object belongs to one of the bottommost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the vertical bar to the left of the object, or when he/she resizes the window below and when the split bar expands (HORIZONTAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_WIDTH) and if the object belongs to one of the rightmost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the vertical bar to the right of the object, or when he/she resizes the window below and when the split bar expands (HORIZONTAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_WIDTH) and if the object belongs to one of the rightmost views.

Note: This property is not implemented in Java and Mobile generation.

Defines the adjustment of an object placed in the view of a split bar object, when the user drags the horizontal bar above the object, or when he/she resizes the window above and when the split bar expands (VERTICAL_ADJUSTMENT property equal to _SPLT_ADJUST_EXPAND_HEIGHT) and if the object belongs to one of the bottommost views.

Note: This property is not implemented in Java and Mobile generation.

Allows the object to be placed in focus. Objects placed in focus will respond to the user's keyboard and mouse actions.

RGB color used to draw the background for the object.

Note: This property is not implemented in Mobile generation.

Specifies the use of a check box for each element in the object. This property can be used to simulate multiple element selections.

Specifies whether the object can be the destination of drag and drop operations (new version only).

Note: This property is not implemented by the Java generator.

Specifies the display of a double border.

Enables or disables the triggering of events that start drag and drop operations from the element on which the user has clicked.

The old version of drag and drop used the mouse to move an element from a starting position to an end position within the object's tree structure.

With the new version, data can be transferred to any other object that also supports drag and drop, including objects in a different application.

If the DRAG_DROP property of the element on which the user clicks is set to *TRUE, the object receives a DD_BeginDrag or BeginDragDrop event, depending on the drag and drop version used.

With the old version, the drag and drop operation is divided into With the old version, the drag and drop operation is divided into three steps:

• • Start the drag and drop procedure by clicking on the chosen element and keeping the left mouse button depressed. The mouse cursor's appearance will change. The object receives the BeginDragDrop event.

• • Move the chosen element (while still holding down the left mouse button). When the mouse cursor is moved over an element in the tree structure, either:

1. the mouse cursor's appearance does not change, informing the user that the selected element can be released in that position,
2. the mouse cursor appears as follows: (no parking sign). The user will not be able to release the selected element in that position.

When the element under the mouse pointer changes and is not the element being dragged, the object receives the MoveDragDrop event.

• End the drag and drop procedure by releasing the left mouse button while the cursor is over a permitted element.

We recommend using the new version.

Lets you specify whether, during a drag and drop operation, the user can drop the selected element onto the element currently under the mouse pointer. This element is contained in the ACTION_ELEMENT property.

Note: The DRAG_DROP_ACTION property only relates to the old version of drag and drop. We recommend using the new version of the drag and drop feature.

Note: This property is not implemented by the Cloud generator.

Specifies the format used to display the value of a treeview's element.

Specifies the use of expand / collapse buttons for node handling. If this property is set to *TRUE, an expand / collapse button will appear to the left of each node. You can expand or collapse the associated node by clicking on this button.

Specifies the format used to display the value of a treeview's element.

Specifies the display of a border with embedded outlines.

Specifies the first visible element in the object (the one highest up within the object). To make an element visible, the object expands all parent links that are not already expanded, then attempts to move the element as far up the object's graphical area possible. As a result, there may be a discrepancy between the value assigned to this property and the value retrieved.

Character font used to display the text of all elements in the object.

The string format contains the name, size, style and script, in that order. A semi-colon must be inserted between each element.

If you set a property's value, you MUST specify the name and size.

The different styles are specified using the following values:

• • 1: Normal (no special style)
  • 2: Strikethrough
  • 16: Italics
  • 256: Bold
  • 4096: Underlined

The style value to be specified in the string can either be one of the above values or else the sum of values other than 1.

The different script values are as follows:

Note:

The size, style and script must be compatible with the chosen font. The Windows system font selection dialog box, accessible via the graphical object's Properties pages, provides a guide for selecting coherent values.

Specifies how the selected element is to be shown. If this property is set to *TRUE, the element's whole line will be selected. If this property is set to *FALSE, only the text in the element's line will be selected.

Note: this property is not implemented by the Java generator and in Mobile generation.

Specifies the first object in an object group. An object group is defined by its first object, and includes all the objects following it (according to the object sequence) until the first object in another group is reached. The user can use the arrow keys to change focus from one object to another within the same group.

Lets you modify an element's text. If this property is set to *TRUE, you will be able to enter text by clicking on the selected element.

Specifies the display of a link between a node and its children.

Note: This property is not implemented by the Java generator.

Object's height value.

Defines how the graphical control is adjusted when the window is resized horizontally.

Note: This property is not implemented in Java and Mobile generation.

Specifies the filter used when the characters for an element in the object are entered.

This property can only be used to specify what Adelia type the element is. If an input control is set for an element, it is possible to indicate an edit word or code to format the text, should the element be modifiable or not.

Specifies the display of a link between all the branches leading from the root node.

Static name of the object.

Number of decimal places in the Adelia type for an element in the object. The Adelia type is described implicitly by the value of the INPUT_CONTROL property. This number is only useful in describing NUM_E and NUM_P Adelia types. This value must be between 0 and 9.

Authorizes the object to draw itself over a control positioned in front of it in the window object order.

In the particular case where the window has a background image with transparent images placed in foreground, it is necessary to set the property to *TRUE if you wish to put the object after a "transparent" object in the tab order.

Reminder: an "overlapped" object must be placed after the background image, while a "non-overlapped" object must be placed before the background image.

For more information about managing overlapping of graphical objects, consult the working with object overlap section.

Note: This property is not implemented by the Java and Mobile generators.

Specifies the use of scroll bars inside the object (only visible if required).

Note: This property is not implemented in Mobile generation.

Specifies the element selected in the object. This property can either take the value of the parameter ElementId entered when the ADD method is called, or else one of the two constants defined below.

Used to manage how the selected element is displayed when the object loses the focus. If this property is set to *TRUE, the element will remain selected onscreen. If this property is set to *FALSE, the selected object will be deselected.

Specifies how node expansion / collapsing is managed. If this property is set to *TRUE, the user will only be able to expand one node at a time, by clicking on the associated text.

Specifies the display of a border with static outlines (3D effect used to show objects not immediately placed in focus).

Allows the object to be placed in focus using the keyboard (Tab key or Shift+Tab).

RGB color used to draw the elements' text.

Note: This property is not implemented in Mobile generation.

Enables the element under the mouse cursor to be highlighted. The text for this element will be displayed underlined and in system color used for hypertext link (by default: blue).

Length of the Adelia type for an element in the object. The Adelia type is described implicitly by the value of the INPUT_CONTROL property. This length is only useful in describing ALPHA, NUM_E and NUM_P Adelia types. This value must be greater than 0.

Defines how the graphical control is adjusted when the window is resized vertically.

Note: This property is not implemented in Java and Mobile generation.

Visibility of the object. Only visible objects can be placed in focus.

Object's width value.

Value of the object's X coordinate, relative to the area covered by the window. The reference point (origin) is the top left-hand corner of the object.

Y coordinate value of the object's position relative to the area covered by the window, page or pane. The reference point (origin) is the top left-hand corner of the object.

• Page:
  Events of the TREE VIEW Object
• Page:
  Methods of the TREE VIEW Object
• Page:
  Properties of the TREE VIEW Object
• Page:
  Properties Relating to Events of the TREE VIEW Object
• Page:
  TREE VIEW (Visual Adelia Context)