This repository has been archived by the owner on May 24, 2024. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 1.3k
/
interface_n_i_cell_factory.html
170 lines (149 loc) · 8.57 KB
/
interface_n_i_cell_factory.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
<!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: NICellFactory Class Reference</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.7.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('interface_n_i_cell_factory.html','');
</script>
<div id="doc-content">
<div class="header">
<div class="summary">
<a href="#pub-methods">Methods</a> </div>
<div class="headertitle">
<div class="title">NICellFactory Class Reference<div class="ingroups"><a class="el" href="group___table_cell_factory.html">Table Cell Factory</a></div></div> </div>
</div>
<div class="contents">
<!-- doxytag: class="NICellFactory" --><hr/><a name="details" id="details"></a><h2>Overview</h2>
<div class="textblock"><p>A simple factory for creating table view cells from objects. </p>
<p>This factory provides a single method that accepts an object and returns a UITableViewCell for use in a UITableView. A cell will only be returned if the object passed to the factory conforms to the <a class="el" href="protocol_n_i_cell_object-p.html" title="The protocol for an object that can be used in the NICellFactory.">NICellObject</a> protocol. The created cell should ideally conform to the <a class="el" href="protocol_n_i_cell-p.html" title="The protocol for a cell created in the NICellFactory.">NICell</a> protocol. If it does, the object will be passed to it via <a class="el" href="protocol_n_i_cell-p.html#af12eab4c2d2d97f512a373a30d230a98">shouldUpdateCellWithObject:</a> before the factory method returns.</p>
<p>This factory is designed to be used with NITableViewModels, though one could easily use it with other table view data source implementations simply by providing nil for the table view model. </p>
<p>Definition at line <a class="el" href="_n_i_cell_factory_8h_source.html#l00039">39</a> of file <a class="el" href="_n_i_cell_factory_8h_source.html">NICellFactory.h</a>.</p>
</div><table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Methods</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">(UITableViewCell *) </td><td class="memItemRight" valign="bottom">+ <a class="el" href="interface_n_i_cell_factory.html#ae8badbc7ff1e42a28845c41eea426641">tableViewModel:cellForTableView:atIndexPath:withObject:</a></td></tr>
</table>
<hr/><h2>Method Documentation</h2>
<a class="anchor" id="ae8badbc7ff1e42a28845c41eea426641"></a><!-- doxytag: member="NICellFactory::tableViewModel:cellForTableView:atIndexPath:withObject:" ref="ae8badbc7ff1e42a28845c41eea426641" args="(NITableViewModel *tableViewModel,[cellForTableView] UITableView *tableView,[atIndexPath] NSIndexPath *indexPath,[withObject] id object)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">+ (UITableViewCell *) tableViewModel: </td>
<td></td>
<td class="paramtype">(<a class="el" href="class_n_i_table_view_model.html">NITableViewModel</a> *) </td>
<td class="paramname"><em>tableViewModel</em></td>
</tr>
<tr>
<td class="paramkey">cellForTableView:</td>
<td></td>
<td class="paramtype">(UITableView *) </td>
<td class="paramname"><em>tableView</em></td>
</tr>
<tr>
<td class="paramkey">atIndexPath:</td>
<td></td>
<td class="paramtype">(NSIndexPath *) </td>
<td class="paramname"><em>indexPath</em></td>
</tr>
<tr>
<td class="paramkey">withObject:</td>
<td></td>
<td class="paramtype">(id) </td>
<td class="paramname"><em>object</em> </td>
</tr>
<tr>
<td></td>
<td></td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Creates a cell from a given object if and only if the object conforms to the <a class="el" href="protocol_n_i_cell_object-p.html" title="The protocol for an object that can be used in the NICellFactory.">NICellObject</a> protocol. </p>
<p>This method signature matches the <a class="el" href="protocol_n_i_table_view_model_delegate-p.html" title="A protocol for NITableViewModel to fetch rows to be displayed for the table view.">NITableViewModelDelegate</a> method so that you can set this factory as the model's delegate:</p>
<div class="fragment"><pre class="fragment"><span class="comment">// Must cast to id to avoid compiler warnings.</span>
_model.delegate = (id)[<a class="code" href="interface_n_i_cell_factory.html" title="A simple factory for creating table view cells from objects.">NICellFactory</a> <span class="keyword">class</span>];
</pre></div><p>If you would like to customize the factory's output, implement the model's delegate method and call the factory method. Remember that if the factory doesn't know how to map the object to a cell it will return nil.</p>
<div class="fragment"><pre class="fragment">- (UITableViewCell *)tableViewModel: (<a class="code" href="class_n_i_table_view_model.html" title="A non-mutable table view model that complies to the UITableViewDataSource protocol.">NITableViewModel</a> *)tableViewModel
cellForTableView: (UITableView *)tableView
atIndexPath: (NSIndexPath *)indexPath
withObject: (id)<span class="keywordtype">object</span> {
UITableViewCell* cell = [<a class="code" href="interface_n_i_cell_factory.html" title="A simple factory for creating table view cells from objects.">NICellFactory</a> tableViewModel: tableViewModel
cellForTableView: tableView
atIndexPath: indexPath
withObject: object];
<span class="keywordflow">if</span> (nil == cell) {
<span class="comment">// Custom cell creation here.</span>
}
<span class="keywordflow">return</span> cell;
}
</pre></div>
<p>Definition at line <a class="el" href="_n_i_cell_factory_8m_source.html#l00027">27</a> of file <a class="el" href="_n_i_cell_factory_8m_source.html">NICellFactory.m</a>.</p>
</div>
</div>
</div>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="interface_n_i_cell_factory.html">NICellFactory</a> </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>