Q3DateTimeEdit Class Reference

#include <q3datetimeedit.h>

Inheritance diagram for Q3DateTimeEdit:

[legend]Collaboration diagram for Q3DateTimeEdit:

[legend]List of all members.

---

Detailed Description

The Q3DateTimeEdit class combines a Q3DateEdit and Q3TimeEdit widget into a single widget for editing datetimes.

Q3DateTimeEdit consists of a Q3DateEdit and Q3TimeEdit 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 setAutoAdvance(). The datetime can be set with setDateTime().

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 Q3DateEdit::setOrder() to change this. Times appear in the order hours, minutes, seconds using the 24 hour clock.

It is recommended that the Q3DateTimeEdit is initialised with a datetime, e.g.

    Q3DateTimeEdit *dateTimeEdit = new Q3DateTimeEdit(QDateTime::currentDateTime(), this);
    dateTimeEdit->dateEdit()->setRange(QDateTime::currentDate(),
                                        QDateTime::currentDate().addDays(7));

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.

Terminology: A Q3DateEdit widget consists of three 'sections', one each for the year, month and day. Similarly a Q3TimeEdit 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.

datetimewidgets.png Date Time Widgets

See also:

Q3DateEdit Q3TimeEdit

Definition at line 217 of file q3datetimeedit.h.

Public Slots
virtual void	setDateTime (const QDateTime &dt)
Signals
void	valueChanged (const QDateTime &datetime)
Public Member Functions
	Q3DateTimeEdit (QWidget *parent=0, const char *name=0)
	Q3DateTimeEdit (const QDateTime &datetime, QWidget *parent=0, const char *name=0)
	~Q3DateTimeEdit ()
QSize	sizeHint () const
QSize	minimumSizeHint () const
QDateTime	dateTime () const
Q3DateEdit *	dateEdit ()
Q3TimeEdit *	timeEdit ()
virtual void	setAutoAdvance (bool advance)
bool	autoAdvance () const
Protected Slots
void	newValue (const QDate &d)
void	newValue (const QTime &t)
Protected Member Functions
void	init ()
void	resizeEvent (QResizeEvent *)
Private Attributes
Q3DateEdit *	de
Q3TimeEdit *	te
Q3DateTimeEditPrivate *	d

---

Constructor & Destructor Documentation

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

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

Definition at line 2634 of file q3datetimeedit.cpp.

References init().

    : QWidget(parent, name)
{
    init();
}

Here is the call graph for this function:

