Inherits from | |
Conforms to | |
Framework | /System/Library/Frameworks/UIKit.framework |
Availability | Available in iOS 2.0 and later. |
Declared in | UIAlertView.h |
Use the UIAlertView
class to display an alert message to the user. An alert view functions similar to but differs in appearance from an action sheet (an instance of UIActionSheet
).
Use the properties and methods defined in this class to set the title, message, and delegate of an alert view and configure the buttons. You must set a delegate if you add custom buttons. The delegate should conform to the UIAlertViewDelegate
protocol. Use the show
method to display an alert view once it is configured.
Important: In iOS 4.0 and later, alert views are not dismissed automatically when an application moves to the background. This behavior differs from earlier versions of the operating system, where alert views were automatically cancelled (and their cancellation handler executed) as part of the termination sequence for the application. Now, it is up to you to decide whether to dismiss the alert view (and execute its cancellation handler) or leave it visible for when your application moves back to the foreground. Remember that your application can still be terminated while in the background, so some type of action may be necessary in either case.
– addButtonWithTitle:
numberOfButtons
property
– buttonTitleAtIndex:
cancelButtonIndex
property
firstOtherButtonIndex
property
For more about Objective-C properties, see “Properties” in The Objective-C Programming Language.
The index number of the cancel button.
@property(nonatomic) NSInteger cancelButtonIndex
The button indices start at 0
. If -1
, then the index is not set.
UIAlertView.h
The receiver’s delegate or nil
if it doesn’t have a delegate.
@property(nonatomic, assign) id delegate
See UIAlertViewDelegate Protocol Reference for the methods this delegate should implement.
UIAlertView.h
The index of the first other button. (read-only)
@property(nonatomic, readonly) NSInteger firstOtherButtonIndex
The button indices start at 0
. If -1
, then the index is not set. This property is ignored if there are no other buttons. The default value is -1
.
UIAlertView.h
Descriptive text that provides more details than the title.
@property(nonatomic, copy) NSString *message
UIAlertView.h
The number of buttons on the alert view. (read-only)
@property(nonatomic, readonly) NSInteger numberOfButtons
UIAlertView.h
The string that appears in the receiver’s title bar.
@property(nonatomic, copy) NSString *title
UIAlertView.h
A Boolean value that indicates whether the receiver is displayed. (read-only)
@property(nonatomic, readonly, getter=isVisible) BOOL visible
If YES
, the receiver is displayed; otherwise, NO
.
UIAlertView.h
Adds a button to the receiver with the given title.
- (NSInteger)addButtonWithTitle:(NSString *)title
The title of the new button.
The index of the new button. Button indices start at 0
and increase in the order they are added.
UIAlertView.h
Returns the title of the button at the given index.
- (NSString *)buttonTitleAtIndex:(NSInteger)buttonIndex
The index of the button. The button indices start at 0
.
The title of the button specified by index buttonIndex.
UIAlertView.h
Dismisses the receiver, optionally with animation.
- (void)dismissWithClickedButtonIndex:(NSInteger)buttonIndex animated:(BOOL)animated
The index of the button that was clicked just before invoking this method. The button indices start at 0
.
YES
if the receiver should be removed by animating it first; otherwise, NO
if it should be removed immediately with no animation.
In iOS 4.0, you may want to call this method whenever your application moves to the background. An alert view is not dismissed automatically when an application moves to the background. This behavior differs from previous versions of the operating system, where they were canceled automatically when the application was terminated. Dismissing the alert view gives your application a chance to save changes or abort the operation and perform any necessary cleanup in case your application is terminated later.
UIAlertView.h
Convenience method for initializing an alert view.
- (id)initWithTitle:(NSString *)title message:(NSString *)message delegate:(id)delegate cancelButtonTitle:(NSString *)cancelButtonTitle otherButtonTitles:(NSString *)otherButtonTitles, ...
The string that appears in the receiver’s title bar.
Descriptive text that provides more details than the title.
The receiver’s delegate or nil
if it doesn’t have a delegate.
The title of the cancel button or nil
if there is no cancel button.
Using this argument is equivalent to setting the cancel button index to the value returned by invoking addButtonWithTitle:
specifying this title.
The title of another button.
Using this argument is equivalent to invoking addButtonWithTitle:
with this title to add more buttons.
Titles of additional buttons to add to the receiver, terminated with nil
.
Newly initialized alert view.
UIAlertView.h
Last updated: 2010-05-14