NICell-Protocol.html

<!-- HTML header for doxygen 1.8.6-->
<!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"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.6-nimbuskit"/>
<title>NimbusKit: &lt;NICell&gt; Protocol Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
  $(document).ready(initResizable);
  $(window).load(resizeHeight);
</script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="appledocs.css" rel="stylesheet" type="text/css"/>
<link href="nimbuskit.css" rel="stylesheet" type="text/css" />
<script type="text/javascript">
  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', 'UA-24278774-1']);
  _gaq.push(['_setDomainName', 'nimbuskit.info']);
  _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="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<a href="index.html"><img style="float:left" src="nimbus128.png" width="80" height="80" /></a>
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  <td style="padding-left: 0.5em;">
   <div id="projectname">NimbusKit
   &#160;<span id="projectnumber">1.2.1 - <a href="http://github.com/jverkoey/nimbus">Fork Nimbus on Github</a> - <a href="http://wiki.nimbuskit.info/">Visit the Nimbus Wiki</a></span>
   </div>
   <div id="projectbrief">The iOS framework that grows only as fast as its documentation</div>
  </td>
 </tr>
 </tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.6-nimbuskit -->
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
      <div id="nav-sync" class="sync"></div>
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('NICell-Protocol.html','');});
</script>
<div id="doc-content">
<div class="header">
  <div class="summary">
<a href="#pub-methods">Tasks</a> &#124;
<a href="NICell-p-members.html">List of all members</a>  </div>
  <div class="headertitle">
<div class="title">&lt;NICell&gt; Protocol Reference<div class="ingroups"><a class="el" href="TableCellFactory.html">Table Cell Factory</a></div></div>  </div>
</div><!--header-->
<div class="contents">
<a name="details" id="details"></a><h2 class="groupheader">Overview</h2>
<div class="textblock"><p>The protocol for a cell created in the <a class="el" href="NICellFactory.html" title="A simple factory for creating table view cells from objects. ">NICellFactory</a>. </p>
<p>Cells that implement this protocol are given the object that implemented the <a class="el" href="NICellObject.html" title="A light-weight implementation of the NICellObject protocol. ">NICellObject</a> protocol and returned this cell's class name in <a class="el" href="">cellClass</a>. </p>
</div><div class="dynheader">
Inheritance diagram for &lt;NICell&gt;:</div>
<div class="dyncontent">
 <div class="center">
  <img src="NICell-Protocol.png" usemap="#&lt;NICell&gt;_map" alt=""/>
  <map id="&lt;NICell&gt;_map" name="&lt;NICell&gt;_map">
<area href="NIDrawRectBlockCell.html" title="A cell that renders its contents using a block. " alt="NIDrawRectBlockCell" shape="rect" coords="0,56,222,80"/>
<area href="NIFormElementCell.html" title="The base class for form element cells. " alt="NIFormElementCell" shape="rect" coords="464,56,686,80"/>
<area href="NIRadioGroupCell.html" title="The cell that is displayed for a NIRadioGroup object when it is displayed in a UITableView. " alt="NIRadioGroupCell" shape="rect" coords="696,56,918,80"/>
<area href="NITextCell.html" title="A general-purpose cell for displaying text. " alt="NITextCell" shape="rect" coords="928,56,1150,80"/>
<area href="NIDatePickerFormElementCell.html" title="The cell sibling to NIDatePickerFormElement. " alt="NIDatePickerFormElementCell" shape="rect" coords="0,112,222,136"/>
<area href="NISegmentedControlFormElementCell.html" title="The cell sibling to NISegmentedControlFormElement. " alt="NISegmentedControlFormElementCell" shape="rect" coords="232,112,454,136"/>
<area href="NISliderFormElementCell.html" title="The cell sibling to NISliderFormElement. " alt="NISliderFormElementCell" shape="rect" coords="464,112,686,136"/>
<area href="NISwitchFormElementCell.html" title="The cell sibling to NISwitchFormElement. " alt="NISwitchFormElementCell" shape="rect" coords="696,112,918,136"/>
<area href="NITextInputFormElementCell.html" title="The cell sibling to NITextInputFormElement. " alt="NITextInputFormElementCell" shape="rect" coords="928,112,1150,136"/>
</map>
 </div></div>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
