summaryrefslogtreecommitdiffstats
path: root/doc/html/ntqdatetimeedit.html
blob: 8fb65813c92912940216e094bf5cbe3134d9a7bf (plain)
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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/widgets/qdatetimeedit.cpp:2599 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>TQDateTimeEdit Class</title>
<style type="text/css"><!--
fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>

<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
 <a href="index.html">
<font color="#004faf">Home</font></a>
 | <a href="classes.html">
<font color="#004faf">All&nbsp;Classes</font></a>
 | <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
 | <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
 | <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
 | <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQDateTimeEdit Class Reference</h1>

<p>The TQDateTimeEdit class combines a TQDateEdit and TQTimeEdit
widget into a single widget for editing datetimes.
<a href="#details">More...</a>
<p><tt>#include &lt;<a href="qdatetimeedit-h.html">ntqdatetimeedit.h</a>&gt;</tt>
<p>Inherits <a href="ntqwidget.html">TQWidget</a>.
<p><a href="qdatetimeedit-members.html">List of all member functions.</a>
<h2>Public Members</h2>
<ul>
<li class=fn><a href="#TQDateTimeEdit"><b>TQDateTimeEdit</b></a> ( TQWidget&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0 )</li>
<li class=fn><a href="#TQDateTimeEdit-2"><b>TQDateTimeEdit</b></a> ( const&nbsp;TQDateTime&nbsp;&amp;&nbsp;datetime, TQWidget&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0 )</li>
<li class=fn><a href="#~TQDateTimeEdit"><b>~TQDateTimeEdit</b></a> ()</li>
<li class=fn>TQDateTime <a href="#dateTime"><b>dateTime</b></a> () const</li>
<li class=fn>TQDateEdit * <a href="#dateEdit"><b>dateEdit</b></a> ()</li>
<li class=fn>TQTimeEdit * <a href="#timeEdit"><b>timeEdit</b></a> ()</li>
<li class=fn>virtual void <a href="#setAutoAdvance"><b>setAutoAdvance</b></a> ( bool&nbsp;advance )</li>
<li class=fn>bool <a href="#autoAdvance"><b>autoAdvance</b></a> () const</li>
</ul>
<h2>Public Slots</h2>
<ul>
<li class=fn>virtual void <a href="#setDateTime"><b>setDateTime</b></a> ( const&nbsp;TQDateTime&nbsp;&amp;&nbsp;dt )</li>
</ul>
<h2>Signals</h2>
<ul>
<li class=fn>void <a href="#valueChanged"><b>valueChanged</b></a> ( const&nbsp;TQDateTime&nbsp;&amp;&nbsp;datetime )</li>
</ul>
<h2>Properties</h2>
<ul>
<li class=fn>TQDateTime <a href="#dateTime-prop"><b>dateTime</b></a>&nbsp;- the editor's datetime value</li>
</ul>
<hr><a name="details"></a><h2>Detailed Description</h2>


The TQDateTimeEdit class combines a <a href="qdateedit.html">TQDateEdit</a> and <a href="qtimeedit.html">TQTimeEdit</a>
widget into a single widget for editing datetimes.
<p> 


<p> TQDateTimeEdit consists of a TQDateEdit and TQTimeEdit 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 TQDateTimeEdit widget, and
the user can be moved automatically when they complete a section
using <a href="#setAutoAdvance">setAutoAdvance</a>(). The datetime can be set with
<a href="#setDateTime">setDateTime</a>().
<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="qdateedit.html#setOrder">TQDateEdit::setOrder</a>() to change this. Times appear in the order
hours, minutes, seconds using the 24 hour clock.
<p> It is recommended that the TQDateTimeEdit is initialised with a
datetime, e.g.
<pre>
    TQDateTimeEdit *dateTimeEdit = new TQDateTimeEdit( TQDateTime::<a href="ntqdatetime.html#currentDateTime">currentDateTime</a>(), this );
    dateTimeEdit-&gt;<a href="#dateEdit">dateEdit</a>()-&gt;setRange( TQDateTime::currentDate(),
                                        TQDateTime::currentDate().addDays( 7 ) );
    </pre>
 
