Kexi API Documentation (2.0 alpha)

KexiDBDateTimeEdit Class Reference

#include <kexidbdatetimeedit.h>

Inheritance diagram for KexiDBDateTimeEdit:

QWidget KexiFormDataItemInterface KexiDataItemInterface List of all members.

Detailed Description

A db-aware datetime editor.

Definition at line 32 of file kexidbdatetimeedit.h.

Public Types

enum  Order { DMY, MDY, YMD, YDM }

Public Slots

void setDataSource (const QString &ds)
 Sets the name of the data source for this widget.
void setDataSourceMimeType (const QCString &ds)
void setDateTime (const QDateTime &dt)
virtual void setReadOnly (bool set)

Signals

void dateTimeChanged ()

Public Member Functions

 KexiDBDateTimeEdit (const QDateTime &datetime, QWidget *parent, const char *name=0)
virtual ~KexiDBDateTimeEdit ()
QString dataSource () const
QCString dataSourceMimeType () const
virtual QVariant value ()
virtual void setInvalidState (const QString &displayText)
virtual bool valueIsNull ()
virtual bool valueIsEmpty ()
virtual bool isReadOnly () const
virtual QWidgetwidget ()
virtual bool cursorAtStart ()
virtual bool cursorAtEnd ()
virtual void clear ()
 clears item's data, so the data will contain NULL data
virtual void setEnabled (bool enabled)
QDateTime dateTime () const

Protected Slots

void slotValueChanged ()
void slotShowDatePicker ()
void acceptDate ()

Protected Member Functions

virtual void setValueInternal (const QVariant &add, bool removeOld)
virtual bool eventFilter (QObject *o, QEvent *e)

Properties

QString dataSource
QCString dataSourceMimeType
QDateTime dateTime
bool readOnly


Member Enumeration Documentation

enum KexiDBDateTimeEdit::Order
 

Enumeration values:
DMY 
MDY 
YMD 
YDM 

Definition at line 42 of file kexidbdatetimeedit.h.


Constructor & Destructor Documentation

KexiDBDateTimeEdit::KexiDBDateTimeEdit const QDateTime &  datetime,
QWidget parent,
const char *  name = 0
 

Definition at line 30 of file kexidbdatetimeedit.cpp.

References acceptDate(), dateTimeChanged(), slotShowDatePicker(), slotValueChanged(), and KexiDataItemInterface::valueChanged().

KexiDBDateTimeEdit::~KexiDBDateTimeEdit  )  [virtual]
 

Definition at line 83 of file kexidbdatetimeedit.cpp.


Member Function Documentation

void KexiDBDateTimeEdit::acceptDate  )  [protected, slot]
 

Definition at line 191 of file kexidbdatetimeedit.cpp.

Referenced by eventFilter(), and KexiDBDateTimeEdit().

void KexiDBDateTimeEdit::clear  )  [virtual]
 

clears item's data, so the data will contain NULL data

Implements KexiDataItemInterface.

Definition at line 166 of file kexidbdatetimeedit.cpp.

bool KexiDBDateTimeEdit::cursorAtEnd  )  [virtual]
 

Returns:
true if the item widget's cursor (whatever that means, eg. line edit cursor) is at the end of editor's contents. This can inform table/form view that after pressing "right arrow" key should stop editing and move to a field on the right hand.

Implements KexiDataItemInterface.

Definition at line 156 of file kexidbdatetimeedit.cpp.

bool KexiDBDateTimeEdit::cursorAtStart  )  [virtual]
 

Returns:
true if the item widget's cursor (whatever that means, eg. line edit cursor) is at the beginning of editor's contents. This can inform table/form view that after pressing "left arrow" key should stop editing and move to a field on the left hand.

Implements KexiDataItemInterface.

Definition at line 147 of file kexidbdatetimeedit.cpp.

QString KexiDBDateTimeEdit::dataSource  )  const [inline]
 

Returns:
the name of the data source for this widget. Data source usually means here a table or query, a field name or an expression.

Reimplemented from KexiFormDataItemInterface.

Definition at line 47 of file kexidbdatetimeedit.h.

References KexiFormDataItemInterface::dataSource().

QCString KexiDBDateTimeEdit::dataSourceMimeType  )  const [inline]
 

Returns:
the mime type of the data source for this widget. Data source mime type means here types like "kexi/table" or "kexi/query" in.the data source is set to object (as within form or subform) or is empty if the data source is set to table field or query column.

Reimplemented from KexiFormDataItemInterface.

Definition at line 48 of file kexidbdatetimeedit.h.

References KexiFormDataItemInterface::dataSourceMimeType().

QDateTime KexiDBDateTimeEdit::dateTime  )  const
 

void KexiDBDateTimeEdit::dateTimeChanged  )  [signal]
 

Referenced by KexiDBDateTimeEdit().

bool KexiDBDateTimeEdit::eventFilter QObject *  o,
QEvent *  e
[protected, virtual]
 

Definition at line 198 of file kexidbdatetimeedit.cpp.

References acceptDate().