Tasks</h2></td></tr>
<tr class="memitem:shouldUpdateCellWithObject:"><td class="memItemLeft" align="right" valign="top">(BOOL)&#160;</td><td class="memItemRight" valign="bottom">- <a class="el" href="NICell-Protocol.html#shouldUpdateCellWithObject:">shouldUpdateCellWithObject:</a></td></tr>
<tr class="separator:shouldUpdateCellWithObject:"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:shouldAppendObjectClassToReuseIdentifier"><td class="memItemLeft" align="right" valign="top">(BOOL)&#160;</td><td class="memItemRight" valign="bottom">+ <a class="el" href="NICell-Protocol.html#shouldAppendObjectClassToReuseIdentifier">shouldAppendObjectClassToReuseIdentifier</a></td></tr>
<tr class="separator:shouldAppendObjectClassToReuseIdentifier"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:heightForObject:atIndexPath:tableView:"><td class="memItemLeft" align="right" valign="top">(CGFloat)&#160;</td><td class="memItemRight" valign="bottom">+ <a class="el" href="NICell-Protocol.html#heightForObject:atIndexPath:tableView:">heightForObject:atIndexPath:tableView:</a></td></tr>
<tr class="separator:heightForObject:atIndexPath:tableView:"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<h2 class="groupheader">Method Documentation</h2>
<a class="anchor" id="shouldUpdateCellWithObject:"></a>
<div class="memitem">
      <h3 class="memname">shouldUpdateCellWithObject:</h3>
<div class="memdoc">

<p class="abstract">Called when a cell is created and reused. </p>
<div class="declaration">
- (BOOL)shouldUpdateCellWithObject:(id)object;</td></tr>
</div>
<h5>Discussion</h5>
<p>Implement this method to customize the cell's properties for display using the given object. </p>

</div>
</div>
<a class="anchor" id="shouldAppendObjectClassToReuseIdentifier"></a>
<div class="memitem">
      <h3 class="memname">shouldAppendObjectClassToReuseIdentifier</h3>
<div class="memdoc">

<p class="abstract">Asks the receiver whether the mapped object class should be appended to the reuse identifier in order to create a unique cell.object identifier key. </p>
<div class="declaration">
+ (BOOL)shouldAppendObjectClassToReuseIdentifier;</td></tr>
</div>
<h5>Discussion</h5>
<p>This is useful when you have a cell that is intended to be used by a variety of different objects. </p>

</div>
</div>
<a class="anchor" id="heightForObject:atIndexPath:tableView:"></a>
<div class="memitem">
      <h3 class="memname">heightForObject:atIndexPath:tableView:</h3>
<div class="memdoc">

<p class="abstract">Asks the receiver to calculate its height. </p>
<div class="declaration">
+ (CGFloat)heightForObject:(id)object atIndexPath:(NSIndexPath *)indexPath tableView:(UITableView *)tableView;</td></tr>
</div>
<h5>Discussion</h5>
<p>The following is an appropiate implementation in your tableView's delegate:</p>
<div class="fragment"><div class="line">-(CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {</div>
<div class="line">  CGFloat height = tableView.rowHeight;</div>
<div class="line">  <span class="keywordtype">id</span> <span class="keywordtype">object</span> = [(<a class="code" href="NITableViewModel.html">NITableViewModel</a> *)tableView.dataSource objectAtIndexPath:indexPath];</div>
<div class="line">  <span class="keywordtype">id</span> <span class="keyword">class</span> = [<span class="keywordtype">object</span> cellClass];</div>
<div class="line">  if ([<span class="keyword">class</span> respondsToSelector:<span class="keyword">@selector</span>(heightForObject:atIndexPath:tableView:)]) {</div>
<div class="line">    height = [<span class="keyword">class </span>heightForObject:object atIndexPath:indexPath tableView:tableView];</div>
<div class="line">  }</div>
<div class="line">  return height;</div>
<div class="line">}</div>
</div><!-- fragment --><p>You may also use the <a class="el" href="NICellFactory.html#tableView:heightForRowAtIndexPath:model:">tableView:heightForRowAtIndexPath:model:</a> methods on <a class="el" href="NICellFactory.html" title="A simple factory for creating table view cells from objects. ">NICellFactory</a> to achieve the same result. Using the above example allows you to customize the logic according to your specific needs. </p>

</div>
</div>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- HTML footer for doxygen 1.8.6-->
<!-- start footer part -->
<script type="text/javascript" src="widget.js"></script>
</body>
</html>