You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
koffice/kexi/plugins/forms/widgets/kexidblineedit.h

172 lines
6.0 KiB

/* This file is part of the KDE project
Copyright (C) 2005 Cedric Pasteur <cedric.pasteur@free.fr>
Copyright (C) 2004-2007 Jaroslaw Staniek <js@iidea.pl>
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this program; see the file COPYING. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*/
#ifndef KexiDBLineEdit_H
#define KexiDBLineEdit_H
#include <klineedit.h>
#include <tqvalidator.h>
#include "kexiformdataiteminterface.h"
#include "kexidbtextwidgetinterface.h"
#include "kexidbutils.h"
#include <widget/tableview/kexitextformatter.h>
#include <widget/utils/kexidatetimeformatter.h>
class KexiDBWidgetContextMenuExtender;
/*! @internal Utility: alter background color to be a blended color
of the background and base (usually lighter gray). Used for read-only mode. */
void setLighterGrayBackgroundColor(TQWidget* widget);
//! @short Line edit widget for Kexi forms
/*! Handles many data types. User input is validated by using validators
and/or input masks.
*/
class KEXIFORMUTILS_EXPORT KexiDBLineEdit :
public KLineEdit,
protected KexiDBTextWidgetInterface,
public KexiFormDataItemInterface,
public KexiSubwidgetInterface
{
Q_OBJECT
TQ_PROPERTY(TQString dataSource READ dataSource WRITE setDataSource DESIGNABLE true)
TQ_PROPERTY(TQCString dataSourceMimeType READ dataSourceMimeType WRITE setDataSourceMimeType DESIGNABLE true)
TQ_OVERRIDE(bool readOnly READ isReadOnly WRITE setReadOnly DESIGNABLE true)
public:
KexiDBLineEdit(TQWidget *parent, const char *name=0);
virtual ~KexiDBLineEdit();
inline TQString dataSource() const { return KexiFormDataItemInterface::dataSource(); }
inline TQCString dataSourceMimeType() const { return KexiFormDataItemInterface::dataSourceMimeType(); }
virtual TQVariant value();
virtual void setInvalidState( const TQString& displayText );
//! \return true if editor's value is null (not empty)
//! Used for checking if a given constraint within table of form is met.
virtual bool valueIsNull();
//! \return 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.
virtual bool valueIsEmpty();
/*! \return true if the value is valid */
virtual bool valueIsValid();
/*! \return 'readOnly' flag for this widget. */
virtual bool isReadOnly() const;
/*! If \a displayDefaultValue is true, the value set by KexiDataItemInterface::setValue()
is displayed in a special way. Used by KexiFormDataProvider::fillDataItems().
\a widget is equal to 'this'.
Reimplemented after KexiFormDataItemInterface. */
virtual void setDisplayDefaultValue(TQWidget* widget, bool displayDefaultValue);
/*! \return the view widget of this item, e.g. line edit widget. */
virtual TQWidget* widget();
virtual bool cursorAtStart();
virtual bool cursorAtEnd();
virtual void clear();
virtual void setColumnInfo(KexiDB::QueryColumnInfo* cinfo);
/*! Handles action having standard name \a actionName.
Action could be: "edit_copy", "edit_paste", etc.
Reimplemented after KexiDataItemChangesListener. */
virtual void handleAction(const TQString& actionName);
/*! Called by top-level form on key press event to consume widget-specific shortcuts. */
virtual bool keyPressed(TQKeyEvent *ke);
public slots:
inline void setDataSource(const TQString &ds) { KexiFormDataItemInterface::setDataSource(ds); }
inline void setDataSourceMimeType(const TQCString &ds) { KexiFormDataItemInterface::setDataSourceMimeType(ds); }
virtual void setReadOnly( bool readOnly );
//! Reimplemented, so "undo" means the same as "cancelEditor" action
virtual void undo();
//! Implemented for KexiDataItemInterface
virtual void moveCursorToEnd();
//! Implemented for KexiDataItemInterface
virtual void moveCursorToStart();
//! Implemented for KexiDataItemInterface
virtual void selectAll();
protected slots:
void slotTextChanged(const TQString&);
protected:
virtual void paintEvent ( TQPaintEvent * );
virtual void setValueInternal(const TQVariant& add, bool removeOld);
virtual bool event ( TQEvent * );
#if 0
//moved to KexiTextFormatter
inline KexiDateFormatter* dateFormatter() {
return m_dateFormatter ? m_dateFormatter : m_dateFormatter = new KexiDateFormatter();
}
inline KexiTimeFormatter* timeFormatter() {
return m_timeFormatter ? m_timeFormatter : m_timeFormatter = new KexiTimeFormatter();
}
#endif
virtual TQPopupMenu * createPopupMenu();
//! Implemented for KexiSubwidgetInterface
virtual bool appendStretchRequired(KexiDBAutoField* autoField) const;
#if 0
//moved to KexiTextFormatter
//! Used for date and date/time types
KexiDateFormatter* m_dateFormatter;
//! Used for time and date/time types
KexiTimeFormatter* m_timeFormatter;
#endif
//! Used to format text
KexiTextFormatter m_textFormatter;
//! Used for read only flag to disable editing
TQGuardedPtr<const TQValidator> m_readOnlyValidator;
//! Used to remember the previous validator used forf r/w mode, after setting the read only flag
TQGuardedPtr<const TQValidator> m_readWriteValidator;
//! Used for extending context menu
KexiDBWidgetContextMenuExtender m_menuExtender;
//! Used in isReadOnly, as sometimes we want to have the flag set tot true when KLineEdit::isReadOnly
//! is still false.
bool m_internalReadOnly : 1;
//! Used in slotTextChanged()
bool m_slotTextChanged_enabled : 1;
};
#endif