Vcl.Outline.TOutlineNode.ChangeLevelBy
Delphi
procedure ChangeLevelBy(Value: TChangeRange);
C++
void __fastcall ChangeLevelBy(TChangeRange Value);
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
procedure function |
public | Vcl.Outline.pas Vcl.Outline.hpp |
Vcl.Outline | TOutlineNode |
Description
Changes the level of an outline node.
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.