From 835c32c6a1d73b2b47db5e29bb8abae84397530d Mon Sep 17 00:00:00 2001 From: dsiders Date: Wed, 27 Jul 2022 20:05:07 +0100 Subject: [PATCH] Docs: LCL/shellctrls. Fixes grammar in topics and tagging for True, False values. --- docs/xml/lcl/shellctrls.xml | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/xml/lcl/shellctrls.xml b/docs/xml/lcl/shellctrls.xml index 5e8f719c49..7b0699d0ad 100644 --- a/docs/xml/lcl/shellctrls.xml +++ b/docs/xml/lcl/shellctrls.xml @@ -456,13 +456,13 @@ Draws the Shell Icon for the specified tree node.

- DrawBuiltInIcon is an overridden TSize function used draw an icon in the tree using the Shell icon for the file or folder name in ANode. It re-implements the method in the TCustomTreeView ancestor, and does not call the inherited method. + DrawBuiltInIcon is an overridden TSize function used to draw an icon on the tree using the Shell icon for the file or folder name in ANode. It re-implements the method in the TCustomTreeView ancestor, and does not call the inherited method.

- When UseBuiltinIcons is True, the internal GetShellIcon routine is called to get the icon used for the file. The icon is drawn on the control Canvas using the rectangle in ARect. The icon is centered vertically in the specified rectangle. + When UseBuiltinIcons is True, the internal GetShellIcon routine is called to get the icon used for the entry. The icon is drawn on the control Canvas using the rectangle in ARect. The icon is centered vertically in the specified rectangle.

- The return value contains the dimensions for the icon as a TSize instance. When UseBuiltinIcons is False, the return value always contains a TSize instance with both the Width (CX) and Height (CY) are set to 0 (zero). The size may also be empty (0, 0) if an icon was not found or returned for the file system entry by the widgetset class instance. This can occur when the file represented by ANode has been removed from the file system. + The return value contains the dimensions for the icon as a TSize instance. When UseBuiltinIcons is False, the return value always contains a TSize instance with both the Width (CX) and Height (CY) set to 0 (zero). The size may also be empty (0, 0) if an icon was not found or returned for the file system entry by the widgetset class instance. This can occur when the entry represented by ANode has been removed from the file system.

DrawBuiltInIcon is defined for the Windows platform only; it requires use of the SHGetFileInfoW routine in the FPC ShellApi.pp unit. @@ -497,7 +497,7 @@ When UseBuiltinIcons is True, the internal member used for the icon size is checked. It is used when explicit values have been set for the Width and Height in the TSize instance. If the default values (0) are in Width and Height, the internal GetShellIcon routine is called to get the icon size used for Drive letter designations. It is assigned as the return value for the method, and stored in the internal member.

- When UseBuiltinIcons is False, the return value always contains a TSize instance with both the Width (CX) and Height (CY) are set to 0 (zero). + When UseBuiltinIcons is False, the return value always contains a TSize instance with both the Width (CX) and Height (CY) set to 0 (zero). The size may also be empty (0, 0) if an icon was not found or returned for the file system entry by the widgetset class instance. This can occur when the entry represented by ANode has been removed from the file system.

GetBuiltinIconSize is defined for the Windows platform only; it requires use of the SHGetFileInfoW routine in the FPC ShellApi.pp unit. @@ -522,7 +522,7 @@ NodeHasChildren signals the OnHasChildren event handler (when assigned) to get the return value for the method. The shell tree view class instance and the value in Node are passed as arguments to the event handler.

- When an event handler has not been assigned, the return value is set to True when the specified Node is a Directory on the local file system. + When an event handler has not been assigned, the return value is set to True if the specified Node is a Directory on the local file system.

The return value is also True when the path to the node can be accessed as a sub-directory in Node (when ObjectTypes does not include otNonFolders objects). Include otHidden in ObjectTypes to include hidden directories in the comparison. @@ -624,7 +624,7 @@ GetPathFromNode casts the tree node in ANode to a TShellTreeNode type to access the file system-specific properties and methods for the node.

- When IsDirectory returns True, the return value contains the path to the folder with a trailing path delimiter. Otherwise, the return value has the fully-qualified path for the file. + When IsDirectory returns True, the return value contains the path to the folder with a trailing path delimiter. Otherwise, the return value has the fully-qualified path for the file.

An absolute path in the return value includes the root directory prepended to the value. @@ -860,7 +860,7 @@ OnAddItem is a TAddItemEvent property which contains the event handler signalled when an item (tree node) is added to the shell control. OnAddItem is signalled from the PopulateTreeNodeWithFiles method, and allows the base path and file information for each file to be checked before it is added to the Items for the tree view control.

- An application must implement and assign an object procedure using the signature in TAddItemEvent to the handler. The Sender argument is the tree view control for the event notification. ABasePath contains the value from BasePath in the tree view control. AFileInfo is a TSearchRec instance with the attributes for the file system object represented in the node. CanAdd is a variable parameter which indicates whether the file system object should be added to the Items property. Set CanAdd to False in the event handler to omit the file system object in Items. + An application must implement and assign an object procedure using the signature in TAddItemEvent to the handler. The Sender argument is the tree view control for the event notification. ABasePath contains the value from BasePath in the tree view control. AFileInfo is a TSearchRec instance with the attributes for the file system object represented in the node. CanAdd is a variable parameter which indicates whether the file system object should be added to the Items property. Set CanAdd to False in the event handler to omit the file system object in Items.

@@ -914,10 +914,10 @@

- ParentColor determines if the control should use the Color from the Parent control, when enabled. The default value for the property is False in TShellTreeView. + ParentColor determines if the control should use the Color from the Parent control, when enabled. The default value for the property is False in TShellTreeView.

- When this property is True, all changes to the Color of the parent will also be applied to the Color of the control, ensuring that they both contain same value. If the Color of the control is changed by the application, then ParentColor will be automatically set to False. + When this property is True, all changes to the Color of the parent will also be applied to the Color of the control, ensuring that they both contain same value. If the Color of the control is changed by the application, then ParentColor will be automatically set to False.

@@ -1311,7 +1311,7 @@ - Set the argument to True to allow the item to be added; set to False to prevent adding the item. + Set the argument to True to allow the item to be added; set to False to prevent adding the item. @@ -1676,10 +1676,10 @@ Uses the Color from the Parent control, when enabled.

- ParentColor determines if the control should use the Color from the Parent control, when enabled. The default value for the property is False in TShellListView. + ParentColor determines if the control should use the Color from the Parent control, when enabled. The default value for the property is False in TShellListView.

- When this property is True, all changes to the Color of the parent will also be applied to the Color of the control, ensuring that they both contain same value. If the Color of the control is changed by the application, then ParentColor will be automatically set to False. + When this property is True, all changes to the Color of the parent will also be applied to the Color of the control, ensuring that they both contain same value. If the Color of the control is changed by the application, then ParentColor will be automatically set to False.

Using ParentColor when the Color value is clDefault can cause problems in resolving the actual color value. To obtain the Color property of a control while taking into account clDefault and ParentColor, use the GetColorResolvingParent method. This method might return a non-RGB color, but will never return clDefault. To obtain a purely RGB result use the GetRGBColorResolvingParent method.