Carbon


NavFileOrFolderInfo

Header: Navigation.h

The NavFileOrFolderInfo structure contains file or folder information for use by your application-defined filter function. For more information, see “Filtering File Objects”. Your filter function can determine whether the currently selected object is a file by checking the isFolder field of the NavFileOrFolderInfo structure for the value false. After making this determination, you can obtain more information about the object from the fileAndFolder structure.Note: The information in this structure is valid only for HFS file objects.

struct NavFileOrFolderInfo {
    UInt16 version; 
    Boolean isFolder; 
    Boolean visible; 
    UInt32 creationDate; 
    UInt32 modificationDate; 
    union {
        struct {  
            Boolean locked; 
        Boolean resourceOpen; 
        Boolean dataOpen; 
        Boolean reserved1; 
        UInt32 dataSize; 
        UInt32 resourceSize; 
        FInfo finderInfo; 
        FXInfo finderXInfo;
        } fileInfo; 
    struct {  
            Boolean shareable; 
        Boolean sharePoint; 
        Boolean mounted; 
        Boolean readable; 
        Boolean writeable; 
        Boolean reserved2; 
        UInt32 numberOfFiles; 
        DInfo finderDInfo; 
        DXInfo finderDXInfo; 
        char reserved3[214]; 
        OSType folderCreator; 
        char reserved3[206];
        } folderInfo;
    } fileAndFolder;
};

Field descriptions

version

Identifies the version of this structure.

isFolder

A Boolean value. If this value is set to true, the object being described is a folder or volume; otherwise, the value is set to false. An alias to a folder or volume returns true. Check for the kIsAlias constant in the FInfo field to determine whether an object is an alias.

visible

A Boolean value. If this value is set to true, the object being described is visible in the browser list; otherwise, the value is set to false.

creationDate

The creation date of the object being described.

modificationDate

The modification date of the object being described.

fileAndFolder

A union of the fileInfo and folderInfo fields.

fileAndFolder

A union of the fileInfo and folderInfo fields.

fileInfo

A structure consisting of the following fields:

locked

A Boolean value specifying whether the file is locked.

resourceOpen

A Boolean value specifying whether the file’s resource fork is open.

dataOpen

A Boolean value specifying whether the file’s data fork is open.

reserved1

dataSize

A value specifying the size of the file’s data fork in bytes.

resourceSize

A value specifying the size of the file’s resource fork in bytes.

finderInfo

A structure providing a set of Finder flags.

finderXInfo

A structure providing an additional set of Finder flags.

folderInfo

A structure consisting of the following fields:

shareable

A Boolean value specifying whether the folder or volume can be shared.

sharePoint

A Boolean value specifying whether the folder or volume is currently a share point.

mounted

A Boolean value specifying whether the folder or volume is currently mounted.

readable

A Boolean value specifying whether the folder or volume can be read.

writeable

A Boolean value specifying whether the folder or volume can be written.

reserved2

numberOfFiles

A value specifying the number of files in the folder or volume.

finderDInfo

A structure providing a set of Finder flags.

finderDXInfo

A structure providing a set of additional Finder flags.

reserved3[214]

folderCreator

A four character code specifying the folder or volume’s creator.

reserved3[206]

The NavFileOrFolderInfo structure contains file or folder information for use by your application-defined filter function. For more information, see “Filtering File Objects”. Your filter function can determine whether the currently selected object is a file by checking the isFolder field of the NavFileOrFolderInfo structure for the value false. After making this determination, you can obtain more information about the object from the structure specified in the fileAndFolder field.

SPECIAL CONSIDERATIONS

The information in this structure is valid only for HFS file objects.


© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)