![]() |
Home · All Classes · Main Classes · Grouped Classes · Modules · Functions | ![]() |
The ObjectDescriptionModel class provides a model from a list of ObjectDescription objects. More...
#include <Phonon>
Inherits QAbstractListModel.
The ObjectDescriptionModel class provides a model from a list of ObjectDescription objects.
ObjectDescriptionModel is a read only model that supplies a list using ObjectDescription::name() for the text and ObjectDescription::description() for the tooltip. If set the properties "icon" and "available" are used to set the decoration and disable the item (disabled only visually, you can still select and drag it).
It also provides the methods moveUp() and moveDown() to order the list. Additionally drag and drop is possible so that QAbstractItemView::InternalMove can be used. The resulting order of the ObjectDescription::index() values can then be retrieved using tupleIndexOrder().
An example use case would be to give the user a QComboBox to select the output device:
QComboBox *cb = new QComboBox(parentWidget); ObjectDescriptionModel *model = new ObjectDescriptionModel(cb); model->setModelData(BackendCapabilities::availableAudioOutputDevices()); cb->setModel(model); cb->setCurrentIndex(0); // select first entry
And to retrieve the selected AudioOutputDevice:
int cbIndex = cb->currentIndex(); AudioOutputDevice selectedDevice = model->modelData(cbIndex);
Author: Matthias Kretz <kretz@kde.org>
Constructs a ObjectDescription model with the given parent.
Constructs a ObjectDescription model with the given parent and the given data.
Returns data from the item with the given index for the specified role. If the view requests an invalid index, an invalid variant is returned.
Reimplemented from QAbstractItemModel.
Reimplemented from QAbstractItemModel.
See also QAbstractItemModel::data and Qt::ItemDataRole.
Accept drops from other models of the same ObjectDescriptionType.
The data is dropped at the given row and column; you also receive the parent model index.
If a valid parent is given the dropped items will be inserted above that item.
Reimplemented from QAbstractItemModel.
Returns a list of supported drag and drop MIME types. Currently it only supports one type used internally.
Reimplemented from QAbstractItemModel.
Returns the model data.
As the order of the list might have changed this can be different to what was set using setModelData().
See also setModelData().
This is an overloaded member function, provided for convenience.
Returns one ObjectDescription of the model data for the given index.
Moves the item at the given index down. In the resulting list the items at index.row() and index.row() + 1 are swapped.
Connected views are updated automatically.
Moves the item at the given index up. In the resulting list the items at index.row() and index.row() - 1 are swapped.
Connected views are updated automatically.
Removes count rows starting with the given row.
If a valid parent is given no rows are removed since this is a list model.
Returns true if the rows were successfully removed; otherwise returns false.
Reimplemented from QAbstractItemModel.
Returns the number of rows in the model. This value corresponds to the size of the list passed through setModelData.
parent The optional parent argument is used in most models to specify the parent of the rows to be counted. Because this is a list if a valid parent is specified the result will always be 0.
Reimplemented from QAbstractItemModel.
Reimplemented from QAbstractItemModel.
See also QAbstractItemModel::rowCount.
Sets the model data using the list provided by data.
All previous model data is cleared.
See also modelData().
This model supports drag and drop to copy or move items.
Reimplemented from QAbstractItemModel.
Returns the ObjectDescription::index for the tuple at the given position positionIndex. For example a QComboBox will give you the currentIndex as the position in the list. But to select the according AudioOutputDevice using AudioOutputDevice::fromIndex you can use this method.
positionIndex The position in the list.
Returns a list of indexes in the same order as they are in the model. The indexes come from the ObjectDescription::index method.
This is useful to let the user define a list of preference.
Copyright © 2008 Trolltech | Trademarks | Qt 4.4.0-beta1 |