/****************************************************************************
**
** Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the QtGui module of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#include "qlineedit.h"
#include "qlineedit_p.h"
#ifndef QT_NO_LINEEDIT
#include "qaction.h"
#include "qapplication.h"
#include "qclipboard.h"
#include "qdrag.h"
#include "qdrawutil.h"
#include "qevent.h"
#include "qfontmetrics.h"
#include "qmenu.h"
#include "qpainter.h"
#include "qpixmap.h"
#include "qpointer.h"
#include "qstringlist.h"
#include "qstyle.h"
#include "qstyleoption.h"
#include "qtimer.h"
#include "qvalidator.h"
#include "qvariant.h"
#include "qvector.h"
#include "qwhatsthis.h"
#include "qdebug.h"
#include "qtextedit.h"
#include <private/qtextedit_p.h>
#ifndef QT_NO_ACCESSIBILITY
#include "qaccessible.h"
#endif
#ifndef QT_NO_IM
#include "qinputcontext.h"
#include "qlist.h"
#endif
#include "qabstractitemview.h"
#include "private/qstylesheetstyle_p.h"
#ifndef QT_NO_SHORTCUT
#include "private/qapplication_p.h"
#include "private/qshortcutmap_p.h"
#include "qkeysequence.h"
#define ACCEL_KEY(k) (!qApp->d_func()->shortcutMap.hasShortcutForKeySequence(k) ? QLatin1Char('\t') + QString(QKeySequence(k)) : QString())
#else
#define ACCEL_KEY(k) QString()
#endif
#include <limits.h>
QT_BEGIN_NAMESPACE
#ifdef Q_WS_MAC
extern void qt_mac_secure_keyboard(bool); //qapplication_mac.cpp
#endif
/*!
Initialize \a option with the values from this QLineEdit. This method
is useful for subclasses when they need a QStyleOptionFrame or QStyleOptionFrameV2, but don't want
to fill in all the information themselves. This function will check the version
of the QStyleOptionFrame and fill in the additional values for a
QStyleOptionFrameV2.
\sa QStyleOption::initFrom()
*/
void QLineEdit::initStyleOption(QStyleOptionFrame *option) const
{
if (!option)
return;
Q_D(const QLineEdit);
option->initFrom(this);
option->rect = contentsRect();
option->lineWidth = d->frame ? style()->pixelMetric(QStyle::PM_DefaultFrameWidth, option, this)
: 0;
option->midLineWidth = 0;
option->state |= QStyle::State_Sunken;
if (d->control->isReadOnly())
option->state |= QStyle::State_ReadOnly;
#ifdef QT_KEYPAD_NAVIGATION
if (hasEditFocus())
option->state |= QStyle::State_HasEditFocus;
#endif
if (QStyleOptionFrameV2 *optionV2 = qstyleoption_cast<QStyleOptionFrameV2 *>(option))
optionV2->features = QStyleOptionFrameV2::None;
}
/*!
\class QLineEdit
\brief The QLineEdit widget is a one-line text editor.
\ingroup basicwidgets
A line edit allows the user to enter and edit a single line of
plain text with a useful collection of editing functions,
including undo and redo, cut and paste, and drag and drop.
By changing the echoMode() of a line edit, it can also be used as
a "write-only" field, for inputs such as passwords.
The length of the text can be constrained to maxLength(). The text
can be arbitrarily constrained using a validator() or an
inputMask(), or both.
A related class is QTextEdit which allows multi-line, rich text
editing.
You can change the text with setText() or insert(). The text is
retrieved with text(); the displayed text (which may be different,
see \l{EchoMode}) is retrieved with displayText(). Text can be
selected with setSelection() or selectAll(), and the selection can
be cut(), copy()ied and paste()d. The text can be aligned with
setAlignment().
When the text changes the textChanged() signal is emitted; when
the text changes other than by calling setText() the textEdited()
signal is emitted; when the cursor is moved the
cursorPositionChanged() signal is emitted; and when the Return or
Enter key is pressed the returnPressed() signal is emitted.
When editing is finished, either because the line edit lost focus
or Return/Enter is pressed the editingFinished() signal is
emitted.
Note that if there is a validator set on the line edit, the
returnPressed()/editingFinished() signals will only be emitted if
the validator returns QValidator::Acceptable.
By default, QLineEdits have a frame as specified by the Windows
and Motif style guides; you can turn it off by calling
setFrame(false).
The default key bindings are described below. The line edit also
provides a context menu (usually invoked by a right mouse click)
that presents some of these editing options.
\target desc
\table
\header \i Keypress \i Action
\row \i Left Arrow \i Moves the cursor one character to the left.
\row \i Shift+Left Arrow \i Moves and selects text one character to the left.
\row \i Right Arrow \i Moves the cursor one character to the right.
\row \i Shift+Right Arrow \i Moves and selects text one character to the right.
\row \i Home \i Moves the cursor to the beginning of the line.
\row \i End \i Moves the cursor to the end of the line.
\row \i Backspace \i Deletes the character to the left of the cursor.
\row \i Ctrl+Backspace \i Deletes the word to the left of the cursor.
\row \i Delete \i Deletes the character to the right of the cursor.
\row \i Ctrl+Delete \i Deletes the word to the right of the cursor.
\row \i Ctrl+A \i Select all.
\row \i Ctrl+C \i Copies the selected text to the clipboard.
\row \i Ctrl+Insert \i Copies the selected text to the clipboard.
\row \i Ctrl+K \i Deletes to the end of the line.
\row \i Ctrl+V \i Pastes the clipboard text into line edit.
\row \i Shift+Insert \i Pastes the clipboard text into line edit.
\row \i Ctrl+X \i Deletes the selected text and copies it to the clipboard.
\row \i Shift+Delete \i Deletes the selected text and copies it to the clipboard.
\row \i Ctrl+Z \i Undoes the last operation.
\row \i Ctrl+Y \i Redoes the last undone operation.
\endtable
Any other key sequence that represents a valid character, will
cause the character to be inserted into the line edit.
\table 100%
\row \o \inlineimage macintosh-lineedit.png Screenshot of a Macintosh style line edit
\o A line edit shown in the \l{Macintosh Style Widget Gallery}{Macintosh widget style}.
\row \o \inlineimage windows-lineedit.png Screenshot of a Windows XP style line edit
\o A line edit shown in the \l{Windows XP Style Widget Gallery}{Windows XP widget style}.
\row \o \inlineimage plastique-lineedit.png Screenshot of a Plastique style line edit
\o A line edit shown in the \l{Plastique Style Widget Gallery}{Plastique widget style}.
\endtable
\sa QTextEdit, QLabel, QComboBox, {fowler}{GUI Design Handbook: Field, Entry}, {Line Edits Example}
*/
/*!
\fn void QLineEdit::textChanged(const QString &text)
This signal is emitted whenever the text changes. The \a text
argument is the new text.
Unlike textEdited(), this signal is also emitted when the text is
changed programmatically, for example, by calling setText().
*/
/*!
\fn void QLineEdit::textEdited(const QString &text)
This signal is emitted whenever the text is edited. The \a text
argument is the next text.
Unlike textChanged(), this signal is not emitted when the text is
changed programmatically, for example, by calling setText().
*/
/*!
\fn void QLineEdit::cursorPositionChanged(int old, int new)
This signal is emitted whenever the cursor moves. The previous
position is given by \a old, and the new position by \a new.
\sa setCursorPosition(), cursorPosition()
*/
/*!
\fn void QLineEdit::selectionChanged()
This signal is emitted whenever the selection changes.
\sa hasSelectedText(), selectedText()
*/
/*!
Constructs a line edit with no text.
The maximum text length is set to 32767 characters.
The \a parent argument is sent to the QWidget constructor.
\sa setText(), setMaxLength()
*/
QLineEdit::QLineEdit(QWidget* parent)
: QWidget(*new QLineEditPrivate, parent,0)
{
Q_D(QLineEdit);
d->init(QString());
}
/*!
Constructs a line edit containing the text \a contents.
The cursor position is set to the end of the line and the maximum
text length to 32767 characters.
The \a parent and argument is sent to the QWidget
constructor.
\sa text(), setMaxLength()
*/
QLineEdit::QLineEdit(const QString& contents, QWidget* parent)
: QWidget(*new QLineEditPrivate, parent, 0)
{
Q_D(QLineEdit);
d->init(contents);
}
#ifdef QT3_SUPPORT
/*!
Constructs a line edit with no text.
The maximum text length is set to 32767 characters.
The \a parent and \a name arguments are sent to the QWidget constructor.
\sa setText(), setMaxLength()
*/
QLineEdit::QLineEdit(QWidget* parent, const char* name)
: QWidget(*new QLineEditPrivate, parent,0)
{
Q_D(QLineEdit);
setObjectName(QString::fromAscii(name));
d->init(QString());
}
/*!
Constructs a line edit containing the text \a contents.
The cursor position is set to the end of the line and the maximum
text length to 32767 characters.
The \a parent and \a name arguments are sent to the QWidget
constructor.
\sa text(), setMaxLength()
*/
QLineEdit::QLineEdit(const QString& contents, QWidget* parent, const char* name)
: QWidget(*new QLineEditPrivate, parent, 0)
{
Q_D(QLineEdit);
setObjectName(QString::fromAscii(name));
d->init(contents);
}
/*!
Constructs a line edit with an input \a inputMask and the text \a
contents.
The cursor position is set to the end of the line and the maximum
text length is set to the length of the mask (the number of mask
characters and separators).
The \a parent and \a name arguments are sent to the QWidget
constructor.
\sa setMask() text()
*/
QLineEdit::QLineEdit(const QString& contents, const QString &inputMask, QWidget* parent, const char* name)
: QWidget(*new QLineEditPrivate, parent, 0)
{
Q_D(QLineEdit);
setObjectName(QString::fromAscii(name));
d->init(contents);
d->control->setInputMask(inputMask);
d->control->moveCursor(d->control->nextMaskBlank(contents.length()));
}
#endif
/*!
Destroys the line edit.
*/
QLineEdit::~QLineEdit()
{
}
/*!
\property QLineEdit::text
\brief the line edit's text
Setting this property clears the selection, clears the undo/redo
history, moves the cursor to the end of the line and resets the
\l modified property to false. The text is not validated when
inserted with setText().
The text is truncated to maxLength() length.
By default, this property contains an empty string.
\sa insert(), clear()
*/
QString QLineEdit::text() const
{
Q_D(const QLineEdit);
return d->control->text();
}
void QLineEdit::setText(const QString& text)
{
Q_D(QLineEdit);
d->control->setText(text);
}
// ### Qt 4.7: remove this #if guard
#if (QT_VERSION >= 0x407000) || defined(Q_WS_MAEMO_5)
/*!
\since 4.7
\property QLineEdit::placeholderText
\brief the line edit's placeholder text
Setting this property makes the line edit display a grayed-out
placeholder text as long as the text() is empty and the widget doesn't
have focus.
By default, this property contains an empty string.
\sa text()
*/
QString QLineEdit::placeholderText() const
{
Q_D(const QLineEdit);
return d->placeholderText;
}
void QLineEdit::setPlaceholderText(const QString& placeholderText)
{
Q_D(QLineEdit);
if (d->placeholderText != placeholderText) {
d->placeholderText = placeholderText;
if (!hasFocus())
update();
}
}
#endif
/*!
\property QLineEdit::displayText
\brief the displayed text
If \l echoMode is \l Normal this returns the same as text(); if
\l EchoMode is \l Password or \l PasswordEchoOnEdit it returns a string of asterisks
text().length() characters long, e.g. "******"; if \l EchoMode is
\l NoEcho returns an empty string, "".
By default, this property contains an empty string.
\sa setEchoMode() text() EchoMode
*/
QString QLineEdit::displayText() const
{
Q_D(const QLineEdit);
return d->control->displayText();
}
/*!
\property QLineEdit::maxLength
\brief the maximum permitted length of the text
If the text is too long, it is truncated at the limit.
If truncation occurs any selected text will be unselected, the
cursor position is set to 0 and the first part of the string is
shown.
If the line edit has an input mask, the mask defines the maximum
string length.
By default, this property contains a value of 32767.
\sa inputMask
*/
int QLineEdit::maxLength() const
{
Q_D(const QLineEdit);
return d->control->maxLength();
}
void QLineEdit::setMaxLength(int maxLength)
{
Q_D(QLineEdit);
d->control->setMaxLength(maxLength);
}
/*!
\property QLineEdit::frame
\brief whether the line edit draws itself with a frame
If enabled (the default) the line edit draws itself inside a
frame, otherwise the line edit draws itself without any frame.
*/
bool QLineEdit::hasFrame() const
{
Q_D(const QLineEdit);
return d->frame;
}
void QLineEdit::setFrame(bool enable)
{
Q_D(QLineEdit);
d->frame = enable;
update();
updateGeometry();
}
/*!
\enum QLineEdit::EchoMode
This enum type describes how a line edit should display its
contents.
\value Normal Display characters as they are entered. This is the
default.
\value NoEcho Do not display anything. This may be appropriate
for passwords where even the length of the
password should be kept secret.
\value Password Display asterisks instead of the characters
actually entered.
\value PasswordEchoOnEdit Display characters as they are entered
while editing otherwise display asterisks.
\sa setEchoMode() echoMode()
*/
/*!
\property QLineEdit::echoMode
\brief the line edit's echo mode
The echo mode determines how the text entered in the line edit is
displayed (or echoed) to the user.
The most common setting is \l Normal, in which the text entered by the
user is displayed verbatim, but QLineEdit also supports modes that allow
the entered text to be suppressed or obscured: these include \l NoEcho,
\l Password and \l PasswordEchoOnEdit.
The widget's display and the ability to copy or drag the text is
affected by this setting.
By default, this property is set to \l Normal.
\sa EchoMode displayText()
*/
QLineEdit::EchoMode QLineEdit::echoMode() const
{
Q_D(const QLineEdit);
return (EchoMode) d->control->echoMode();
}
void QLineEdit::setEchoMode(EchoMode mode)
{
Q_D(QLineEdit);
if (mode == (EchoMode)d->control->echoMode())
return;
Qt::InputMethodHints imHints = inputMethodHints();
if (mode == Password) {
imHints |= Qt::ImhHiddenText;
} else {
imHints &= ~Qt::ImhHiddenText;
}
setInputMethodHints(imHints);
d->control->setEchoMode(mode);
update();
#ifdef Q_WS_MAC
if (hasFocus())
qt_mac_secure_keyboard(mode == Password || mode == NoEcho);
#endif
}
#ifndef QT_NO_VALIDATOR
/*!
Returns a pointer to the current input validator, or 0 if no
validator has been set.
\sa setValidator()
*/
const QValidator * QLineEdit::validator() const
{
Q_D(const QLineEdit);
return d->control->validator();
}
/*!
Sets this line edit to only accept input that the validator, \a v,
will accept. This allows you to place any arbitrary constraints on
the text which may be entered.
If \a v == 0, setValidator() removes the current input validator.
The initial setting is to have no input validator (i.e. any input
is accepted up to maxLength()).
\sa validator() QIntValidator QDoubleValidator QRegExpValidator
*/
void QLineEdit::setValidator(const QValidator *v)
{
Q_D(QLineEdit);
d->control->setValidator(v);
}
#endif // QT_NO_VALIDATOR
#ifndef QT_NO_COMPLETER
/*!
\since 4.2
Sets this line edit to provide auto completions from the completer, \a c.
The completion mode is set using QCompleter::setCompletionMode().
To use a QCompleter with a QValidator or QLineEdit::inputMask, you need to
ensure that the model provided to QCompleter contains valid entries. You can
use the QSortFilterProxyModel to ensure that the QCompleter's model contains
only valid entries.
If \a c == 0, setCompleter() removes the current completer, effectively
disabling auto completion.
\sa QCompleter
*/
void QLineEdit::setCompleter(QCompleter *c)
{
Q_D(QLineEdit);
if (c == d->control->completer())
return;
if (d->control->completer()) {
disconnect(d->control->completer(), 0, this, 0);
d->control->completer()->setWidget(0);
if (d->control->completer()->parent() == this)
delete d->control->completer();
}
d->control->setCompleter(c);
if (!c)
return;
if (c->widget() == 0)
c->setWidget(this);
if (hasFocus()) {
QObject::connect(d->control->completer(), SIGNAL(activated(QString)),
this, SLOT(setText(QString)));
QObject::connect(d->control->completer(), SIGNAL(highlighted(QString)),
this, SLOT(_q_completionHighlighted(QString)));
}
}
/*!
\since 4.2
Returns the current QCompleter that provides completions.
*/
QCompleter *QLineEdit::completer() const
{
Q_D(const QLineEdit);
return d->control->completer();
}
#endif // QT_NO_COMPLETER
/*!
Returns a recommended size for the widget.
The width returned, in pixels, is usually enough for about 15 to
20 characters.
*/
QSize QLineEdit::sizeHint() const
{
Q_D(const QLineEdit);
ensurePolished();
QFontMetrics fm(font());
int h = qMax(fm.height(), 14) + 2*d->verticalMargin
+ d->topTextMargin + d->bottomTextMargin
+ d->topmargin + d->bottommargin;
int w = fm.width(QLatin1Char('x')) * 17 + 2*d->horizontalMargin
+ d->leftTextMargin + d->rightTextMargin
+ d->leftmargin + d->rightmargin; // "some"
QStyleOptionFrameV2 opt;
initStyleOption(&opt);
return (style()->sizeFromContents(QStyle::CT_LineEdit, &opt, QSize(w, h).
expandedTo(QApplication::globalStrut()), this));
}
/*!
Returns a minimum size for the line edit.
The width returned is enough for at least one character.
*/
QSize QLineEdit::minimumSizeHint() const
{
Q_D(const QLineEdit);
ensurePolished();
QFontMetrics fm = fontMetrics();
int h = fm.height() + qMax(2*d->verticalMargin, fm.leading())
+ d->topmargin + d->bottommargin;
int w = fm.maxWidth() + d->leftmargin + d->rightmargin;
QStyleOptionFrameV2 opt;
initStyleOption(&opt);
return (style()->sizeFromContents(QStyle::CT_LineEdit, &opt, QSize(w, h).
expandedTo(QApplication::globalStrut()), this));
}
/*!
\property QLineEdit::cursorPosition
\brief the current cursor position for this line edit
Setting the cursor position causes a repaint when appropriate.
By default, this property contains a value of 0.
*/
int QLineEdit::cursorPosition() const
{
Q_D(const QLineEdit);
return d->control->cursorPosition();
}
void QLineEdit::setCursorPosition(int pos)
{
Q_D(QLineEdit);
d->control->setCursorPosition(pos);
}
/*!
Returns the cursor position under the point \a pos.
*/
// ### What should this do if the point is outside of contentsRect? Currently returns 0.
int QLineEdit::cursorPositionAt(const QPoint &pos)
{
Q_D(QLineEdit);
return d->xToPos(pos.x());
}
#ifdef QT3_SUPPORT
/*! \obsolete
Use setText(), setCursorPosition() and setSelection() instead.
*/
bool QLineEdit::validateAndSet(const QString &newText, int newPos,
int newMarkAnchor, int newMarkDrag)
{
// The suggested functions above in the docs don't seem to validate,
// below code tries to mimic previous behaviour.
QString oldText = text();
setText(newText);
if(!hasAcceptableInput()){
setText(oldText);
return false;
}
setCursorPosition(newPos);
setSelection(qMin(newMarkAnchor, newMarkDrag), qAbs(newMarkAnchor - newMarkDrag));
return true;
}
#endif //QT3_SUPPORT
/*!
\property QLineEdit::alignment
\brief the alignment of the line edit
Both horizontal and vertical alignment is allowed here, Qt::AlignJustify
will map to Qt::AlignLeft.
By default, this property contains a combination of Qt::AlignLeft and Qt::AlignVCenter.
\sa Qt::Alignment
*/
Qt::Alignment QLineEdit::alignment() const
{
Q_D(const QLineEdit);
return QFlag(d->alignment);
}
void QLineEdit::setAlignment(Qt::Alignment alignment)
{
Q_D(QLineEdit);
d->alignment = alignment;
update();
}
/*!
Moves the cursor forward \a steps characters. If \a mark is true
each character moved over is added to the selection; if \a mark is
false the selection is cleared.
\sa cursorBackward()
*/
void QLineEdit::cursorForward(bool mark, int steps)
{
Q_D(QLineEdit);
d->control->cursorForward(mark, steps);
}
/*!
Moves the cursor back \a steps characters. If \a mark is true each
character moved over is added to the selection; if \a mark is
false the selection is cleared.
\sa cursorForward()
*/
void QLineEdit::cursorBackward(bool mark, int steps)
{
cursorForward(mark, -steps);
}
/*!
Moves the cursor one word forward. If \a mark is true, the word is
also selected.
\sa cursorWordBackward()
*/
void QLineEdit::cursorWordForward(bool mark)
{
Q_D(QLineEdit);
d->control->cursorWordForward(mark);
}
/*!
Moves the cursor one word backward. If \a mark is true, the word
is also selected.
\sa cursorWordForward()
*/
void QLineEdit::cursorWordBackward(bool mark)
{
Q_D(QLineEdit);
d->control->cursorWordBackward(mark);
}
/*!
If no text is selected, deletes the character to the left of the
text cursor and moves the cursor one position to the left. If any
text is selected, the cursor is moved to the beginning of the
selected text and the selected text is deleted.
\sa del()
*/
void QLineEdit::backspace()
{
Q_D(QLineEdit);
d->control->backspace();
}
/*!
If no text is selected, deletes the character to the right of the
text cursor. If any text is selected, the cursor is moved to the
beginning of the selected text and the selected text is deleted.
\sa backspace()
*/
void QLineEdit::del()
{
Q_D(QLineEdit);
d->control->del();
}
/*!
Moves the text cursor to the beginning of the line unless it is
already there. If \a mark is true, text is selected towards the
first position; otherwise, any selected text is unselected if the
cursor is moved.
\sa end()
*/
void QLineEdit::home(bool mark)
{
Q_D(QLineEdit);
d->control->home(mark);
}
/*!
Moves the text cursor to the end of the line unless it is already
there. If \a mark is true, text is selected towards the last
position; otherwise, any selected text is unselected if the cursor
is moved.
\sa home()
*/
void QLineEdit::end(bool mark)
{
Q_D(QLineEdit);
d->control->end(mark);
}
/*!
\property QLineEdit::modified
\brief whether the line edit's contents has been modified by the user
The modified flag is never read by QLineEdit; it has a default value
of false and is changed to true whenever the user changes the line
edit's contents.
This is useful for things that need to provide a default value but
do not start out knowing what the default should be (perhaps it
depends on other fields on the form). Start the line edit without
the best default, and when the default is known, if modified()
returns false (the user hasn't entered any text), insert the
default value.
Calling setText() resets the modified flag to false.
*/
bool QLineEdit::isModified() const
{
Q_D(const QLineEdit);
return d->control->isModified();
}
void QLineEdit::setModified(bool modified)
{
Q_D(QLineEdit);
d->control->setModified(modified);
}
/*!\fn QLineEdit::clearModified()
Use setModified(false) instead.
\sa isModified()
*/
/*!
\property QLineEdit::hasSelectedText
\brief whether there is any text selected
hasSelectedText() returns true if some or all of the text has been
selected by the user; otherwise returns false.
By default, this property is false.
\sa selectedText()
*/
bool QLineEdit::hasSelectedText() const
{
Q_D(const QLineEdit);
return d->control->hasSelectedText();
}
/*!
\property QLineEdit::selectedText
\brief the selected text
If there is no selected text this property's value is
an empty string.
By default, this property contains an empty string.
\sa hasSelectedText()
*/
QString QLineEdit::selectedText() const
{
Q_D(const QLineEdit);
return d->control->selectedText();
}
/*!
selectionStart() returns the index of the first selected character in the
line edit or -1 if no text is selected.
\sa selectedText()
*/
int QLineEdit::selectionStart() const
{
Q_D(const QLineEdit);
return d->control->selectionStart();
}
#ifdef QT3_SUPPORT
/*!
\fn void QLineEdit::lostFocus()
This signal is emitted when the line edit has lost focus.
Use editingFinished() instead
\sa editingFinished(), returnPressed()
*/
/*!
Use isModified() instead.
*/
bool QLineEdit::edited() const { return isModified(); }
/*!
Use setModified() or setText().
*/
void QLineEdit::setEdited(bool on) { setModified(on); }
/*!
There exists no equivalent functionality in Qt 4.
*/
int QLineEdit::characterAt(int xpos, QChar *chr) const
{
Q_D(const QLineEdit);
int pos = d->xToPos(xpos + contentsRect().x() - d->hscroll + d->horizontalMargin);
QString txt = d->control->text();
if (chr && pos < (int) txt.length())
*chr = txt.at(pos);
return pos;
}
/*!
Use selectedText() and selectionStart() instead.
*/
bool QLineEdit::getSelection(int *start, int *end)
{
Q_D(QLineEdit);
if (d->control->hasSelectedText() && start && end) {
*start = selectionStart();
*end = *start + selectedText().length();
return true;
}
return false;
}
#endif
/*!
Selects text from position \a start and for \a length characters.
Negative lengths are allowed.
\sa deselect() selectAll() selectedText()
*/
void QLineEdit::setSelection(int start, int length)
{
Q_D(QLineEdit);
if (start < 0 || start > (int)d->control->text().length()) {
qWarning("QLineEdit::setSelection: Invalid start position (%d)", start);
return;
}
d->control->setSelection(start, length);
if (d->control->hasSelectedText()){
QStyleOptionFrameV2 opt;
initStyleOption(&opt);
if (!style()->styleHint(QStyle::SH_BlinkCursorWhenTextSelected, &opt, this))
d->setCursorVisible(false);
}
}
/*!
\property QLineEdit::undoAvailable
\brief whether undo is available
Undo becomes available once the user has modified the text in the line edit.
By default, this property is false.
*/
bool QLineEdit::isUndoAvailable() const
{
Q_D(const QLineEdit);
return d->control->isUndoAvailable();
}
/*!
\property QLineEdit::redoAvailable
\brief whether redo is available
Redo becomes available once the user has performed one or more undo operations
on text in the line edit.
By default, this property is false.
*/
bool QLineEdit::isRedoAvailable() const
{
Q_D(const QLineEdit);
return d->control->isRedoAvailable();
}
/*!
\property QLineEdit::dragEnabled
\brief whether the lineedit starts a drag if the user presses and
moves the mouse on some selected text
Dragging is disabled by default.
*/
bool QLineEdit::dragEnabled() const
{
Q_D(const QLineEdit);
return d->dragEnabled;
}
void QLineEdit::setDragEnabled(bool b)
{
Q_D(QLineEdit);
d->dragEnabled = b;
}
/*!
\property QLineEdit::acceptableInput
\brief whether the input satisfies the inputMask and the
validator.
By default, this property is true.
\sa setInputMask(), setValidator()
*/
bool QLineEdit::hasAcceptableInput() const
{
Q_D(const QLineEdit);
return d->control->hasAcceptableInput();
}
/*!
Sets the margins around the text inside the frame to have the
sizes \a left, \a top, \a right, and \a bottom.
\since 4.5
See also getTextMargins().
*/
void QLineEdit::setTextMargins(int left, int top, int right, int bottom)
{
Q_D(QLineEdit);
d->leftTextMargin = left;
d->topTextMargin = top;
d->rightTextMargin = right;
d->bottomTextMargin = bottom;
updateGeometry();
update();
}
/*!
\since 4.6
Sets the \a margins around the text inside the frame.
See also textMargins().
*/
void QLineEdit::setTextMargins(const QMargins &margins)
{
setTextMargins(margins.left(), margins.top(), margins.right(), margins.bottom());
}
/*!
Returns the widget's text margins for \a left, \a top, \a right, and \a bottom.
\since 4.5
\sa setTextMargins()
*/
void QLineEdit::getTextMargins(int *left, int *top, int *right, int *bottom) const
{
Q_D(const QLineEdit);
if (left)
*left = d->leftTextMargin;
if (top)
*top = d->topTextMargin;
if (right)
*right = d->rightTextMargin;
if (bottom)
*bottom = d->bottomTextMargin;
}
/*!
\since 4.6
Returns the widget's text margins.
\sa setTextMargins()
*/
QMargins QLineEdit::textMargins() const
{
Q_D(const QLineEdit);
return QMargins(d->leftTextMargin, d->topTextMargin, d->rightTextMargin, d->bottomTextMargin);
}
/*!
\property QLineEdit::inputMask
\brief The validation input mask
If no mask is set, inputMask() returns an empty string.
Sets the QLineEdit's validation mask. Validators can be used
instead of, or in conjunction with masks; see setValidator().
Unset the mask and return to normal QLineEdit operation by passing
an empty string ("") or just calling setInputMask() with no
arguments.
The table below shows the characters that can be used in an input mask.
A space character, the default character for a blank, is needed for cases
where a character is \e{permitted but not required}.
\table
\header \i Character \i Meaning
\row \i \c A \i ASCII alphabetic character required. A-Z, a-z.
\row \i \c a \i ASCII alphabetic character permitted but not required.
\row \i \c N \i ASCII alphanumeric character required. A-Z, a-z, 0-9.
\row \i \c n \i ASCII alphanumeric character permitted but not required.
\row \i \c X \i Any character required.
\row \i \c x \i Any character permitted but not required.
\row \i \c 9 \i ASCII digit required. 0-9.
\row \i \c 0 \i ASCII digit permitted but not required.
\row \i \c D \i ASCII digit required. 1-9.
\row \i \c d \i ASCII digit permitted but not required (1-9).
\row \i \c # \i ASCII digit or plus/minus sign permitted but not required.
\row \i \c H \i Hexadecimal character required. A-F, a-f, 0-9.
\row \i \c h \i Hexadecimal character permitted but not required.
\row \i \c B \i Binary character required. 0-1.
\row \i \c b \i Binary character permitted but not required.
\row \i \c > \i All following alphabetic characters are uppercased.
\row \i \c < \i All following alphabetic characters are lowercased.
\row \i \c ! \i Switch off case conversion.
\row \i \tt{\\} \i Use \tt{\\} to escape the special
characters listed above to use them as
separators.
\endtable
The mask consists of a string of mask characters and separators,
optionally followed by a semicolon and the character used for
blanks. The blank characters are always removed from the text
after editing.
Examples:
\table
\header \i Mask \i Notes
\row \i \c 000.000.000.000;_ \i IP address; blanks are \c{_}.
\row \i \c HH:HH:HH:HH:HH:HH;_ \i MAC address
\row \i \c 0000-00-00 \i ISO Date; blanks are \c space
\row \i \c >AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;# \i License number;
blanks are \c - and all (alphabetic) characters are converted to
uppercase.
\endtable
To get range control (e.g., for an IP address) use masks together
with \link setValidator() validators\endlink.
\sa maxLength
*/
QString QLineEdit::inputMask() const
{
Q_D(const QLineEdit);
return d->control->inputMask();
}
void QLineEdit::setInputMask(const QString &inputMask)
{
Q_D(QLineEdit);
d->control->setInputMask(inputMask);
}
/*!
Selects all the text (i.e. highlights it) and moves the cursor to
the end. This is useful when a default value has been inserted
because if the user types before clicking on the widget, the
selected text will be deleted.
\sa setSelection() deselect()
*/
void QLineEdit::selectAll()
{
Q_D(QLineEdit);
d->control->selectAll();
}
/*!
Deselects any selected text.
\sa setSelection() selectAll()
*/
void QLineEdit::deselect()
{
Q_D(QLineEdit);
d->control->deselect();
}
/*!
Deletes any selected text, inserts \a newText, and validates the
result. If it is valid, it sets it as the new contents of the line
edit.
\sa setText(), clear()
*/
void QLineEdit::insert(const QString &newText)
{
// q->resetInputContext(); //#### FIX ME IN QT
Q_D(QLineEdit);
d->control->insert(newText);
}
/*!
Clears the contents of the line edit.
\sa setText(), insert()
*/
void QLineEdit::clear()
{
Q_D(QLineEdit);
resetInputContext();
d->control->clear();
}
/*!
Undoes the last operation if undo is \link
QLineEdit::undoAvailable available\endlink. Deselects any current
selection, and updates the selection start to the current cursor
position.
*/
void QLineEdit::undo()
{
Q_D(QLineEdit);
resetInputContext();
d->control->undo();
}
/*!
Redoes the last operation if redo is \link
QLineEdit::redoAvailable available\endlink.
*/
void QLineEdit::redo()
{
Q_D(QLineEdit);
resetInputContext();
d->control->redo();
}
/*!
\property QLineEdit::readOnly
\brief whether the line edit is read only.
In read-only mode, the user can still copy the text to the
clipboard, or drag and drop the text (if echoMode() is \l Normal),
but cannot edit it.
QLineEdit does not show a cursor in read-only mode.
By default, this property is false.
\sa setEnabled()
*/
bool QLineEdit::isReadOnly() const
{
Q_D(const QLineEdit);
return d->control->isReadOnly();
}
void QLineEdit::setReadOnly(bool enable)
{
Q_D(QLineEdit);
if (d->control->isReadOnly() != enable) {
d->control->setReadOnly(enable);
setAttribute(Qt::WA_MacShowFocusRect, !enable);
setAttribute(Qt::WA_InputMethodEnabled, d->shouldEnableInputMethod());
#ifndef QT_NO_CURSOR
setCursor(enable ? Qt::ArrowCursor : Qt::IBeamCursor);
#endif
update();
}
}
#ifndef QT_NO_CLIPBOARD
/*!
Copies the selected text to the clipboard and deletes it, if there
is any, and if echoMode() is \l Normal.
If the current validator disallows deleting the selected text,
cut() will copy without deleting.
\sa copy() paste() setValidator()
*/
void QLineEdit::cut()
{
if (hasSelectedText()) {
copy();
del();
}
}
/*!
Copies the selected text to the clipboard, if there is any, and if
echoMode() is \l Normal.
\sa cut() paste()
*/
void QLineEdit::copy() const
{
Q_D(const QLineEdit);
d->control->copy();
}
/*!
Inserts the clipboard's text at the cursor position, deleting any
selected text, providing the line edit is not \link
QLineEdit::readOnly read-only\endlink.
If the end result would not be acceptable to the current
\link setValidator() validator\endlink, nothing happens.
\sa copy() cut()
*/
void QLineEdit::paste()
{
Q_D(QLineEdit);
d->control->paste();
}
#endif // !QT_NO_CLIPBOARD
/*! \reimp
*/
bool QLineEdit::event(QEvent * e)
{
Q_D(QLineEdit);
if (e->type() == QEvent::Timer) {
// should be timerEvent, is here for binary compatibility
int timerId = ((QTimerEvent*)e)->timerId();
if (false) {
#ifndef QT_NO_DRAGANDDROP
} else if (timerId == d->dndTimer.timerId()) {
d->drag();
#endif
}
else if (timerId == d->tripleClickTimer.timerId())
d->tripleClickTimer.stop();
} else if (e->type() == QEvent::ContextMenu) {
#ifndef QT_NO_IM
if (d->control->composeMode())
return true;
#endif
//d->separate();
} else if (e->type() == QEvent::WindowActivate) {
QTimer::singleShot(0, this, SLOT(_q_handleWindowActivate()));
}else if(e->type() == QEvent::ShortcutOverride){
d->control->processEvent(e);
} else if (e->type() == QEvent::KeyRelease) {
d->control->setCursorBlinkPeriod(QApplication::cursorFlashTime());
} else if (e->type() == QEvent::Show) {
//In order to get the cursor blinking if QComboBox::setEditable is called when the combobox has focus
if (hasFocus()) {
d->control->setCursorBlinkPeriod(QApplication::cursorFlashTime());
QStyleOptionFrameV2 opt;
initStyleOption(&opt);
if ((!hasSelectedText() && d->control->preeditAreaText().isEmpty())
|| style()->styleHint(QStyle::SH_BlinkCursorWhenTextSelected, &opt, this))
d->setCursorVisible(true);
}
}
#ifdef QT_KEYPAD_NAVIGATION
if (QApplication::keypadNavigationEnabled()) {
if (e->type() == QEvent::EnterEditFocus) {
end(false);
d->setCursorVisible(true);
d->control->setCursorBlinkPeriod(QApplication::cursorFlashTime());
} else if (e->type() == QEvent::LeaveEditFocus) {
d->setCursorVisible(false);
d->control->setCursorBlinkPeriod(0);
if (d->control->hasAcceptableInput() || d->control->fixup())
emit editingFinished();
}
}
#endif
return QWidget::event(e);
}
/*! \reimp
*/
void QLineEdit::mousePressEvent(QMouseEvent* e)
{
Q_D(QLineEdit);
if (d->sendMouseEventToInputContext(e))
return;
if (e->button() == Qt::RightButton)
return;
#ifdef QT_KEYPAD_NAVIGATION
if (QApplication::keypadNavigationEnabled() && !hasEditFocus()) {
setEditFocus(true);
// Get the completion list to pop up.
if (d->control->completer())
d->control->completer()->complete();
}
#endif
if (d->tripleClickTimer.isActive() && (e->pos() - d->tripleClick).manhattanLength() <
QApplication::startDragDistance()) {
selectAll();
return;
}
bool mark = e->modifiers() & Qt::ShiftModifier;
int cursor = d->xToPos(e->pos().x());
#ifndef QT_NO_DRAGANDDROP
if (!mark && d->dragEnabled && d->control->echoMode() == Normal &&
e->button() == Qt::LeftButton && d->control->inSelection(e->pos().x())) {
d->dndPos = e->pos();
if (!d->dndTimer.isActive())
d->dndTimer.start(QApplication::startDragTime(), this);
} else
#endif
{
d->control->moveCursor(cursor, mark);
}
}
/*! \reimp
*/
void QLineEdit::mouseMoveEvent(QMouseEvent * e)
{
Q_D(QLineEdit);
if (d->sendMouseEventToInputContext(e))
return;
if (e->buttons() & Qt::LeftButton) {
#ifndef QT_NO_DRAGANDDROP
if (d->dndTimer.isActive()) {
if ((d->dndPos - e->pos()).manhattanLength() > QApplication::startDragDistance())
d->drag();
} else
#endif
{
d->control->moveCursor(d->xToPos(e->pos().x()), true);
}
}
}
/*! \reimp
*/
void QLineEdit::mouseReleaseEvent(QMouseEvent* e)
{
Q_D(QLineEdit);
if (d->sendMouseEventToInputContext(e))
return;
#ifndef QT_NO_DRAGANDDROP
if (e->button() == Qt::LeftButton) {
if (d->dndTimer.isActive()) {
d->dndTimer.stop();
deselect();
return;
}
}
#endif
#ifndef QT_NO_CLIPBOARD
if (QApplication::clipboard()->supportsSelection()) {
if (e->button() == Qt::LeftButton) {
d->control->copy(QClipboard::Selection);
} else if (!d->control->isReadOnly() && e->button() == Qt::MidButton) {
deselect();
insert(QApplication::clipboard()->text(QClipboard::Selection));
}
}
#endif
if (!isReadOnly() && rect().contains(e->pos()))
d->handleSoftwareInputPanel(e->button(), d->clickCausedFocus);
d->clickCausedFocus = 0;
}
/*! \reimp
*/
void QLineEdit::mouseDoubleClickEvent(QMouseEvent* e)
{
Q_D(QLineEdit);
if (d->sendMouseEventToInputContext(e))
return;
if (e->button() == Qt::LeftButton) {
d->control->selectWordAtPos(d->xToPos(e->pos().x()));
d->tripleClickTimer.start(QApplication::doubleClickInterval(), this);
d->tripleClick = e->pos();
}
}
/*!
\fn void QLineEdit::returnPressed()
This signal is emitted when the Return or Enter key is pressed.
Note that if there is a validator() or inputMask() set on the line
edit, the returnPressed() signal will only be emitted if the input
follows the inputMask() and the validator() returns
QValidator::Acceptable.
*/
/*!
\fn void QLineEdit::editingFinished()
This signal is emitted when the Return or Enter key is pressed or
the line edit loses focus. Note that if there is a validator() or
inputMask() set on the line edit and enter/return is pressed, the
editingFinished() signal will only be emitted if the input follows
the inputMask() and the validator() returns QValidator::Acceptable.
*/
/*!
Converts the given key press \a event into a line edit action.
If Return or Enter is pressed and the current text is valid (or
can be \link QValidator::fixup() made valid\endlink by the
validator), the signal returnPressed() is emitted.
The default key bindings are listed in the class's detailed
description.
*/
void QLineEdit::keyPressEvent(QKeyEvent *event)
{
Q_D(QLineEdit);
#ifdef QT_KEYPAD_NAVIGATION
bool select = false;
switch (event->key()) {
case Qt::Key_Select:
if (QApplication::keypadNavigationEnabled()) {
if (hasEditFocus()) {
setEditFocus(false);
if (d->control->completer() && d->control->completer()->popup()->isVisible())
d->control->completer()->popup()->hide();
select = true;
}
}
break;
case Qt::Key_Back:
case Qt::Key_No:
if (!QApplication::keypadNavigationEnabled() || !hasEditFocus()) {
event->ignore();
return;
}
break;
default:
if (QApplication::keypadNavigationEnabled()) {
if (!hasEditFocus() && !(event->modifiers() & Qt::ControlModifier)) {
if (!event->text().isEmpty() && event->text().at(0).isPrint()
&& !isReadOnly())
{
setEditFocus(true);
#ifndef Q_OS_SYMBIAN
clear();
#endif
} else {
event->ignore();
return;
}
}
}
}
if (QApplication::keypadNavigationEnabled() && !select && !hasEditFocus()) {
setEditFocus(true);
if (event->key() == Qt::Key_Select)
return; // Just start. No action.
}
#endif
d->control->processKeyEvent(event);
if (event->isAccepted())
d->control->setCursorBlinkPeriod(0);
}
/*!
\since 4.4
Returns a rectangle that includes the lineedit cursor.
*/
QRect QLineEdit::cursorRect() const
{
Q_D(const QLineEdit);
return d->cursorRect();
}
/*! \reimp
*/
void QLineEdit::inputMethodEvent(QInputMethodEvent *e)
{
Q_D(QLineEdit);
if (d->control->isReadOnly()) {
e->ignore();
return;
}
if (echoMode() == PasswordEchoOnEdit && !d->control->passwordEchoEditing()) {
// Clear the edit and reset to normal echo mode while entering input
// method data; the echo mode switches back when the edit loses focus.
// ### changes a public property, resets current content.
d->updatePasswordEchoEditing(true);
clear();
}
#ifdef QT_KEYPAD_NAVIGATION
// Focus in if currently in navigation focus on the widget
// Only focus in on preedits, to allow input methods to
// commit text as they focus out without interfering with focus
if (QApplication::keypadNavigationEnabled()
&& hasFocus() && !hasEditFocus()
&& !e->preeditString().isEmpty()) {
setEditFocus(true);
#ifndef Q_OS_SYMBIAN
selectAll(); // so text is replaced rather than appended to
#endif
}
#endif
d->control->processInputMethodEvent(e);
#ifndef QT_NO_COMPLETER
if (!e->commitString().isEmpty())
d->control->complete(Qt::Key_unknown);
#endif
}
/*!\reimp
*/
QVariant QLineEdit::inputMethodQuery(Qt::InputMethodQuery property) const
{
Q_D(const QLineEdit);
switch(property) {
case Qt::ImMicroFocus:
return d->cursorRect();
case Qt::ImFont:
return font();
case Qt::ImCursorPosition:
return QVariant(d->control->cursor());
case Qt::ImSurroundingText:
return QVariant(text());
case Qt::ImCurrentSelection:
return QVariant(selectedText());
case Qt::ImMaximumTextLength:
return QVariant(maxLength());
case Qt::ImAnchorPosition:
if (d->control->selectionStart() == d->control->selectionEnd())
return QVariant(d->control->cursor());
else if (d->control->selectionStart() == d->control->cursor())
return QVariant(d->control->selectionEnd());
else
return QVariant(d->control->selectionStart());
default:
return QVariant();
}
}
/*!\reimp
*/
void QLineEdit::focusInEvent(QFocusEvent *e)
{
Q_D(QLineEdit);
if (e->reason() == Qt::TabFocusReason ||
e->reason() == Qt::BacktabFocusReason ||
e->reason() == Qt::ShortcutFocusReason) {
if (!d->control->inputMask().isEmpty())
d->control->moveCursor(d->control->nextMaskBlank(0));
else if (!d->control->hasSelectedText())
selectAll();
} else if (e->reason() == Qt::MouseFocusReason) {
d->clickCausedFocus = 1;
}
#ifdef QT_KEYPAD_NAVIGATION
if (!QApplication::keypadNavigationEnabled() || (hasEditFocus() && ( e->reason() == Qt::PopupFocusReason
#ifdef Q_OS_SYMBIAN
|| e->reason() == Qt::ActiveWindowFocusReason
#endif
))) {
#endif
d->control->setCursorBlinkPeriod(QApplication::cursorFlashTime());
QStyleOptionFrameV2 opt;
initStyleOption(&opt);
if((!hasSelectedText() && d->control->preeditAreaText().isEmpty())
|| style()->styleHint(QStyle::SH_BlinkCursorWhenTextSelected, &opt, this))
d->setCursorVisible(true);
#ifdef Q_WS_MAC
if (d->control->echoMode() == Password || d->control->echoMode() == NoEcho)
qt_mac_secure_keyboard(true);
#endif
#ifdef QT_KEYPAD_NAVIGATION
d->control->setCancelText(d->control->text());
}
#endif
#ifndef QT_NO_COMPLETER
if (d->control->completer()) {
d->control->completer()->setWidget(this);
QObject::connect(d->control->completer(), SIGNAL(activated(QString)),
this, SLOT(setText(QString)));
QObject::connect(d->control->completer(), SIGNAL(highlighted(QString)),
this, SLOT(_q_completionHighlighted(QString)));
}
#endif
update();
}
/*!\reimp
*/
void QLineEdit::focusOutEvent(QFocusEvent *e)
{
Q_D(QLineEdit);
if (d->control->passwordEchoEditing()) {
// Reset the echomode back to PasswordEchoOnEdit when the widget loses
// focus.
d->updatePasswordEchoEditing(false);
}
Qt::FocusReason reason = e->reason();
if (reason != Qt::ActiveWindowFocusReason &&
reason != Qt::PopupFocusReason)
deselect();
d->setCursorVisible(false);
d->control->setCursorBlinkPeriod(0);
#ifdef QT_KEYPAD_NAVIGATION
// editingFinished() is already emitted on LeaveEditFocus
if (!QApplication::keypadNavigationEnabled())
#endif
if (reason != Qt::PopupFocusReason
|| !(QApplication::activePopupWidget() && QApplication::activePopupWidget()->parentWidget() == this)) {
if (hasAcceptableInput() || d->control->fixup())
emit editingFinished();
#ifdef QT3_SUPPORT
emit lostFocus();
#endif
}
#ifdef Q_WS_MAC
if (d->control->echoMode() == Password || d->control->echoMode() == NoEcho)
qt_mac_secure_keyboard(false);
#endif
#ifdef QT_KEYPAD_NAVIGATION
d->control->setCancelText(QString());
#endif
#ifndef QT_NO_COMPLETER
if (d->control->completer()) {
QObject::disconnect(d->control->completer(), 0, this, 0);
}
#endif
update();
}
/*!\reimp
*/
void QLineEdit::paintEvent(QPaintEvent *)
{
Q_D(QLineEdit);
QPainter p(this);
QRect r = rect();
QPalette pal = palette();
QStyleOptionFrameV2 panel;
initStyleOption(&panel);
style()->drawPrimitive(QStyle::PE_PanelLineEdit, &panel, &p, this);
r = style()->subElementRect(QStyle::SE_LineEditContents, &panel, this);
r.setX(r.x() + d->leftTextMargin);
r.setY(r.y() + d->topTextMargin);
r.setRight(r.right() - d->rightTextMargin);
r.setBottom(r.bottom() - d->bottomTextMargin);
p.setClipRect(r);
QFontMetrics fm = fontMetrics();
Qt::Alignment va = QStyle::visualAlignment(layoutDirection(), QFlag(d->alignment));
switch (va & Qt::AlignVertical_Mask) {
case Qt::AlignBottom:
d->vscroll = r.y() + r.height() - fm.height() - d->verticalMargin;
break;
case Qt::AlignTop:
d->vscroll = r.y() + d->verticalMargin;
break;
default:
//center
d->vscroll = r.y() + (r.height() - fm.height() + 1) / 2;
break;
}
QRect lineRect(r.x() + d->horizontalMargin, d->vscroll, r.width() - 2*d->horizontalMargin, fm.height());
if (d->control->text().isEmpty()) {
if (!hasFocus() && !d->placeholderText.isEmpty()) {
QColor col = pal.text().color();
col.setAlpha(128);
QPen oldpen = p.pen();
p.setPen(col);
p.drawText(lineRect, va, d->placeholderText);
p.setPen(oldpen);
return;
}
}
int cix = qRound(d->control->cursorToX());
// horizontal scrolling. d->hscroll is the left indent from the beginning
// of the text line to the left edge of lineRect. we update this value
// depending on the delta from the last paint event; in effect this means
// the below code handles all scrolling based on the textline (widthUsed,
// minLB, minRB), the line edit rect (lineRect) and the cursor position
// (cix).
int minLB = qMax(0, -fm.minLeftBearing());
int minRB = qMax(0, -fm.minRightBearing());
int widthUsed = qRound(d->control->naturalTextWidth()) + 1 + minRB;
if ((minLB + widthUsed) <= lineRect.width()) {
// text fits in lineRect; use hscroll for alignment
switch (va & ~(Qt::AlignAbsolute|Qt::AlignVertical_Mask)) {
case Qt::AlignRight:
d->hscroll = widthUsed - lineRect.width() + 1;
break;
case Qt::AlignHCenter:
d->hscroll = (widthUsed - lineRect.width()) / 2;
break;
default:
// Left
d->hscroll = 0;
break;
}
d->hscroll -= minLB;
} else if (cix - d->hscroll >= lineRect.width()) {
// text doesn't fit, cursor is to the right of lineRect (scroll right)
d->hscroll = cix - lineRect.width() + 1;
} else if (cix - d->hscroll < 0 && d->hscroll < widthUsed) {
// text doesn't fit, cursor is to the left of lineRect (scroll left)
d->hscroll = cix;
} else if (widthUsed - d->hscroll < lineRect.width()) {
// text doesn't fit, text document is to the left of lineRect; align
// right
d->hscroll = widthUsed - lineRect.width() + 1;
}
// the y offset is there to keep the baseline constant in case we have script changes in the text.
QPoint topLeft = lineRect.topLeft() - QPoint(d->hscroll, d->control->ascent() - fm.ascent());
// draw text, selections and cursors
#ifndef QT_NO_STYLE_STYLESHEET
if (QStyleSheetStyle* cssStyle = qobject_cast<QStyleSheetStyle*>(style())) {
cssStyle->styleSheetPalette(this, &panel, &pal);
}
#endif
p.setPen(pal.text().color());
int flags = QLineControl::DrawText;
#ifdef QT_KEYPAD_NAVIGATION
if (!QApplication::keypadNavigationEnabled() || hasEditFocus())
#endif
if (d->control->hasSelectedText() || (d->cursorVisible && !d->control->inputMask().isEmpty() && !d->control->isReadOnly())){
flags |= QLineControl::DrawSelections;
// Palette only used for selections/mask and may not be in sync
if(d->control->palette() != pal)
d->control->setPalette(pal);
}
// Asian users see an IM selection text as cursor on candidate
// selection phase of input method, so the ordinary cursor should be
// invisible if we have a preedit string.
if (d->cursorVisible && !d->control->isReadOnly())
flags |= QLineControl::DrawCursor;
d->control->setCursorWidth(style()->pixelMetric(QStyle::PM_TextCursorWidth));
d->control->draw(&p, topLeft, r, flags);
}
#ifndef QT_NO_DRAGANDDROP
/*!\reimp
*/
void QLineEdit::dragMoveEvent(QDragMoveEvent *e)
{
Q_D(QLineEdit);
if (!d->control->isReadOnly() && e->mimeData()->hasFormat(QLatin1String("text/plain"))) {
e->acceptProposedAction();
d->control->moveCursor(d->xToPos(e->pos().x()), false);
d->cursorVisible = true;
update();
}
}
/*!\reimp */
void QLineEdit::dragEnterEvent(QDragEnterEvent * e)
{
QLineEdit::dragMoveEvent(e);
}
/*!\reimp */
void QLineEdit::dragLeaveEvent(QDragLeaveEvent *)
{
Q_D(QLineEdit);
if (d->cursorVisible) {
d->cursorVisible = false;
update();
}
}
/*!\reimp */
void QLineEdit::dropEvent(QDropEvent* e)
{
Q_D(QLineEdit);
QString str = e->mimeData()->text();
if (!str.isNull() && !d->control->isReadOnly()) {
if (e->source() == this && e->dropAction() == Qt::CopyAction)
deselect();
int cursorPos = d->xToPos(e->pos().x());
int selStart = cursorPos;
int oldSelStart = d->control->selectionStart();
int oldSelEnd = d->control->selectionEnd();
d->control->moveCursor(cursorPos, false);
d->cursorVisible = false;
e->acceptProposedAction();
insert(str);
if (e->source() == this) {
if (e->dropAction() == Qt::MoveAction) {
if (selStart > oldSelStart && selStart <= oldSelEnd)
setSelection(oldSelStart, str.length());
else if (selStart > oldSelEnd)
setSelection(selStart - str.length(), str.length());
else
setSelection(selStart, str.length());
} else {
setSelection(selStart, str.length());
}
}
} else {
e->ignore();
update();
}
}
#endif // QT_NO_DRAGANDDROP
#ifndef QT_NO_CONTEXTMENU
/*!
Shows the standard context menu created with
createStandardContextMenu().
If you do not want the line edit to have a context menu, you can set
its \l contextMenuPolicy to Qt::NoContextMenu. If you want to
customize the context menu, reimplement this function. If you want
to extend the standard context menu, reimplement this function, call
createStandardContextMenu() and extend the menu returned.
\snippet doc/src/snippets/code/src_gui_widgets_qlineedit.cpp 0
The \a event parameter is used to obtain the position where
the mouse cursor was when the event was generated.
\sa setContextMenuPolicy()
*/
void QLineEdit::contextMenuEvent(QContextMenuEvent *event)
{
QPointer<QMenu> menu = createStandardContextMenu();
menu->exec(event->globalPos());
delete menu;
}
#if defined(Q_WS_WIN)
extern bool qt_use_rtl_extensions;
#endif
/*! This function creates the standard context menu which is shown
when the user clicks on the line edit with the right mouse
button. It is called from the default contextMenuEvent() handler.
The popup menu's ownership is transferred to the caller.
*/
QMenu *QLineEdit::createStandardContextMenu()
{
Q_D(QLineEdit);
QMenu *popup = new QMenu(this);
popup->setObjectName(QLatin1String("qt_edit_menu"));
QAction *action = 0;
if (!isReadOnly()) {
action = popup->addAction(QLineEdit::tr("&Undo") + ACCEL_KEY(QKeySequence::Undo));
action->setEnabled(d->control->isUndoAvailable());
connect(action, SIGNAL(triggered()), SLOT(undo()));
action = popup->addAction(QLineEdit::tr("&Redo") + ACCEL_KEY(QKeySequence::Redo));
action->setEnabled(d->control->isRedoAvailable());
connect(action, SIGNAL(triggered()), SLOT(redo()));
popup->addSeparator();
}
#ifndef QT_NO_CLIPBOARD
if (!isReadOnly()) {
action = popup->addAction(QLineEdit::tr("Cu&t") + ACCEL_KEY(QKeySequence::Cut));
action->setEnabled(!d->control->isReadOnly() && d->control->hasSelectedText()
&& d->control->echoMode() == QLineEdit::Normal);
connect(action, SIGNAL(triggered()), SLOT(cut()));
}
action = popup->addAction(QLineEdit::tr("&Copy") + ACCEL_KEY(QKeySequence::Copy));
action->setEnabled(d->control->hasSelectedText()
&& d->control->echoMode() == QLineEdit::Normal);
connect(action, SIGNAL(triggered()), SLOT(copy()));
if (!isReadOnly()) {
action = popup->addAction(QLineEdit::tr("&Paste") + ACCEL_KEY(QKeySequence::Paste));
action->setEnabled(!d->control->isReadOnly() && !QApplication::clipboard()->text().isEmpty());
connect(action, SIGNAL(triggered()), SLOT(paste()));
}
#endif
if (!isReadOnly()) {
action = popup->addAction(QLineEdit::tr("Delete"));
action->setEnabled(!d->control->isReadOnly() && !d->control->text().isEmpty() && d->control->hasSelectedText());
connect(action, SIGNAL(triggered()), d->control, SLOT(_q_deleteSelected()));
}
if (!popup->isEmpty())
popup->addSeparator();
action = popup->addAction(QLineEdit::tr("Select All") + ACCEL_KEY(QKeySequence::SelectAll));
action->setEnabled(!d->control->text().isEmpty() && !d->control->allSelected());
d->selectAllAction = action;
connect(action, SIGNAL(triggered()), SLOT(selectAll()));
#if !defined(QT_NO_IM)
QInputContext *qic = inputContext();
if (qic) {
QList<QAction *> imActions = qic->actions();
for (int i = 0; i < imActions.size(); ++i)
popup->addAction(imActions.at(i));
}
#endif
#if defined(Q_WS_WIN)
if (!d->control->isReadOnly() && qt_use_rtl_extensions) {
#else
if (!d->control->isReadOnly()) {
#endif
popup->addSeparator();
QUnicodeControlCharacterMenu *ctrlCharacterMenu = new QUnicodeControlCharacterMenu(this, popup);
popup->addMenu(ctrlCharacterMenu);
}
return popup;
}
#endif // QT_NO_CONTEXTMENU
/*! \reimp */
void QLineEdit::changeEvent(QEvent *ev)
{
Q_D(QLineEdit);
switch(ev->type())
{
case QEvent::ActivationChange:
if (!palette().isEqual(QPalette::Active, QPalette::Inactive))
update();
break;
case QEvent::FontChange:
d->control->setFont(font());
break;
case QEvent::StyleChange:
{
QStyleOptionFrameV2 opt;
initStyleOption(&opt);
d->control->setPasswordCharacter(style()->styleHint(QStyle::SH_LineEdit_PasswordCharacter, &opt, this));
}
update();
break;
case QEvent::LayoutDirectionChange:
d->control->setLayoutDirection(layoutDirection());
break;
default:
break;
}
QWidget::changeEvent(ev);
}
/*!
\fn void QLineEdit::repaintArea(int a, int b)
Use update() instead.
*/
/*!
\fn void QLineEdit::cursorLeft(bool mark, int steps)
Use cursorForward() with a negative number of steps instead. For
example, cursorForward(mark, -steps).
*/
/*!
\fn void QLineEdit::cursorRight(bool mark, int steps)
Use cursorForward() instead.
*/
/*!
\fn bool QLineEdit::frame() const
Use hasFrame() instead.
*/
/*!
\fn void QLineEdit::clearValidator()
Use setValidator(0) instead.
*/
/*!
\fn bool QLineEdit::hasMarkedText() const
Use hasSelectedText() instead.
*/
/*!
\fn QString QLineEdit::markedText() const
Use selectedText() instead.
*/
/*!
\fn void QLineEdit::setFrameRect(QRect)
\internal
*/
/*!
\fn QRect QLineEdit::frameRect() const
\internal
*/
/*!
\enum QLineEdit::DummyFrame
\internal
\value Box
\value Sunken
\value Plain
\value Raised
\value MShadow
\value NoFrame
\value Panel
\value StyledPanel
\value HLine
\value VLine
\value GroupBoxPanel
\value WinPanel
\value ToolBarPanel
\value MenuBarPanel
\value PopupPanel
\value LineEditPanel
\value TabWidgetPanel
\value MShape
*/
/*!
\fn void QLineEdit::setFrameShadow(DummyFrame)
\internal
*/
/*!
\fn DummyFrame QLineEdit::frameShadow() const
\internal
*/
/*!
\fn void QLineEdit::setFrameShape(DummyFrame)
\internal
*/
/*!
\fn DummyFrame QLineEdit::frameShape() const
\internal
*/
/*!
\fn void QLineEdit::setFrameStyle(int)
\internal
*/
/*!
\fn int QLineEdit::frameStyle() const
\internal
*/
/*!
\fn int QLineEdit::frameWidth() const
\internal
*/
/*!
\fn void QLineEdit::setLineWidth(int)
\internal
*/
/*!
\fn int QLineEdit::lineWidth() const
\internal
*/
/*!
\fn void QLineEdit::setMargin(int margin)
Sets the width of the margin around the contents of the widget to \a margin.
Use QWidget::setContentsMargins() instead.
\sa margin(), QWidget::setContentsMargins()
*/
/*!
\fn int QLineEdit::margin() const
Returns the width of the margin around the contents of the widget.
Use QWidget::getContentsMargins() instead.
\sa setMargin(), QWidget::getContentsMargins()
*/
/*!
\fn void QLineEdit::setMidLineWidth(int)
\internal
*/
/*!
\fn int QLineEdit::midLineWidth() const
\internal
*/
QT_END_NAMESPACE
#include "moc_qlineedit.cpp"
#endif // QT_NO_LINEEDIT