NavPanelAttributes

Header: Navigation.h

enum NavPanelAttributes {
    kNavDefaultNavDlogOptions = 228,
    kNavNoTypePopup = 1,
    kNavDontAutoTranslate = 2,
    kNavDontAddTranslateItems = 4,
    kNavAllFilesInPopup = 16,
    kNavAllowStationery = 32,
    kNavAllowPreviews = 64,
    kNavAllowMultipleFiles = 128,
    kNavAllowInvisibleFiles = 256,
    kNavDontResolveAliases = 512,
    kNavSelectDefaultLocation = 1024,
    kNavSelectAllReadableItem = 2048,
    kNavSupportPackages = 4096,
    kNavAllowOpenPackages = 8192,
    kNavDontAddRecents = 16384,
    kNavDontUseCustomFrame = 32768,
    kNavDontConfirmReplacement = 65536
};

Constant descriptions

kNavDefaultNavDlogOptions

Tells Navigation Services to use default configuration options. These default options include:

kNavNoTypePopup

Tells Navigation Services not to display the Show pop-up menu in the Open dialog box or the Format pop-up menu in the Save dialog box.

kNavDontAutoTranslate

Tells Navigation Services that your application will handle file translation. Normally a file chosen in an Open dialog box that requires translation is automatically translated. Navigation Services informs your application that a file needs translating by setting the translationNeeded field of the structure NavReplyRecord to true. A translation specification array, specified in the fileTranslation field of the NavReplyRecord structure, contains the associated translation specification records. When you set the kNavDontAutoTranslate flag, your application is responsible for translation, either by calling the function NavTranslateFile or by performing the translation itself. For more information, see “Translating Files on Open”.

kNavDontAddTranslateItems

Tells Navigation Services not to display file translation options in the Show pop-up menu. For more information, see “Translating Files on Open”.

kNavAllFilesInPopup

Tells Navigation Services to add a pop-up menu item called All Documents, so the user can see a display of all files in the current directory.

kNavAllowStationery

Tells Navigation Services to display a Stationery Option command in the Format pop-up menu of Save dialog boxes, so users can choose to save a file as a document or as stationery. This is a default option. For more information, see “Providing File Format Options”.

kNavAllowPreviews

Tells Navigation Services to provide previews, when available, of selected files. This is a default option. See also “Drawing Custom Previews”.

kNavAllowMultipleFiles

Tells Navigation Services to allow users to select and open multiple files in the browser list by shift-clicking or using the Select All command. If you don’t specify this constant, users can select multiple files for drag-and-drop operations, but the default button (normally titled Open) is disabled when multiple items are selected. Note that the user cannot add folders or volumes to a multiple selection.

kNavAllowInvisibleFiles

Tells Navigation Services to show invisible file objects in the browser list.

kNavDontResolveAliases

Tells Navigation Services not to resolve any alias selected by the user. If the user selects an alias with this option set, the file system specification returned by Navigation Services designates the alias file instead of its referenced original. If you specify this constant before calling the function NavPutFile, Navigation Services returns a result code of paramErr (-50).

kNavSelectDefaultLocation

Tells Navigation Services to select the default location in the browser list. By default, Navigation Services will open the browser list with the default location displayed, not selected. For example, if you define the System Folder as the default location and specify the kNavSelectDefaultLocation constant, the System Folder appears as the current selection in the browser list. Without this constant, the browser list displays the contents of the System Folder.

kNavSelectAllReadableItem

Tells Navigation Services to show All Readable Documents as the default selection in the Show pop-up menu when the Open dialog box is first displayed. If you do not specify this constant, Navigation Services shows the All Documents menu item as the default selection in the Show pop-up menu when the Open dialog box is first displayed.

kNavSupportPackages

(Available in Navigation Services 2.0 or later.) Tells Navigation Services to allow packages to be displayed in the browser list. For a description of packages, see “Working With Packages”.

kNavAllowOpenPackages

(Available in Navigation Services 2.0 or later.) Tells Navigation Services to allow packages to be opened and navigated in the browser list. For a description of packages, see “Working With Packages”.

kNavDontAddRecents

(Available in Navigation Services 2.0 or later.) Tells Navigation Services not to add file objects to the Recents list after a dialog box is closed. This is useful if you want to allow users to choose long lists of items without cluttering up the Recent list.

kNavDontUseCustomFrame

(Available in Navigation Services 2.0 or later.) Tells Navigation Services not to draw a bevelled border around the customization area. The border is drawn by default, so you must specify this constant if you want to turn it off.Note: Keep in mind that turning off the border may affect the placement of any controls you create in the customization area. This means your controls may appear differently in different versions of Navigation Services.

kNavDontConfirmReplacement

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