Home · All Namespaces · All Classes · Grouped Classes · Modules · Functions

QTextEntryProxy Class Reference
[QtBaseModule]

The QTextEntryProxy class provides a text entry widget for overlaying list widgets. More...

    #include <QTextEntryProxy>

This class is under development and is subject to change.

Inherits QWidget.

This class was introduced in Qtopia 4.3.

• List of all members, including inherited members

Public Functions

• QTextEntryProxy ( QWidget * parent, QWidget * target )
• ~QTextEntryProxy ()
• void clear ()
• void setTarget ( QWidget * target )
• QString text () const

• 206 public functions inherited from QWidget
• 29 public functions inherited from QObject
• 14 public functions inherited from QPaintDevice

Signals

• void textChanged ( const QString & text )

• 1 signal inherited from QWidget
• 1 signal inherited from QObject

Additional Inherited Members

• 57 properties inherited from QWidget
• 1 property inherited from QObject
• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject
• 1 public type inherited from QObject
• 4 static public members inherited from QWidget
• 4 static public members inherited from QObject
• 38 protected functions inherited from QWidget
• 7 protected functions inherited from QObject
• 1 protected function inherited from QPaintDevice
• 1 protected slot inherited from QWidget
• 2 protected variables inherited from QObject
• 1 protected type inherited from QPaintDevice

Detailed Description

The QTextEntryProxy class provides a text entry widget for overlaying list widgets.

QTextEntryProxy is a helper widget for overlaying on listboxes (or other widgets) which need a text based display of the currently entered text, whilst still allowing the proxied widget to retain focus.

    QTextEntryProxy *textEntry = new QTextEntryProxy(this, listbox);

    int mFindHeight = textEntry->sizeHint().height();
    QLabel *findIcon = new QLabel;
    findIcon->setPixmap(QIcon(":icon/find").pixmap(mFindHeight-2, mFindHeight-2));
    findIcon->setMargin(2);
    findIcon->setFocusPolicy(Qt::NoFocus);

    QHBoxLayout *findLayout = new QHBoxLayout;
    findLayout->addWidget(findIcon);
    findLayout->addWidget(textEntry);
    qobject_cast<QVBoxLayout*>(this->layout())->addLayout(findLayout);

    connect(textEntry, SIGNAL(textChanged(QString)), this, SLOT(textEntrytextChanged(QString)));

To Note: QTextEntryProxy has no way of determining what the SoftMenuBar context labels are/were, so it will replace the back key location with QSoftMenuBar::Back when no text is displayed by the object. As this handles 90% of use cases, no further work is scheduled on this until necessary.

See also setTarget().

Member Function Documentation

QTextEntryProxy::QTextEntryProxy ( QWidget * parent, QWidget * target )

Constructs a new text entry proxy object setting parent and target widgets.

QTextEntryProxy::~QTextEntryProxy ()

Destroys this object

void QTextEntryProxy::clear ()

Deletes all the text in the text entry.

void QTextEntryProxy::setTarget ( QWidget * target )

Sets the target of this object. This involves creating an event filter on the target object, so that it can filter events that it is interested in. If this object was previously targeted at another widget, it removes the eventfilters placed upon the original object.

QString QTextEntryProxy::text () const

Returns the current text displayed in the widget

void QTextEntryProxy::textChanged ( const QString & text )   [signal]

This signal is emitted whenever the text for this control is updated via user input to the target control.