Files
2018-07-23 19:30:47 -05:00

422 lines
11 KiB
HTML

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>ORKPieChartViewDataSource Protocol Reference</title>
<link rel="stylesheet" href="../css/style.css">
<meta name="viewport" content="initial-scale=1, maximum-scale=1.4">
<meta name="generator" content="appledoc 2.2.1 (build 1334)">
</head>
<body class="appledoc">
<header>
<div class="container" class="hide-in-xcode">
<h1 id="library-title">
<a href="../index.html">ResearchKit </a>
</h1>
<p id="developer-home">
<a href="../index.html">ResearchKit</a>
</p>
</div>
</header>
<aside>
<div class="container">
<nav>
<ul id="header-buttons" role="toolbar">
<li><a href="../index.html">Index</a></li>
<li><a href="../hierarchy.html">Hierarchy</a></li>
<li id="on-this-page" role="navigation">
<label>
On This Page
<div class="chevron">
<div class="chevy chevron-left"></div>
<div class="chevy chevron-right"></div>
</div>
<select id="jump-to">
<option value="top">Jump To&#133;</option>
<option value="overview">Overview</option>
<option value="tasks">Tasks</option>
<optgroup label="Instance Methods">
<option value="//api/name/numberOfSegmentsInPieChartView:">- numberOfSegmentsInPieChartView:</option>
<option value="//api/name/pieChartView:colorForSegmentAtIndex:">- pieChartView:colorForSegmentAtIndex:</option>
<option value="//api/name/pieChartView:titleForSegmentAtIndex:">- pieChartView:titleForSegmentAtIndex:</option>
<option value="//api/name/pieChartView:valueForSegmentAtIndex:">- pieChartView:valueForSegmentAtIndex:</option>
</optgroup>
</select>
</label>
</li>
</ul>
</nav>
</div>
</aside>
<article>
<div id="overview_contents" class="container">
<div id="content">
<main role="main">
<h1 class="title">ORKPieChartViewDataSource Protocol Reference</h1>
<div class="section section-specification"><table cellspacing="0"><tbody>
<tr>
<th>Conforms to</th>
<td>NSObject</td>
</tr><tr>
<th>Declared in</th>
<td>ORKPieChartView.h</td>
</tr>
</tbody></table></div>
<div class="section section-overview">
<a title="Overview" name="overview"></a>
<h2 class="subtitle subtitle-overview">Overview</h2>
<p>An object that adopts the <code>ORKPieChartViewDataSource</code> protocol is responsible for providing the
data required to populate an <a href="../Classes/ORKPieChartView.html"><code>ORKPieChartView</code></a> object.</p>
<p>At a minimumm, a data source object must implement the <code>numberOfSegmentsInPieChartView</code> and
<a href="#//api/name/pieChartView:valueForSegmentAtIndex:"><code>pieChartView:valueForSegmentAtIndex:</code></a> methods. These methods are responsible for returning the
number of segments in a pie chart view and the value for each segment. A data source object may
provide additional information to the pie chart by implementing the optional
<code>ORKPieChartViewDataSource</code> methods.</p>
<p>When configuring an <a href="../Classes/ORKPieChartView.html"><code>ORKPieChartView</code></a> object, assign your data source to its <code>dataSource</code> property.</p>
</div>
<div class="section section-tasks">
<a title="Tasks" name="tasks"></a>
<div class="task-list">
<div class="section-method">
<a name="//api/name/numberOfSegmentsInPieChartView:" title="numberOfSegmentsInPieChartView:"></a>
<h3 class="method-title"><code><a href="#//api/name/numberOfSegmentsInPieChartView:">&ndash;&nbsp;numberOfSegmentsInPieChartView:</a></code>
<span class="task-item-suffix">required method</span></h3>
<div class="method-info">
<div class="pointy-thing"></div>
<div class="method-info-container">
<div class="method-subsection brief-description">
<p>Asks the data source for the number of segments in the pie chart view.</p>
</div>
<div class="method-subsection method-declaration"><code>- (NSInteger)numberOfSegmentsInPieChartView:(ORKPieChartView *)<em>pieChartView</em></code></div>
<div class="method-subsection arguments-section parameters">
<h4 class="method-subtitle parameter-title">Parameters</h4>
<table class="argument-def parameter-def">
<tr>
<th scope="row" class="argument-name"><code>pieChartView</code></th>
<td><p>The pie chart view asking for the number of segments.</p></td>
</tr>
</table>
</div>
<div class="method-subsection return">
<h4 class="method-subtitle parameter-title">Return Value</h4>
<p>The number of segments in the pie chart view.</p>
</div>
<div class="method-subsection declared-in-section">
<h4 class="method-subtitle">Declared In</h4>
<p><code class="declared-in-ref">ORKPieChartView.h</code></p>
</div>
</div>
</div>
</div><div class="section-method">
<a name="//api/name/pieChartView:valueForSegmentAtIndex:" title="pieChartView:valueForSegmentAtIndex:"></a>
<h3 class="method-title"><code><a href="#//api/name/pieChartView:valueForSegmentAtIndex:">&ndash;&nbsp;pieChartView:valueForSegmentAtIndex:</a></code>
<span class="task-item-suffix">required method</span></h3>
<div class="method-info">
<div class="pointy-thing"></div>
<div class="method-info-container">
<div class="method-subsection brief-description">
<p>Asks the data source for the value of a segment in the pie chart view.</p>
</div>
<div class="method-subsection method-declaration"><code>- (CGFloat)pieChartView:(ORKPieChartView *)<em>pieChartView</em> valueForSegmentAtIndex:(NSInteger)<em>index</em></code></div>
<div class="method-subsection arguments-section parameters">
<h4 class="method-subtitle parameter-title">Parameters</h4>
<table class="argument-def parameter-def">
<tr>
<th scope="row" class="argument-name"><code>pieChartView</code></th>
<td><p>The pie chart view asking for the value of the segment.</p></td>
</tr>
<tr>
<th scope="row" class="argument-name"><code>index</code></th>
<td><p>An index number specifying the segment in the pie chart view.</p></td>
</tr>
</table>
</div>
<div class="method-subsection return">
<h4 class="method-subtitle parameter-title">Return Value</h4>
<p>The value of the segment at the specified <code>index</code> in the pie chart view.</p>
</div>
<div class="method-subsection discussion-section">
<h4 class="method-subtitle">Discussion</h4>
<p>The value can be any arbitrary integer: the pie chart view normalizes them by the sum of all
returned values.</p>
</div>
<div class="method-subsection declared-in-section">
<h4 class="method-subtitle">Declared In</h4>
<p><code class="declared-in-ref">ORKPieChartView.h</code></p>
</div>
</div>
</div>
</div><div class="section-method">
<a name="//api/name/pieChartView:colorForSegmentAtIndex:" title="pieChartView:colorForSegmentAtIndex:"></a>
<h3 class="method-title"><code><a href="#//api/name/pieChartView:colorForSegmentAtIndex:">&ndash;&nbsp;pieChartView:colorForSegmentAtIndex:</a></code>
</h3>
<div class="method-info">
<div class="pointy-thing"></div>
<div class="method-info-container">
<div class="method-subsection brief-description">
<p>Asks the data source for the color of a segment in the pie chart view.</p>
</div>
<div class="method-subsection method-declaration"><code>- (UIColor *)pieChartView:(ORKPieChartView *)<em>pieChartView</em> colorForSegmentAtIndex:(NSInteger)<em>index</em></code></div>
<div class="method-subsection arguments-section parameters">
<h4 class="method-subtitle parameter-title">Parameters</h4>
<table class="argument-def parameter-def">
<tr>
<th scope="row" class="argument-name"><code>pieChartView</code></th>
<td><p>The pie chart view asking for the color of the segment.</p></td>
</tr>
<tr>
<th scope="row" class="argument-name"><code>index</code></th>
<td><p>An index number specifying the segment in the pie chart view.</p></td>
</tr>
</table>
</div>
<div class="method-subsection return">
<h4 class="method-subtitle parameter-title">Return Value</h4>
<p>The color of the segment at the specified <code>index</code> in the pie chart view.</p>
</div>
<div class="method-subsection discussion-section">
<h4 class="method-subtitle">Discussion</h4>
<p>If this method is not implemented, the pie chart view uses a unique shade of the current
tint color for each segment.</p>
</div>
<div class="method-subsection declared-in-section">
<h4 class="method-subtitle">Declared In</h4>
<p><code class="declared-in-ref">ORKPieChartView.h</code></p>
</div>
</div>
</div>
</div><div class="section-method">
<a name="//api/name/pieChartView:titleForSegmentAtIndex:" title="pieChartView:titleForSegmentAtIndex:"></a>
<h3 class="method-title"><code><a href="#//api/name/pieChartView:titleForSegmentAtIndex:">&ndash;&nbsp;pieChartView:titleForSegmentAtIndex:</a></code>
</h3>
<div class="method-info">
<div class="pointy-thing"></div>
<div class="method-info-container">
<div class="method-subsection brief-description">
<p>Asks the data source for the title to appear in the legend for a segment in the pie chart view.</p>
</div>
<div class="method-subsection method-declaration"><code>- (NSString *)pieChartView:(ORKPieChartView *)<em>pieChartView</em> titleForSegmentAtIndex:(NSInteger)<em>index</em></code></div>
<div class="method-subsection arguments-section parameters">
<h4 class="method-subtitle parameter-title">Parameters</h4>
<table class="argument-def parameter-def">
<tr>
<th scope="row" class="argument-name"><code>pieChartView</code></th>
<td><p>The pie chart view asking for the title.</p></td>
</tr>
<tr>
<th scope="row" class="argument-name"><code>index</code></th>
<td><p>An index number specifying the segment in the pie chart view.</p></td>
</tr>
</table>
</div>
<div class="method-subsection return">
<h4 class="method-subtitle parameter-title">Return Value</h4>
<p>The title of the segment at the specified index in the pie chat view&rsquo;s
legend.</p>
</div>
<div class="method-subsection discussion-section">
<h4 class="method-subtitle">Discussion</h4>
<p>If this method is not implemented, the pie chart view does not display the legend.</p>
</div>
<div class="method-subsection declared-in-section">
<h4 class="method-subtitle">Declared In</h4>
<p><code class="declared-in-ref">ORKPieChartView.h</code></p>
</div>
</div>
</div>
</div>
</div>
</div>
</main>
<footer>
<div class="footer-copyright">
<p class="copyright">Copyright &copy; 2018 ResearchKit. All rights reserved. Updated: 2018-07-23</p>
<p class="generator">Generated by <a href="http://appledoc.gentlebytes.com">appledoc 2.2.1 (build 1334)</a>.</p>
</div>
</footer>
</div>
</div>
</article>
<script src="../js/script.js"></script>
</body>
</html>