qlineedit.h
This is the verbatim text of the qlineedit.h include file. It is provided only for illustration; the copyright remains with Trolltech.
/**********************************************************************
** $Id: qt/qlineedit.h 3.3.8 edited Jan 11 14:38 $
**
** Definition of QLineEdit widget class
**
** Created : 941011
**
** Copyright (C) 1992-2007 Trolltech ASA. All rights reserved.
**
** This file is part of the widgets module of the Qt GUI Toolkit.
**
** This file may be used under the terms of the GNU General Public
** License versions 2.0 or 3.0 as published by the Free Software
** Foundation and appearing in the file LICENSE.GPL included in the
** packaging of this file. Alternatively you may (at your option) use any
** later version of the GNU General Public License if such license has
** been publicly approved by Trolltech ASA (or its successors, if any)
** and the KDE Free Qt Foundation.
**
** Please review the following information to ensure GNU General
** Public Licensing requirements will be met:
** http://trolltech.com/products/qt/licenses/licensing/opensource/.
** If you are unsure which license is appropriate for your use, please
** review the following information:
** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
** or contact the sales department at sales@trolltech.com.
**
** This file may be used under the terms of the Q Public License as
** defined by Trolltech ASA and appearing in the file LICENSE.QPL
** included in the packaging of this file. Licensees holding valid Qt
** Commercial licenses may use this file in accordance with the Qt
** Commercial License Agreement provided with the Software.
**
** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
** herein.
**
**********************************************************************/
#ifndef QLINEEDIT_H
#define QLINEEDIT_H
struct QLineEditPrivate;
class QValidator;
class QPopupMenu;
#ifndef QT_H
#include "qframe.h"
#include "qstring.h"
#endif // QT_H
#ifndef QT_NO_LINEEDIT
class QTextParagraph;
class QTextCursor;
class Q_EXPORT QLineEdit : public QFrame
{
Q_OBJECT
Q_ENUMS( EchoMode )
Q_PROPERTY( QString text READ text WRITE setText )
Q_PROPERTY( int maxLength READ maxLength WRITE setMaxLength )
Q_PROPERTY( bool frame READ frame WRITE setFrame )
Q_PROPERTY( EchoMode echoMode READ echoMode WRITE setEchoMode )
Q_PROPERTY( QString displayText READ displayText )
Q_PROPERTY( int cursorPosition READ cursorPosition WRITE setCursorPosition )
Q_PROPERTY( Alignment alignment READ alignment WRITE setAlignment )
Q_PROPERTY( bool edited READ edited WRITE setEdited DESIGNABLE false )
Q_PROPERTY( bool modified READ isModified )
Q_PROPERTY( bool hasMarkedText READ hasMarkedText DESIGNABLE false )
Q_PROPERTY( bool hasSelectedText READ hasSelectedText )
Q_PROPERTY( QString markedText READ markedText DESIGNABLE false )
Q_PROPERTY( QString selectedText READ selectedText )
Q_PROPERTY( bool dragEnabled READ dragEnabled WRITE setDragEnabled )
Q_PROPERTY( bool readOnly READ isReadOnly WRITE setReadOnly )
Q_PROPERTY( bool undoAvailable READ isUndoAvailable )
Q_PROPERTY( bool redoAvailable READ isRedoAvailable )
Q_PROPERTY( QString inputMask READ inputMask WRITE setInputMask )
Q_PROPERTY( bool acceptableInput READ hasAcceptableInput )
public:
QLineEdit( QWidget* parent, const char* name=0 );
QLineEdit( const QString &, QWidget* parent, const char* name=0 );
QLineEdit( const QString &, const QString &, QWidget* parent, const char* name=0 );
~QLineEdit();
QString text() const;
QString displayText() const;
int maxLength() const;
bool frame() const;
enum EchoMode { Normal, NoEcho, Password };
EchoMode echoMode() const;
bool isReadOnly() const;
const QValidator * validator() const;
QSize sizeHint() const;
QSize minimumSizeHint() const;
int cursorPosition() const;
bool validateAndSet( const QString &, int, int, int ); // obsolete
int alignment() const;
#ifndef QT_NO_COMPAT
void cursorLeft( bool mark, int steps = 1 ) { cursorForward( mark, -steps ); }
void cursorRight( bool mark, int steps = 1 ) { cursorForward( mark, steps ); }
#endif
void cursorForward( bool mark, int steps = 1 );
void cursorBackward( bool mark, int steps = 1 );
void cursorWordForward( bool mark );
void cursorWordBackward( bool mark );
void backspace();
void del();
void home( bool mark );
void end( bool mark );
bool isModified() const;
void clearModified();
bool edited() const; // obsolete, use isModified()
void setEdited( bool ); // obsolete, use clearModified()
bool hasSelectedText() const;
QString selectedText() const;
int selectionStart() const;
bool isUndoAvailable() const;
bool isRedoAvailable() const;
#ifndef QT_NO_COMPAT
bool hasMarkedText() const { return hasSelectedText(); }
QString markedText() const { return selectedText(); }
#endif
bool dragEnabled() const;
QString inputMask() const;
void setInputMask( const QString &inputMask );
bool hasAcceptableInput() const;
public slots:
virtual void setText( const QString &);
virtual void selectAll();
virtual void deselect();
virtual void clearValidator();
virtual void insert( const QString &);
virtual void clear();
virtual void undo();
virtual void redo();
virtual void setMaxLength( int );
virtual void setFrame( bool );
virtual void setEchoMode( EchoMode );
virtual void setReadOnly( bool );
virtual void setValidator( const QValidator * );
virtual void setFont( const QFont & );
virtual void setPalette( const QPalette & );
virtual void setSelection( int, int );
virtual void setCursorPosition( int );
virtual void setAlignment( int flag );
#ifndef QT_NO_CLIPBOARD
virtual void cut();
virtual void copy() const;
virtual void paste();
#endif
virtual void setDragEnabled( bool b );
signals:
void textChanged( const QString &);
void returnPressed();
void lostFocus();
void selectionChanged();
protected:
bool event( QEvent * );
void mousePressEvent( QMouseEvent * );
void mouseMoveEvent( QMouseEvent * );
void mouseReleaseEvent( QMouseEvent * );
void mouseDoubleClickEvent( QMouseEvent * );
void keyPressEvent( QKeyEvent * );
void imStartEvent( QIMEvent * );
void imComposeEvent( QIMEvent * );
void imEndEvent( QIMEvent * );
void focusInEvent( QFocusEvent * );
void focusOutEvent( QFocusEvent * );
void resizeEvent( QResizeEvent * );
void drawContents( QPainter * );
#ifndef QT_NO_DRAGANDDROP
void dragEnterEvent( QDragEnterEvent * );
void dragMoveEvent( QDragMoveEvent *e );
void dragLeaveEvent( QDragLeaveEvent *e );
void dropEvent( QDropEvent * );
#endif
void contextMenuEvent( QContextMenuEvent * );
virtual QPopupMenu *createPopupMenu();
void windowActivationChange( bool );
#ifndef QT_NO_COMPAT
void repaintArea( int, int ) { update(); }
#endif
private slots:
void clipboardChanged();
public:
void setPasswordChar( QChar c ); // internal obsolete
QChar passwordChar() const; // obsolete internal
int characterAt( int, QChar* ) const; // obsolete
bool getSelection( int *, int * ); // obsolete
private:
friend struct QLineEditPrivate;
QLineEditPrivate * d;
private: // Disabled copy constructor and operator=
#if defined(Q_DISABLE_COPY)
QLineEdit( const QLineEdit & );
QLineEdit &operator=( const QLineEdit & );
#endif
};
#endif // QT_NO_LINEEDIT
#endif // QLINEEDIT_H
