RAD Studio VCL Reference
ContentsIndex
PreviousUpNext
TOutlineNode.ChangeLevelBy Method
TOutlineNode Class | TOutlineNode Members | Outline Namespace | Description | See Also
Collapse All

Changes the level of an outline node.

Pascal
procedure ChangeLevelBy(Value: TChangeRange);
C++
__fastcall ChangeLevelBy(TChangeRange Value);
Description

Call ChangeLevelBy to move a node up or down a branch in the outline. Specify a Value parameter value of -1 to move up (toward the root) one level. Specify a Value parameter value of 1 to move down (away from the root) one level. 

When moving up one level, an item becomes the next sibling of its former parent. When moving down one level, an item becomes the last child of its former prior sibling.  

Nodes at the first level can not be moved up, as they have no parent. The first node in the outline can not be moved down either, as it has no prior sibling.

Note: Before calling ChangeLevelBy, be sure that the node has the appropriate number of parents or that the appropriate prior siblings exist.
 

 

See Also
Copyright(C) 2009 Embarcadero Technologies, Inc. All Rights Reserved.
What do you think about this topic? Send feedback!