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

QContactSelector Class Reference
[QtMessagingModule, QtPimModule, QtTelephonyModule, QtUiModule]

The QContactSelector class provides a way of selecting a single contact from a QContactModel. More...

    #include <QContactSelector>

Inherits QDialog.

• List of all members, including inherited members

Public Functions

• QContactSelector ( bool showCreateNew, QWidget * parent = 0 )
• QContactSelector ( QWidget * parent = 0 )
• ~QContactSelector ()
• bool contactSelected () const
• virtual bool eventFilter ( QObject * watched, QEvent * event )
• bool newContactSelected () const
• QContact selectedContact () const
• QString selectedText () const
• void setAcceptTextEnabled ( bool enable )
• void setCreateNewContactEnabled ( bool enable )
• void setModel ( QContactModel * model )
• bool textSelected () const

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

Signals

• void contactSelected ( const QContact & contact )
• void textSelected ( const QString & text )

• 3 signals inherited from QDialog
• 1 signal inherited from QWidget
• 1 signal inherited from QObject

Additional Inherited Members

• 2 properties inherited from QDialog
• 57 properties inherited from QWidget
• 1 property inherited from QObject
• 4 public slots inherited from QDialog
• 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 QContactSelector class provides a way of selecting a single contact from a QContactModel.

In addition, the user can optionally be allowed to indicate they want to create a new contact, if none of the existing contacts are suitable.

The following image displays a QContactSelector with the option to create a new QContact highlighted.

See also Pim Library.

Member Function Documentation

QContactSelector::QContactSelector ( bool showCreateNew, QWidget * parent = 0 )

Constructs a QContactSelector with parent parent. If showCreateNew is true an action will be include to allow the user to create new contacts.

See also setCreateNewContactEnabled().

QContactSelector::QContactSelector ( QWidget * parent = 0 )

Contructs a QContactSelector with parent parent.

QContactSelector::~QContactSelector ()

Destroys a QContactSelector.

bool QContactSelector::contactSelected () const

Returns true if the dialog was accepted with an existing contact selected. Otherwise returns false.

See also newContactSelected().

void QContactSelector::contactSelected ( const QContact & contact )   [signal]

This is an overloaded member function, provided for convenience.

When selection of a contact occurs, this signal is emitted with the contact selected.

See also selectedContact().

bool QContactSelector::eventFilter ( QObject * watched, QEvent * event )   [virtual]

Filters events if this object has been installed as an event filter for the watched object. Returns true if the event is filtered. Otherwise returns false.

Reimplemented from QObject.

bool QContactSelector::newContactSelected () const

Returns true if the dialog was accepted via the option to create a new contact. Otherwise returns false.

See also contactSelected().

QContact QContactSelector::selectedContact () const

Returns the contact that was selected. If no contact was selected returns a null contact.

See also contactSelected() and newContactSelected().

QString QContactSelector::selectedText () const

Returns the text entered when the dialog was accepted. Requires that accept on text is enabled.

See also setAcceptTextEnabled().

void QContactSelector::setAcceptTextEnabled ( bool enable )

If enable is true pressing select while filter text will accept the dialog even if no contact from the list is selected.

void QContactSelector::setCreateNewContactEnabled ( bool enable )

If enable is true an action to create new contacts will be visible in the context menu. Otherwise the action to create new contacts will be hidden.

void QContactSelector::setModel ( QContactModel * model )

Sets the model providing the choice of contacts to model.

bool QContactSelector::textSelected () const

Returns true if the dialog was accepted with filter text entered but no contact selected.

void QContactSelector::textSelected ( const QString & text )   [signal]

This is an overloaded member function, provided for convenience.

When the dialog is accepted with text entered, this signal is emitted with the text previously entered.

See also selectedText().