Here we've created a new TQDateTimeEdit 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> Terminology: A <a href="qdateedit.html">TQDateEdit</a> widget consists of three 'sections', one
each for the year, month and day. Similarly a <a href="qtimeedit.html">TQTimeEdit</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> <center><img src="datetimewidgets.png" alt="Date Time Widgets"></center> 
<p> <p>See also <a href="qdateedit.html">TQDateEdit</a>, <a href="qtimeedit.html">TQTimeEdit</a>, <a href="advanced.html">Advanced Widgets</a>, and <a href="time.html">Time and Date</a>.

<hr><h2>Member Function Documentation</h2>
<h3 class=fn><a name="TQDateTimeEdit"></a>TQDateTimeEdit::TQDateTimeEdit ( <a href="ntqwidget.html">TQWidget</a>&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0 )
</h3>
Constructs an empty datetime edit with parent <em>parent</em> and called
<em>name</em>.

<h3 class=fn><a name="TQDateTimeEdit-2"></a>TQDateTimeEdit::TQDateTimeEdit ( const&nbsp;<a href="ntqdatetime.html">TQDateTime</a>&nbsp;&amp;&nbsp;datetime, <a href="ntqwidget.html">TQWidget</a>&nbsp;*&nbsp;parent = 0, const&nbsp;char&nbsp;*&nbsp;name = 0 )
</h3>
This is an overloaded member function, provided for convenience. It behaves essentially like the above function.
<p> Constructs a datetime edit with the initial value <em>datetime</em>,
parent <em>parent</em> and called <em>name</em>.

<h3 class=fn><a name="~TQDateTimeEdit"></a>TQDateTimeEdit::~TQDateTimeEdit ()
</h3>
Destroys the object and frees any allocated resources.

<h3 class=fn>bool <a name="autoAdvance"></a>TQDateTimeEdit::autoAdvance () const
</h3>
Returns TRUE if auto-advance is enabled, otherwise returns FALSE.
<p> <p>See also <a href="#setAutoAdvance">setAutoAdvance</a>().

<h3 class=fn><a href="qdateedit.html">TQDateEdit</a>&nbsp;* <a name="dateEdit"></a>TQDateTimeEdit::dateEdit ()
</h3>

<p> Returns the internal widget used for editing the date part of the
datetime.

<h3 class=fn><a href="ntqdatetime.html">TQDateTime</a> <a name="dateTime"></a>TQDateTimeEdit::dateTime () const
</h3><p>Returns the editor's datetime value.
See the <a href="ntqdatetimeedit.html#dateTime-prop">"dateTime"</a> property for details.
<h3 class=fn>void <a name="setAutoAdvance"></a>TQDateTimeEdit::setAutoAdvance ( bool&nbsp;advance )<tt> [virtual]</tt>
</h3>
Sets the auto advance property of the editor to <em>advance</em>. If set
to TRUE, the editor will automatically advance focus to the next
date or time section if the user has completed a section.

<h3 class=fn>void <a name="setDateTime"></a>TQDateTimeEdit::setDateTime ( const&nbsp;<a href="ntqdatetime.html">TQDateTime</a>&nbsp;&amp;&nbsp;dt )<tt> [virtual slot]</tt>
</h3><p>Sets the editor's datetime value to <em>dt</em>.
See the <a href="ntqdatetimeedit.html#dateTime-prop">"dateTime"</a> property for details.
<h3 class=fn><a href="qtimeedit.html">TQTimeEdit</a>&nbsp;* <a name="timeEdit"></a>TQDateTimeEdit::timeEdit ()
</h3>

<p> Returns the internal widget used for editing the time part of the
datetime.

<h3 class=fn>void <a name="valueChanged"></a>TQDateTimeEdit::valueChanged ( const&nbsp;<a href="ntqdatetime.html">TQDateTime</a>&nbsp;&amp;&nbsp;datetime )<tt> [signal]</tt>
</h3>

<p> This signal is emitted every time the date or time changes. The <em>datetime</em> argument is the new datetime.

<hr><h2>Property Documentation</h2>
<h3 class=fn><a href="ntqdatetime.html">TQDateTime</a> <a name="dateTime-prop"></a>dateTime</h3>
<p>This property holds the editor's datetime value.
<p>The datetime edit's datetime which may be an invalid datetime.

<p>Set this property's value with <a href="#setDateTime">setDateTime</a>() and get this property's value with <a href="#dateTime">dateTime</a>().
<!-- eof -->
<hr><p>
This file is part of the <a href="index.html">TQt toolkit</a>.
Copyright &copy; 1995-2007
<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>TQt 3.3.8</div>
</table></div></address></body>
</html>