Specifying tree control object layout properties
The following properties specify the layout in the tree control.
anchorSpecifies where to anchor an object in the display. If an object has the dock property set, the anchor property will be ignored.
The anchor property is only applied when the dimensions of the display are modified, either by editing Background Properties or resizing the window in Layout mode.
Select None, or one or more the following options:
None - Object not anchored. This is the default.
Top - Anchor top of object at top of display.
Left - Anchor left side of object at left of display.
Bottom - Anchor bottom of object at bottom of display.
Right - Anchor right side of object at right of display.
When a display is resized the number of pixels between an anchored object and the specified location remain constant. If an object is anchored on opposite sides (that is, top and bottom or left and right), the object will be stretched to fill the available space. If the Resize Mode is set to Scale and an object is anchored on opposite sides, then the object will be moved rather than stretched to fill the available space.
dock Specifies the docking location of an object in the display. An object should not be docked if the Resize Mode is set to Scale.
Select from the following options:
None - Object is not docked. This is the default.
Top- Dock object at top of display.
Left - Dock object at left of display.
Bottom - Dock object at bottom of display.
Right - Dock object at right of display.
Fill - Dock object in available space remaining in the display after all docked objects are positioned.
If the dimensions of the display are modified, either by editing Background Properties or resizing the window in Layout mode, the properties (objX, objY, objWidth and objHeight) of docked objects will automatically adapt to match the new size of the display.
When multiple objects are docked to the same side of the display, the first object is docked against the side of the display, the next object is docked against the edge of the first object, and so on.
When objects are docked to multiple sides of the display, the order in which objects were added to the display controls docking position. For example, suppose the first object added to the display is docked at the top and the second object is docked at the left. Consequently, the first object will fill the entire width of the display and the second object will fill the left side of the display from the bottom of the first object to the bottom of the display.
Objects in a displaythat have the dock property set to Fill, are laid out across a grid in the available space remaining after all docked objects are positioned. By default, the grid has one row and as many columns as there are objects in the display. You can modify the grid in the Background Properties dialog.
Once an object is docked, there are some limitations on how that object can be modified.
Docked objects cannot be dragged or repositioned using
objX and
objY properties.
Docked objects cannot be resized using the
objWidth or
objHeight properties. To resize you must drag on the resize handle.
Docked objects can only be resized toward the center of the display. For example, if an object is docked at the top, only its height can be increased by dragging down toward the center of the display.
Docked objects set to
Fill cannot be resized.
Docked objects cannot be moved using
Align. Non-docked objects can be aligned against a docked object, but a docked object will not move to align against another object.
Docked objects are ignored by
Distribute.
objHeight This property is read-only. It shows the height in pixels of the object, which is set by the height of the tree display.
objName Name given to facilitate object management by means of the Object List dialog. Select Tools > Object List.
objWidth This property is read-only. It shows the width in pixels of the object, which is set by the width of the tree display.
objX Sets the x position of the object.
objY Sets the y position of the object.
visFlag Sets the visibility of the object.
Copyright © 2013
Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or Terracotta Inc., San Francisco, CA, USA, and/or Software AG (Canada) Inc., Cambridge, Ontario, Canada, and/or, Software AG (UK) Ltd., Derby, United Kingdom, and/or Software A.G. (Israel) Ltd., Or-Yehuda, Israel and/or their licensors.