ListCategorizer Class Reference
This Widget extends KListView for a particular purpose: sorting some items into some bins. More...
#include <listCat.h>
Public Member Functions | |
ListCategorizer (QWidget *parent, const char *name=0) | |
ListCategorizer (const QStringList &categories, bool startOpen, QWidget *parent, const char *name=0) | |
void | addCategories (const QStringList &) |
QListViewItem * | addCategory (const QString &name, const QString &description=QString::null) |
QStringList | categories () const |
QListViewItem * | addItem (const QString &category, const QString &name, const QString &description=QString::null) |
QStringList | items (const QString &category, int column=0) const |
QListViewItem * | findCategory (const QString &categoryName) const |
Detailed Description
This Widget extends KListView for a particular purpose: sorting some items into some bins.This can be useful for putting items in an enabled / disabled state, or into categories, or configuring toolbars (putting icons onto toolbars).
You can use all of the standard KListView signals and slots. You may in particular want to change the names of the columns, for example:
ListCategorizer *lc = new ListCategorizer(this,colors); lc->setColumnText(0,i18n("Color")); lc->setColumnText(1,i18n("HTML")); QListViewItem *stdKDE = lc->addCategory(i18n("Standard KDE")); (void) new QListViewItem(stdKDE,i18n("red"),"#FF0000");to set sensible column headers for a list of colors and their HTML equivalents (although why you would want to categorize colors is beyond me).
- Version:
- Id
- listCat.h,v 1.11 2003/03/20 21:08:56 adridg Exp
Definition at line 62 of file listCat.h.
Constructor & Destructor Documentation
|
Constructor.
This creates a new empty ListCategorizer with startOpen set to false. The parameters Definition at line 42 of file listCat.cc. References ListCategorizer(). Referenced by ListCategorizer(). |
|
Constructor.
This creates a ListCategorizer with the given Definition at line 52 of file listCat.cc. References addCategories(), and ListCategorizer(). |
Member Function Documentation
|
Add a list of categories to the ListCategorizer. All the categories are added without descriptions; use on a per-category basis for that. Definition at line 63 of file listCat.cc. References addCategories(), and addCategory(). Referenced by addCategories(), and ListCategorizer(). |
|
Add a category with name This can be useful if you want either a description for the category or want to refer to this category in the future without using findCategory(). the QListViewItem created for the category Definition at line 74 of file listCat.cc. References addCategory(). Referenced by addCategories(), and addCategory(). |
|
Returns the list of names of the categories in the ListCategorizer.
|
|
Add a single item to the category named This might be a convenience function, but it's probably more convenient to just use QListViewItem's constructor. That way you can also hide more data in the remaining columns. Definition at line 178 of file listCat.cc. References addItem(), and findCategory(). Referenced by addItem(). |
|
Returns the list of strings in column
You can do this to get, for example the names of all the items categorized under a given category, or, more usefully, set Definition at line 133 of file listCat.h. References findCategory(), and items(). Referenced by items(). |
|
Given a category return the QListViewItem that represents that category. Probably a useless function, since just remembering the pointer addCategory gives you is faster and uses hardly any memory. Definition at line 163 of file listCat.cc. References findCategory(). Referenced by addItem(), findCategory(), and items(). |
The documentation for this class was generated from the following files: