forked from jverkoey/nimbus
-
Notifications
You must be signed in to change notification settings - Fork 0
/
_n_i_launcher_view_controller_8m_source.html
267 lines (249 loc) · 17.3 KB
/
_n_i_launcher_view_controller_8m_source.html
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
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>Nimbus: /Users/featherless/workbench/ios/nimbus/src/launcher/src/NILauncherViewController.m Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
</script>
<link href="stylesheet.css" rel="stylesheet" type="text/css" />
<script type="text/javascript">
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-24278774-1']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();
</script>
</head>
<body>
<div id="page">
<div style="position:relative">
<div id="top"><!-- do not remove this div! -->
<div id="titlearea">
<a style="float: right;margin-right:20px;margin-top:20px" href='http://www.pledgie.com/campaigns/15519'><img alt='Click here to support Nimbus development and make a donation at www.pledgie.com !' src='http://www.pledgie.com/campaigns/15519.png?skin_name=chrome' border='0' /></a>
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">Nimbus
 <span id="projectnumber">0.6.0 - <a href="http://github.com/jverkoey/nimbus">Nimbus is proudly hosted on Github</a></span>
</div>
<div id="projectbrief">An iOS framework whose growth is bounded by O(documentation).</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- Generated by Doxygen 1.7.4-20110629 -->
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
initNavTree('_n_i_launcher_view_controller_8m.html','');
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<div class="title">/Users/featherless/workbench/ios/nimbus/src/launcher/src/NILauncherViewController.m</div> </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">//</span>
<a name="l00002"></a>00002 <span class="comment">// Copyright 2011 Jeff Verkoeyen</span>
<a name="l00003"></a>00003 <span class="comment">//</span>
<a name="l00004"></a>00004 <span class="comment">// Licensed under the Apache License, Version 2.0 (the "License");</span>
<a name="l00005"></a>00005 <span class="comment">// you may not use this file except in compliance with the License.</span>
<a name="l00006"></a>00006 <span class="comment">// You may obtain a copy of the License at</span>
<a name="l00007"></a>00007 <span class="comment">//</span>
<a name="l00008"></a>00008 <span class="comment">// http://www.apache.org/licenses/LICENSE-2.0</span>
<a name="l00009"></a>00009 <span class="comment">//</span>
<a name="l00010"></a>00010 <span class="comment">// Unless required by applicable law or agreed to in writing, software</span>
<a name="l00011"></a>00011 <span class="comment">// distributed under the License is distributed on an "AS IS" BASIS,</span>
<a name="l00012"></a>00012 <span class="comment">// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</span>
<a name="l00013"></a>00013 <span class="comment">// See the License for the specific language governing permissions and</span>
<a name="l00014"></a>00014 <span class="comment">// limitations under the License.</span>
<a name="l00015"></a>00015 <span class="comment">//</span>
<a name="l00016"></a>00016
<a name="l00017"></a>00017 <span class="preprocessor">#import "NILauncherViewController.h"</span>
<a name="l00018"></a>00018
<a name="l00019"></a>00019 <span class="preprocessor">#import "NILauncherView.h"</span>
<a name="l00020"></a>00020
<a name="l00021"></a>00021
<a name="l00025"></a>00025 <span class="keyword">@implementation </span><a class="code" href="interface_n_i_launcher_view_controller.html" title="A view controller that displays a launcher view and implements its protocols.">NILauncherViewController</a>
<a name="l00026"></a>00026
<a name="l00027"></a>00027 <span class="keyword">@synthesize</span> launcherView = _launcherView;
<a name="l00028"></a>00028 <span class="keyword">@synthesize</span> <a class="code" href="interface_n_i_launcher_view_controller.html#ae6d4791037f7aec351b814ebc0dfad00" title="An array of arrays of NILauncherItemDetails.">pages</a> = _pages;
<a name="l00029"></a>00029
<a name="l00030"></a>00030
<a name="l00032"></a>00032 - (void)dealloc {
<a name="l00033"></a>00033 <a class="code" href="group___preprocessor-_macros.html#ga5d2e99251aeb3ddb687e27f72336e5db" title="Release and assign nil to an object.">NI_RELEASE_SAFELY</a>(_pages);
<a name="l00034"></a>00034 <span class="comment">// _launcherView is retained by self.view and is released in viewDidUnload</span>
<a name="l00035"></a>00035
<a name="l00036"></a>00036 [<span class="keyword">super</span> dealloc];
<a name="l00037"></a>00037 }
<a name="l00038"></a>00038
<a name="l00039"></a>00039
<a name="l00041"></a>00041 - (void)viewDidLoad {
<a name="l00042"></a>00042 [<span class="keyword">super</span> viewDidLoad];
<a name="l00043"></a>00043
<a name="l00044"></a>00044 _launcherView = [[[<a class="code" href="interface_n_i_launcher_view.html" title="A launcher view that simulates iOS' home screen launcher functionality.">NILauncherView</a> alloc] initWithFrame:self.view.bounds] autorelease];
<a name="l00045"></a>00045 _launcherView.autoresizingMask = (UIViewAutoresizingFlexibleWidth
<a name="l00046"></a>00046 | UIViewAutoresizingFlexibleHeight);
<a name="l00047"></a>00047 _launcherView.dataSource = <span class="keyword">self</span>;
<a name="l00048"></a>00048 _launcherView.delegate = <span class="keyword">self</span>;
<a name="l00049"></a>00049 [_launcherView reloadData];
<a name="l00050"></a>00050 [<span class="keyword">self</span>.view addSubview:_launcherView];
<a name="l00051"></a>00051 }
<a name="l00052"></a>00052
<a name="l00053"></a>00053
<a name="l00055"></a>00055 - (void)viewDidUnload {
<a name="l00056"></a>00056 _launcherView = nil;
<a name="l00057"></a>00057
<a name="l00058"></a>00058 [<span class="keyword">super</span> viewDidUnload];
<a name="l00059"></a>00059 }
<a name="l00060"></a>00060
<a name="l00061"></a>00061
<a name="l00063"></a>00063 - (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)toInterfaceOrientation {
<a name="l00064"></a>00064 <span class="comment">// Only allow portrait for the iPhone and iPod touch.</span>
<a name="l00065"></a>00065 <span class="keywordflow">return</span> <a class="code" href="group___s_d_k-_availability.html#ga7c693df0e5edd930db9d711852561eb4" title="Checks whether the device the app is currently running on is an iPad or not.">NIIsPad</a>() || UIInterfaceOrientationIsPortrait(toInterfaceOrientation);
<a name="l00066"></a>00066 }
<a name="l00067"></a>00067
<a name="l00068"></a>00068
<a name="l00071"></a>00071 <span class="preprocessor">#pragma mark -</span>
<a name="l00072"></a>00072 <span class="preprocessor"></span><span class="preprocessor">#pragma mark NILauncherDataSource</span>
<a name="l00073"></a>00073 <span class="preprocessor"></span>
<a name="l00074"></a>00074
<a name="l00076"></a>00076 - (NSInteger)numberOfRowsPerPageInLauncherView:(<a class="code" href="interface_n_i_launcher_view.html" title="A launcher view that simulates iOS' home screen launcher functionality.">NILauncherView</a> *)launcherView {
<a name="l00077"></a>00077 <span class="comment">// Replace this with NILauncherViewDynamic to allow the launcher view to calculate the number</span>
<a name="l00078"></a>00078 <span class="comment">// of rows and columns automatically.</span>
<a name="l00079"></a>00079 <span class="keywordflow">return</span> (<a class="code" href="group___s_d_k-_availability.html#ga7c693df0e5edd930db9d711852561eb4" title="Checks whether the device the app is currently running on is an iPad or not.">NIIsPad</a>()
<a name="l00080"></a>00080 ? 4
<a name="l00081"></a>00081 : (UIInterfaceOrientationIsPortrait(<a class="code" href="group___device-_orientation.html#ga350d238bb40115bab71c59aab4d74958" title="Returns the application's current interface orientation.">NIInterfaceOrientation</a>())
<a name="l00082"></a>00082 ? 3 : 2));
<a name="l00083"></a>00083 }
<a name="l00084"></a>00084
<a name="l00085"></a>00085
<a name="l00087"></a>00087 - (NSInteger)numberOfColumnsPerPageInLauncherView:(<a class="code" href="interface_n_i_launcher_view.html" title="A launcher view that simulates iOS' home screen launcher functionality.">NILauncherView</a> *)launcherView {
<a name="l00088"></a>00088 <span class="keywordflow">return</span> (<a class="code" href="group___s_d_k-_availability.html#ga7c693df0e5edd930db9d711852561eb4" title="Checks whether the device the app is currently running on is an iPad or not.">NIIsPad</a>()
<a name="l00089"></a>00089 ? 5
<a name="l00090"></a>00090 : (UIInterfaceOrientationIsPortrait(<a class="code" href="group___device-_orientation.html#ga350d238bb40115bab71c59aab4d74958" title="Returns the application's current interface orientation.">NIInterfaceOrientation</a>())
<a name="l00091"></a>00091 ? 3 : 5));
<a name="l00092"></a>00092 }
<a name="l00093"></a>00093
<a name="l00094"></a>00094
<a name="l00096"></a>00096 - (NSInteger)numberOfPagesInLauncherView:(<a class="code" href="interface_n_i_launcher_view.html" title="A launcher view that simulates iOS' home screen launcher functionality.">NILauncherView</a> *)launcherView {
<a name="l00097"></a>00097 <span class="keywordflow">return</span> [_pages count];
<a name="l00098"></a>00098 }
<a name="l00099"></a>00099
<a name="l00100"></a>00100
<a name="l00102"></a>00102 - (NSInteger)launcherView:(<a class="code" href="interface_n_i_launcher_view.html" title="A launcher view that simulates iOS' home screen launcher functionality.">NILauncherView</a> *)launcherView numberOfButtonsInPage:(NSInteger)page {
<a name="l00103"></a>00103 <span class="keywordflow">return</span> [[_pages objectAtIndex:page] count];
<a name="l00104"></a>00104 }
<a name="l00105"></a>00105
<a name="l00106"></a>00106
<a name="l00108"></a>00108 - (UIButton *)launcherView: (<a class="code" href="interface_n_i_launcher_view.html" title="A launcher view that simulates iOS' home screen launcher functionality.">NILauncherView</a> *)launcherView
<a name="l00109"></a>00109 buttonForPage: (NSInteger)page
<a name="l00110"></a>00110 atIndex: (NSInteger)buttonIndex {
<a name="l00111"></a>00111 UIButton* button = [[[[<span class="keyword">self</span> launcherButtonClass] alloc] init] autorelease];
<a name="l00112"></a>00112
<a name="l00113"></a>00113 <span class="comment">// launcherButtonClass must return a class that is a subclass of UIButton.</span>
<a name="l00114"></a>00114 <a class="code" href="group___debugging-_tools.html#ga13cc3ae82820ea8141bc319bcb76ab7f" title="Assertions that only fire when DEBUG is defined.">NIDASSERT</a>([button isKindOfClass:[UIButton <span class="keyword">class</span>]]);
<a name="l00115"></a>00115 <span class="keywordflow">if</span> (![button isKindOfClass:[UIButton <span class="keyword">class</span>]]) {
<a name="l00116"></a>00116 <span class="keywordflow">return</span> nil;
<a name="l00117"></a>00117 }
<a name="l00118"></a>00118
<a name="l00119"></a>00119 <a class="code" href="class_n_i_launcher_item_details.html" title="A convenience class for managing the data used to create an NILauncherButton.">NILauncherItemDetails</a>* item = [[_pages objectAtIndex:page] objectAtIndex:buttonIndex];
<a name="l00120"></a>00120 [button setTitle:item.title forState:UIControlStateNormal];
<a name="l00121"></a>00121 [button setImage: [UIImage imageWithContentsOfFile:item.imagePath]
<a name="l00122"></a>00122 forState: UIControlStateNormal];
<a name="l00123"></a>00123
<a name="l00124"></a>00124 <span class="keywordflow">return</span> button;
<a name="l00125"></a>00125 }
<a name="l00126"></a>00126
<a name="l00127"></a>00127
<a name="l00130"></a>00130 <span class="preprocessor">#pragma mark -</span>
<a name="l00131"></a>00131 <span class="preprocessor"></span><span class="preprocessor">#pragma mark NILauncherDelegate</span>
<a name="l00132"></a>00132 <span class="preprocessor"></span>
<a name="l00133"></a>00133
<a name="l00135"></a>00135 - (void)launcherView: (<a class="code" href="interface_n_i_launcher_view.html" title="A launcher view that simulates iOS' home screen launcher functionality.">NILauncherView</a> *)launcher
<a name="l00136"></a>00136 didSelectButton: (UIButton *)button
<a name="l00137"></a>00137 onPage: (NSInteger)page
<a name="l00138"></a>00138 atIndex: (NSInteger)buttonIndex {
<a name="l00139"></a>00139 <span class="comment">// This is purely an example implementation. It is incredibly likely that you will not want to</span>
<a name="l00140"></a>00140 <span class="comment">// use this in your production code.</span>
<a name="l00141"></a>00141
<a name="l00142"></a>00142 <span class="comment">// If you require access to the launcher item details, you may find the following</span>
<a name="l00143"></a>00143 <span class="comment">// to be helpful:</span>
<a name="l00144"></a>00144 <span class="comment">//</span>
<a name="l00145"></a>00145 <span class="comment">// NILauncherItemDetails* item = [[_pages objectAtIndex:page] objectAtIndex:index];</span>
<a name="l00146"></a>00146
<a name="l00147"></a>00147 UIAlertView* alert =
<a name="l00148"></a>00148 [[[UIAlertView alloc] initWithTitle: @"Launcher button tapped"
<a name="l00149"></a>00149 message: [button titleForState:UIControlStateNormal]
<a name="l00150"></a>00150 delegate: nil
<a name="l00151"></a>00151 cancelButtonTitle: nil
<a name="l00152"></a>00152 otherButtonTitles: @"OK", nil]
<a name="l00153"></a>00153 autorelease];
<a name="l00154"></a>00154 [alert show];
<a name="l00155"></a>00155 }
<a name="l00156"></a>00156
<a name="l00157"></a>00157
<a name="l00160"></a>00160 <span class="preprocessor">#pragma mark -</span>
<a name="l00161"></a>00161 <span class="preprocessor"></span><span class="preprocessor">#pragma mark Override Methods</span>
<a name="l00162"></a>00162 <span class="preprocessor"></span>
<a name="l00163"></a>00163
<a name="l00165"></a><a class="code" href="interface_n_i_launcher_view_controller.html#a21629435d3eea13bb429361dae2ac0b5">00165</a> - (Class)<a class="code" href="interface_n_i_launcher_view_controller.html#a21629435d3eea13bb429361dae2ac0b5" title="The launcher button view class.">launcherButtonClass</a> {
<a name="l00166"></a>00166 <span class="keywordflow">return</span> [<a class="code" href="class_n_i_launcher_button.html" title="A simple launcher button that shows an image and text.">NILauncherButton</a> class];
<a name="l00167"></a>00167 }
<a name="l00168"></a>00168
<a name="l00169"></a>00169
<a name="l00172"></a>00172 <span class="preprocessor">#pragma mark -</span>
<a name="l00173"></a>00173 <span class="preprocessor"></span><span class="preprocessor">#pragma mark Properties</span>
<a name="l00174"></a>00174 <span class="preprocessor"></span>
<a name="l00175"></a>00175
<a name="l00177"></a>00177 - (void)setPages:(NSArray *)pages {
<a name="l00178"></a>00178 <span class="keywordflow">if</span> (_pages != pages) {
<a name="l00179"></a>00179 [_pages release];
<a name="l00180"></a>00180 _pages = [pages mutableCopy];
<a name="l00181"></a>00181
<a name="l00182"></a>00182 <span class="comment">// If the view hasn't been loaded yet (entirely possible) then this will no-op and the</span>
<a name="l00183"></a>00183 <span class="comment">// launcher view will load its data in viewDidLoad.</span>
<a name="l00184"></a>00184 [_launcherView reloadData];
<a name="l00185"></a>00185 }
<a name="l00186"></a>00186 }
<a name="l00187"></a>00187
<a name="l00188"></a>00188
<a name="l00190"></a>00190 - (NSArray *)pages {
<a name="l00191"></a>00191 <span class="keywordflow">return</span> [NSArray arrayWithArray:_pages];
<a name="l00192"></a>00192 }
<a name="l00193"></a>00193
<a name="l00194"></a>00194
<a name="l00195"></a>00195 <span class="keyword">@end</span>
</pre></div></div>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><b>NILauncherViewController.m</b> </li>
</div><!-- .fixedwidth -->
<span class="footer">Generated for Nimbus by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.4-20110629 </span>
</ul>
</div>
</div> <!-- page -->
</body>
</html>