Platforms to show: All Mac Windows Linux Cross-Platform

FolderItem class

• 16 properties
  • property AccessDateMBS(UTC as boolean = false) as date
  • property AccessDateTimeMBS(UTC as boolean = false) as DateTime
  • property AddedToDirectoryDateMBS as date
  • property AddedToDirectoryDateTimeMBS as DateTime
  • property AttributeModificationDateMBS(UTC as boolean = false) as date
  • property AttributeModificationDateTimeMBS(UTC as boolean = false) as DateTime
  • property BackupDateMBS(UTC as boolean = false) as date
  • property BackupDateTimeMBS(UTC as boolean = false) as DateTime
  • property BackupItemExcludedMBS as boolean
  • property CommentMBS as string
  • property CreationDateMBS(UTC as boolean = false) as date
  • property CreationDateTimeMBS(UTC as boolean = false) as DateTime
  • property FinderLabelMBS as Integer
  • property MacQuarantinePropertiesMBS as MacQuarantinePropertiesMBS
  • property ModificationDateMBS(UTC as boolean = false) as date
  • property ModificationDateTimeMBS(UTC as boolean = false) as DateTime
• 137 methods
  • method AbsolutePath as string
  • method AbsolutePathMBS as string
  • method BackupIsItemExcludedMBS(byref excludeByPath as boolean) as boolean
  • method BackupSetItemExcludedMBS(exclude as boolean, excludeByPath as boolean) as Integer
  • method CalculateDirectorySizeMBS(recursive as boolean = false, ticks as Integer = 0, QueryCompressedSizes as boolean = false, RecursionLimit as Integer = -1) as DirectorySizeMBS
  • method CompressedFileLengthMBS as int64
  • method CreateLargeBinaryStreamMBS(MacType as string, MacCreator as string) as LargeBinaryStreamMBS
  • method CreateResStreamMBS(MacType as string, MacCreator as string) as ResStreamMBS
  • method CreatorAppMBS as FolderItem
  • method CreatorAppMBS(creatorCode as String) as FolderItem
  • method DarwinMediaClassMBS as string
  • method DarwinMediaInfoMBS as CFDictionaryMBS
  • method DarwinVolumeNameMBS as string
  • method DeleteDataForkMBS
  • method DeleteResourceForkMBS
  • method DisplayPathMBS(delimiter as string = "/") as string
  • method EjectVolumeMBS(force as boolean, byref dissenterPID as Integer) as Integer
  • method FilesMBS as FolderItem()
  • method FlushVolumeMBS as Integer
  • method FoldersMBS as FolderItem()
  • method FontActivateMBS(OnlyLocal as boolean) as Integer
  • method FontDeactivateMBS(OnlyLocal as boolean) as Integer
  • method GetFileFlagsMBS as Integer
  • method GetFolderFlagsMBS as Integer
  • method GetVolumeRefMBS as Integer
  • method HasUnresolvedConflictsMBS as boolean
  • method IconImageMBS(width as Integer, WindowsFlags as Integer=0) as picture
  • method IconMaskMBS(width as Integer, WindowsFlags as Integer=0) as picture
  • method IconMBS(width as Integer, WindowsFlags as Integer=0) as picture
  • method isApplicationMBS as boolean
  • method isBundleMBS as boolean
  • method IsCompressedFileMBS as Boolean
  • method IsDownloadedMBS as boolean
  • method IsDownloadingMBS as boolean
  • method IsEjectableVolumeMBS as Boolean
  • method IsEncryptedFileMBS as Boolean
  • method IsFileDataForkOpenReadWriteMBS as boolean
  • method IsFileResourceForkOpenReadWriteMBS as boolean
  • method IsOnRemoteVolumeMBS as Boolean
  • method IsUbiquitousItemMBS as boolean
  • method IsUploadedMBS as boolean
  • method IsUploadingMBS as boolean
  • method ItemsMBS as FolderItem()
  • method KindMBS as string
  • method LaunchMBS(inFront as Boolean) as Boolean
  • method LaunchServicesApplicationForItemMBS(role as Integer) as folderitem
  • method LaunchServicesApplicationsForItemMBS(role as Integer) as LaunchServicesApplicationListMBS
  • method LaunchServicesCanApplicationAcceptItemMBS(TargetApp as folderitem, role as Integer, flags as Integer) as boolean
  • method LaunchServicesDisplayNameMBS as string
  • method LaunchServicesItemInfoMBS(WhichInfo as Integer) as LaunchServicesItemInfoMBS
  • method LaunchServicesKindStringMBS as string
  • method LaunchServicesOpenMBS as folderitem
  • method LaunchServicesRegisterMBS(update as boolean) as Integer
  • method LogicalFileDataLengthMBS as int64
  • method LogicalFileResLengthMBS as int64
  • method LogicalFileTotalLengthMBS as int64
  • method LongPathMBS as string
  • method MacCopyObjectMBS(DestinationFolder as folderitem, DestinationName as string, byref Result as folderitem, Options as Integer) as Integer
  • method MacIsHardLinkedMBS as boolean
  • method MacMoveObjectMBS(DestinationFolder as folderitem, DestinationName as string, byref Result as folderitem, Options as Integer) as Integer
  • method MacMoveObjectToTrashMBS(byref Result as folderitem, Options as Integer) as Integer
  • method MacNodeIDMBS as UInt64
  • method MacParentDirectoryIDMBS as UInt64
  • method MacResolveNodeIDMBS(NodeID as UInt64) as folderitem
  • method NameExtensionMBS as string
  • method NameWithoutExtensionMBS as string
  • method NativePath as string
  • method NewCGPDFDocumentMBS(MediaBox as CGRectMBS, title as string, author as string, creator as string) as CGPDFContextMBS
  • method NewCGPDFDocumentMBS(MediaBox as CGRectMBS, title as string, author as string, creator as string, subject as string, keywords as string, OwnerPassword as string, UserPassword as string, AllowsPrinting as boolean, AllowsCopy as boolean) as CGPDFContextMBS
  • method NewCGPDFDocumentMBS(MediaBox as CGRectMBS, title as string, author as string, creator as string, subject as string, keywords as string, OwnerPassword as string, UserPassword as string, AllowsPrinting as boolean, AllowsCopy as boolean, KeyLength as Integer) as CGPDFContextMBS
  • method NewCGPDFDocumentWithInfoMBS(MediaBox as CGRectMBS, info as object) as CGPDFContextMBS
  • method OpenAsCGPDFDocumentMBS as CGPDFDocumentMBS
  • method OpenAsGIFMBS as GIFMBS
  • method OpenAsJPEGMBS as picture
  • method OpenAsJPEGMBS(allowdamaged as Boolean) as picture
  • method OpenAsJPEGMBS(allowdamaged as Boolean,fileposition as Integer) as picture
  • method OpenAsLargeBinaryStreamMBS(write as Boolean) as LargeBinaryStreamMBS
  • method OpenAsPNGMBS(gamma as single = 0.0, AllowDamaged as Boolean = false) as PNGPictureMBS
  • method OpenAsResStreamMBS(write as Boolean) as ResStreamMBS
  • method OpenAsTiffMBS(HeaderOnly as boolean=false) as TiffPictureMBS
  • method OpenWithAppMBS(TheApplication as FolderItem, inFront as Boolean) as Boolean
  • method ParentVolumeMBS as folderitem
  • method PercentDownloadedMBS as Double
  • method PercentUploadedMBS as Double
  • method PermissionsMBS(OldWay as boolean) as PermissionsMBS
  • method PhysicalFileDataLengthMBS as int64
  • method PhysicalFileResLengthMBS as int64
  • method PhysicalFileTotalLengthMBS as int64
  • method QuickLookMBS(MaxWidth as Integer = 500, MaxHeight as Integer = 500, IconMode as Boolean = false, ScaleFactor as Double = 1.0) as picture
  • method QuickLookMTMBS(MaxWidth as Integer = 500, MaxHeight as Integer = 500, IconMode as Boolean = false, ScaleFactor as Double = 1.0) as picture
  • method ReadFileMBS(byref data as MemoryBlock, offset As Integer = 0, byteCount As Integer = -1) as boolean
  • method ReadFileMBS(byref data as string, offset As Integer = 0, byteCount As Integer = -1) as boolean
  • method SaveAs8BitAlphaPNGMBS(pic as picture, colors() as color, alphas() as Integer, gamma as single = 0.0) as boolean
  • method SaveAs8BitAlphaPNGMBS(pic as picture, colors() as color, alphas() as Integer, gamma as single, Interlace as Boolean, FilterType as Integer) as boolean
  • method SaveAs8BitPNGMBS(pic as picture, colors() as color, gamma as single = 0.0) as boolean
  • method SaveAs8BitPNGMBS(pic as picture, colors() as color, gamma as single, Interlace as Boolean, FilterType as Integer) as boolean
  • method SaveAsGIFMBS(data as GIFMBS) as boolean
  • method SaveAsJPEGMBS(pic as picture, quality as Integer = 80) as boolean
  • method SaveAsPNGMBS(pic as picture, gamma as single = 0.0) as boolean
  • method SaveAsPNGMBS(pic as picture, gamma as single, Interlace as Boolean, FilterType as Integer) as boolean
  • method SaveAsPNGMBS(pic as picture, mask as picture, gamma as single = 0.0) as boolean
  • method SaveAsPNGMBS(pic as picture, mask as picture, gamma as single, Interlace as Boolean, FilterType as Integer) as boolean
  • method SetDesktopPictureMBS as Integer
  • method SetFileFlagsMBS(flags as Integer) as Integer
  • method SetFolderFlagsMBS(flags as Integer) as Integer
  • method SetTagNamesMBS(tags() as string) as Integer
  • method SetTagNamesMBS(tags() as string, byref e as CFErrorMBS) as Integer
  • method ShortPathMBS as string
  • method SortedFilesMBS(followAlias as Boolean = false, SortByDisplayName as boolean = false, VisibleOnly as boolean = false) as FolderItem()
  • method SortedFoldersMBS(followAlias as Boolean = false, SortByDisplayName as boolean = false, VisibleOnly as boolean = false) as FolderItem()
  • method SortedItemsMBS(followAlias as Boolean = false, SortByDisplayName as boolean = false, VisibleOnly as boolean = false) as FolderItem()
  • method SpotLightFileInfoMBS(uti as string = "") as dictionary
  • method SpotLightLoadMDImporterMBS as boolean
  • method SpotLightTextContentMBS(uti as string = "") as string
  • method TagNamesMBS as string()
  • method TagNamesMBS(byref e as CFErrorMBS) as string()
  • method TrueFilesMBS as FolderItem()
  • method TrueFoldersMBS as FolderItem()
  • method TrueItemsMBS as FolderItem()
  • method UnixpathMBS as string
  • method UnMountVolumeMBS(force as boolean = false) as Integer
  • method UnMountVolumeMBS(force as boolean, byref dissenterPID as Integer) as Integer
  • method VolGetFolderItemIDMBS(createFileIDs as Boolean = true) as Integer
  • method VolSupportsCatSearchMBS as Boolean
  • method VolumeFreeSizeMBS as Int64
  • method VolumeInformationMBS as VolumeInformationMBS
  • method VolumeSizeMBS as Int64
  • method VolumeSupportsHugeFilesMBS as Integer
  • method VolumeUUIDMBS as string
  • method WinThumbnailMBS(preferredSize as Integer = 512) as picture
  • method WriteFileMBS(data as MemoryBlock) as boolean
  • method WriteFileMBS(data as string) as boolean

