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

QCategorySelector Class Reference
[QtBaseModule]

The QCategorySelector widget allows users to select categories for filtering or for applying to an item. More...

    #include <QCategorySelector>

Inherits QWidget.

• List of all members, including inherited members

Public Types

• enum ContentFlag { IncludeAll, IncludeUnfiled, SingleSelection, ListView, ..., ViewMask }
• flags ContentFlags

Public Functions

• QCategorySelector ( QWidget * parent = 0 )
• QCategorySelector ( const QString & scope, ContentFlags f = Editor, QWidget * parent = 0 )
• virtual ~QCategorySelector ()
• QStringList selectedCategories () const
• QCategoryFilter selectedFilter () const

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

Public Slots

• void selectAll ()
• void selectCategories ( const QString & categoryids )
• void selectCategories ( const QStringList & categoryids )
• void selectFilter ( const QCategoryFilter & filter )
• void selectUnfiled ()

• 19 public slots inherited from QWidget
• 1 public slot inherited from QObject

Signals

• void categoriesSelected ( const QList<QString> & list )
• void filterSelected ( const QCategoryFilter & filter )

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

Additional Inherited Members

• 57 properties inherited from QWidget
• 1 property 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 QCategorySelector widget allows users to select categories for filtering or for applying to an item.

QCategorySelector is a widget that shows categories the user can choose from. Its appearance and behavior are determined by flags given to the constructor. Control over the categories that are visible is achieved via the select...() functions.

QCategorySelector automatically updates when the system's categories are changed. It provides an interface for the user to add/edit/delete user categories.

QCategorySelector is typically used as a QCategorySelector::Filter or QCategorySelector::Editor;

Here's an example of using it as a filter.

    MyWidget::MyWidget()
    {
        QCategorySelector *sel = new QCategorySelector( "myappscope", QCategorySelector::Filter );
        connect( sel, SIGNAL(filterSelected(QCategoryFilter)),
                 this, SLOT(filterCategories(QCategoryFilter)) );
        QSettings settings("mycompany", "myapp");
        QCategoryFilter f;
        f.readConfig( settings, "filter" );
        sel->selectFilter( f );
    }

    void MyWidget::filterCategories( const QCategoryFilter &filter )
    {
        QSettings settings("mycompany", "myapp");
        filter.writeConfig( settings, "filter" );
        foreach ( item, itemList )
            item->setVisible( filter.accepted( item->categories() ) );
    }

Here's an example of using QCategorySelector an editor.

    MyWidget::MyWidget( MyRecord *item )
    {
        QCategorySelector *sel = new QCategorySelector( "myappscope", QCategorySelector::Editor );
        sel->selectCategories( item->categories() );
        connect( sel, SIGNAL(categoriesSelected(QList<QString>)),
                 item, SLOT(setCategories(QList<QString>)) );
    }

See also Categories.

Member Type Documentation

enum QCategorySelector::ContentFlag
flags QCategorySelector::ContentFlags

The list view looks like this.

[Missing image qcategoryselector-list.png]

The combo box looks like this.

[Missing image qcategoryselector-combo-down.png]

[Missing image qcategoryselector-combo-up.png]

The button looks like this.

[Missing image qcategoryselector-button.png]

The ContentFlags type is a typedef for QFlags<ContentFlag>. It stores an OR combination of ContentFlag values.

Member Function Documentation

QCategorySelector::QCategorySelector ( QWidget * parent = 0 )

Constructs a QCategorySelector as an editor widget with the given parent.

QCategorySelector::QCategorySelector ( const QString & scope, ContentFlags f = Editor, QWidget * parent = 0 )

Constructs a QCategorySelector with the given parent. Unless it is null, scope limits the categories that can be seen. The flags in f determine the apperance and behavior of the QCategorySelector.

QCategorySelector::~QCategorySelector ()   [virtual]

Destroys a QCategorySelector.

void QCategorySelector::categoriesSelected ( const QList<QString> & list )   [signal]

This signal is emitted when the selected categories changes. The selected categories are indicated by list.

Note that this function does not indicate if All or Unfiled is selected. Use filterSelected() to determine if these items are selected.

void QCategorySelector::filterSelected ( const QCategoryFilter & filter )   [signal]

This signal is emitted when the selected categories changes. The selected categories are indicated by filter.

See also QCategoryFilter::requiredCategories().

void QCategorySelector::selectAll ()   [slot]

Selects the All entry (all categories are selected).

void QCategorySelector::selectCategories ( const QString & categoryids )   [slot]

Selects the categories with identifiers in the comma-separated list categoryids.

void QCategorySelector::selectCategories ( const QStringList & categoryids )   [slot]

This is an overloaded member function, provided for convenience.

Selects the categories with identifiers in list categoryids.

void QCategorySelector::selectFilter ( const QCategoryFilter & filter )   [slot]

Selects the categories specified by filter.

void QCategorySelector::selectUnfiled ()   [slot]

Selects the Unfiled entry (no categories are selected).

QStringList QCategorySelector::selectedCategories () const

Returns the list of selected categories.

Note that this function does not indicate if All or Unfiled is selected. Use selectedFilter() to determine if these items are selected.

QCategoryFilter QCategorySelector::selectedFilter () const

Returns the QCategoryFilter that indicates the selected categories.

See also QCategoryFilter::requiredCategories().