mirror of
https://github.com/taigrr/arduinolibs
synced 2025-01-18 04:33:12 -08:00
550 lines
40 KiB
HTML
550 lines
40 KiB
HTML
<!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"/>
|
|
<title>ArduinoLibs: TimeField Class 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="search/search.css" rel="stylesheet" type="text/css"/>
|
|
<script type="text/javascript" src="search/search.js"></script>
|
|
<script type="text/javascript">
|
|
$(document).ready(function() { searchBox.OnSelectItem(0); });
|
|
</script>
|
|
<link href="doxygen.css" rel="stylesheet" type="text/css" />
|
|
</head>
|
|
<body>
|
|
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
|
|
<div id="titlearea">
|
|
<table cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr style="height: 56px;">
|
|
<td style="padding-left: 0.5em;">
|
|
<div id="projectname">ArduinoLibs
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<!-- end header part -->
|
|
<!-- Generated by Doxygen 1.8.6 -->
|
|
<script type="text/javascript">
|
|
var searchBox = new SearchBox("searchBox", "search",false,'Search');
|
|
</script>
|
|
<div id="navrow1" class="tabs">
|
|
<ul class="tablist">
|
|
<li><a href="index.html"><span>Main Page</span></a></li>
|
|
<li><a href="pages.html"><span>Related Pages</span></a></li>
|
|
<li><a href="modules.html"><span>Modules</span></a></li>
|
|
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
|
|
<li><a href="files.html"><span>Files</span></a></li>
|
|
<li>
|
|
<div id="MSearchBox" class="MSearchBoxInactive">
|
|
<span class="left">
|
|
<img id="MSearchSelect" src="search/mag_sel.png"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
alt=""/>
|
|
<input type="text" id="MSearchField" value="Search" accesskey="S"
|
|
onfocus="searchBox.OnSearchFieldFocus(true)"
|
|
onblur="searchBox.OnSearchFieldFocus(false)"
|
|
onkeyup="searchBox.OnSearchFieldChange(event)"/>
|
|
</span><span class="right">
|
|
<a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
|
|
</span>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div id="navrow2" class="tabs2">
|
|
<ul class="tablist">
|
|
<li><a href="annotated.html"><span>Class List</span></a></li>
|
|
<li><a href="classes.html"><span>Class Index</span></a></li>
|
|
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
|
|
<li><a href="functions.html"><span>Class Members</span></a></li>
|
|
</ul>
|
|
</div>
|
|
<!-- window showing the filter options -->
|
|
<div id="MSearchSelectWindow"
|
|
onmouseover="return searchBox.OnSearchSelectShow()"
|
|
onmouseout="return searchBox.OnSearchSelectHide()"
|
|
onkeydown="return searchBox.OnSearchSelectKey(event)">
|
|
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark"> </span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark"> </span>Classes</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark"> </span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark"> </span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark"> </span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark"> </span>Typedefs</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark"> </span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark"> </span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(8)"><span class="SelectionMark"> </span>Groups</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(9)"><span class="SelectionMark"> </span>Pages</a></div>
|
|
|
|
<!-- iframe showing the search results (closed by default) -->
|
|
<div id="MSearchResultsWindow">
|
|
<iframe src="javascript:void(0)" frameborder="0"
|
|
name="MSearchResults" id="MSearchResults">
|
|
</iframe>
|
|
</div>
|
|
|
|
</div><!-- top -->
|
|
<div class="header">
|
|
<div class="summary">
|
|
<a href="#pub-methods">Public Member Functions</a> |
|
|
<a href="classTimeField-members.html">List of all members</a> </div>
|
|
<div class="headertitle">
|
|
<div class="title">TimeField Class Reference</div> </div>
|
|
</div><!--header-->
|
|
<div class="contents">
|
|
|
|
<p><a class="el" href="classField.html" title="Manages a single data input/output field within a Form. ">Field</a> that manages the display and editing of a time value.
|
|
<a href="classTimeField.html#details">More...</a></p>
|
|
|
|
<p><code>#include <<a class="el" href="TimeField_8h_source.html">TimeField.h</a>></code></p>
|
|
<div class="dynheader">
|
|
Inheritance diagram for TimeField:</div>
|
|
<div class="dyncontent">
|
|
<div class="center">
|
|
<img src="classTimeField.png" usemap="#TimeField_map" alt=""/>
|
|
<map id="TimeField_map" name="TimeField_map">
|
|
<area href="classField.html" title="Manages a single data input/output field within a Form. " alt="Field" shape="rect" coords="0,0,66,24"/>
|
|
</map>
|
|
</div></div>
|
|
<table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
|
|
Public Member Functions</h2></td></tr>
|
|
<tr class="memitem:a138e2425379705828a87eb2d8a836431"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#a138e2425379705828a87eb2d8a836431">TimeField</a> (const String &<a class="el" href="classField.html#aaa861ef917130c989a955bc75c683afe">label</a>)</td></tr>
|
|
<tr class="memdesc:a138e2425379705828a87eb2d8a836431"><td class="mdescLeft"> </td><td class="mdescRight">Constructs a new time field with a specific <em>label</em>. <a href="#a138e2425379705828a87eb2d8a836431">More...</a><br/></td></tr>
|
|
<tr class="separator:a138e2425379705828a87eb2d8a836431"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a87f222bc098367963ed21a7edc4624de"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#a87f222bc098367963ed21a7edc4624de">TimeField</a> (<a class="el" href="classForm.html">Form</a> &<a class="el" href="classField.html#a27427319be1cc92db3128637d8884ee5">form</a>, const String &<a class="el" href="classField.html#aaa861ef917130c989a955bc75c683afe">label</a>, int <a class="el" href="classTimeField.html#aa73f5a62c330ac7d2f647dfe27d026b7">maxHours</a>, bool <a class="el" href="classTimeField.html#aa0795c873ba9941c8a1a3bf8c06668f1">readOnly</a>)</td></tr>
|
|
<tr class="memdesc:a87f222bc098367963ed21a7edc4624de"><td class="mdescLeft"> </td><td class="mdescRight">Constructs a new boolean field with a specific <em>label</em> and attaches it to a <em>form</em>. <a href="#a87f222bc098367963ed21a7edc4624de">More...</a><br/></td></tr>
|
|
<tr class="separator:a87f222bc098367963ed21a7edc4624de"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a9b953d9abdbe960a3fa34938462832e5"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#a9b953d9abdbe960a3fa34938462832e5">dispatch</a> (int event)</td></tr>
|
|
<tr class="memdesc:a9b953d9abdbe960a3fa34938462832e5"><td class="mdescLeft"> </td><td class="mdescRight">Dispatches <em>event</em> via this field. <a href="#a9b953d9abdbe960a3fa34938462832e5">More...</a><br/></td></tr>
|
|
<tr class="separator:a9b953d9abdbe960a3fa34938462832e5"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ae914d6b870283a334d2d669460f7646b"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#ae914d6b870283a334d2d669460f7646b">enterField</a> (bool reverse)</td></tr>
|
|
<tr class="memdesc:ae914d6b870283a334d2d669460f7646b"><td class="mdescLeft"> </td><td class="mdescRight">Enters the field due to form navigation. <a href="#ae914d6b870283a334d2d669460f7646b">More...</a><br/></td></tr>
|
|
<tr class="separator:ae914d6b870283a334d2d669460f7646b"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a5a6b7db2e3fda7745e0ff9c3d8d9a541"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#a5a6b7db2e3fda7745e0ff9c3d8d9a541">exitField</a> ()</td></tr>
|
|
<tr class="memdesc:a5a6b7db2e3fda7745e0ff9c3d8d9a541"><td class="mdescLeft"> </td><td class="mdescRight">Exits the field due to form navigation. <a href="#a5a6b7db2e3fda7745e0ff9c3d8d9a541">More...</a><br/></td></tr>
|
|
<tr class="separator:a5a6b7db2e3fda7745e0ff9c3d8d9a541"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a400aaa72a83b3b872e1de1c3af1a240f"><td class="memItemLeft" align="right" valign="top">unsigned long </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#a400aaa72a83b3b872e1de1c3af1a240f">value</a> () const </td></tr>
|
|
<tr class="memdesc:a400aaa72a83b3b872e1de1c3af1a240f"><td class="mdescLeft"> </td><td class="mdescRight">Returns the current value of this time field, in seconds. <a href="#a400aaa72a83b3b872e1de1c3af1a240f">More...</a><br/></td></tr>
|
|
<tr class="separator:a400aaa72a83b3b872e1de1c3af1a240f"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a063b6df2bd6fa7970ee445ab4e5d1fc1"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#a063b6df2bd6fa7970ee445ab4e5d1fc1">setValue</a> (unsigned long <a class="el" href="classTimeField.html#a400aaa72a83b3b872e1de1c3af1a240f">value</a>)</td></tr>
|
|
<tr class="memdesc:a063b6df2bd6fa7970ee445ab4e5d1fc1"><td class="mdescLeft"> </td><td class="mdescRight">Sets the <em>value</em> of this time field, in seconds. <a href="#a063b6df2bd6fa7970ee445ab4e5d1fc1">More...</a><br/></td></tr>
|
|
<tr class="separator:a063b6df2bd6fa7970ee445ab4e5d1fc1"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:aa73f5a62c330ac7d2f647dfe27d026b7"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#aa73f5a62c330ac7d2f647dfe27d026b7">maxHours</a> () const </td></tr>
|
|
<tr class="memdesc:aa73f5a62c330ac7d2f647dfe27d026b7"><td class="mdescLeft"> </td><td class="mdescRight">Returns the maximum number of hours before the field wraps around. <a href="#aa73f5a62c330ac7d2f647dfe27d026b7">More...</a><br/></td></tr>
|
|
<tr class="separator:aa73f5a62c330ac7d2f647dfe27d026b7"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a7ac124eb9dde01c18c711c421736b5ed"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#a7ac124eb9dde01c18c711c421736b5ed">setMaxHours</a> (int <a class="el" href="classTimeField.html#aa73f5a62c330ac7d2f647dfe27d026b7">maxHours</a>)</td></tr>
|
|
<tr class="memdesc:a7ac124eb9dde01c18c711c421736b5ed"><td class="mdescLeft"> </td><td class="mdescRight">Sets the maximum number of hours before the field wraps around to <em>maxHours</em>. <a href="#a7ac124eb9dde01c18c711c421736b5ed">More...</a><br/></td></tr>
|
|
<tr class="separator:a7ac124eb9dde01c18c711c421736b5ed"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:aa0795c873ba9941c8a1a3bf8c06668f1"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#aa0795c873ba9941c8a1a3bf8c06668f1">readOnly</a> () const </td></tr>
|
|
<tr class="memdesc:aa0795c873ba9941c8a1a3bf8c06668f1"><td class="mdescLeft"> </td><td class="mdescRight">Returns TIMEFIELD_READ_ONLY (true) or TIMEFIELD_READ_WRITE (false). <a href="#aa0795c873ba9941c8a1a3bf8c06668f1">More...</a><br/></td></tr>
|
|
<tr class="separator:aa0795c873ba9941c8a1a3bf8c06668f1"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a3f002a0729e90e88d04025908be102fe"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classTimeField.html#a3f002a0729e90e88d04025908be102fe">setReadOnly</a> (bool <a class="el" href="classTimeField.html#a400aaa72a83b3b872e1de1c3af1a240f">value</a>)</td></tr>
|
|
<tr class="memdesc:a3f002a0729e90e88d04025908be102fe"><td class="mdescLeft"> </td><td class="mdescRight">Sets the read-only state of this field to <em>value</em>. <a href="#a3f002a0729e90e88d04025908be102fe">More...</a><br/></td></tr>
|
|
<tr class="separator:a3f002a0729e90e88d04025908be102fe"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="inherit_header pub_methods_classField"><td colspan="2" onclick="javascript:toggleInherit('pub_methods_classField')"><img src="closed.png" alt="-"/> Public Member Functions inherited from <a class="el" href="classField.html">Field</a></td></tr>
|
|
<tr class="memitem:ac4ea0d104376233c3f0bfc080ec8564e inherit pub_methods_classField"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classField.html#ac4ea0d104376233c3f0bfc080ec8564e">Field</a> (const String &<a class="el" href="classField.html#aaa861ef917130c989a955bc75c683afe">label</a>)</td></tr>
|
|
<tr class="memdesc:ac4ea0d104376233c3f0bfc080ec8564e inherit pub_methods_classField"><td class="mdescLeft"> </td><td class="mdescRight">Constructs a new field with a specific <em>label</em>. <a href="#ac4ea0d104376233c3f0bfc080ec8564e">More...</a><br/></td></tr>
|
|
<tr class="separator:ac4ea0d104376233c3f0bfc080ec8564e inherit pub_methods_classField"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a7e2bdb203ddfd9219696f263c1731fe7 inherit pub_methods_classField"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7e2bdb203ddfd9219696f263c1731fe7"></a>
|
|
 </td><td class="memItemRight" valign="bottom"><a class="el" href="classField.html#a7e2bdb203ddfd9219696f263c1731fe7">Field</a> (<a class="el" href="classForm.html">Form</a> &<a class="el" href="classField.html#a27427319be1cc92db3128637d8884ee5">form</a>, const String &<a class="el" href="classField.html#aaa861ef917130c989a955bc75c683afe">label</a>)</td></tr>
