FileListMBS.AttributeModificationDateTime(index as integer, UTC as boolean) as DateTime

Either in UTC time zone or in local time zone.
Raises an exception if index is out of bounds. Index is zero based.

FileListMBS.BackupDateTime(index as integer, UTC as boolean) as DateTime

Either in UTC time zone or in local time zone.
Raises an exception if index is out of bounds. Index is zero based.

FileListMBS.Close

There is no need to call this method except you want to free all resources of this object now without waiting for Xojo to do it for you.

FileListMBS.Constructor(filelist as FileListMBS, index as Integer, WinFilter as string = "", SkipMode as Integer = 0)

Var f1 as new FileListMBS(SpecialFolder.UserHome)
'MsgBox f1.path

// search first index of a visible folder
Var IndexOfDirectory as integer = 0
while f1.Directory(IndexOfDirectory) = false or f1.Visible(IndexOfDirectory) = false
  IndexOfDirectory = IndexOfDirectory + 1
wend

// list that folder
Var f2 as new FileListMBS(f1, IndexOfDirectory)
'MsgBox f2.path

// show first file and path
MsgBox f2.Name(0)+EndOfLine+f2.ItemPath(0)

If count is 0 after the contrustor the folder is invalid or empty.
On Windows the WinFilter allows you to pass a custom filter like "*.txt" to only find some files there.

SkipMode, added in version 20.1, allows you to skip some files from being part of the file list. Please use BitwiseOr() to combine Skip flags, e.g. BitwiseOr(SkipHidden, SkipFolders) returns only visible files.

See also:

• Constructor
• Constructor(folder as folderitem, WinFilter as string = "", SkipMode as Integer = 0)
• Constructor(Path as String, WinFilter as string = "", SkipMode as Integer = 0)

FileListMBS.Constructor(folder as folderitem, WinFilter as string = "", SkipMode as Integer = 0)

If count is 0 after the contrustor the folder is invalid or empty.
On Windows the WinFilter allows you to pass a custom filter like "*.txt" to only find some files there.

SkipMode, added in version 20.1, allows you to skip some files from being part of the file list. Please use BitwiseOr() to combine Skip flags, e.g. BitwiseOr(SkipHidden, SkipFolders) returns only visible files.

See also:

• Constructor
• Constructor(filelist as FileListMBS, index as Integer, WinFilter as string = "", SkipMode as Integer = 0)
• Constructor(Path as String, WinFilter as string = "", SkipMode as Integer = 0)

FileListMBS.Constructor(Path as String, WinFilter as string = "", SkipMode as Integer = 0)

If count is 0 after the contrustor the directory path is invalid or empty.
On Windows the WinFilter allows you to pass a custom filter like "*.txt" to only find some files there.

SkipMode, added in version 20.1, allows you to skip some files from being part of the file list. Please use BitwiseOr() to combine Skip flags, e.g. BitwiseOr(SkipHidden, SkipFolders) returns only visible files.

See also:

• Constructor
• Constructor(filelist as FileListMBS, index as Integer, WinFilter as string = "", SkipMode as Integer = 0)
• Constructor(folder as folderitem, WinFilter as string = "", SkipMode as Integer = 0)

FileListMBS.CreationDateTime(index as integer, UTC as boolean) as DateTime

Either in UTC time zone or in local time zone.
Raises an exception if index is out of bounds. Index is zero based.

FileListMBS.Directory(index as Integer) as boolean

True if it is a folder and false if it is a file.
Raises an exception if index is out of bounds. Index is zero based.

FileListMBS.DisplayName(index as Integer) as string

Asks the System for the display name of the item. Returns the normal name on any error.

As this call may cost quite some CPU time you may cache the value if you need it more often.

May return a Unicode string, so be carefull with encoding.
Returns "" on any error.

Raises an exception if index is out of bounds. Index is zero based.

FileListMBS.FinderFlags(index as Integer) as Integer

On Windows and Linux value is 0.

The flag value is a set of bits with the following meaning:

