File: q3datetimeedit.html

package info (click to toggle)
qt4-x11 4%3A4.8.2%2Bdfsg-11
  • links: PTS, VCS
  • area: main
  • in suites: wheezy
  • size: 701,696 kB
  • sloc: cpp: 2,686,179; ansic: 375,485; python: 25,859; sh: 19,349; xml: 17,091; perl: 14,765; yacc: 5,383; asm: 5,038; makefile: 1,259; lex: 555; ruby: 526; objc: 347; cs: 112; pascal: 112; php: 54; sed: 34
file content (220 lines) | stat: -rw-r--r-- 17,137 bytes parent folder | download 
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
 
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- q3datetimeedit.cpp -->
  <title>Qt 4.8: Q3DateTimeEdit Class Reference</title>
  <link rel="stylesheet" type="text/css" href="style/offline.css" />
</head>
<body>
<div class="header" id="qtdocheader">
  <div class="content"> 
    <a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
  </div>
  <div class="breadcrumb toolblock">
    <ul>
      <li class="first"><a href="index.html">Home</a></li>
      <!--  Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li>Qt3SupportLight</li>
<li>Q3DateTimeEdit</li>
    </ul>
  </div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#public-slots">Public Slots</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#protected-functions">Protected Functions</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">Q3DateTimeEdit Class Reference</h1>
<!-- $$$Q3DateTimeEdit-brief -->
<p>The Q3DateTimeEdit class combines a <a href="q3dateedit.html">Q3DateEdit</a> and <a href="q3timeedit.html">Q3TimeEdit</a> widget into a single widget for editing datetimes. <a href="#details">More...</a></p>
<!-- @@@Q3DateTimeEdit -->
<pre class="cpp"> <span class="preprocessor">#include &lt;Q3DateTimeEdit&gt;</span></pre><p><b>This class is part of the Qt 3 support library.</b> It is provided to keep old source code working. We strongly advise against using it in new code. See <a href="porting4.html#qdatetimeedit">Porting to Qt 4</a> for more information.</p>
<p><b>Inherits: </b><a href="qwidget.html">QWidget</a>.</p>
<ul>
<li><a href="q3datetimeedit-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li class="fn"><b><a href="q3datetimeedit.html#dateTime-prop">dateTime</a></b> : QDateTime</li>
</ul>
<ul>
<li class="fn">58 properties inherited from <a href="qwidget.html#properties">QWidget</a></li>
<li class="fn">1 property inherited from <a href="qobject.html#properties">QObject</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#Q3DateTimeEdit">Q3DateTimeEdit</a></b> ( QWidget * <i>parent</i> = 0, const char * <i>name</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#Q3DateTimeEdit-2">Q3DateTimeEdit</a></b> ( const QDateTime &amp; <i>datetime</i>, QWidget * <i>parent</i> = 0, const char * <i>name</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#dtor.Q3DateTimeEdit">~Q3DateTimeEdit</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#autoAdvance">autoAdvance</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Q3DateEdit * </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#dateEdit">dateEdit</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDateTime </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#dateTime-prop">dateTime</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#setAutoAdvance">setAutoAdvance</a></b> ( bool <i>advance</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> Q3TimeEdit * </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#timeEdit">timeEdit</a></b> ()</td></tr>
</table>
<a name="reimplemented-public-functions"></a>
<h2>Reimplemented Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual QSize </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#minimumSizeHint">minimumSizeHint</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QSize </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#sizeHint">sizeHint</a></b> () const</td></tr>
</table>
<ul>
<li class="fn">221 public functions inherited from <a href="qwidget.html#public-functions">QWidget</a></li>
<li class="fn">29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
<li class="fn">13 public functions inherited from <a href="qpaintdevice.html#public-functions">QPaintDevice</a></li>
</ul>
<a name="public-slots"></a>
<h2>Public Slots</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#dateTime-prop">setDateTime</a></b> ( const QDateTime &amp; <i>dt</i> )</td></tr>
</table>
<ul>
<li class="fn">19 public slots inherited from <a href="qwidget.html#public-slots">QWidget</a></li>
<li class="fn">1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
</ul>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#valueChanged">valueChanged</a></b> ( const QDateTime &amp; <i>datetime</i> )</td></tr>
</table>
<ul>
<li class="fn">1 signal inherited from <a href="qwidget.html#signals">QWidget</a></li>
<li class="fn">1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
</ul>
<a name="reimplemented-protected-functions"></a>
<h2>Reimplemented Protected Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="q3datetimeedit.html#resizeEvent">resizeEvent</a></b> ( QResizeEvent * <i>event</i> )</td></tr>
</table>
<ul>
<li class="fn">37 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
<li class="fn">8 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li class="fn">1 protected function inherited from <a href="qpaintdevice.html#protected-functions">QPaintDevice</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">4 static public members inherited from <a href="qwidget.html#static-public-members">QWidget</a></li>
<li class="fn">7 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
<li class="fn">37 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
<li class="fn">8 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li class="fn">1 protected function inherited from <a href="qpaintdevice.html#protected-functions">QPaintDevice</a></li>
<li class="fn">1 protected slot inherited from <a href="qwidget.html#protected-slots">QWidget</a></li>
</ul>
<a name="details"></a>
<!-- $$$Q3DateTimeEdit-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The Q3DateTimeEdit class combines a <a href="q3dateedit.html">Q3DateEdit</a> and <a href="q3timeedit.html">Q3TimeEdit</a> widget into a single widget for editing datetimes.</p>
<p>Q3DateTimeEdit consists of a <a href="q3dateedit.html">Q3DateEdit</a> and <a href="q3timeedit.html">Q3TimeEdit</a> widget placed side by side and offers the functionality of both. The user can edit the date and time by using the keyboard or the arrow keys to increase/decrease date or time values. The Tab key can be used to move from section to section within the Q3DateTimeEdit widget, and the user can be moved automatically when they complete a section using <a href="q3datetimeedit.html#setAutoAdvance">setAutoAdvance</a>(). The datetime can be set with <a href="q3datetimeedit.html#dateTime-prop">setDateTime</a>().</p>
<p>The date format is read from the system's locale settings. It is set to year, month, day order if that is not possible. See <a href="q3dateedit.html#order-prop">Q3DateEdit::setOrder</a>() to change this. Times appear in the order hours, minutes, seconds using the 24 hour clock.</p>
<p>It is recommended that the Q3DateTimeEdit is initialised with a datetime, e.g&#x2e;</p>
<pre class="cpp"> <span class="type">Q3DateTimeEdit</span> <span class="operator">*</span>dateTimeEdit <span class="operator">=</span> <span class="keyword">new</span> <span class="type">Q3DateTimeEdit</span>(<span class="type"><a href="qdatetime.html">QDateTime</a></span><span class="operator">::</span>currentDateTime()<span class="operator">,</span> <span class="keyword">this</span>);
 dateTimeEdit<span class="operator">-</span><span class="operator">&gt;</span>dateEdit()<span class="operator">-</span><span class="operator">&gt;</span>setRange(<span class="type"><a href="qdatetime.html">QDateTime</a></span><span class="operator">::</span>currentDate()<span class="operator">,</span>
                                     <span class="type"><a href="qdatetime.html">QDateTime</a></span><span class="operator">::</span>currentDate()<span class="operator">.</span>addDays(<span class="number">7</span>));</pre>