Q3DateTimeEdit::Q3DateTimeEdit	(	const QDateTime &	datetime,
		QWidget *	parent = 0,
		const char *	name = 0
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Constructs a datetime edit with the initial value datetime, parent parent and called name.

Definition at line 2647 of file q3datetimeedit.cpp.

References init(), and setDateTime().

    : QWidget(parent, name)
{
    init();
    setDateTime(datetime);
}

Here is the call graph for this function:

Q3DateTimeEdit::~Q3DateTimeEdit

(

)

Destroys the object and frees any allocated resources.

Definition at line 2661 of file q3datetimeedit.cpp.

References d.

{
    delete d;
}

---

Member Function Documentation

QSize Q3DateTimeEdit::sizeHint

(

)

const [virtual]

Reimplemented from QWidget.

Definition at line 2722 of file q3datetimeedit.cpp.

References de, QWidget::ensurePolished(), QSize::height(), qMax(), Q3TimeEdit::sizeHint(), Q3DateEdit::sizeHint(), te, and QSize::width().

{
    ensurePolished();
    QSize dsh = de->sizeHint();
    QSize tsh = te->sizeHint();
    return QSize(dsh.width() + tsh.width(),
                  qMax(dsh.height(), tsh.height()));
}

Here is the call graph for this function:

QSize Q3DateTimeEdit::minimumSizeHint

(

)

const [virtual]

Reimplemented from QWidget.

Definition at line 2696 of file q3datetimeedit.cpp.

References de, QSize::height(), Q3DateEdit::minimumSizeHint(), Q3TimeEdit::minimumSizeHint(), qMax(), te, and QSize::width().

{
    QSize dsh = de->minimumSizeHint();
    QSize tsh = te->minimumSizeHint();
    return QSize(dsh.width() + tsh.width(),
                  qMax(dsh.height(), tsh.height()));
}

Here is the call graph for this function:

void Q3DateTimeEdit::setDateTime

(

const QDateTime &

dt

)

[virtual, slot]

Definition at line 2738 of file q3datetimeedit.cpp.

References QDateTime::date(), de, emit, QDateTime::isValid(), Q3DateEdit::setDate(), Q3TimeEdit::setTime(), te, QDateTime::time(), and valueChanged().

Referenced by Q3DateTimeEdit().

{
    if (dt.isValid()) {
        de->setDate(dt.date());
        te->setTime(dt.time());
        emit valueChanged(dt);
    }
}

QDateTime Q3DateTimeEdit::dateTime

(

)

const

Definition at line 2747 of file q3datetimeedit.cpp.

References Q3DateEdit::date(), de, te, and Q3TimeEdit::time().

Referenced by newValue().

{
    return QDateTime(de->date(), te->time());
}

Here is the call graph for this function:

Q3DateEdit * Q3DateTimeEdit::dateEdit

(

)

[inline]

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

Definition at line 237 of file q3datetimeedit.h.

Referenced by Q3DateTimeEditor::eventFilter().

{ return de; }

Q3TimeEdit * Q3DateTimeEdit::timeEdit

(

)

[inline]

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

Definition at line 238 of file q3datetimeedit.h.

Referenced by Q3DateTimeEditor::eventFilter().

{ return te; }

void Q3DateTimeEdit::setAutoAdvance

(

bool

advance

)

[virtual]

Sets the auto advance property of the editor to advance. If set to true, the editor will automatically advance focus to the next date or time section if the user has completed a section.

Definition at line 2789 of file q3datetimeedit.cpp.

References de, Q3DateEdit::setAutoAdvance(), Q3TimeEdit::setAutoAdvance(), and te.

{
    de->setAutoAdvance(advance);
    te->setAutoAdvance(advance);
}

Here is the call graph for this function:

bool Q3DateTimeEdit::autoAdvance

(

)

const

Returns true if auto-advance is enabled, otherwise returns false.

See also:

setAutoAdvance()

Definition at line 2801 of file q3datetimeedit.cpp.

References Q3DateEdit::autoAdvance(), and de.

{
    return de->autoAdvance();
}

Here is the call graph for this function:

void Q3DateTimeEdit::valueChanged

(

const QDateTime &

datetime

)

[signal]

This signal is emitted every time the date or time changes. The datetime argument is the new datetime.

Referenced by init(), newValue(), and setDateTime().

void Q3DateTimeEdit::init

(

)

[protected]

Definition at line 2707 of file q3datetimeedit.cpp.

References Q3DateTimeEditPrivate::adv, QObject::connect(), d, de, QSizePolicy::Fixed, QSizePolicy::Minimum, newValue(), QWidget::setFocusProxy(), QWidget::setSizePolicy(), SIGNAL, SLOT, te, and valueChanged().

Referenced by Q3DateTimeEdit().

{
    d = new Q3DateTimeEditPrivate();
    de = new Q3DateEdit(this, "qt_datetime_dateedit");
    te = new Q3TimeEdit(this, "qt_datetime_timeedit");
    d->adv = false;
    connect(de, SIGNAL(valueChanged(QDate)), this, SLOT(newValue(QDate)));
    connect(te, SIGNAL(valueChanged(QTime)), this, SLOT(newValue(QTime)));
    setFocusProxy(de);
    setSizePolicy(QSizePolicy::Minimum, QSizePolicy::Fixed);
}

Here is the call graph for this function:

void Q3DateTimeEdit::resizeEvent

(

QResizeEvent *

)

[protected, virtual]

Intercepts and handles resize events which have special meaning for the Q3DateTimeEdit.

Reimplemented from QWidget.

Definition at line 2674 of file q3datetimeedit.cpp.

References de, h, QWidget::height(), QWidget::setGeometry(), Q3TimeEdit::sizeHint(), Q3DateEdit::sizeHint(), te, w, QSize::width(), and QWidget::width().

{
    int dw = de->sizeHint().width();
    int tw = te->sizeHint().width();
    int w = width();
    int h = height();
    int extra = w - (dw + tw);

    if (tw + extra < 0) {
        dw = w;
    } else {
        dw += 9 * extra / 16;
    }
    tw = w - dw;

    de->setGeometry(0, 0, dw, h);
    te->setGeometry(dw, 0, tw, h);
}

Here is the call graph for this function:

void Q3DateTimeEdit::newValue

(

const QDate &

d

)

[protected, slot]

Definition at line 2765 of file q3datetimeedit.cpp.

References dateTime(), emit, and valueChanged().

Referenced by init().

{
    QDateTime dt = dateTime();
    emit valueChanged(dt);
}

void Q3DateTimeEdit::newValue

(

const QTime &

t

)

[protected, slot]

Definition at line 2776 of file q3datetimeedit.cpp.

References dateTime(), emit, and valueChanged().

{
    QDateTime dt = dateTime();
    emit valueChanged(dt);
}

---

Member Data Documentation

Q3DateEdit* Q3DateTimeEdit::de [private]

Definition at line 257 of file q3datetimeedit.h.

Referenced by autoAdvance(), dateTime(), init(), minimumSizeHint(), resizeEvent(), setAutoAdvance(), setDateTime(), and sizeHint().

Q3TimeEdit* Q3DateTimeEdit::te [private]

Definition at line 258 of file q3datetimeedit.h.

Referenced by dateTime(), init(), minimumSizeHint(), resizeEvent(), setAutoAdvance(), setDateTime(), and sizeHint().

Q3DateTimeEditPrivate* Q3DateTimeEdit::d [private]

Definition at line 259 of file q3datetimeedit.h.

Referenced by init(), and ~Q3DateTimeEdit().

---

The documentation for this class was generated from the following files:

• src/qt3support/widgets/q3datetimeedit.h
• src/qt3support/widgets/q3datetimeedit.cpp

---