KexiDateTimeTableEdit Class Reference

#include <kexidatetimetableedit.h>

Inheritance diagram for KexiDateTimeTableEdit:

Detailed Description

Editor class for Date/Time type. It is a replacement QDateTimeEdit due to usability problems: people are accustomed to use single-character cursor. Date and Time format is retrieved from the KDE global settings and input/output is performed using KLineEdit (from KexiInputTableEdit).

Definition at line 34 of file kexidatetimetableedit.h.

Public Member Functions

KexiDateTimeTableEdit (KexiTableViewColumn &column, QWidget *parent=0)

virtual ~KexiDateTimeTableEdit ()

virtual void setupContents (QPainter *p, bool focused, const QVariant &val, QString &txt, int &align, int &x, int &y_offset, int &w, int &h)

virtual QVariant value ()

virtual bool valueIsNull ()

virtual bool valueIsEmpty ()

virtual bool valueIsValid ()

virtual void handleAction (const QString &actionName)

virtual void handleCopyAction (const QVariant &value, const QVariant &visibleValue)

Protected Member Functions

void setValueInInternalEditor (const QVariant &value)

helper

virtual void setValueInternal (const QVariant &add, bool removeOld)

bool textIsEmpty () const

Protected Attributes

KexiDateFormatter m_dateFormatter

Used to format and convert date values.

KexiTimeFormatter m_timeFormatter

Used to format and convert time values.

Constructor & Destructor Documentation

KexiDateTimeTableEdit::KexiDateTimeTableEdit ( KexiTableViewColumn & column,

QWidget * parent = 0

)

Todo:
add QValidator so time like "99:88:77" cannot be even entered

Definition at line 50 of file kexidatetimetableedit.cpp.
References dateTimeInputMask(), m_dateFormatter, KexiInputTableEdit::m_lineedit, and m_timeFormatter.

KexiDateTimeTableEdit::~KexiDateTimeTableEdit ( ) [virtual]

Definition at line 61 of file kexidatetimetableedit.cpp.

Member Function Documentation

void KexiDateTimeTableEdit::handleAction ( const QString & actionName ) [virtual]

Reimplemented after KexiInputTableEdit.
Reimplemented from KexiInputTableEdit.
Definition at line 147 of file kexidatetimetableedit.cpp.
References KexiTableEdit::editRequested(), KexiInputTableEdit::handleAction(), m_dateFormatter, KexiInputTableEdit::m_lineedit, m_timeFormatter, setValueInInternalEditor(), and stringToDateTime().

void KexiDateTimeTableEdit::handleCopyAction ( const QVariant & value,

const QVariant & visibleValue

) [virtual]

Reimplemented after KexiInputTableEdit.
Reimplemented from KexiInputTableEdit.
Definition at line 137 of file kexidatetimetableedit.cpp.
References KexiDateFormatter::dateToString(), m_dateFormatter, m_timeFormatter, and KexiTimeFormatter::timeToString().

void KexiDateTimeTableEdit::setupContents ( QPainter * p,

bool focused,

const QVariant & val,

QString & txt,

int & align,

int & x,

int & y_offset,

int & w,

int & h

) [virtual]

For reimplementation. Sets up and paints cell's contents using context of val value. focused is true if the cell is focused. align is set using Qt::AlignmentFlags. Some additional things may be painted using p, but it is not needed to paint the text (this is done automatically outside of this method).
Before calling, x, y_offset, w, h parameters are initialized, but you can tune these values depending on the context. You should set txt to a text representation of val, otherwise no text will be painted.
p can be 0 - in this case no painting should be performed, becasue caller only expects that x, y_offset, w, h, txt parameters are tuned, if needed. p painter's pen is set to foreground color (usually black) that should be used to paint foreground information, if needed. For example boolean editor widget paints a rectangle using this color.
Reimplemented from KexiTableEdit.
Definition at line 89 of file kexidatetimetableedit.cpp.
References KexiDateFormatter::dateToString(), m_dateFormatter, m_timeFormatter, and KexiTimeFormatter::timeToString().

void KexiDateTimeTableEdit::setValueInInternalEditor ( const QVariant & value ) [protected]

helper

Definition at line 65 of file kexidatetimetableedit.cpp.
References KexiDateFormatter::dateToString(), m_dateFormatter, KexiInputTableEdit::m_lineedit, m_timeFormatter, and KexiTimeFormatter::timeToString().
Referenced by handleAction(), and setValueInternal().

