diff --git a/docs/xml/lcl/comctrls.xml b/docs/xml/lcl/comctrls.xml index 05aa6805f9..3e85a96f57 100644 --- a/docs/xml/lcl/comctrls.xml +++ b/docs/xml/lcl/comctrls.xml @@ -14781,63 +14781,63 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - + Allow to select several tree-items, e.g. using Ctrl+click and Shift+click. Does the same as MultiSelect property. - + When tree-item gets focus (by user or code), unfold tree to make this item visible. - + Allow to paint horizontal line, below tree-item under cursor, when mouse moves. Good for drag-drop. - + Detect height of tree-item, from current font and icons. - + If control looses focus, then don't paint selection for selected tree-item. Same as HideSelection property. - + Additionally highlight/underline tree-item, when mouse is over it. Same as HotTrack property. - + When some items change, keep previously folded tree-items in folded state. - + Don't allow to change item captions, by clicking on items with a delay. Same as ReadOnly property. - + Right-click also selects tree-item. Else it only calls PopupMenu. Same as RightClickSelect property. - + When tree-item is selected, paint selection background with full width. Same as RowSelect property. - + Show expand/collapse (fold/unfold) icons, at left side, for nodes with sub-nodes. Same as ShowButtons property. - + Show vertical lines, at left side, which paint tree structure for nested nodes. Same as ShowLines property. - + Show root tree-item, which is always present in code, but may be hidden for user. Same as ShowRoot property. - + Show horizontal lines, below all tree-items. - + Show tooltip (hint) for tree-item, when item is too long to fit by width, and mouse is over it. Same as ToolTips property. @@ -16645,10 +16645,10 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - AutoExpand - if True, the tree structure is automatically expanded when a node is selected + + Unfold tree-item, when user clicks it, or item activated by code. @@ -16658,38 +16658,37 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - HideSelection - if True, the selected part of the tree is to be hidden + + If control looses focus, then don't paint selection for selected tree-item. - - HotTrack - the property whereby the item under the mouse pointer becomes emphasised + TCustomListView.HotTrack + Additionally highlight/underline tree-item, when mouse is over it. - - Images - the ImageList to be used in association with the list of TreeNodes + + TImageList object, which holds icons for tree-items. - - Indent - the amount by which each successive level of branching is to be indented in the tree structure + + Size in pixels, by which each nested branching level is to be indented. - - Items - the collection of TreeNodes that comprise the TreeView + Collection of tree-items, which is the content of control. Has type TTreeNodes. @@ -16821,24 +16820,24 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - ReadOnly - if True, the TreeView can only be observed, and not Written to or changed. Default False + + Don't allow to change item captions, by mouse click with a delay. - - RightClickSelect - if True, a Right Click selects an Item. Default False + + Right-click also selects tree-item. Else it only calls PopupMenu. - - RowSelect - if True, a row is selected + + When tree-item is selected, paint selection background with full width. @@ -16856,52 +16855,51 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - ShowButtons - if True, buttons are displayed + + Show expand/collapse (fold/unfold) icons, at left side, for nodes with sub-nodes. - - - ShowLines - show the connecting lines of the tree structure + + + Show vertical lines, at left side, which paint tree structure for nested nodes. - - ShowRoot - if True, the root of the tree structure is displayed + + Show root tree-item, which is always present in code, but may be hidden for user. - - ShowSeparators - if True, separators are shown between items + - - SortType - the way the items are to be sorted: None, by Data, by Text or Both + + Allow to show items sorted: by caption, by Data property, or both. - - StateImages - the list of images to denote state of the tree (expanded, contracted etc) + + TImageList object, which holds icons for tree-item states: normal item, selected item, etc. - - ToolTips - if True (default), pop-up tool tips are to be shown + + Show tooltip (hint) for tree-item, when item is too long to fit by width, and mouse is over it. @@ -17223,10 +17221,10 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - BackgroundColor for the treeview + + Color of background area of control. @@ -17243,10 +17241,10 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - DefaultItemHeight - default height for items on the list - If tvoAutoItemHeight is set in Options this value is set automatically depending on font and icons. + + + Default height of tree-items. If tvoAutoItemHeight is set in Options, this value is detected from font and icons. @@ -17257,10 +17255,10 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - ExpandSignType - the symbols to denote whether a list is expanded or collapsed; default is plus or minus + + Sets shape of expand/collapse (fold/unfold) symbol: plus/minus, empty arrows, filled arrows etc. @@ -17285,36 +17283,17 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - The set of Options for displaying the tree view - -

