QDateTimeEdit(3qt)

1QDateTimeEdit(3qt)                                          QDateTimeEdit(3qt)
2
3
4

NAME

6       QDateTimeEdit - Combines a QDateEdit and QTimeEdit widget into a single
7       widget for editing datetimes
8

SYNOPSIS

10       #include <qdatetimeedit.h>
11
12       Inherits QWidget.
13
14   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
25   Public Slots
26       virtual void setDateTime ( const QDateTime & dt )
27
28   Signals
29       void valueChanged ( const QDateTime & datetime )
30
31   Properties
32       QDateTime dateTime - the editor's datetime value
33

DESCRIPTION

35       The QDateTimeEdit class combines a QDateEdit and QTimeEdit widget into
36       a single widget for editing datetimes.
37
38       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
46       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
51       It is recommended that the QDateTimeEdit is initialised with a
52       datetime, e.g.
53
54           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
61       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
67       <center>
68                                   [Image Omitted]
69
70       </center>
71
72       See also QDateEdit, QTimeEdit, Advanced Widgets, and Time and Date.
73

MEMBER FUNCTION DOCUMENTATION

QDateTimeEdit::QDateTimeEdit ( QWidget * parent = 0, const char * name = 0 )

76       Constructs an empty datetime edit with parent parent and called name.
77

QDateTimeEdit::QDateTimeEdit ( const QDateTime & datetime, QWidget * parent =

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
83       Constructs a datetime edit with the initial value datetime, parent
84       parent and called name.
85

QDateTimeEdit::~QDateTimeEdit ()

87       Destroys the object and frees any allocated resources.
88

bool QDateTimeEdit::autoAdvance () const

90       Returns TRUE if auto-advance is enabled, otherwise returns FALSE.
91
92       See also setAutoAdvance().
93

QDateEdit * QDateTimeEdit::dateEdit ()

95       Returns the internal widget used for editing the date part of the
96       datetime.
97

QDateTime QDateTimeEdit::dateTime () const

99       Returns the editor's datetime value. See the "dateTime" property for
100       details.
101

void QDateTimeEdit::setAutoAdvance ( bool advance ) [virtual]

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

void QDateTimeEdit::setDateTime ( const QDateTime & dt ) [virtual slot]

108       Sets the editor's datetime value to dt. See the "dateTime" property for
109       details.
110

QTimeEdit * QDateTimeEdit::timeEdit ()

112       Returns the internal widget used for editing the time part of the
113       datetime.
114

void QDateTimeEdit::valueChanged ( const QDateTime & datetime ) [signal]

116       This signal is emitted every time the date or time changes. The
117       datetime argument is the new datetime.
118
119   Property Documentation

QDateTime dateTime

121       This property holds the editor's datetime value.
122
123       The datetime edit's datetime which may be an invalid datetime.
124
125       Set this property's value with setDateTime() and get this property's
126       value with dateTime().
127
128

COPYRIGHT

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

AUTHOR

139       Generated automatically from the source code.
140

BUGS

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
146       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
152       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).
155
156
157
158Trolltech AS                    2 February 2007             QDateTimeEdit(3qt)