Instance Method

panel:compareFilename:with:caseSensitive:

Controls the ordering of files presented by the NSSavePanel object specified.

Declaration

- (NSComparisonResult)panel:(id)sender compareFilename:(NSString *)name1 with:(NSString *)name2 caseSensitive:(BOOL)caseSensitive;

Parameters

sender

Panel requesting the ordering.

fileName1

String representing the first filename to order.

fileName2

String representing the second filename to order.

flag

If YES, the ordering is case-sensitive; if NO, it is not.

Return Value

One of the following:

  • NSOrderedAscending if fileName1 should precede fileName2

  • NSOrderedSame if the two names are equivalent

  • NSOrderedDescending if fileName2 should precede fileName1

Discussion

Don’t reorder filenames in the Save panel without good reason, because it may confuse the user to have files in one Save panel or Open panel ordered differently than those in other such panels or in the Finder. The default behavior of Save and Open panels is to order files as they appear in the Finder. Note also that by implementing this method you will reduce the operating performance of the panel.

See Also

Methods

- requiredFileType

Returns the required file type (if any).

Deprecated
- setRequiredFileType:

Specifies the file type (as an extension) or a UTI.

Deprecated
- setDirectory:

Sets the current pathname in the panel’s browser.

Deprecated
- beginSheetForDirectory:file:modalForWindow:modalDelegate:didEndSelector:contextInfo:

Presents a Save panel as a sheet with a specified path and, optionally, a specified file in that path.

Deprecated
- runModalForDirectory:file:

Initializes the panel to the directory and file specified, if any, then displays it and begins its modal event loop.

Deprecated
- panel:isValidFilename:

Gives the delegate the opportunity to validate selected items.

Deprecated
- panel:shouldShowFilename:

Gives the delegate the opportunity to filter items that it doesn’t want the user to choose.

Deprecated
- panel:directoryDidChange:

Tells the delegate that the user has changed the selected directory in the NSSavePanel object specified.

Deprecated
- directory

Returns the absolute pathname of the directory currently shown in the panel.

Deprecated
- filename

Returns the absolute pathname of the file currently shown in the panel.

Deprecated
- selectText:

This method has been deprecated.

Deprecated