kexi

KexiDBCheckBox Class Reference

#include <kexidbcheckbox.h>

Inheritance diagram for KexiDBCheckBox:

KexiFormDataItemInterface KexiDataItemInterface List of all members.

Detailed Description

A db-aware check box.

Definition at line 28 of file kexidbcheckbox.h.


Public Types

enum  Tristate { TristateDefault, TristateOn, TristateOff }

Public Slots

void setDataSource (const QString &ds)
void setDataSourceMimeType (const QCString &ds)
void slotStateChanged (int state)
virtual void setReadOnly (bool readOnly)

Public Member Functions

 KexiDBCheckBox (const QString &text, QWidget *parent, const char *name=0)
virtual ~KexiDBCheckBox ()
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 QWidget * widget ()
virtual bool cursorAtStart ()
virtual bool cursorAtEnd ()
virtual void clear ()
virtual void setEnabled (bool enabled)
void setTristate (Tristate tristate)
Tristate isTristate () const
virtual void setDisplayDefaultValue (QWidget *widget, bool displayDefaultValue)

Protected Member Functions

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

Properties

QString dataSource []
QCString dataSourceMimeType []

Member Function Documentation

QString KexiDBCheckBox::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 40 of file kexidbcheckbox.h.

QCString KexiDBCheckBox::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 41 of file kexidbcheckbox.h.

QVariant KexiDBCheckBox::value (  )  [virtual]

Returns:
value currently represented by this item.

Implements KexiDataItemInterface.

Definition at line 77 of file kexidbcheckbox.cpp.

void KexiDBCheckBox::setInvalidState ( const QString &  displayText  )  [virtual]

Sets 'invalid' state, e.g. a text editor widget should display text displayText and become read only to prevent entering data, because updating at the database backend is not available. displayText is usually set to something i18n'd like "#NAME?". Note: that even widgets that usualy do not display texts (e.g. pixmaps) should display displayText too.

Implements KexiFormDataItemInterface.

Definition at line 41 of file kexidbcheckbox.cpp.

bool KexiDBCheckBox::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 89 of file kexidbcheckbox.cpp.

bool KexiDBCheckBox::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 94 of file kexidbcheckbox.cpp.

bool KexiDBCheckBox::isReadOnly (  )  const [virtual]

Returns:
'readOnly' flag for this widget.

Reimplemented from KexiDataItemInterface.

Definition at line 99 of file kexidbcheckbox.cpp.

QWidget * KexiDBCheckBox::widget (  )  [virtual]

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

Reimplemented from KexiFormDataItemInterface.

Definition at line 105 of file kexidbcheckbox.cpp.

bool KexiDBCheckBox::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 110 of file kexidbcheckbox.cpp.

bool KexiDBCheckBox::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 115 of file kexidbcheckbox.cpp.

void KexiDBCheckBox::clear (  )  [virtual]

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

Implements KexiDataItemInterface.

Definition at line 120 of file kexidbcheckbox.cpp.

void KexiDBCheckBox::setDisplayDefaultValue ( QWidget *  widget,
bool  displayDefaultValue 
) [virtual]

Reimplemented after KexiFormDataItemInterface.

Reimplemented from KexiFormDataItemInterface.

Definition at line 162 of file kexidbcheckbox.cpp.

void KexiDBCheckBox::setDataSource ( const QString &  ds  )  [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 156 of file kexidbcheckbox.cpp.

void KexiDBCheckBox::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 77 of file kexidbcheckbox.h.

void KexiDBCheckBox::setReadOnly ( bool  readOnly  )  [virtual, slot]

This implementation just disables read only widget.

Implements KexiFormDataItemInterface.

Definition at line 61 of file kexidbcheckbox.cpp.

void KexiDBCheckBox::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 66 of file kexidbcheckbox.cpp.

bool KexiDBCheckBox::isTristateInternal (  )  const [protected]

Returns:
true in isTristate() == TristateDefault and the widget has bound data source or if isTristate() == TristateOn, else false is returned.

Definition at line 137 of file kexidbcheckbox.cpp.

void KexiDBCheckBox::updateTristate (  )  [protected]

Updates tristate in QCheckBox itself according to m_tristate.

Todo:
the data source may be defined as NOT NULL... thus disallowing NULL state

Definition at line 145 of file kexidbcheckbox.cpp.


The documentation for this class was generated from the following files:
KDE Home | KDE Accessibility Home | Description of Access Keys