Sidebar

reference:scripting_reference:scripting_objects:unsortedfiles

The UnsortedFiles object contains a subset of the items in a Tab object relating to file and folder lists. It is obtained from a Tab object and provides the same set of files in an unsorted state. This is mostly useful with expanded sub-folders or FlatView mode, which normally depth-sort the returned files (deepest first) - accessing through the unsorted objects will return files in the order they appear in the file display.

Property Name Return Type Description

all

object:Items 

Returns an Items object that represents all the files and folders currently displayed in this tab.

Note: The first time a script accesses this property (and all the other properties that return an Items object), a snapshot is taken of all the appropriate items. If the script then makes changes to those items (e.g. by creating a new file, modifying the selection, etc), these changes will not be reflected by the collection. To re-synchronize the collection call the Update method on the object.

dirs

object:Items 

Returns an Items object that represents all the folders currently displayed in this tab.

files

object:Items

Returns an Items object that represents all the files currently displayed in this tab.

hidden

object:Items

Returns an Items object that represents all the files and folders currently hidden from this tab.

hidden_dirs

object:Items

Returns an Items object that represents all the folders currently hidden from this tab.

hidden_files

object:Items

Returns an Items object that represents all the files currently hidden from this tab

highlighted

object:Items 

Returns an Items object that represents all the files and folders currently displayed in this tab that have one or more cells highlighted.

selected

object:Items

Returns an Items object that represents all the selected files and folders currently displayed in this tab. Note that if checkbox mode is turned on in the tab, this will be a collection of checked items rather than selected.

selected_dirs

object:Items

Returns an Items object that represents all the selected folders currently displayed in this tab.

selected_files

object:Items

Returns an Items objects that represents all the selected files currently displayed in this tab

unresolved

object:UnresolvedFiles

Returns an UnresolvedFiles object that provides unresolved, unsorted file collections.