From 741fe7ad70e116a239e3e57e73117c99c21b2855 Mon Sep 17 00:00:00 2001 From: dsiders Date: Mon, 12 Feb 2024 20:15:18 +0000 Subject: [PATCH] Docs: LCL/shellctrls. Updates TCustomShellTreeView topics for changes in 1b2d06b8. Issue #40766. * TCustomShellTreeView.Exists * TCustomShellTreeView.ObjectTypes --- docs/xml/lcl/shellctrls.xml | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) diff --git a/docs/xml/lcl/shellctrls.xml b/docs/xml/lcl/shellctrls.xml index 0de7bda1be..6c140be347 100644 --- a/docs/xml/lcl/shellctrls.xml +++ b/docs/xml/lcl/shellctrls.xml @@ -1023,12 +1023,13 @@ on the tree view control. APath is a UTF-8-encoded fully-qualified path name. File attributes for the argument are retrieved to check whether it exists on the local file system. ObjectTypes is checked to determine whether the item is one of the object types -displayed on the tree view control. +displayed on the tree view control; this includes checking whether the otHidden +object type setting matches the file system attributes for the path.

-The return value is False if both conditions are not satisfied. The -return value is True if APath a valid file (or directory) on the local -file system. +The return value is False if both conditions are not satisfied. +The return value is True if APath a valid file (or directory) on the +local file system.

Exists is used in the UpdateView method when the Path and expanded state for a @@ -1630,21 +1631,24 @@ control. The default value for the property is [otFolders].

-Changing the values in the property causes the Refresh method to be called to -reload the Items for the control starting at the root directory. The -currently Selected tree node is saved before the nodes are refreshed, and -restored when Items has been reloaded. An exception raised when the path no -longer exists in the tree nodes is handled and ignored in the method. +Changing the values in the property causes the UpdateView method to be called +to reload the Items displayed on the control. The currently Selected tree node +is saved before the nodes are refreshed, and restored (when able) when Items +has been reloaded. If the selected path has become invalid after the property +change, an previous path (or the root node) becomes the Selected item on the +control.

- + - + +TCustomTreeView.Selected +TCustomTreeView.TopItem