bit 15	value &H8000	isAlias
bit 14	value &H4000	isInvisible
bit 13	value &H2000	hasBundle (has a BNDL resource)
bit 12	value &H1000	nameLocked
bit 11	value &H0800	isStationary
bit 10	value &H0400	hasCustomIcon
bit 8	value &H0100	hasBeenInited (Finder has seen the file since it has been created)
bit 7	value &H0080	hasNoINITs (there is no INIT rsrc in the Extension file)
bit 6	value &H0040	isShared
bits 1-3	value &H000E	color (as a 3-bit value from 0-7)

FileListMBS.Item(index as Integer) as folderitem

Returns nil on any error.
The reason why you use this class is to avoid makeing folderitems which is slow, so don't use this function too often.
Raises an exception if index is out of bounds. Index is zero based.

FileListMBS.ItemPath(index as Integer) as string

Some examples using this method:

• /Util/FileList/FileList Recursive

FileListMBS.LastAccessDate(index as Integer) as Double

On Mac OS the UTC date (+0 time zone)
Raises an exception if index is out of bounds. Index is zero based.

To query Spotlight's Last Open day, please check the FAQ for sampel code.

See also:

• LastAccessDate(index as Integer, UTC as boolean) as Date

FileListMBS.LastAccessDate(index as Integer, UTC as boolean) as Date

Either in UTC time zone or in local time zone.
Raises an exception if index is out of bounds. Index is zero based.
To query Spotlight's Last Open day, please check the FAQ for sample code.

See also:

• LastAccessDate(index as Integer) as Double

FileListMBS.LastAccessDateTime(index as integer, UTC as boolean) as DateTime

Either in UTC time zone or in local time zone.
Raises an exception if index is out of bounds. Index is zero based.
To query Spotlight's Last Open day, please check the FAQ for sample code.

FileListMBS.LogicalDataLength(index as Integer) as Int64

Same value as folderitem.length, but works with files >2GB.
Raises an exception if index is out of bounds. Index is zero based.

Some examples using this method:

• /Util/FileList/FileList Benchmark
• /Util/FileList/FileList Recursive

FileListMBS.LogicalResourceLength(index as Integer) as Int64

Raises an exception if index is out of bounds. Index is zero based.

FileListMBS.ModificationDate(index as Integer) as Double

On Mac OS the UTC date (+0 time zone)
On Windows looks like local timezone.
Raises an exception if index is out of bounds. Index is zero based.

See also:

• ModificationDate(index as Integer, UTC as boolean) as Date

FileListMBS.ModificationDate(index as Integer, UTC as boolean) as Date

Either in UTC time zone or in local time zone.
Raises an exception if index is out of bounds. Index is zero based.

See also:

• ModificationDate(index as Integer) as Double

FileListMBS.ModificationDateTime(index as integer, UTC as boolean) as DateTime

Either in UTC time zone or in local time zone.
Raises an exception if index is out of bounds. Index is zero based.

FileListMBS.Name(index as Integer) as string

May return a Unicode string, so be carefull with encoding.
Returns "" on any error.
Raises an exception if index is out of bounds. Index is zero based.

FileListMBS.PhysicalDataLength(index as Integer) as Int64

Returns 0 on any error.
Raises an exception if index is out of bounds. Index is zero based.

Some examples using this method:

• /Util/FileList/FileList

FileListMBS.PhysicalResourceLength(index as Integer) as Int64

Value is always 0 on Windows.
Returns 0 on any error.
Raises an exception if index is out of bounds. Index is zero based.

Some examples using this method:

• /Util/FileList/FileList

FileListMBS.SortByCreationDate

FileListMBS.SortByFileName

FileListMBS.SortByModificationDate

FileListMBS.TrueItem(index as Integer) as folderitem

Returns nil on any error.
The reason why you use this class is to avoid makeing folderitems which is slow, so don't use this function too often. e.g. good if you just take 5 folderitems for 20000 files by filtering.

TrueItem will use GetTrueFolderItem so the link/alias files are not resolved by Xojo.
Due to bugs in Xojo, you may still get alias resolved.

Some examples using this method:

• /Util/FileList/FileList Benchmark
• /Util/FileList/FileList Listbox
• /Util/FileList/FileList Recursive
• /Util/FileList/Koingo FileList Example

FileListMBS.Visible(index as Integer) as boolean

On Mac OS X, files with name starting with "." are considered to be invisible.
False on any error.
Raises an exception if index is out of bounds. Index is zero based.