En esta página

QRangeModel::RowOptions Struct

template <typename T> struct QRangeModel::RowOptions

La plantilla RowOptions ofrece un punto de personalización para controlar cómo representa QRangeModel los tipos utilizados como filas. Más información...

Esta estructura se introdujo en Qt 6.10.

Miembros públicos estáticos

(since 6.12) bool canDropMimeData(const QMimeData *data)
(since 6.12) bool canDropMimeData(const QMimeData *data, int action, int row, int column, const QModelIndex &parent)
(since 6.12) auto dropMimeData(const QMimeData *data, auto inserter)
(since 6.12) auto dropMimeData(const QMimeData *data, int action, int row, int column, const QModelIndex &parent, auto inserter)
(since 6.12) Qt::ItemFlags flags(const T &row)
(since 6.12) QVariant headerData(int section, int role)
(since 6.12) QMimeData *mimeData(const QModelIndex &range)
(since 6.12) QMimeData *mimeData(const auto &range)
(since 6.12) QStringList mimeTypes()
const QRangeModel::RowCategory rowCategory

Descripción detallada

RowOptions<T> es una plantilla de estructura en la que T especifica el tipo de fila. Especializa esta plantilla para el tipo utilizado en tu rango y añade los miembros pertinentes.

template <>
struct QRangeModel::RowOptions<ColorEntry>
{
    ...
};

Véase también ItemAccess.

Documentación de las funciones de miembro

[static, since 6.12] bool RowOptions::canDropMimeData(const QMimeData *data)

[static, since 6.12] bool RowOptions::canDropMimeData(const QMimeData *data, int action, int row, int column, const QModelIndex &parent)

Implementa uno de estos miembros de clase para indicar si data puede soltarse en el modelo. Si se implementa la versión simplificada, QRangeModel validará que action sea uno de los supported drop actions. En la versión completa, la implementación puede devolver resultados diferentes en función de la posición de la acción de soltar, tal y como se especifica en row, column y parent.

Este miembro es opcional y no es necesario para la personalización de la función de arrastrar y soltar. El comportamiento por defecto comprueba si data contiene alguno de los tipos MIME admitidos.

Estas funciones se introdujeron en Qt 6.12.

Véase también QAbstractItemModel::canDropMimeData().

[static, since 6.12] template <typename inserter:auto> auto RowOptions::dropMimeData(const QMimeData *data, auto inserter)

[static, since 6.12] template <typename inserter:auto> auto RowOptions::dropMimeData(const QMimeData *data, int action, int row, int column, const QModelIndex &parent, auto inserter)

Implementa uno de estos miembros de clase para decodificar las entradas pertinentes de data en una secuencia de filas de tipo T y añade estas filas al modelo asignando cada una de ellas al inserter proporcionado. Devuelve si la operación se ha realizado correctamente.

template <>
struct QRangeModel::RowOptions<ColorEntry>
{
    static bool dropMimeData(const QMimeData *mimeData, auto inserter)
    {
        const QByteArray data = mimeData->data(mimeTypes().first());
        if (data.isEmpty())
            return false;
        QXmlStreamReader stream(data);
        while (!stream.atEnd()) {
            stream.readNext();
            if (stream.isStartElement() && stream.name() == u"li"_s)
                inserter = ColorEntry(stream.readElementText());
        }

        return true;
    }
};

El objeto ` inserter ` se comporta como un ` std::back_insert_iterator ` y puede utilizarse, por ejemplo, con ` std::copy`. Los fragmentos de código anteriores omiten el manejo de errores, lo que quizá requeriría almacenar los elementos descodificados en una lista separada que pudiera descartarse en caso de error. Lo siguiente permitiría trasladar de forma eficiente las filas descodificadas al modelo:

static bool dropMimeData(const QMimeData *mimeData, auto inserter)
{
    QList<ColorEntry> decodedEntries;
    // read stream and populate decodedEntries

    if (stream.hasError())
        return false;
    std::copy(std::move_iterator(decodedRows.begin()), std::move_iterator(decodedRows.end()),
                inserter);
    return true;
}

Opcionalmente, las filas descodificadas pueden emparejarse con el número de fila relativo que deberían ocupar en el rango de filas insertadas.

int row = 0;
for (const auto &decodedRow : decodedRows) {
    inserter = {decodedRow, row};
    row += 2;
}

Esta implementación mantiene una fila vacía entre cada fila descodificada.

Devuelve uno de los valores de DropOperation para proporcionar una indicación a QRangeModel sobre cómo deben aplicarse las filas descartadas al modelo. Como alternativa, basta con devolver true (el equivalente a DropOperation::Automatic) o false (el equivalente a DropOperation::DontDrop).

