forked from BlocksKit/BlocksKit
-
Notifications
You must be signed in to change notification settings - Fork 0
/
A2BlockDelegate.h
111 lines (85 loc) · 4.07 KB
/
A2BlockDelegate.h
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
//
// A2BlockDelegate.h
// A2DynamicDelegate
//
// Created by Alexsander Akers on 11/30/11.
// Copyright (c) 2011 Pandamonia LLC. All rights reserved.
//
#import <Foundation/Foundation.h>
/** The A2BlockDelegate category extends features provided
by A2DynamicDelegate to create custom block properties in
a category on a delegating object and dynamically map them
to delegate (`UIAlertViewDelegate`),
data source (`UITableViewDataSource`), or other delegated
protocol (`NSErrorRecoveryAttempting`) methods.
Simply call one of the methods in the category on a class
to add a block property to that class.
These methods should be called in a category's `+load` method,
before the application starts.
*/
@interface NSObject (A2BlockDelegate)
/** @name Data Source Properties */
/** Synthesizes a property with the given name and
links it to the given selector in the data source
protocol.
A2DynamicDelegate assumes a protocol name `FooBarDataSource`
for instances of class `FooBar`. The method will generate
appropriate `setHandler:` and `handler` implementations for
the given property name.
@param propertyName A property name to synthesize. Must not be NULL.
@param selector An encoded selector. Must not be NULL.
*/
+ (void) linkCategoryBlockProperty: (NSString *) propertyName withDataSourceMethod: (SEL) selector;
/** Synthesizes multiple properties and links them to
the appropriate selector in the data source protocol.
A2DynamicDelegate assumes a protocol name `FooBarDataSource`
for instances of class `FooBar`. The method will generate
appropriate `setHandler:` and `handler` implementations for
each property name and selector name string pair.
@param selectorsForPropertyNames A dictionary with property
names as keys and selectors (as strings) as objects.
*/
+ (void) linkDataSourceMethods: (NSDictionary *) selectorsForPropertyNames;
/** @name Delegate Properties */
/** Synthesizes a property with the given name and
links it to the given selector in the delegate protocol.
A2DynamicDelegate assumes a protocol name `FooBarDelegate`
for instances of class `FooBar`. The method will generate
appropriate `setHandler:` and `handler` implementations for
the given property name.
@param propertyName A property name to synthesize. Must not be NULL.
@param selector An encoded selector. Must not be NULL.
*/
+ (void) linkCategoryBlockProperty: (NSString *) propertyName withDelegateMethod: (SEL) selector;
/** Synthesizes multiple properties and links them to
the appropriate selector in the delegate protocol.
A2DynamicDelegate assumes a protocol name `FooBarDelegate`
for instances of class `FooBar`. The method will generate
appropriate `setHandler:` and `handler` implementations for
each property name and selector name string pair.
@param selectorsForPropertyNames A dictionary with property
names as keys and selectors (as strings) as objects.
*/
+ (void) linkDelegateMethods: (NSDictionary *) selectorsForPropertyNames;
/** @name Other Protocol Properties */
/** Synthesizes a property with the given name and
links it to the given selector in the given protocol.
The method will generate appropriate `setHandler:`
and `handler` implementations for the given property name.
@param propertyName A property name to synthesize. Must not be NULL.
@param protocol A protocol that declares the given selector. Must not be NULL.
@param selector An encoded selector. Must not be NULL.
*/
+ (void) linkCategoryBlockProperty: (NSString *) propertyName withProtocol: (Protocol *) protocol method: (SEL) selector;
/** Synthesizes multiple properties and links them to
the appropriate selector in the given protocol.
The method will generate appropriate `setHandler:`
and `handler` implementations for each property name and
selector name string pair.
@param protocol A protocol that declares all of the given
selectors. Must not be NULL.
@param selectorsForPropertyNames A dictionary with property
names as keys and selectors (as strings) as objects.
*/
+ (void) linkProtocol: (Protocol *) protocol methods: (NSDictionary *) selectorsForPropertyNames;
@end