This class has no sub classes.

See also in the Xojo Language Reference

Release notes

• Version 25.1
  • Improved TrueItemsMBS function to be quicker.
• Version 24.3
  • Improved JSONMBS class conversion from variant to convert folderitem to native path, Date & DateTime to SQLDateTime or from JSONItem objects.
• Version 23.5
  • Fixed FolderItem.PhysicalFileTotalLengthMBS function for Windows to report block size.
• Version 23.4
  • Added fallback for FontActivateMBS to use AddFontResourceW if AddFontResourceExW fails.
  • Fixed crash in XMLDocumentMBS constructor when passing folderitem pointing to a folder.
  • Fixed ReadFileMBS function when passing an offset.
• Version 23.1
  • Added Offset and Length parameters for FolderItem.ReadFileMBS function.
• Version 22.5
  • Changed AddedToDirectoryDateMBS and AddedToDirectoryDateTimeMBS in FolderItem class to be settable.
  • Fixed potential issue in VolumeSizeMBS function when NULL value is returned from system.
• Version 22.0
  • Fixed a bug where some functions like GetWindowsColorProfileMBS returning a FolderItem cause an InvalidArgumentException when running on newer Xojo versions.
• Version 21.5
  • Fixed code to return FolderItem in various functions on iOS.
• Version 21.4
  • Added ReadFileMBS for reading file data into MemoryBlock.

