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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	20.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The attribute modification date of this file or directory.
Notes:
Either in UTC time zone or in local time zone.
Raises an exception if index is out of bounds. Index is zero based.

Feedback, Comments & Corrections

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	20.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The backup date of this file or directory.
Notes:
Either in UTC time zone or in local time zone.
Raises an exception if index is out of bounds. Index is zero based.

Feedback, Comments & Corrections

FileListMBS.Close

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	5.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The destructor.
Notes: 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.

Feedback, Comments & Corrections

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	6.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The constructor which creates a new file list based on item in a given file list.
Example:
Notes:
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)

Feedback, Comments & Corrections

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	5.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The constructor which creates a new file list based on the folder.
Notes:
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)

Feedback, Comments & Corrections

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	16.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The constructor which creates a new file list based on the directory path.
Notes:
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)

Feedback, Comments & Corrections

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	20.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The creation date.
Notes:
Either in UTC time zone or in local time zone.
Raises an exception if index is out of bounds. Index is zero based.

Feedback, Comments & Corrections

FileListMBS.Directory(index as Integer) as boolean

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	5.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Whether the item with the given index is a folder.
Notes:
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.

Feedback, Comments & Corrections

FileListMBS.DisplayName(index as Integer) as string

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	5.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The display name of the item with the given index.
Notes:
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.

Feedback, Comments & Corrections

FileListMBS.FinderFlags(index as Integer) as Integer

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	6.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The Finder flags from Mac OS.
Notes:
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)

Feedback, Comments & Corrections

Protected Sub Dir(f as FolderItem)
  dim l as FileListMBS
  dim i,c as Integer
  
  // search subfolders and find bundles
  
  l=new FileListMBS(f)
  c=l.Count-1
  for i=0 to c
    // if bundle, show it in listbox
    if l.IsBundle(i) then
      ListBox1.AddRow l.Item(i).NativePath
    elseif l.Directory(i) then
      // if sub folder, browse it
      dir l.Item(i)
    end if
  next
End Sub

FileListMBS.Item(index as Integer) as folderitem

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	5.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: Creates a folderitem for the item with the given index.
Notes:
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.
On Mac OS X you always get TrueItem behavior as the plugin doesn't resolve aliases.

Feedback, Comments & Corrections

FileListMBS.ItemPath(index as Integer) as string

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	16.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The native file path for an item.

Feedback, Comments & Corrections

FileListMBS.LastAccessDate(index as Integer) as Double

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	9.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The last access date of this file or directory.
Notes:
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

Feedback, Comments & Corrections

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	13.4	✅ Yes	✅ Yes	✅ Yes	❌ No	Desktop, Console & Web

Function: The last access date of this file or directory.
Notes:
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

Feedback, Comments & Corrections

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

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	20.5	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The last access date of this file or directory.
Notes:
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.

Feedback, Comments & Corrections

FileListMBS.LogicalDataLength(index as Integer) as Int64

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
method	Files	MBS Util Plugin	5.1	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The logical file data length for the item with the given index.
Notes:
Same value as folderitem.length, but works with files >2GB.
Raises an exception if index is out of bounds. Index is zero based.

Feedback, Comments & Corrections