diff --git a/docs/xml/lcl/comctrls.xml b/docs/xml/lcl/comctrls.xml index 2c3c6f48d3..b1014161bd 100644 --- a/docs/xml/lcl/comctrls.xml +++ b/docs/xml/lcl/comctrls.xml @@ -7049,7 +7049,7 @@ end; Checked is a Boolean property which indicates if a check mark is displayed for the list item. Checked allows specific list items to be marked for inclusion in methods for the list view control, such as Sort.

- The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid and its Checkboxes property is set to True. + Checked is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid.

@@ -7059,6 +7059,8 @@ end; + + @@ -9752,8 +9754,26 @@ end;

- TListViewProperty is an enumerated type with values representing Boolean properties used in TCustomListView. + TListViewProperty is an enumerated type with values representing Boolean properties used in TCustomListView. This includes the following:

+

Values from the enumeration are included in or excluded from the TListViewProperties set type. When a value is included in the set, the corresponding Boolean property has been set to True. When a value is excluded from the set, the corresponding Boolean property has been set to False.

@@ -9818,8 +9838,26 @@ end; TListViewProperties is a set type used to store zero or more values from the TListViewProperty enumeration.

- The set represents Boolean property values found in TCustomListView / TListView. When a value is included in the set, the corresponding property in TCustomListView has been set to True. The value is excluded from the set when the corresponding property in TCustomListView is set to False. + The set represents Boolean property values found in TCustomListView / TListView. When a value is included in the set, the corresponding property in TCustomListView has been set to True. The value is excluded from the set when the corresponding property in TCustomListView is set to False. The following properties in TCustomListView are presented in the set type:

+

TListViewProperties is the type used to implement the internal FProperties member in TCustomListView.

