1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
//
// UIAlertView+BlocksKit.h
// BlocksKit
//
#import "BKGlobals.h"
/** UIAlertView without delegates!
This set of extensions and convenience classes allows
for an instance of UIAlertView without the implementation
of a delegate. Any time you instantiate a UIAlertView
using the methods here, you must add buttons using
addButtonWithTitle:handler: otherwise nothing will happen.
A typical invocation will go like this:
UIAlertView *testView = [UIAlertView alertViewWithTitle:@"Application Alert" message:@"This app will explode in 42 seconds."];
[testView setCancelButtonWithTitle:@"Oh No!" handler:^{ NSLog(@"Boom!"); }];
[testView show];
A more traditional, and more useful, modal dialog looks like so:
UIAlertView *testView = [UIAlertView alertViewWithTitle:@"Very important!" message:@"Do you like chocolate?"];
[testView addButtonWithTitle:@"Yes" handler:^{ NSLog(@"Yay!"); }];
[testView addButtonWithTitle:@"No" handler:^{ NSLog(@"We hate you."); }];
[testView show];
Includes code by the following:
- [Landon Fuller](http://landonf.bikemonkey.org), "Using Blocks".
- [Peter Steinberger](https://github.com/steipete)
- [Zach Waldowski](https://github.com/zwaldowski)
@warning UIAlertView is only available on a platform with UIKit.
*/
@interface UIAlertView (BlocksKit)
///-----------------------------------
/// @name Creating alert views
///-----------------------------------
/** Creates and shows a new alert view with only a title, message, and cancel button.
@param title The title of the alert view.
@param message The message content of the alert.
@param cancelButtonTitle The title of the cancel button. If both cancelButtonTitle and otherButtonTitles are empty or nil, defaults to a
@param otherButtonTitles Titles of additional buttons to add to the receiver.
@param block A block of code to be fired on the dismissal of the alert view.
*/
+ (void) showAlertViewWithTitle: (NSString *) title message: (NSString *) message cancelButtonTitle: (NSString *) cancelButtonTitle otherButtonTitles: (NSArray *) otherButtonTitles handler: (void (^)(UIAlertView *alertView, NSInteger buttonIndex)) block;
/** Creates and returns a new alert view with only a title and cancel button.
@param title The title of the alert view.
@return A newly created alert view.
*/
+ (id)alertViewWithTitle:(NSString *)title;
/** Creates and returns a new alert view with only a title, message, and cancel button.
@param title The title of the alert view.
@param message The message content of the alert.
@return A newly created alert view.
*/
+ (id)alertViewWithTitle:(NSString *)title message:(NSString *)message;
/** Returns a configured alert view with only a title, message, and cancel button.
@param title The title of the alert view.
@param message The message content of the alert.
@return An instantiated alert view.
*/
- (id)initWithTitle:(NSString *)title message:(NSString *)message;
///-----------------------------------
/// @name Adding buttons
///-----------------------------------
/** Add a new button with an associated code block.
@param title The text of the button.
@param block A block of code.
*/
- (NSInteger)addButtonWithTitle:(NSString *)title handler:(BKBlock)block;
/** Set the title and trigger of the cancel button.
@param title The text of the button.
@param block A block of code.
*/
- (NSInteger)setCancelButtonWithTitle:(NSString *)title handler:(BKBlock)block;
///-----------------------------------
/// @name Altering actions
///-----------------------------------
/** Sets the block that is to be fired when a button is pressed.
@param block A code block, or nil to set no response.
@param index The index of a button already added to the action sheet.
*/
- (void)setHandler:(BKBlock)block forButtonAtIndex:(NSInteger)index;
/** The block that is to be fired when a button is pressed.
@param index The index of the button already added to the alert view.
@return A code block, or nil if no block yet assigned.
*/
- (BKBlock)handlerForButtonAtIndex:(NSInteger)index;
/** The block to be fired when the action sheet is dismissed with the cancel
button.
Contrary to setCancelButtonWithTitle:handler:, you can set this
property multiple times but multiple cancel buttons will
not be generated.
*/
@property (nonatomic, copy) BKBlock cancelBlock;
/** The block to be fired before the alert view will show. */
@property (nonatomic, copy) void (^willShowBlock)(UIAlertView *);
/** The block to be fired when the alert view shows. */
@property (nonatomic, copy) void (^didShowBlock)(UIAlertView *);
/** The block to be fired before the alert view will dismiss. */
@property (nonatomic, copy) void (^willDismissBlock)(UIAlertView *, NSInteger);
/** The block to be fired after the alert view dismisses. */
@property (nonatomic, copy) void (^didDismissBlock)(UIAlertView *, NSInteger);
/** The block to be fired to determine whether the first non-cancel should be enabled */
@property (nonatomic, copy) BOOL (^shouldEnableFirstOtherButtonBlock)(UIAlertView *) NS_AVAILABLE_IOS(5_0);
@end
|