bool KexiDBDateTimeEdit::isReadOnly  )  const [virtual]
 

Returns:
'readOnly' flag for this widget.

Reimplemented from KexiDataItemInterface.

Definition at line 129 of file kexidbdatetimeedit.cpp.

void KexiDBDateTimeEdit::setDataSource const QString ds  )  [inline, slot]
 

Sets the name of the data source for this widget.

Data source usually means here a table or query or field name name.

Reimplemented from KexiFormDataItemInterface.

Definition at line 81 of file kexidbdatetimeedit.h.

References KexiFormDataItemInterface::setDataSource().

void KexiDBDateTimeEdit::setDataSourceMimeType const QCString &  ds  )  [inline, slot]
 

Sets the mime type of the data source for this widget. Data source usually means here a "kexi/table" or "kexi/query".

See also:
dataSourceMimeType()

Reimplemented from KexiFormDataItemInterface.

Definition at line 82 of file kexidbdatetimeedit.h.

References KexiFormDataItemInterface::setDataSourceMimeType().

void KexiDBDateTimeEdit::setDateTime const QDateTime &  dt  )  [slot]
 

Definition at line 237 of file kexidbdatetimeedit.cpp.

void KexiDBDateTimeEdit::setEnabled bool  enabled  )  [virtual]
 

Definition at line 98 of file kexidbdatetimeedit.cpp.

Referenced by setInvalidState().

void KexiDBDateTimeEdit::setInvalidState const QString displayText  )  [virtual]
 

Todo:
move this to KexiDataItemInterface::setInvalidStateInternal() ?
Parameters:
displayText  paint this text: text

Implements KexiFormDataItemInterface.

Definition at line 87 of file kexidbdatetimeedit.cpp.

References setEnabled(), and setReadOnly().

void KexiDBDateTimeEdit::setReadOnly bool  set  )  [virtual, slot]
 

Changes 'read only' flag, for this widget. Typically this flag can be passed to a widget itself, e.g. KLineEdit::setReadOnly(bool).

Implements KexiFormDataItemInterface.

Definition at line 136 of file kexidbdatetimeedit.cpp.

Referenced by setInvalidState().

void KexiDBDateTimeEdit::setValueInternal const QVariant &  add,
bool  removeOld
[protected, virtual]
 

Initializes this editor with add value, which should be somewhat added to the current value (already storted in m_origValue). If removeOld is true, a value should be set to add, otherwise -it should be set to current m_origValue + add, if possible. Implement this.

Implements KexiDataItemInterface.

Definition at line 106 of file kexidbdatetimeedit.cpp.

References KexiDataItemInterface::m_origValue.

void KexiDBDateTimeEdit::slotShowDatePicker  )  [protected, slot]
 

Definition at line 180 of file kexidbdatetimeedit.cpp.

Referenced by KexiDBDateTimeEdit().

void KexiDBDateTimeEdit::slotValueChanged  )  [protected, slot]
 

Definition at line 174 of file kexidbdatetimeedit.cpp.

Referenced by KexiDBDateTimeEdit().

QVariant KexiDBDateTimeEdit::value  )  [virtual]
 

Returns:
value currently represented by this item.

Implements KexiDataItemInterface.

Definition at line 113 of file kexidbdatetimeedit.cpp.

bool KexiDBDateTimeEdit::valueIsEmpty  )  [virtual]
 

Returns:
true if editor's value is empty (not necessary null). Only few data types can accept "EMPTY" property (use KexiDB::Field::hasEmptyProperty() to check this). Used for checking if a given constraint within table or form is met.

Implements KexiDataItemInterface.

Definition at line 124 of file kexidbdatetimeedit.cpp.

bool KexiDBDateTimeEdit::valueIsNull  )  [virtual]
 

Returns:
true if editor's value is null (not empty) Used for checking if a given constraint within table of form is met.

Implements KexiDataItemInterface.

Definition at line 118 of file kexidbdatetimeedit.cpp.

QWidget * KexiDBDateTimeEdit::widget  )  [virtual]
 

Returns:
the view widget of this item, e.g. line edit widget.

Reimplemented from KexiFormDataItemInterface.

Definition at line 142 of file kexidbdatetimeedit.cpp.


Property Documentation

QString KexiDBDateTimeEdit::dataSource [read, write]
 

Definition at line 35 of file kexidbdatetimeedit.h.

QCString KexiDBDateTimeEdit::dataSourceMimeType [read, write]
 

Definition at line 36 of file kexidbdatetimeedit.h.

QDateTime KexiDBDateTimeEdit::dateTime [read, write]
 

Definition at line 38 of file kexidbdatetimeedit.h.

bool KexiDBDateTimeEdit::readOnly [read, write]
 

Definition at line 39 of file kexidbdatetimeedit.h.


The documentation for this class was generated from the following files:
KDE Logo
This file is part of the documentation for Kexi 2.0 alpha.
Documentation copyright © 2002-2007 the Kexi Team.
Generated on Tue Apr 1 20:49:56 2008 by doxygen 1.4.2 written by Dimitri van Heesch, © 1997-2003