Docs: LCL/shellctrls. Clarifies content in the TCustomShellTreeView.FileSortType topic.

This commit is contained in:
dsiders 2025-02-02 18:42:55 -05:00
parent 3a07a26d47
commit 6c528d9822

View File

@ -1725,14 +1725,15 @@ enumeration values and their meanings.
</p> </p>
<p> <p>
Changing the value in <var>FileSortType</var> causes the <var>Items</var> Changing the value in <var>FileSortType</var> causes the <var>Items</var>
property to be cleared, and tree nodes to be reloaded. If Root has not been property to be cleared, and tree nodes to be reloaded using the sort order
assigned, PopulateWithBaseFiles is used to fill the Items property. needed for the property value. If Root has not been assigned,
If Root has a non-empty value, an internal routine is called to recreate the PopulateWithBaseFiles is used to fill the Items property. If Root has a
root node using the required path. The value in Root is expanded and used to non-empty value, an internal routine is called to recreate the root node using
create the remaining nodes for the tree. This includes filling the required path. The value in Root is expanded and used to create the
TShellTreeNode-specific information for the TTreeNode instances in Items. If remaining nodes for the tree. This includes filling TShellTreeNode-specific
the path to the Selected tree node is still valid for the file system, it is information for the TTreeNode instances in Items. If the path to the Selected
restored to the Path property. tree node is still valid for the file system, it is restored to the Path
property.
</p> </p>
<p> <p>
No action other than setting the property value is performed in the method at No action other than setting the property value is performed in the method at
@ -1743,6 +1744,10 @@ The value in FileSortType is used in the PopulateTreeNodeWithFiles method and
passed as an argument to an internal method used to load the files in a given passed as an argument to an internal method used to load the files in a given
path name. path name.
</p> </p>
<p>
Use the OnSortCompare event handler to implement the sort / compare routine
needed when FileSortType is set to fstCustom.
</p>
<remark> <remark>
The value in FileSortType is not used in <var>PopulateWithBaseFiles</var> on The value in FileSortType is not used in <var>PopulateWithBaseFiles</var> on
Windows platforms. The entries are logical drive letters processed in the Windows platforms. The entries are logical drive letters processed in the
@ -1750,14 +1755,15 @@ order provided by the file system.
</remark> </remark>
</descr> </descr>
<seealso> <seealso>
<link id="TFileSortType"/>
<link id="EInvalidPath"/>
<link id="TCustomShellTreeView.Items"/> <link id="TCustomShellTreeView.Items"/>
<link id="TCustomShellTreeView.Root"/> <link id="TCustomShellTreeView.Root"/>
<link id="TCustomShellTreeView.Path"/> <link id="TCustomShellTreeView.Path"/>
<link id="TCustomShellTreeView.ExistsAndIsValid"/> <link id="TCustomShellTreeView.ExistsAndIsValid"/>
<link id="TCustomShellTreeView.OnSortCompare"/>
<link id="TCustomShellTreeView.PopulateWithBaseFiles"/> <link id="TCustomShellTreeView.PopulateWithBaseFiles"/>
<link id="TCustomShellTreeView.PopulateTreeNodeWithFiles"/> <link id="TCustomShellTreeView.PopulateTreeNodeWithFiles"/>
<link id="TFileSortType"/>
<link id="EInvalidPath"/>
</seealso> </seealso>
</element> </element>
@ -1997,6 +2003,7 @@ Added in LCL version 3.0.
<link id="TCustomShellTreeView.ExistsAndIsValid"/> <link id="TCustomShellTreeView.ExistsAndIsValid"/>
<link id="TCustomShellTreeView.PopulateTreeNodeWithFiles"/> <link id="TCustomShellTreeView.PopulateTreeNodeWithFiles"/>
<link id="TCustomShellTreeView.PopulateWithBaseFiles"/> <link id="TCustomShellTreeView.PopulateWithBaseFiles"/>
<link id="TFileSortType"/>
</seealso> </seealso>
</element> </element>