1QDateTimeEdit(3qt) QDateTimeEdit(3qt)
2
6 QDateTimeEdit - Combines a QDateEdit and QTimeEdit widget into a single
7 widget for editing datetimes
8
10 #include <qdatetimeedit.h>
11 Inherits QWidget.
13 Public Members
15 QDateTimeEdit ( QWidget * parent = 0, const char * name = 0 )
16 QDateTimeEdit ( const QDateTime & datetime, QWidget * parent = 0, const
17 char * name = 0 )
18 ~QDateTimeEdit ()
19 QDateTime dateTime () const
20 QDateEdit * dateEdit ()
21 QTimeEdit * timeEdit ()
22 virtual void setAutoAdvance ( bool advance )
23 bool autoAdvance () const
24 Public Slots
26 virtual void setDateTime ( const QDateTime & dt )
27 Signals
29 void valueChanged ( const QDateTime & datetime )
30 Properties
32 QDateTime dateTime - the editor's datetime value
33
35 The QDateTimeEdit class combines a QDateEdit and QTimeEdit widget into
36 a single widget for editing datetimes.
37 QDateTimeEdit consists of a QDateEdit and QTimeEdit widget placed side
39 by side and offers the functionality of both. The user can edit the
40 date and time by using the keyboard or the arrow keys to
41 increase/decrease date or time values. The Tab key can be used to move
42 from section to section within the QDateTimeEdit widget, and the user
43 can be moved automatically when they complete a section using
44 setAutoAdvance(). The datetime can be set with setDateTime().
45 The date format is read from the system's locale settings. It is set to
47 year, month, day order if that is not possible. See
48 QDateEdit::setOrder() to change this. Times appear in the order hours,
49 minutes, seconds using the 24 hour clock.
50 It is recommended that the QDateTimeEdit is initialised with a
52 datetime, e.g.
53 QDateTimeEdit *dateTimeEdit = new QDateTimeEdit( QDateTime::currentDateTime(), this );
55 dateTimeEdit->dateEdit()->setRange( QDateTime::currentDate(),
56 QDateTime::currentDate().addDays( 7 ) );
57 Here we've created a new QDateTimeEdit set to the current date and
58 time, and set the date to have a minimum date of now and a maximum date
59 of a week from now.
60 Terminology: A QDateEdit widget consists of three 'sections', one each
62 for the year, month and day. Similarly a QTimeEdit consists of three
63 sections, one each for the hour, minute and second. The character that
64 separates each date section is specified with setDateSeparator();
65 similarly setTimeSeparator() is used for the time sections.
66 <center>
68 [Image Omitted]
69 </center>
71 See also QDateEdit, QTimeEdit, Advanced Widgets, and Time and Date.
73
76 Constructs an empty datetime edit with parent parent and called name.
77
79 0, const char * name = 0 )
80 This is an overloaded member function, provided for convenience. It
81 behaves essentially like the above function.
82 Constructs a datetime edit with the initial value datetime, parent
84 parent and called name.
85
87 Destroys the object and frees any allocated resources.
88
90 Returns TRUE if auto-advance is enabled, otherwise returns FALSE.
91 See also setAutoAdvance().
93
95 Returns the internal widget used for editing the date part of the
96 datetime.
97
99 Returns the editor's datetime value. See the "dateTime" property for
100 details.
101
103 Sets the auto advance property of the editor to advance. If set to
104 TRUE, the editor will automatically advance focus to the next date or
105 time section if the user has completed a section.
106
108 Sets the editor's datetime value to dt. See the "dateTime" property for
109 details.
110
112 Returns the internal widget used for editing the time part of the
113 datetime.
114
116 This signal is emitted every time the date or time changes. The
117 datetime argument is the new datetime.
118 Property Documentation
121 This property holds the editor's datetime value.
122 The datetime edit's datetime which may be an invalid datetime.
124 Set this property's value with setDateTime() and get this property's
126 value with dateTime().
127
130 http://doc.trolltech.com/qdatetimeedit.html
131 http://www.trolltech.com/faq/tech.html
132
134 Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the
135 license file included in the distribution for a complete license
136 statement.
137
139 Generated automatically from the source code.
140
142 If you find a bug in Qt, please report it as described in
143 http://doc.trolltech.com/bughowto.html. Good bug reports help us to
144 help you. Thank you.
145 The definitive Qt documentation is provided in HTML format; it is
147 located at $QTDIR/doc/html and can be read using Qt Assistant or with a
148 web browser. This man page is provided as a convenience for those users
149 who prefer man pages, although this format is not officially supported
150 by Trolltech.
151 If you find errors in this manual page, please report them to qt-
153 bugs@trolltech.com. Please include the name of the manual page
154 (qdatetimeedit.3qt) and the Qt version (3.3.8).
155Trolltech AS 2 February 2007 QDateTimeEdit(3qt)