Estas funciones se introdujeron en Qt 6.12.

Véase también QAbstractItemModel::dropMimeData().

[static, since 6.12] Qt::ItemFlags RowOptions::flags(const T &row)

Implementa este miembro de clase para que devuelva el ` flags ` de todos los elementos de ` row`.

template <>
struct QRangeModel::RowOptions<ColorEntry>
{
    static Qt::ItemFlags flags(const ColorEntry &entry)
    {
        return entry.flags();
    }
};

Esto se sobrescribirá mediante una personalización de ItemAccess::flags.

Si no se proporciona este miembro, QRangeModel calcula los indicadores basándose en el rango a partir del cual se construyó.

Esta función se introdujo en Qt 6.12.

Véase también QAbstractItemModel::flags().

[static, since 6.12] QVariant RowOptions::headerData(int section, int role)

Implementa este miembro de clase para devolver los datos de cabecera que QRangeModel debería devolver para el role del section en la cabecera horizontal.

template <>
struct QRangeModel::RowOptions<ColorEntry>
{
    static QVariant headerData(int section, int role)
    {
        switch (section) {
            // ...
        }
        return {};
    }
};

Si no se proporciona este miembro, QRangeModel devuelve valores por defecto específicos del tipo a partir de la implementación de headerData().

Esta función se introdujo en Qt 6.12.

Véase también QAbstractItemModel::headerData().

[static, since 6.12] QMimeData *RowOptions::mimeData(const QModelIndex &range)

[static, since 6.12] template <typename range:auto> QMimeData *RowOptions::mimeData(const auto &range)

Implementa uno de estos miembros de clase para devolver el ` mime data ` correspondiente a las filas del ` range` facilitado.

Si se proporciona la versión genérica, el iterador sobre range es bidireccional y apunta a un par formado por una fila de tipo T y el correspondiente QModelIndex.

template <>
struct QRangeModel::RowOptions<ColorEntry>
{
    template <typename Items>
    static QMimeData *mimeData(const Items &items)
    {
        if (items.isEmpty())
            return nullptr;
        QByteArray data;
        QXmlStreamWriter stream(&data);
        stream.writeStartElement("ul");
        for (const auto &[item, index] : items)
            stream.writeTextElement("li", item.colorName());
        stream.writeEndElement();

        QMimeData *mimeData = new QMimeData;
        mimeData->setData(mimeTypes().first(), data);
        return mimeData;
    }
};
for (const auto &[row, index] : range) {
    // ...
}

Las filas seleccionadas en su totalidad se incluirán en el rango una sola vez, emparejadas con un index que contiene el número de fila y el padre, y una columna con el valor -1. Las filas seleccionadas parcialmente se incluyen en el rango varias veces, una vez por cada columna seleccionada.

Las entradas de range se ordenan en orden lógico, desde la fila más superior hasta la última, y desde la columna más a la izquierda hasta la última.

Estas funciones se introdujeron en Qt 6.12.

Véase también QAbstractItemModel::mimeData().

[static, since 6.12] QStringList RowOptions::mimeTypes()

Implementa este miembro de clase para devolver la lista de elementos ` mime types ` que un modelo que contenga filas de tipo ` T ` puede utilizar para representar los datos del modelo durante las operaciones de arrastrar y soltar.

template <>
struct QRangeModel::RowOptions<ColorEntry>
{
    static QStringList mimeTypes()
    {
        return {
            u"text/html"_s
        };
    }
};

Si no se proporciona este miembro, QRangeModel devuelve el tipo MIME predeterminado, «application/x-qabstractitemmodeldatalist», tal y como admite QAbstractItemModel. Si la lista devuelta no incluye ese tipo MIME, no será compatible.

Esta función se introdujo en Qt 6.12.

Véase también QAbstractItemModel::mimeTypes().

Documentación de las variables de miembro

const QRangeModel::RowCategory RowOptions::rowCategory

Establece esta constante estática de tiempo de compilación en uno de los valores de la enumeración « RowCategory » para definir cómo debe interpretar « QRangeModel » los elementos del rango. No especificar esta constante equivale a « RowCategory::Default ».

class ColorEntry
{
    Q_GADGET
    Q_PROPERTY(QString display READ colorName)
    Q_PROPERTY(QColor decoration READ decoration)
    Q_PROPERTY(QString toolTip READ toolTip)
public:
    ...
};
template <>
struct QRangeModel::RowOptions<ColorEntry>
{
    static constexpr auto rowCategory = QRangeModel::RowCategory::MultiRoleItem;
};

Si rowCategory se establece en MultiRoleItem, ninguno de los demás miembros tendrá efecto alguno.

Véase también ItemAccess.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.