@@ -10233,6 +10271,8 @@ end;
  • MultiSelect
  • ReadOnly
  • RowSelect
    • +
  • AutoArrange
    • +
  • WrapText

    • See SetProperty for the write access specifier equivalent. @@ -10578,6 +10618,8 @@ end;

  • MultiSelect
  • ReadOnly
  • RowSelect
    • +
  • AutoArrange
    • +
  • WrapText

    • This technique allows multiple Boolean properties to be represented using a single set type member variable. It avoids allocating a Boolean member for each of the property values. @@ -11896,7 +11938,10 @@ end;

    - ColumnClick is an indexed Boolean property which controls whether the OnColumnClick event handler is signalled when a Report view column is clicked. The default value for the property is True. Changing the value for the property causes the widgetset class to be updated with the new property value. + ColumnClick is an indexed Boolean property which controls whether the OnColumnClick event handler is signalled when a Report view column is clicked. The default value for the property is True. +

    +

    + ColumnClick is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new property value.

    ColumnClick is used in the ColClick method, which is called when the LVN_COLUMNCLICK control notification message is handled for the list view control. @@ -11905,6 +11950,8 @@ end; + + @@ -11958,16 +12005,19 @@ end;

    - HideSelection is a Boolean property which indicates if the selected item(s) for the list view are highlighted when the control loses focus. When set to True, the selected item(s) are redrawn to remove the selection highlighting. When set to False, the selection hightlighting is retained when the control loses focus. + HideSelection is a Boolean property which indicates if the selected item(s) for the list view are highlighted when the control loses focus. When set to True, the selected item(s) are redrawn to remove the selection highlighting. When set to False, the selection highlighting is retained when the control loses focus. The default value for the property is True.

    - The default value for the property is True. Changing the value for the property causes the widgetset class to be updated with the new value. + HideSelection is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value.

    - The Windows API documentation recommends setting HideSelection to False if the application uses Accessiblity roles and descriptions. + The Windows API documentation recommends setting HideSelection to False if the application uses Accessibility roles and descriptions.     - + + + + @@ -12023,11 +12073,16 @@ end;

    When set to True, the OnDrawItem event handler is signalled to draw list items when the control is using the Report view style (ViewStyle = vsReport). The handler is signalled (when assigned) from the DrawItem method, and occurs when the CN_DRAWITEM control notification message is handled for the control. It should handle all aspects of drawing the list item to the control Canvas. If OnDrawItem has not been assigned, a basic default drawing routine is used.

    +

    + OwnerDraw is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value. +

    + +     @@ -12053,15 +12108,17 @@ end; Show header area in ListView, which shows captions of columns.

    - ShowColumnHeaders is a Boolean property which indicates whether column headers are displayed for the Report view style (ViewStyle = vsReport). When enabled, the captions for the list Items are displayed as column headers. + ShowColumnHeaders is a Boolean property which indicates whether column headers are displayed for the Report view style (ViewStyle = vsReport). When enabled, the captions for the list Items are displayed as column headers. The default value for the property is True.

    - The default value for the property is True. Changing the value for the property causes the widgetset class to be updated when its Handle has been assigned. + ShowColumnHeaders is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value.

    + + @@ -12073,11 +12130,17 @@ end;

    ShowWorkAreas is an indexed Boolean property used to configure whether work areas are displayed on the control.

    +

    + ShowWorkAreas is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value. +

    Work areas are not implemented (for any platform) in the current LCL version. - + + + + @@ -12221,13 +12284,30 @@ end; - Indicates if a hint (tool tip) is automatically displayed for an item under the mouse cursor. + Indicates if a hint (tool tip) is automatically displayed for the list item under the mouse cursor. - + +

    + ToolTips is a Boolean property which enables or disables display of a tool tip or hint window when the mouse pointer is hovered over a list item on the control. The default value for the property is True, and allows the tool tip to be displayed. +

    +

    + Use the Hint property for the text displayed in the hint window. Or, use the OnShowHint event handler to assign a custom value. For example: +

    +procedure TForm1.ListView2ShowHint(Sender: TObject; HintInfo: PHintInfo); +begin + HintInfo^.HintStr := 'This is the hint for ' + Sender.ClassName; +end; +

    + ToolTips is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value. +

    +     TControl.Hint + TControl.OnShowHint + +     @@ -12848,7 +12928,7 @@ end;

    - AlphaSort is Boolean function used to apply an ascending alphabtic sort order to the list items in the control. The sort order is always applied to Column 0 (the list item and not its sub-items). + AlphaSort is Boolean function used to apply an ascending alphabetic sort order to the list items in the control. The sort order is always applied to Column 0 (the list item and not its sub-items).

    AlphaSort updates values in the SortDirection, SortType, and SortColumn properties. Flag values for the control are updated to include lffPreparingSorting prior to setting the property values; this suppresses reordering until the changes are completed. @@ -13223,7 +13303,11 @@ end;

    - Checkboxes is a Boolean property which indicates if check boxes are displayed next to list items on the control. The default value for the property is False. Changing the value for the property causes the widgetset class to be updated. + Checkboxes is a Boolean property which indicates if check boxes are displayed next to list items on the control. The default value for the property is False. +

    + +

    + CheckBoxes is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value.

    Use the OnItemChecked event handler to perform actions needed when the check state for a list item has been changed. @@ -13298,21 +13382,34 @@ end;

    - FlatScrollBars is a Boolean property which indicates if scroll bars are drawn using a "flat" display style. Flat scroll bars are not drawn using raised 3-D relief with shadowing normally used for borders or edges on the control. It also applies color inversion when elements in the control are hovered under the mouse pointer. + FlatScrollBars is a Boolean property which indicates if scroll bars are drawn using a "flat" display style. Flat scroll bars are not drawn using raised 3-D relief with shadowing normally used for borders or edges on the control. It also applies color inversion when elements in the control are hovered under the mouse pointer. The default value for the property is False.

    - The default value for the property is False. Changing the value for the property causes the widgetset class to be updated. + FlatScrollBars is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value.

    - + + + +     - Indicates whether column headers are redrawn during a column drag or resizing operations. + Indicates whether column headers are redrawn during a column drag or resizing operation. - - + +

    + FullDrag is a Boolean property which indicates whether column headers are redrawn when a column drop or a column resize operation is in effect. The default value for the property is False. +

    +

    + FullDrag is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value. +

    +     + + + +     @@ -13321,10 +13418,16 @@ end;

    - GridLines is a Boolean property used to enable or disable drawing of a 1-pixel grid line between rows and columns on the control. The default value for the property is False, and hides the grid lines. Changing the value for the property causes the widgetset class to be updated. + GridLines is a Boolean property used to enable or disable drawing of a 1-pixel grid line between rows and columns on the control. The default value for the property is False, and hides the grid lines. +

    +

    + GridLines is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value.

    - + + + +     @@ -13338,6 +13441,9 @@ end;

    When enabled, a list item is automatically selected (or de-selected) when the mouse pointer is hovered over a list item for a short period of time. It can be used in MultiSelect mode when the Shift, Ctrl, or Shift+Ctrl keys are held while moving and hovering the mouse pointer.

    +

    + HotTrack is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value. +

    Use HoverTime to specify the hover duration (in milliseconds) before a list item toggles its selected state.

    @@ -13352,6 +13458,8 @@ end; + +     @@ -13390,7 +13498,7 @@ end; The list item which has focus on the control.

    - ItemFocused is a ItemFocused property which contains the list that has focus on the list view control. The property value is Nil if a list item has not been focued on the control. Changing the value in the property to a valid list item causes the widgetset class to be updated when its Handle has been assigned. + ItemFocused is a ItemFocused property which contains the list that has focus on the list view control. The property value is Nil if a list item has not been focused on the control. Changing the value in the property to a valid list item causes the widgetset class to be updated when its Handle has been assigned.

    ItemFocused is updated when a LVN_ITEMCHANGED notification message with a focus state change is handled for the list view control. @@ -13470,6 +13578,9 @@ end; Toggles the selected state for a contiguous block of list items from the mouse pointer to the previously focused list item. +

    + MultiSelect is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value. +

    Use SelCount to get the number of selected items when MultiSelect is enabled. Use Items to access the list items to check the values in their Selected properties.

    @@ -13487,6 +13598,8 @@ end; + +     @@ -13507,6 +13620,10 @@ end;

    When OwnerData is set to False, all values displayed on the list view control are maintained in the Items property.

    + +

    + OwnerData is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value. +

    @@ -13514,6 +13631,8 @@ end; + + @@ -13526,8 +13645,14 @@ end;

    The default value for the property is False, and indicates that item editing is allowed.

    +

    + ReadOnly is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value. +

    - + + + + @@ -13536,25 +13661,13 @@ end;

    - RowSelect is a Boolean property which indicates whether all columns in the row are highlighted when the row is selected. The default value for RowSelect is False, and indicates that a single column/row value is displayed using the selected highlighting. RowSelect is used in report mode (ViewStyle = vsReport). + RowSelect is a Boolean property which indicates whether all columns in the row are highlighted when the row is selected. The default value for RowSelect is False, and indicates that only the row value in the first column is displayed using the selected highlighting. RowSelect is used in report mode (ViewStyle = vsReport).

    - RowSelect is one of several properties represented as a TListViewProperty enumeration value (lvpRowSelect), and passed to the widgetset class in a TListViewProperties set type. Others properties represented in the set type include: -

    -
      -
    • CheckBoxes
      • -
    • FlatScrollBars
      • -
    • FullDrag
      • -
    • GridLines
      • -
    • HotTrack
      • -
    • MultiSelect
      • -
    • ReadOnly
      • -
    -

    - Changing the value for the property causes the widget to be notified of a change in the set when its handle has been allocated. + RowSelect is one of the TListViewProperty values included in the TListViewProperties set type and exchanged with the widgetset class. The property value is read from and written to the TCustomTreeview widgetset class instance when its handle is valid. Changing the value for the property causes the widgetset class to be updated with the new value.

    - Use MultiSelect to enable multi-selection of rows and/or columns. + Use MultiSelect to enable multi-selection of rows and/or columns on the list view control.