From 00037248cf8d1e4f062a9b71c029a3d0a9716d11 Mon Sep 17 00:00:00 2001
From: dsiders
- TListColumn is the type used for items added to the TListColumns collection. + TListColumn is the type used for items added to the TListColumns collection, and maintained in the TCustomListView.Columns property.
-+ Calls the inherited method to move the collection item to the position indicated in the property value. Calls the ColumnMove method in the widgetset class to reorder the column in the control. +
++ GetDisplayName returns the Caption for the control, and when blank, calls the inherited method to the property value. +
++ Create is the constructor for TListColumn, and sets the default values for properties, including: +
++ Create calls the inherited Create method to instantiate the class instance and assign the value in ACollection as the owner for the class instance. +
++ Destroy is the destructor for TListColumn. When the collection allows updates, the update is suppressed for the column instance that is being destroyed. Calls the inherited method to clear the owner for the collection item and destroy the class instance. The columnDelete method in the widgetset class is called to remove the column. +
++ Assign is an overridden method used to implement object persistence for the TListColumn type. It copies property values from the persistent object in ASource into the current class instance. When ASource is derived from TListColumn, the following properties are copied: +
++ The Changed method is called to signal a change in the values for the collection item. +
++ If ASource is not derived from TListColumn, the inherited method is called using ASource as an argument. An EConvertError exception is raised if ASource has not been assigned (contains Nil). +
++ WidthType is a read-only TWidth property. Provided for VCL code compatibility. +
+ Left or right justified, or centered. +
+
OnDrawItem is a TLVDrawItemEvent property which is the event handler signalled to render an owner drawn item. The event is triggered (when assigned) in the DrawItem method only when OwnerDraw is set to True and ViewStyle contains vsReport.
@@ -10306,7 +10356,7 @@
- Create is the overridden constructor for TCustomListView. It calls the inherited Create method, and allocates resources needed for the class instance. It sets the default values for properties and the control style flags. It creates a TChangeLink instance for the image lists in SmallImages, LargeImages, and StateImages. The change links are configures to use the ImageChange and ImageResolutionHandleDestroyed methods in their event handlers. It also creates the TCustomListViewEditor instance used to edit values in the list view control.
+ Create is the overridden constructor for TCustomListView. It calls the inherited Create method, and allocates resources needed for the class instance. It sets the default values for properties and the control style flags. It creates a TChangeLink instance for the image lists in SmallImages, LargeImages, and StateImages. The change links are configured to use the ImageChange and ImageResolutionHandleDestroyed methods in their event handlers. It also creates the TCustomListViewEditor instance used to edit values in the list view control.
+ IconOptions is a TIconOptions property with the icon options used when the list view uses the vsIcon or vsSmallIcon view style. Values in IconOptions are passed to the widgetset class to render the control using the native style or API for the platform. Set values in its properties to control the icon placement, auto-arrange features, and caption text wrapping for a list item on then control.
+
Items - the list of entries in the list. Held as a linked list with a cached index of the last accessed item.
@@ -10694,7 +10748,7 @@
+ OwnerData is a Boolean property which enables or disables virtual mode for the list view control.
+
+ When set to True, the Items property does not contain the actual data displayed on the control. The display values are retrieved using the OnData, OnDataFind, and OnDataHint event handlers. Only the most recently accessed owner data item exists in the list view control. This allows the list view to be used to display a large number of items with a minimal amount of overhead.
+
+ Set the value for the Count property in Items to indicate the number of owner data items available to the list view control. Assign a routine to OnData to populate an individual list item (and sub-items if needed) from the source for the owner data.
+
+ When OwnerData is set to False, all values displayed on the list view control are maintained in the Items property.
+
+ SelCount is a read-only Integer property with the number selected entries in Items. SelCount is relevant when MultiSelect is set to True; otherwise, the single selected item is found in the Selected property.
+
+ If the Handle has been allocated for the widgetset class, the value from the GetSelCount method is used as the property value. Otherwise, the property value is calculated by counting the number of TListItem instances in Items that have their Selected property set to True. The return value is 0 when none of the Items have a selected property set to True.
+
+ Use GetNextItem with the lisSelected item state to retrieve a multi-selected item that is adjacent to another selected item.
+
+ Selected is a TListItem property which contains the selected list item in the list view control. Assign a value from the Items property to select the list item.
+
+ When MultiSelect is enabled, Selected represents the first entry in Items that has its Selected property set to True. If none of the list items has its Selected property set to True, or SelCount is 0, the property value is Nil.
+
+ When OwnerData (or Virtual Mode) is enabled, Selected refers to the most recent owner data item retrieved when the value in ItemIndex was changed. If the item index was set to -1, the property value is Nil.
+
+ Assigning a new value to Selected causes the existing list item in the property to be updated. In single select mode (MultiSelect = False), the Selected property for the list item is set to False prior to clearing or reassigning the property value.
+
+ When MultiSelect is enabled, setting a new value for the property causes the list item to be included in the list of multi-selected Items. If the new value is Nil, all of the entries in Items reset their Selected properties to False. In short, setting Selected to Nil clears any existing multi-selections in Items.
+
+ Setting a new value for the property causes the OnChange and OnSelectItem event handlers to be signalled (when assigned) when the LVN_ITEMCHANGED notification message is handled for the control.
+
+ Use ClearSelection to remove all selections (single or multi-) for the control.
+
+ Use SelectAll to select all list items when MultiSelect is enabled.
+
+ Calls the RegisterCustomImage method in the widgetset class.
+
Overridden to ensure proper handling of the WS_CHILD flag in Style in the Parent control.
@@ -123,7 +123,7 @@
@@ -209,10 +209,11 @@ TCommonDialog.Execute TCommonDialog.UserChoice + TOpenDialog.DoExecute
@@ -311,7 +312,7 @@
@@ -321,6 +322,7 @@
@@ -393,7 +395,7 @@
@@ -567,7 +571,7 @@
@@ -601,11 +605,11 @@
+ Change is an overridden method used to perform actions needed when the value for the control has been changed. In TPickListCellEditor, it ensures that the grid control is notified when the value in the cell editor has been changed. +
++ Changed calls the inherited method to signal the OnChange event handler (when assigned). +
++ DefineProperties is an overridden method used to define the properties which are included during LCL component streaming. The TFiler instance in Filer is used to set the read and write procedures for specific properties. In TGridColumnTitle, the Caption is written when it has an explicit non-default value. This implements the storage specifier declared for the property. +
++ Assign is an overridden method used to implement object persistence for the class. When Source is a TGridColumnTitle instance, the values from the following properties are copied: +
++ If Source is not derived from TGridColumnTitle, the inherited method is called using Source as an argument. +
+- When Grid has been assigned, the TitleFont property from the Grid is used in the Font property. Otherwise, the Font from the Column is used. IsDefaultFont is set to True in the method. + When Grid has been assigned, the TitleFont property from the Grid is used in the Font property. Otherwise, the Font from the Column is used. IsDefaultFont is set to True in the method.
- ScaleFontsPPI is an overridden procedure used to... + ScaleFontsPPI is an overridden procedure used to scale the size for the fonts in the Grid and Title properties to the specified display density (PPI) (Pixels Per Inch). +
++ AToPPI contains the value assigned to the fonts used when a non-zero value is specified. +
++ If AToPPI is omitted, the scaling factor in AProportion is used to adjust the existing PPI setting in the fonts by the indicated factor. +
++ ScaleFontsPPI is called when the AutoAdjustLayout method is used to apply a layout policy to a control.
+ DefaultWidth is a read-only Integer property with the default width used for the column. The property value is read from the DefaultColWidth property in the Grid control (when assigned). If it is not assigned, the property value is -1. +
+ TListWithEvent is a TList descendant which implements a list with an event handler signalled when values are added to or removed from the container. It provides an overridden Notify method which signals the event handler (when assigned) for add or delete operations. Assign an object procedure using the signature in TListChangeEvent to the OnChange event handler to respond to the notification. +
++ Notify is an overridden method in TListWithEvent. It calls the inherited method to notify registered observers of the change to the list. It signals the OnChange event handler (when assigned) using the values in Ptr and AnAction as arguments. +
++ Signalled from the Notify method (when assigned). +
+