Some useful global functions for this class:

• CGNewPDFDocumentMBS(file as folderitem, MediaBox as CGRectMBS, title as string, author as string, creator as string, subject as string, keywords as string, OwnerPassword as string, UserPassword as string, AllowsPrinting as boolean, AllowsCopy as boolean, KeyLength as Integer) as CGPDFContextMBS
• CombineBitCMYKtoCMYKMBS(dest as TiffPictureMBS, CyanChannel() as Integer, MagentaChannel() as Integer, YellowChannel() as Integer, BlackChannel() as Integer, Files() as FolderItem, scale as Double, width as Integer, height as Integer, X1 as Integer, Y1 as Integer, X2 as Integer, Y2 as Integer, CacheSizeRead as Integer) as Integer
• CombineBitCMYKtoRGBMBS(CyanChannel() as Integer, MagentaChannel() as Integer, YellowChannel() as Integer, BlackChannel() as Integer, Files() as FolderItem, scale as Double, width as Integer, height as Integer, X1 as Integer, Y1 as Integer, X2 as Integer, Y2 as Integer, byref output as picture, CacheSizeRead as Integer) as Integer
• FolderItemToPathMBS(file as folderitem) as string
• GetWindowsColorProfileMBS as folderitem
• GetWindowsDisplayColorProfileMBS(DisplayIndex as Integer) as folderitem
• LaunchServicesFindApplicationForInfoMBS(creator as string, bundleID as string, name as string) as folderitem
• NewCFURLMBSFile(f as folderitem) as CFURLMBS
• Split1BitFileMBS(f as folderitem, fc as folderitem, fm as folderitem, fy as folderitem, fk as folderitem, width as Integer, height as Integer, CallbackTarget as object, CacheSizeRead as Integer, CacheSizeWrite as Integer) as Integer
• VolResolveIDMBS(volume as FolderItem, id as Integer) as FolderItem

