diff --git a/docs/xml/lcl/comctrls.xml b/docs/xml/lcl/comctrls.xml index d829261310..36958d5bba 100644 --- a/docs/xml/lcl/comctrls.xml +++ b/docs/xml/lcl/comctrls.xml @@ -34454,31 +34454,101 @@ ShowButtons is used during the paint process in the DoPaintNode method. - Enables or disables the horizontal and vertical lines which join nodes in the tree hierarchy. - - + +

+ShowLines is a Boolean property used to enable or +disable drawing of lines which connect the nodes on the tree view control. +When enabled, a line is drawn to connect a tree node to its parent, sibling +and child nodes. Values in TreeLineColor and TreeLinePenStyle are used to draw +the connector lines in the DoPaintNode method. +

+

+ShowLines is a convenience property; its value is read from and written to the +Options for the control. ShowLines contains True when the value +tvoShowLines has been included in Options. Changing the value for the property +causes Options to be updated to include or exclude tvoShowLines as needed for +the Boolean value. The control is redrawn when Options is modified. +

+

+The default value for the ShowLines property is True. +

+
+ + + + + + + +
-Enables or disables drawing the root node indicator for the tree view control. +Enables or disables drawing the root node for the tree view control. - - + +

+ShowRoot is a Boolean property which Enables or disables +drawing the root node for the tree view control. +

+

+When enabled, the root node is represented by an expand / collapse indicator +which does not contain any text. Top-level nodes which have child nodes also +have expand / collapse indicators when ShowRoot is enabled. When disabled, the +expand / collapse indicators at the top-level of the node hierarchy are +omitted and only the text for the top-level nodes is displayed. The default +value for the property is True. +

+

+ShowRoot is a convenience property; its value is read from and written to the +Options for the control. ShowRoot contains True when the value +tvoShowRoot has been included in the Options property, and False if the +value has been omitted. Changing the value for the property causes Options to +be updated to include or exclude tvoShowRoot as needed for the Boolean value. +The control is redrawn when the value in Options is modified. +

+
+ + + + + + + + + +
-Indicates if horizontal separator lines are drawn between nodes in the tree -view control. +Indicates whether horizontal separator lines are drawn between nodes on the +tree view control. - - + +

+ShowSeparators is a Boolean property which enables or disables drawing of +separator lines between the nodes on the tree view control. +

+ +In the current LCL version, the TTreeView descendant does not raised the +visibility of this protected property. + +
+ + + + + + + +
@@ -34506,7 +34576,8 @@ control. tool tips (pop-up hints) are enabled for nodes on the tree view control. A tool tip is activated when the mouse pointer is hovered over a node. The text displayed on the tool tip is set to the Text property in the TTreeNode -instance. +instance. The tool tip is displayed only when the text for the node is longer +than the available display area on the control.

ToolTips is a convenience property; it indicates whether tvoToolTips has been @@ -34522,6 +34593,11 @@ events like: DoMouseWheel, DoMouseWheelHorz, and MouseMove. ToolTips is temporarily disabled when a drag operation is started for a node on the tree view control.

+

+Use Hint and ShowHint to enable or disable a pop-up hint window on the +control. Both Hints and ToolTips can be active at the same time - but the +effect may be a little overwhelming. +

@@ -34531,6 +34607,8 @@ on the tree view control. +TControl.Hint +TControl.ShowHint