|
|
<tr class="memdesc:a7e2bdb203ddfd9219696f263c1731fe7 inherit pub_methods_classField"><td class="mdescLeft"> </td><td class="mdescRight">Constructs a new field with a specific <em>label</em> and attaches it to a <em>form</em>. <br/></td></tr>
|
|
<tr class="separator:a7e2bdb203ddfd9219696f263c1731fe7 inherit pub_methods_classField"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a45d6e6d09b8f8e46de62b40119d62c60 inherit pub_methods_classField"><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classField.html#a45d6e6d09b8f8e46de62b40119d62c60">~Field</a> ()</td></tr>
|
|
<tr class="memdesc:a45d6e6d09b8f8e46de62b40119d62c60 inherit pub_methods_classField"><td class="mdescLeft"> </td><td class="mdescRight">Destroys this field and removes it from its owning <a class="el" href="classForm.html" title="Manager for a form containing data input/output fields. ">Form</a>. <a href="#a45d6e6d09b8f8e46de62b40119d62c60">More...</a><br/></td></tr>
|
|
<tr class="separator:a45d6e6d09b8f8e46de62b40119d62c60 inherit pub_methods_classField"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a27427319be1cc92db3128637d8884ee5 inherit pub_methods_classField"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a27427319be1cc92db3128637d8884ee5"></a>
|
|
<a class="el" href="classForm.html">Form</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="classField.html#a27427319be1cc92db3128637d8884ee5">form</a> () const </td></tr>
|
|
<tr class="memdesc:a27427319be1cc92db3128637d8884ee5 inherit pub_methods_classField"><td class="mdescLeft"> </td><td class="mdescRight">Returns the <a class="el" href="classForm.html" title="Manager for a form containing data input/output fields. ">Form</a> that owns this field; null if not associated with a <a class="el" href="classForm.html" title="Manager for a form containing data input/output fields. ">Form</a>. <br/></td></tr>
|
|
<tr class="separator:a27427319be1cc92db3128637d8884ee5 inherit pub_methods_classField"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:aaa861ef917130c989a955bc75c683afe inherit pub_methods_classField"><td class="memItemLeft" align="right" valign="top">const String & </td><td class="memItemRight" valign="bottom"><a class="el" href="classField.html#aaa861ef917130c989a955bc75c683afe">label</a> () const </td></tr>
|
|
<tr class="memdesc:aaa861ef917130c989a955bc75c683afe inherit pub_methods_classField"><td class="mdescLeft"> </td><td class="mdescRight">Returns the label to display in the first line of this field. <a href="#aaa861ef917130c989a955bc75c683afe">More...</a><br/></td></tr>
|
|
<tr class="separator:aaa861ef917130c989a955bc75c683afe inherit pub_methods_classField"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:ad4ea63599d780c35b296cf2840b69f7b inherit pub_methods_classField"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classField.html#ad4ea63599d780c35b296cf2840b69f7b">setLabel</a> (const String &<a class="el" href="classField.html#aaa861ef917130c989a955bc75c683afe">label</a>)</td></tr>
|
|
<tr class="memdesc:ad4ea63599d780c35b296cf2840b69f7b inherit pub_methods_classField"><td class="mdescLeft"> </td><td class="mdescRight">Sets the <em>label</em> to display in the first line of this field. <a href="#ad4ea63599d780c35b296cf2840b69f7b">More...</a><br/></td></tr>
|
|
<tr class="separator:ad4ea63599d780c35b296cf2840b69f7b inherit pub_methods_classField"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:a25d86a67b321e8c642edf75a10a35f72 inherit pub_methods_classField"><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classField.html#a25d86a67b321e8c642edf75a10a35f72">isCurrent</a> () const </td></tr>
|
|
<tr class="memdesc:a25d86a67b321e8c642edf75a10a35f72 inherit pub_methods_classField"><td class="mdescLeft"> </td><td class="mdescRight">Returns true if this field is the currently-displayed field in its owning form; false otherwise. <a href="#a25d86a67b321e8c642edf75a10a35f72">More...</a><br/></td></tr>
|
|
<tr class="separator:a25d86a67b321e8c642edf75a10a35f72 inherit pub_methods_classField"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table><table class="memberdecls">
|
|
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="inherited"></a>
|
|
Additional Inherited Members</h2></td></tr>
|
|
<tr class="inherit_header pro_methods_classField"><td colspan="2" onclick="javascript:toggleInherit('pro_methods_classField')"><img src="closed.png" alt="-"/> Protected Member Functions inherited from <a class="el" href="classField.html">Field</a></td></tr>
|
|
<tr class="memitem:a5cf21bf958a71e51feac9e1bf9f599d1 inherit pro_methods_classField"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a5cf21bf958a71e51feac9e1bf9f599d1"></a>
|
|
LiquidCrystal * </td><td class="memItemRight" valign="bottom"><a class="el" href="classField.html#a5cf21bf958a71e51feac9e1bf9f599d1">lcd</a> () const </td></tr>
|
|
<tr class="memdesc:a5cf21bf958a71e51feac9e1bf9f599d1 inherit pro_methods_classField"><td class="mdescLeft"> </td><td class="mdescRight">Returns the <a class="el" href="classLCD.html" title="Enhanced library for Freetronics 16x2 LCD shields. ">LCD</a> that this field is being drawn on. <br/></td></tr>
|
|
<tr class="separator:a5cf21bf958a71e51feac9e1bf9f599d1 inherit pro_methods_classField"><td class="memSeparator" colspan="2"> </td></tr>
|
|
<tr class="memitem:afc612378167be0e7f8a6f8395b3537bd inherit pro_methods_classField"><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classField.html#afc612378167be0e7f8a6f8395b3537bd">updateCursor</a> ()</td></tr>
|
|
<tr class="memdesc:afc612378167be0e7f8a6f8395b3537bd inherit pro_methods_classField"><td class="mdescLeft"> </td><td class="mdescRight">Updates the cursor position after the label has been drawn by <a class="el" href="classField.html#ad4ea63599d780c35b296cf2840b69f7b" title="Sets the label to display in the first line of this field. ">setLabel()</a>. <a href="#afc612378167be0e7f8a6f8395b3537bd">More...</a><br/></td></tr>
|
|
<tr class="separator:afc612378167be0e7f8a6f8395b3537bd inherit pro_methods_classField"><td class="memSeparator" colspan="2"> </td></tr>
|
|
</table>
|
|
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
|
|
<div class="textblock"><p><a class="el" href="classField.html" title="Manages a single data input/output field within a Form. ">Field</a> that manages the display and editing of a time value. </p>
|
|
<p><a class="el" href="classTimeField.html" title="Field that manages the display and editing of a time value. ">TimeField</a> is suitable for displaying wall clock time in 24-hour format, or for displaying timeouts and durations in seconds. Times are specified in seconds as an <code>unsigned long</code> value. They are displayed as <code>HH:MM:SS</code>, for hours, minutes, and seconds.</p>
|
|
<p>The time field can be either read-only or read-write. When read-write, the Up, Down, Left, and Right buttons can be used to modify the hour, minute, and second components of the time value.</p>
|
|
<p>The following example displays the number of hours, minutes, and seconds since the device was reset, wrapping around after 24 hours:</p>
|
|
<div class="fragment"><div class="line"><a class="code" href="classForm.html">Form</a> mainForm(lcd);</div>
|
|
<div class="line"><a class="code" href="classTimeField.html">TimeField</a> timeField(mainForm, <span class="stringliteral">"Time since reset"</span>, 24, TIMEFIELD_READ_ONLY);</div>
|
|
<div class="line"></div>
|
|
<div class="line"><span class="keywordtype">void</span> loop() {</div>
|
|
<div class="line"> timeField.setValue(millis() / 1000);</div>
|
|
<div class="line"> mainForm.dispatch(lcd.<a class="code" href="classLCD.html#ac1e80e2603bd1cf0276c36092c416292">getButton</a>());</div>
|
|
<div class="line">}</div>
|
|
</div><!-- fragment --><div class="image">
|
|
<img src="FormTimeRO.png" alt="FormTimeRO.png"/>
|
|
</div>
|
|
<p>A read-write field can be used to ask the user for the duration of an application count-down timer:</p>
|
|
<div class="fragment"><div class="line"><a class="code" href="classTimeField.html">TimeField</a> durationField(mainForm, <span class="stringliteral">"Timer duration"</span>, 24, TIMEFIELD_READ_WRITE);</div>
|
|
</div><!-- fragment --><div class="image">
|
|
<img src="FormTimeRW.png" alt="FormTimeRW.png"/>
|
|
</div>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classField.html" title="Manages a single data input/output field within a Form. ">Field</a> </dd></dl>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8h_source.html#l00031">31</a> of file <a class="el" href="TimeField_8h_source.html">TimeField.h</a>.</p>
|
|
</div><h2 class="groupheader">Constructor & Destructor Documentation</h2>
|
|
<a class="anchor" id="a138e2425379705828a87eb2d8a836431"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">TimeField::TimeField </td>
|
|
<td>(</td>
|
|
<td class="paramtype">const String & </td>
|
|
<td class="paramname"><em>label</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">explicit</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Constructs a new time field with a specific <em>label</em>. </p>
|
|
<p>The field is initially not associated with a <a class="el" href="classForm.html" title="Manager for a form containing data input/output fields. ">Form</a>. The field can be added to a form later using <a class="el" href="classForm.html#a5cb056ace428e75e321610555bfecac7" title="Adds field to this form. ">Form::addField()</a>.</p>
|
|
<p>Initially <a class="el" href="classTimeField.html#a400aaa72a83b3b872e1de1c3af1a240f" title="Returns the current value of this time field, in seconds. ">value()</a> is 0, <a class="el" href="classTimeField.html#aa73f5a62c330ac7d2f647dfe27d026b7" title="Returns the maximum number of hours before the field wraps around. ">maxHours()</a> is 24, and isReadOnly() is TIMEFIELD_READ_WRITE.</p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classForm.html#a5cb056ace428e75e321610555bfecac7" title="Adds field to this form. ">Form::addField()</a> </dd></dl>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8cpp_source.html#l00082">82</a> of file <a class="el" href="TimeField_8cpp_source.html">TimeField.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a87f222bc098367963ed21a7edc4624de"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">TimeField::TimeField </td>
|
|
<td>(</td>
|
|
<td class="paramtype"><a class="el" href="classForm.html">Form</a> & </td>
|
|
<td class="paramname"><em>form</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">const String & </td>
|
|
<td class="paramname"><em>label</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">int </td>
|
|
<td class="paramname"><em>maxHours</em>, </td>
|
|
</tr>
|
|
<tr>
|
|
<td class="paramkey"></td>
|
|
<td></td>
|
|
<td class="paramtype">bool </td>
|
|
<td class="paramname"><em>readOnly</em> </td>
|
|
</tr>
|
|
<tr>
|
|
<td></td>
|
|
<td>)</td>
|
|
<td></td><td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Constructs a new boolean field with a specific <em>label</em> and attaches it to a <em>form</em>. </p>
|
|
<p>The initial <a class="el" href="classTimeField.html#a400aaa72a83b3b872e1de1c3af1a240f" title="Returns the current value of this time field, in seconds. ">value()</a> of the field will be 0. The <a class="el" href="classTimeField.html#a400aaa72a83b3b872e1de1c3af1a240f" title="Returns the current value of this time field, in seconds. ">value()</a> will be limited to be less than <em>maxHours</em> * 60 * 60 seconds.</p>
|
|
<p>If <em>readOnly</em> is TIMEFIELD_READ_ONLY, then the field will display times but not allow them to be modified by the user. If <em>readOnly</em> is TIMEFIELD_READ_WRITE, then the field will modifiable by the user.</p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classTimeField.html#a400aaa72a83b3b872e1de1c3af1a240f" title="Returns the current value of this time field, in seconds. ">value()</a> </dd></dl>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8cpp_source.html#l00105">105</a> of file <a class="el" href="TimeField_8cpp_source.html">TimeField.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<h2 class="groupheader">Member Function Documentation</h2>
|
|
<a class="anchor" id="a9b953d9abdbe960a3fa34938462832e5"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">int TimeField::dispatch </td>
|
|
<td>(</td>
|
|
<td class="paramtype">int </td>
|
|
<td class="paramname"><em>event</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Dispatches <em>event</em> via this field. </p>
|
|
<p>The <em>event</em> is usually obtained from <a class="el" href="classLCD.html#ac1e80e2603bd1cf0276c36092c416292" title="Gets the next button press, release, or idle event. ">LCD::getButton()</a>.</p>
|
|
<p>Returns zero if the <em>event</em> has been handled and no further action is required.</p>
|
|
<p>Returns FORM_CHANGED if the <em>event</em> has changed the value of this field in a manner that may require the application to take further action based on the new field value.</p>
|
|
<p>Returns -1 if the <em>event</em> is not handled by this field, and should be handled by the <a class="el" href="classForm.html" title="Manager for a form containing data input/output fields. ">Form</a> itself (particularly for Left and Right buttons). The default implementation returns -1 for all events.</p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classForm.html#a89bd3850e87caa2ca7b2e946f923d0ee" title="Dispatches event to the currently active field using Field::dispatch(). ">Form::dispatch()</a>, <a class="el" href="classLCD.html#ac1e80e2603bd1cf0276c36092c416292" title="Gets the next button press, release, or idle event. ">LCD::getButton()</a> </dd></dl>
|
|
|
|
<p>Reimplemented from <a class="el" href="classField.html#a061bd1ed4d8b079df86465df8facd3b3">Field</a>.</p>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8cpp_source.html#l00115">115</a> of file <a class="el" href="TimeField_8cpp_source.html">TimeField.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="ae914d6b870283a334d2d669460f7646b"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void TimeField::enterField </td>
|
|
<td>(</td>
|
|
<td class="paramtype">bool </td>
|
|
<td class="paramname"><em>reverse</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Enters the field due to form navigation. </p>
|
|
<p>This function is typically called when the user presses Left and Right buttons to navigate to the field. If <em>reverse</em> is true, then navigation was due to the Left button being pressed.</p>
|
|
<p>This function can assume that the display has been cleared and the cursor is positioned at (0, 0).</p>
|
|
<p>The default implementation prints the <a class="el" href="classField.html#aaa861ef917130c989a955bc75c683afe" title="Returns the label to display in the first line of this field. ">label()</a>.</p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classTimeField.html#a5a6b7db2e3fda7745e0ff9c3d8d9a541" title="Exits the field due to form navigation. ">exitField()</a> </dd></dl>
|
|
|
|
<p>Reimplemented from <a class="el" href="classField.html#aa032bbeacb405c56546cb56fbbee94f5">Field</a>.</p>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8cpp_source.html#l00193">193</a> of file <a class="el" href="TimeField_8cpp_source.html">TimeField.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a5a6b7db2e3fda7745e0ff9c3d8d9a541"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void TimeField::exitField </td>
|
|
<td>(</td>
|
|
<td class="paramname"></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">virtual</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Exits the field due to form navigation. </p>
|
|
<p>This function is typically called when the user presses Left and Right buttons to navigate from the field.</p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classTimeField.html#ae914d6b870283a334d2d669460f7646b" title="Enters the field due to form navigation. ">enterField()</a> </dd></dl>
|
|
|
|
<p>Reimplemented from <a class="el" href="classField.html#ad6805c75ee1e62f8cd8bd550c4530c07">Field</a>.</p>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8cpp_source.html#l00205">205</a> of file <a class="el" href="TimeField_8cpp_source.html">TimeField.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="aa73f5a62c330ac7d2f647dfe27d026b7"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">int TimeField::maxHours </td>
|
|
<td>(</td>
|
|
<td class="paramname"></td><td>)</td>
|
|
<td> const</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Returns the maximum number of hours before the field wraps around. </p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classTimeField.html#a7ac124eb9dde01c18c711c421736b5ed" title="Sets the maximum number of hours before the field wraps around to maxHours. ">setMaxHours()</a>, <a class="el" href="classTimeField.html#a063b6df2bd6fa7970ee445ab4e5d1fc1" title="Sets the value of this time field, in seconds. ">setValue()</a> </dd></dl>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8h_source.html#l00044">44</a> of file <a class="el" href="TimeField_8h_source.html">TimeField.h</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="aa0795c873ba9941c8a1a3bf8c06668f1"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">bool TimeField::readOnly </td>
|
|
<td>(</td>
|
|
<td class="paramname"></td><td>)</td>
|
|
<td> const</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Returns TIMEFIELD_READ_ONLY (true) or TIMEFIELD_READ_WRITE (false). </p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classTimeField.html#a3f002a0729e90e88d04025908be102fe" title="Sets the read-only state of this field to value. ">setReadOnly()</a> </dd></dl>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8h_source.html#l00047">47</a> of file <a class="el" href="TimeField_8h_source.html">TimeField.h</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a7ac124eb9dde01c18c711c421736b5ed"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void TimeField::setMaxHours </td>
|
|
<td>(</td>
|
|
<td class="paramtype">int </td>
|
|
<td class="paramname"><em>maxHours</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Sets the maximum number of hours before the field wraps around to <em>maxHours</em>. </p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classTimeField.html#aa73f5a62c330ac7d2f647dfe27d026b7" title="Returns the maximum number of hours before the field wraps around. ">maxHours()</a>, <a class="el" href="classTimeField.html#a063b6df2bd6fa7970ee445ab4e5d1fc1" title="Sets the value of this time field, in seconds. ">setValue()</a> </dd></dl>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8h_source.html#l00045">45</a> of file <a class="el" href="TimeField_8h_source.html">TimeField.h</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a3f002a0729e90e88d04025908be102fe"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void TimeField::setReadOnly </td>
|
|
<td>(</td>
|
|
<td class="paramtype">bool </td>
|
|
<td class="paramname"><em>value</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Sets the read-only state of this field to <em>value</em>. </p>
|
|
<p>The <em>value</em> should be one of TIMEFIELD_READ_ONLY (true) or TIMEFIELD_READ_WRITE (false). Use of the named constants is recommended.</p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classTimeField.html#aa0795c873ba9941c8a1a3bf8c06668f1" title="Returns TIMEFIELD_READ_ONLY (true) or TIMEFIELD_READ_WRITE (false). ">readOnly()</a> </dd></dl>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8cpp_source.html#l00268">268</a> of file <a class="el" href="TimeField_8cpp_source.html">TimeField.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a063b6df2bd6fa7970ee445ab4e5d1fc1"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">void TimeField::setValue </td>
|
|
<td>(</td>
|
|
<td class="paramtype">unsigned long </td>
|
|
<td class="paramname"><em>value</em></td><td>)</td>
|
|
<td></td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Sets the <em>value</em> of this time field, in seconds. </p>
|
|
<p>If <em>value</em> is greater than or equal to <a class="el" href="classTimeField.html#aa73f5a62c330ac7d2f647dfe27d026b7" title="Returns the maximum number of hours before the field wraps around. ">maxHours()</a> * 60 * 60, then it will be wrapped around to fall within the valid range.</p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classTimeField.html#a400aaa72a83b3b872e1de1c3af1a240f" title="Returns the current value of this time field, in seconds. ">value()</a>, <a class="el" href="classTimeField.html#aa73f5a62c330ac7d2f647dfe27d026b7" title="Returns the maximum number of hours before the field wraps around. ">maxHours()</a> </dd></dl>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8cpp_source.html#l00227">227</a> of file <a class="el" href="TimeField_8cpp_source.html">TimeField.cpp</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<a class="anchor" id="a400aaa72a83b3b872e1de1c3af1a240f"></a>
|
|
<div class="memitem">
|
|
<div class="memproto">
|
|
<table class="mlabels">
|
|
<tr>
|
|
<td class="mlabels-left">
|
|
<table class="memname">
|
|
<tr>
|
|
<td class="memname">unsigned long TimeField::value </td>
|
|
<td>(</td>
|
|
<td class="paramname"></td><td>)</td>
|
|
<td> const</td>
|
|
</tr>
|
|
</table>
|
|
</td>
|
|
<td class="mlabels-right">
|
|
<span class="mlabels"><span class="mlabel">inline</span></span> </td>
|
|
</tr>
|
|
</table>
|
|
</div><div class="memdoc">
|
|
|
|
<p>Returns the current value of this time field, in seconds. </p>
|
|
<dl class="section see"><dt>See Also</dt><dd><a class="el" href="classTimeField.html#a063b6df2bd6fa7970ee445ab4e5d1fc1" title="Sets the value of this time field, in seconds. ">setValue()</a> </dd></dl>
|
|
|
|
<p>Definition at line <a class="el" href="TimeField_8h_source.html#l00041">41</a> of file <a class="el" href="TimeField_8h_source.html">TimeField.h</a>.</p>
|
|
|
|
</div>
|
|
</div>
|
|
<hr/>The documentation for this class was generated from the following files:<ul>
|
|
<li><a class="el" href="TimeField_8h_source.html">TimeField.h</a></li>
|
|
<li><a class="el" href="TimeField_8cpp_source.html">TimeField.cpp</a></li>
|
|
</ul>
|
|
</div><!-- contents -->
|
|
<!-- start footer part -->
|
|
<hr class="footer"/><address class="footer"><small>
|
|
Generated on Sat Mar 14 2015 09:07:26 for ArduinoLibs by  <a href="http://www.doxygen.org/index.html">
|
|
<img class="footer" src="doxygen.png" alt="doxygen"/>
|
|
</a> 1.8.6
|
|
</small></address>
|
|
</body>
|
|
</html>
|