Some methods using this class:

• AVAssetWriterMBS.Constructor(outputFile as folderitem, outputFileType as string, byref error as NSErrorMBS)
• CDBaseChartMBS.makeChart(path as folderitem) as boolean
• CURLNMBS.SetPathCAPath(path as folderitem)
• DocumentBuilderMBS.parseXmlFromFile(File as FolderItem) as XdmNodeMBS
• DynaPDFMBS.ConvertEMFSpool(File as folderitem, LeftMargin as Double, TopMargin as Double, Flags as Integer = 0) as Integer
• DynaPDFMBS.InsertMetafile(FileName as folderitem, PosX as Double, PosY as Double, Width as Double, Height as Double) as Boolean
• LSSharedFileListMBS.InsertFile(AfterItem as LSSharedFileListItemMBS, DisplayName as string, Icon as object, file as folderitem) as LSSharedFileListItemMBS
• MacAliasMBS.Create(relPath as FolderItem, target as FolderItem, isDirectory as boolean = false) as Integer
• MacFileOperationMBS.MoveObject(Item as folderitem, DestinationFolder as folderitem, DestinationName as string, Options as Integer, statusChangeInterval as Double)
• ZipMBS.Constructor(file as folderitem, append as Integer = 0)

Some properties using for this class:

• CTFontMBS.File as FolderItem
• FileMappingMBS.File as FolderItem
• GMConvertMBS.OutputFile as FolderItem
• ICScannerDeviceMBS.downloadsFolder as FolderItem
• iTunesLibraryMediaItemMBS.locationFile as FolderItem
• JPEGExporterMBS.file as folderitem
• LMFitControlMBS.msgfile as FolderItem
• NSPathControlItemMBS.File as FolderItem
• OpenDialogMBS.InitialDirectory as FolderItem
• VolumeInformationMBS.Root as FolderItem

Some events using this class:

• DesktopNSOutlineControlMBS.namesOfPromisedFilesDroppedAtDestination(dropDestination as folderItem, DraggedItems() as NSOutlineViewItemMBS) as string()
• IKScannerDeviceViewControlMBS.DidScanToURL(url as String, file as FolderItem, fileData as MemoryBlock, error as NSErrorMBS)
• NSFileCoordinatorMBS.coordinateReadingItemAtURL(url as string, file as folderitem, tag as Variant)
• NSFilePresenterMBS.presentedItemDidMoveToURL(url as string, file as folderitem)
• NSFilePresenterMBS.presentedSubitemAtURLdidMoveToURL(oldURL as string, newURL as string, oldFile as folderitem, newFile as folderitem)
• NSOutlineControlMBS.namesOfPromisedFilesDroppedAtDestination(dropDestination as folderItem, DraggedItems() as NSOutlineViewItemMBS) as string()
• NSSavePanelMBS.isValidFilename(path as string, item as folderitem) as boolean
• NSSavePanelMBS.shouldShowFilename(path as string, item as folderitem) as boolean
• QLPreviewControllerMBS.editingModeForPreviewItem(Item as FolderItem) as Integer
• QLPreviewControllerMBS.shouldOpenURL(URL as String, Item as FolderItem) as Boolean

Some related classes:

• class CFErrorMBS
• class CGPDFDocumentMBS
• class CTFontMBS
• class CURLNMBS
• class GMConvertMBS
• class LaunchServicesItemInfoMBS
• class LSSharedFileListMBS
• class NSFilePresenterMBS
• class NSPathControlItemMBS
• class XdmNodeMBS

The items on this page are in the following plugins: MBS Images Plugin, MBS MacCF Plugin, MBS MacCG Plugin, MBS MacClassic Plugin, MBS MacCloud Plugin, MBS MacFrameworks Plugin, MBS MacOSX Plugin, MBS Picture Plugin, MBS Util Plugin, MBS Win Plugin.

FolderChangedNotificationMBS   -   FSEventsMBS