Edit AllPages ( is also dead ( is dead

NSRunAlertPanel This function creates an attention panel.

int NSRunAlertPanel(NSString *title, NSString *msg, NSString *defaultButton, NSString *alternateButton, NSString *otherButton, …)

Returns :

Creates an attention panel that alerts the user to some consequence of a requested action; the panel may also let the user cancel or modify the action. NSRunAlertPanel runs the panel in a modal event loop.

The first argument is the title of the panel, which should be at most a few words long. The default title is “Alert”. The next argument is the message that’s displayed in the panel. It can use printf-style formatting characters; any necessary arguments should be listed at the end of the function’s argument list (after the otherButton argument). For more information on formatting characters, see the man page for printf.

There are arguments to supply titles for up to three buttons, which will be displayed in a row across the bottom of the panel. The panel created by NSRunAlertPanel must have at least one button, which will have the symbol for the Return key; if you pass a nil title to the other two buttons, they won’t be created. If nil is passed as the defaultButton, “OK” will be used as its title.

NSRunAlertPanel not only creates the panel, it puts the panel on screen and runs it using the runModalFor: method defined in the NSApplication class. This method sets up a modal event loop that causes the panel to remain on screen until the user clicks one of its buttons. NSRunAlertPanel then removes the panel from the screen list and returns a value that indicates which of the three buttons the user clicked: NSAlertDefaultReturn, NSAlertAlternateReturn, or NSAlertOtherReturn. (If an error occurred while creating the panel, NSAlertErrorReturn is returned.) For efficiency, NSRunAlertPanel creates the panel the first time it’s called and reuses it on subsequent calls, reconfiguring it if necessary.

See NSAlert. []

The NSAlert class, which was introduced in Mac OS X v10.3, supersedes the functional Application Kit API for displaying alerts (NSRunAlertPanel, NSBeginAlertSheet, and so on). The former API is still supported, but you are encouraged to use the NSAlert class for your application�s alert dialogs.