<p>Here we've created a new Q3DateTimeEdit set to the current date and time, and set the date to have a minimum date of now and a maximum date of a week from now.</p>
<p>Terminology: A <a href="q3dateedit.html">Q3DateEdit</a> widget consists of three 'sections', one each for the year, month and day. Similarly a <a href="q3timeedit.html">Q3TimeEdit</a> consists of three sections, one each for the hour, minute and second. The character that separates each date section is specified with setDateSeparator(); similarly setTimeSeparator() is used for the time sections.</p>
<p class="centerAlign"><img src="images/datetimewidgets.png" alt="Date Time Widgets" /></p></div>
<p><b>See also </b><a href="q3dateedit.html">Q3DateEdit</a> and <a href="q3timeedit.html">Q3TimeEdit</a>.</p>
<!-- @@@Q3DateTimeEdit -->
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$dateTime-prop$$$dateTime$$$setDateTimeconstQDateTime& -->
<h3 class="fn"><a name="dateTime-prop"></a><span class="name">dateTime</span> : <span class="type"><a href="qdatetime.html">QDateTime</a></span></h3>
<p>This property holds the editor's datetime value.</p>
<p>The datetime edit's datetime which may be an invalid datetime.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QDateTime </td><td class="memItemRight bottomAlign"><span class="name"><b>dateTime</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> virtual void </td><td class="memItemRight bottomAlign"><span class="name"><b>setDateTime</b></span> ( const QDateTime &amp; <i>dt</i> )</td></tr>
</table>
<!-- @@@dateTime -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$Q3DateTimeEdit[overload1]$$$Q3DateTimeEditQWidget*constchar* -->
<h3 class="fn"><a name="Q3DateTimeEdit"></a>Q3DateTimeEdit::<span class="name">Q3DateTimeEdit</span> ( <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>parent</i> = 0, const <span class="type">char</span> * <i>name</i> = 0 )</h3>
<p>Constructs an empty datetime edit with parent <i>parent</i> and called <i>name</i>.</p>
<!-- @@@Q3DateTimeEdit -->
<!-- $$$Q3DateTimeEdit$$$Q3DateTimeEditconstQDateTime&QWidget*constchar* -->
<h3 class="fn"><a name="Q3DateTimeEdit-2"></a>Q3DateTimeEdit::<span class="name">Q3DateTimeEdit</span> ( const <span class="type"><a href="qdatetime.html">QDateTime</a></span> &amp; <i>datetime</i>, <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>parent</i> = 0, const <span class="type">char</span> * <i>name</i> = 0 )</h3>
<p>This is an overloaded function.</p>
<p>Constructs a datetime edit with the initial value <i>datetime</i>, parent <i>parent</i> and called <i>name</i>.</p>
<!-- @@@Q3DateTimeEdit -->
<!-- $$$~Q3DateTimeEdit[overload1]$$$~Q3DateTimeEdit -->
<h3 class="fn"><a name="dtor.Q3DateTimeEdit"></a>Q3DateTimeEdit::<span class="name">~Q3DateTimeEdit</span> ()</h3>
<p>Destroys the object and frees any allocated resources.</p>
<!-- @@@~Q3DateTimeEdit -->
<!-- $$$autoAdvance[overload1]$$$autoAdvance -->
<h3 class="fn"><a name="autoAdvance"></a><span class="type">bool</span> Q3DateTimeEdit::<span class="name">autoAdvance</span> () const</h3>
<p>Returns true if auto-advance is enabled, otherwise returns false.</p>
<p><b>See also </b><a href="q3datetimeedit.html#setAutoAdvance">setAutoAdvance</a>().</p>
<!-- @@@autoAdvance -->
<!-- $$$dateEdit[overload1]$$$dateEdit -->
<h3 class="fn"><a name="dateEdit"></a><span class="type"><a href="q3dateedit.html">Q3DateEdit</a></span> * Q3DateTimeEdit::<span class="name">dateEdit</span> ()</h3>
<p>Returns the internal widget used for editing the date part of the datetime.</p>
<!-- @@@dateEdit -->
<!-- $$$minimumSizeHint[overload1]$$$minimumSizeHint -->
<h3 class="fn"><a name="minimumSizeHint"></a><span class="type"><a href="qsize.html">QSize</a></span> Q3DateTimeEdit::<span class="name">minimumSizeHint</span> () const<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#minimumSizeHint-prop">QWidget::minimumSizeHint</a>().</p>
<!-- @@@minimumSizeHint -->
<!-- $$$resizeEvent[overload1]$$$resizeEventQResizeEvent* -->
<h3 class="fn"><a name="resizeEvent"></a><span class="type">void</span> Q3DateTimeEdit::<span class="name">resizeEvent</span> ( <span class="type"><a href="qresizeevent.html">QResizeEvent</a></span> * <i>event</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#resizeEvent">QWidget::resizeEvent</a>().</p>
<p>Intercepts and handles the resize <i>event</i>, which hase a special meaning for the <a href="q3datetimeedit.html" class="compat">Q3DateTimeEdit</a>.</p>
<!-- @@@resizeEvent -->
<!-- $$$setAutoAdvance[overload1]$$$setAutoAdvancebool -->
<h3 class="fn"><a name="setAutoAdvance"></a><span class="type">void</span> Q3DateTimeEdit::<span class="name">setAutoAdvance</span> ( <span class="type">bool</span> <i>advance</i> )<tt> [virtual]</tt></h3>
<p>Sets the auto advance property of the editor to <i>advance</i>. If set to true, the editor will automatically advance focus to the next date or time section if the user has completed a section.</p>
<p><b>See also </b><a href="q3datetimeedit.html#autoAdvance">autoAdvance</a>().</p>
<!-- @@@setAutoAdvance -->
<!-- $$$sizeHint[overload1]$$$sizeHint -->
<h3 class="fn"><a name="sizeHint"></a><span class="type"><a href="qsize.html">QSize</a></span> Q3DateTimeEdit::<span class="name">sizeHint</span> () const<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#sizeHint-prop">QWidget::sizeHint</a>().</p>
<!-- @@@sizeHint -->
<!-- $$$timeEdit[overload1]$$$timeEdit -->
<h3 class="fn"><a name="timeEdit"></a><span class="type"><a href="q3timeedit.html">Q3TimeEdit</a></span> * Q3DateTimeEdit::<span class="name">timeEdit</span> ()</h3>
<p>Returns the internal widget used for editing the time part of the datetime.</p>
<!-- @@@timeEdit -->
<!-- $$$valueChanged[overload1]$$$valueChangedconstQDateTime& -->
<h3 class="fn"><a name="valueChanged"></a><span class="type">void</span> Q3DateTimeEdit::<span class="name">valueChanged</span> ( const <span class="type"><a href="qdatetime.html">QDateTime</a></span> &amp; <i>datetime</i> )<tt> [signal]</tt></h3>
<p>This signal is emitted every time the date or time changes. The <i>datetime</i> argument is the new datetime.</p>
<!-- @@@valueChanged -->
</div>
  <div class="ft">
    <span></span>
  </div>
</div> 
<div class="footer">
    <p>
      <acronym title="Copyright">&copy;</acronym> 2012 Nokia Corporation and/or its
      subsidiaries. Documentation contributions included herein are the copyrights of
      their respective owners.</p>
    <br />
    <p>
      The documentation provided herein is licensed under the terms of the
      <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
      License version 1.3</a> as published by the Free Software Foundation.</p>
    <p>
      Documentation sources may be obtained from <a href="http://www.qt-project.org">
      www.qt-project.org</a>.</p>
    <br />
    <p>
      Nokia, Qt and their respective logos are trademarks of Nokia Corporation 
      in Finland and/or other countries worldwide. All other trademarks are property
      of their respective owners. <a title="Privacy Policy"
      href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
</body>
</html>