void KexiDateTimeTableEdit::setValueInternal ( const QVariant & add_,

bool removeOld

) [protected, virtual]

Todo:
cut string if too long..

Reimplemented from KexiInputTableEdit.
Definition at line 75 of file kexidatetimetableedit.cpp.
References KexiInputTableEdit::m_lineedit, KexiDataItemInterface::m_origValue, and setValueInInternalEditor().

bool KexiDateTimeTableEdit::textIsEmpty ( ) const [protected]

Definition at line 132 of file kexidatetimetableedit.cpp.
References dateTimeIsEmpty(), m_dateFormatter, KexiInputTableEdit::m_lineedit, and m_timeFormatter.
Referenced by value(), and valueIsNull().

QVariant KexiDateTimeTableEdit::value ( ) [virtual]

js
Todo:
PRESERVE PRECISION!

Todo:
check constraints

Reimplemented from KexiInputTableEdit.
Definition at line 120 of file kexidatetimetableedit.cpp.
References m_dateFormatter, KexiInputTableEdit::m_lineedit, m_timeFormatter, stringToDateTime(), and textIsEmpty().

bool KexiDateTimeTableEdit::valueIsEmpty ( ) [virtual]

Returns:
true if editor's value is empty (not null). Only few field types can accept "EMPTY" property (check this with KexiDB::Field::hasEmptyProperty()),

Reimplemented from KexiInputTableEdit.
Definition at line 115 of file kexidatetimetableedit.cpp.
References valueIsNull().

bool KexiDateTimeTableEdit::valueIsNull ( ) [virtual]

Returns:
true if editor's value is null (not empty)

Reimplemented from KexiInputTableEdit.
Definition at line 108 of file kexidatetimetableedit.cpp.
References m_dateFormatter, KexiInputTableEdit::m_lineedit, m_timeFormatter, stringToDateTime(), and textIsEmpty().
Referenced by valueIsEmpty().

bool KexiDateTimeTableEdit::valueIsValid ( ) [virtual]

Returns:
true if editor's value is valid for a given type Used for checking if an entered value is valid, E.g. a part of time value can be entered: "12:8" and this is invalid, not only null. Null time or date is valid in Kexi, so it is not enough to test value().isValid(). Default implementation just returns true.

Reimplemented from KexiDataItemInterface.
Definition at line 127 of file kexidatetimetableedit.cpp.
References dateTimeIsValid(), m_dateFormatter, KexiInputTableEdit::m_lineedit, and m_timeFormatter.

Member Data Documentation

KexiDateFormatter KexiDateTimeTableEdit::m_dateFormatter [protected]

Used to format and convert date values.

Definition at line 61 of file kexidatetimetableedit.h.
Referenced by handleAction(), handleCopyAction(), KexiDateTimeTableEdit(), setupContents(), setValueInInternalEditor(), textIsEmpty(), value(), valueIsNull(), and valueIsValid().

KexiTimeFormatter KexiDateTimeTableEdit::m_timeFormatter [protected]

Used to format and convert time values.

Definition at line 64 of file kexidatetimetableedit.h.
Referenced by handleAction(), handleCopyAction(), KexiDateTimeTableEdit(), setupContents(), setValueInInternalEditor(), textIsEmpty(), value(), valueIsNull(), and valueIsValid().

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


Public Member Functions
	KexiDateTimeTableEdit (KexiTableViewColumn &column, QWidget *parent=0)
virtual	~KexiDateTimeTableEdit ()
virtual void	setupContents (QPainter *p, bool focused, const QVariant &val, QString &txt, int &align, int &x, int &y_offset, int &w, int &h)
virtual QVariant	value ()
virtual bool	valueIsNull ()
virtual bool	valueIsEmpty ()
virtual bool	valueIsValid ()
virtual void	handleAction (const QString &actionName)
virtual void	handleCopyAction (const QVariant &value, const QVariant &visibleValue)
Protected Member Functions
void	setValueInInternalEditor (const QVariant &value)
	helper
virtual void	setValueInternal (const QVariant &add, bool removeOld)
bool	textIsEmpty () const
Protected Attributes
KexiDateFormatter	m_dateFormatter
	Used to format and convert date values.
KexiTimeFormatter	m_timeFormatter
	Used to format and convert time values.

Kexi API Documentation (2.0 alpha)

KexiDateTimeTableEdit Class Reference

Detailed Description

Public Member Functions

Protected Member Functions

Protected Attributes

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation