PanelUserEnteredFilenameConfirmed Method (sender, filename, okFlag)

Tells the delegate that the user confirmed a filename choice by clicking Save in a Save panel.

Original signature is '- (NSString *)panel:(id)sender userEnteredFilename:(NSString *)filename confirmed:(BOOL)okFlag'

Available in Mac OS X v10.0 and later.

Declaration Syntax

Visual Basic

Visual C++

NSString PanelUserEnteredFilenameConfirmed(
	Id sender,
	NSString filename,
	bool okFlag
)

Function PanelUserEnteredFilenameConfirmed ( _
	sender As Id, _
	filename As NSString, _
	okFlag As Boolean _
) As NSString

NSString^ PanelUserEnteredFilenameConfirmed(
	Id^ sender, 
	NSString^ filename, 
	bool okFlag
)

Parameters

sender (Id): The panel reporting the user’s confirmation of a filename choice.

filename (NSString): The user’s filename choice.

okFlag (Boolean): If YES, the user clicked the Save button; if NO, the user did not.

Return Value

You can either leave the filename alone, return a new filename, or return nil to cancel the save (and leave the Save panel as is). This method is called before any required extension is appended to the filename and before the Save panel asks the user to replace an existing file, if applicable. Note that in the future, this method may be called multiple times in the sessions as the user types. In those cases, okFlag will be NO until the user confirms the choice, in which case okFlag will become YES. If the delegate does extensive validation or puts up alerts, it should do so only when okFlag is YES.

Version Information

Available in Monobjc Bridge: 10.6 (For Mac OS X 10.6 and later), 10.5 (For Mac OS X 10.5 and later)

Assembly: Monobjc.AppKit (Module: Monobjc.AppKit)