| Inherits from | |
| Conforms to | |
| Framework | /System/Library/Frameworks/UIKit.framework |
| Availability | Available in iPhone OS 2.0 and later. |
| Declared in | UIAlert.h |
| Related sample code |
Use the UIActionSheet class to implement an action sheet that displays a message and presents buttons that let the user decide how to proceed. An action sheet is similar in function but differs in appearance from an alert view.
Use the properties and methods in this class to set the message, set the style, set the delegate, configure the buttons, and display the action sheet. You must set a delegate if you add custom buttons. The delegate should conform to the UIActionSheetDelegate protocol. When you display an action sheet, you can optionally animate it from the bottom bar or an arbitrary view. How the action sheet is animated depends on the bar style or the action sheet style you set.
delegate property
title property
visible property
actionSheetStyle property
– addButtonWithTitle:
numberOfButtons property
– buttonTitleAtIndex:
cancelButtonIndex property
destructiveButtonIndex property
firstOtherButtonIndex property
For more about Objective-C properties, see “Properties” in The Objective-C Programming Language.
The receiver’s style.
@property(nonatomic) UIActionSheetStyle actionSheetStyle
See UIActionSheetStyle for the possible values.
UIAlert.hThe index number of the cancel button.
@property(nonatomic) NSInteger cancelButtonIndex
The button indices start at 0. If -1, then the index is not set.
UIAlert.hThe receiver’s delegate or nil if it doesn’t have a delegate.
@property(nonatomic, assign) id<UIActionSheetDelegate> delegate
See UIActionSheetDelegate Protocol Reference for the methods this delegate should implement.
UIAlert.hThe index number of the destructive button.
@property(nonatomic) NSInteger destructiveButtonIndex
The button indices start at 0. If -1, then the index is not set. This property is ignored if there is only one button. The default value is -1.
UIAlert.hThe 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.
UIAlert.hThe number of buttons on the action sheet. (read-only)
@property(nonatomic, readonly) NSInteger numberOfButtons
UIAlert.hThe string that appears in the receiver’s title bar.
@property(nonatomic, copy) NSString *title
UIAlert.hA 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.
UIAlert.hAdds 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.
UIAlert.hReturns 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.
UIAlert.hDismisses 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.
UIAlert.hConvenience method for initializing an action sheet.
- (id)initWithTitle:(NSString *)title delegate:(id < UIActionSheetDelegate >)delegate cancelButtonTitle:(NSString *)cancelButtonTitle destructiveButtonTitle:(NSString *)destructiveButtonTitle otherButtonTitles:(NSString *)otherButtonTitles, ...
The string that appears in the receiver’s title bar.
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 showInView: specifying this title.
The title of the destructive button or nil if there is no destructive button..
The title of another button.
Using this argument is equivalent to invoking showInView: with this title to add more buttons.
Titles of additional buttons to add to the receiver, terminated with nil.
Newly initialized action sheet.
UIAlert.hDisplays the receiver using animation by originating it from the specified tab bar.
- (void)showFromTabBar:(UITabBar *)view
The tab bar that the receiver originates from.
The style of the animation depends on the style of the tab bar, not the receiver.
UIAlert.hDisplays the receiver using animation by originating it from the specified toolbar.
- (void)showFromToolbar:(UIToolbar *)view
The toolbar that the receiver originates from.
The style of the animation depends on the style of the toolbar, not the receiver.
UIAlert.hDisplays the receiver using animation by originating it from the specified view.
- (void)showInView:(UIView *)view
The view that the receiver originates from.
The style of the animation depends on the actionSheetStyle property.
UIAlert.hSpecifies the style of an action sheet.
typedef enum {
UIActionSheetStyleAutomatic = -1,
UIActionSheetStyleDefault = UIBarStyleDefault,
UIActionSheetStyleBlackTranslucent = UIBarStyleBlackTranslucent,
UIActionSheetStyleBlackOpaque = UIBarStyleBlackOpaque,
} UIActionSheetStyle;
UIActionSheetStyleAutomaticTakes the appearance of the bottom bar if specified; otherwise, same as UIActionSheetStyleDefault.
Available in iPhone OS 2.0 and later.
Declared in UIAlert.h.
UIActionSheetStyleDefaultThe default style.
Available in iPhone OS 2.0 and later.
Declared in UIAlert.h.
UIActionSheetStyleBlackTranslucentA black translucent style.
Available in iPhone OS 2.0 and later.
Declared in UIAlert.h.
UIActionSheetStyleBlackOpaqueA black opaque style.
Available in iPhone OS 2.0 and later.
Declared in UIAlert.h.
UIAlert.hLast updated: 2009-03-31
iPhone OS Reference Library User Experience: Windows & Views UIActionSheet Class Reference