QwwButtonLineEdit Class
A QLineEdit with an integrated customizable button. More...
Header: | #include <QwwButtonLineEdit> |
Inherited By: |
Public Types
enum | Position { None, RightOutside, RightInside, LeftOutside, LeftInside } |
Properties
|
|
Public Functions
QwwButtonLineEdit(QWidget * parent = 0) | |
QwwButtonLineEdit(const QString & contents, QWidget * parent = 0) | |
bool | autoRaise() const |
Qt::FocusPolicy | buttonFocusPolicy() const |
bool | buttonIsVisible() const |
Position | buttonPosition() const |
QIcon | icon() const |
QString | placeholderText() const |
QString | regExp() const |
void | setButtonFocusPolicy(Qt::FocusPolicy) |
void | setButtonPosition(Position pos) |
Public Slots
void | setAutoRaise(bool) |
void | setButtonVisible(bool) |
void | setIcon(const QIcon &) |
void | setPlaceholderText(const QString &) |
void | setRegExp(const QString & v) |
void | setRegExp(const QRegExp & rx) |
Signals
void | buttonClicked() |
void | validatorChanged(const QString & regexp) |
Protected Functions
QToolButton * | button() const |
void | paintEvent(QPaintEvent * pe) |
Detailed Description
A QLineEdit with an integrated customizable button.
The control is a line edit that contains a tool button can hold an icon and can be set either on the right or the left side of the line edit and can occupy space inside or outside the line edit.
It can be used to associate an easy to access action with the line edit, i.e. that will modify contents of the box in a definable way.
Using QWidget::addAction() one can associate more than one action with the button.
Member Type Documentation
enum QwwButtonLineEdit::Position
Constant | Value | Description |
---|---|---|
QwwButtonLineEdit::None | 0 | Button is not visible |
QwwButtonLineEdit::RightOutside | 1 | Button is positioned on the right side of the line edit. |
QwwButtonLineEdit::RightInside | 2 | Button is positioned inside the line edit on the right. |
QwwButtonLineEdit::LeftOutside | 3 | Button is positioned on the left side of the line edit. |
QwwButtonLineEdit::LeftInside | 4 | Button is positioned inside the line edit on the left. |
Property Documentation
autoRaise : bool
This property holds this property holds whether auto-raising is enabled or not.
The default is disabled (i.e. false).
This property is currently ignored on Mac OS X when using QMacStyle.
Access functions:
bool | autoRaise() const |
void | setAutoRaise(bool) |
buttonFocusPolicy : Qt::FocusPolicy
This property holds this property allows to specify the focus policy for the button that accompanies the line edit.
Access functions:
Qt::FocusPolicy | buttonFocusPolicy() const |
void | setButtonFocusPolicy(Qt::FocusPolicy) |
buttonPosition : Position
This property holds the position of the button relative to the line edit.
Access functions:
Position | buttonPosition() const |
void | setButtonPosition(Position pos) |
buttonVisible : bool
This property holds information whether the button is visible.
Access functions:
bool | buttonIsVisible() const |
void | setButtonVisible(bool) |
See also button() and buttonPosition.
icon : QIcon
This property holds the icon shown on the button
Access functions:
QIcon | icon() const |
void | setIcon(const QIcon &) |
placeholderText : QString
This property holds this property holds 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.
By default, this property contains an empty string.
Access functions:
QString | placeholderText() const |
void | setPlaceholderText(const QString &) |
regExp : QString
This property holds the regular expression used to validate contents of the widget
Access functions:
QString | regExp() const |
void | setRegExp(const QString & v) |
void | setRegExp(const QRegExp & rx) |
Member Function Documentation
QwwButtonLineEdit::QwwButtonLineEdit(QWidget * parent = 0)
Constructs a button line edit with a given parent.
QwwButtonLineEdit::QwwButtonLineEdit(const QString & contents, QWidget * parent = 0)
Constructs a button line edit with a given parent and sets its text to contents.
QToolButton * QwwButtonLineEdit::button() const [protected]
Returns a pointer to the button.
void QwwButtonLineEdit::buttonClicked() [signal]
This signal is emitted when the button is clicked.
void QwwButtonLineEdit::paintEvent(QPaintEvent * pe) [protected]
*
void QwwButtonLineEdit::validatorChanged(const QString & regexp) [signal]
Signal emitted when the validator of the line edit changes to regexp