The set of Options for displaying the tree view

-

List of available options:

-
tvoAllowMultiselect,
-    tvoAutoExpand,
-    tvoAutoInsertMark,
-    tvoAutoItemHeight,
-    tvoHideSelection,
-    tvoHotTrack,
-    tvoKeepCollapsedNodes,
-    tvoReadOnly,
-    tvoRightClickSelect,
-    tvoRowSelect,
-    tvoShowButtons,
-    tvoShowLines,
-    tvoShowRoot,
-    tvoShowSeparators,
-    tvoToolTips,
-    tvoNoDoubleClickExpand
-
-
+ + + Set of additional option flags for treeview.
- - ScrollBars - the style of scroll bars for the treeview display + + Kind of scrollbars: horizontal, vertical, or both. Auto* mean that scrollbars hide automatically. @@ -17324,17 +17303,17 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - SelectionColor - the colour to be used for the selected nodes, to distinguish them from the others + + Color used to paint background of item selection. - - SeparatorColor - the colour to be used for separators + + Color used to paint horizontal lines between items, separators. @@ -17350,17 +17329,17 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - TreeLineColor - the colour to be used for the lines showing the tree structure + + Color used to paint vertical lines, at left side. - - ExpandSignColor - the colour to be used for the expand/collapse symbols + + Color used to paint expand/collapse (fold/unfold) symbol (ie, plus/minus symbol). @@ -17393,8 +17372,7 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - AutoExpand - automatically expand the tree when an item is selected + @@ -17405,8 +17383,8 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove
- - + + @@ -17441,8 +17419,8 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - + + @@ -17471,8 +17449,8 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - + + @@ -17484,28 +17462,23 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - HideSelection - the selected items are to be hidden + - - HotTrack - the property whereby the item under the mouse pointer becomes emphasised + - - TCustomListView.HotTrack - + - The Bitmap image associated with each item in the display + - - Indent - the amount by which each successive branching level is to be indented + @@ -17540,36 +17513,40 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - + + + + + + + + + + + + + + + + + + + + - + + - - - - - - - - - - - - - - - - - - + + @@ -17578,24 +17555,28 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - + + - + + - + + - + + @@ -17616,9 +17597,10 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - + + @@ -17808,8 +17790,8 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - + + @@ -17822,14 +17804,14 @@ If Images.HasOverlays then it is fetched from Images via Images.Overlay(Node.Ove - - + + - - + + @@ -18706,11 +18688,12 @@ the comparision is case sensitive. SelectOnlyThis - method for selecting only the indicated node - - TreeLinePenStyle - the pen style for drawing lines on the tree + + Style of TPen, used to paint vertical lines, at left side. - + + THeaderSectionState - enumerated type containing possible selection states for header @@ -18809,6 +18792,25 @@ the comparision is case sensitive. Executed when user clicked the arrow part for Style=tbsDropDown.It is not executed if DropDownMenu is assigned. Invokes the OnArrowClick event handlerExecuted automatically when user clicked the arrow part for Style=tbsDropDown and no DropDownMenu is assigned. + + + + Allow to select one additonal item, by Ctrl+click. + Allow to select range of items (from previous current item, to clicked one), by Shift+click. + When selecting range with Shift+click, select only visible (unfolded) items. + When selecting range with Shift+click, touch only siblings of previous current item. + Don't expand (unfold) tree-item, by mouse double click. + Use OS themes to paint control elements. + + + + + Size of expand/collapse (fold/unfold) symbol. + Allow to select several tree-items at a time, e.g. using Ctrl+click (select one item more) or Shift+click (select range of items). + Additional options for MultiSelect property. + Color used to paint text of selected item. + Allow to use property SelectionFontColor. If not used, that color is detected automatically. +