QRangeModel Class

멤버 함수 문서

range 에 있는 데이터를 처리하는 QRangeModel 인스턴스를 생성합니다. range 는 컴파일러가 인자 의존적 조회( argument dependent lookup) 를 통해 begin 및 end 오버로드를 찾을 수 있거나, std::begin 및 std::end 가 구현된 순차적 범위여야 합니다. protocol 가 제공되면, 모델은 프로토콜 구현을 사용하여 해당 범위를 트리로 표현합니다. 모델 인스턴스는 parent 의 자식이 됩니다.

range 는 포인터나 참조 래퍼일 수 있으며, 이 경우 모델의 변형 API(예: setData() 또는 insertRow()))를 호출하면 참조된 범위 인스턴스의 데이터가 수정됩니다. range 가 값(또는 모델로 이동된)인 경우, 데이터 변경에 대응하기 위해 모델이 발산하는 신호에 연결해야 합니다.

QRangeModel 이 생성자는 생성되는 동안 range 에 접근하지 않습니다. 따라서 subclassing QRangeModel 와 같이, 아직 완전히 생성되지 않은 범위 객체에 대한 포인터나 참조를 이 생성자에 전달하는 것이 허용됩니다.

range 가 모델로 이동된 경우, 모델이 소멸되면 범위와 그 안의 모든 데이터가 소멸됩니다.

QRangeModelAdapter도 참조하십시오 .

[override virtual noexcept] QRangeModel::~QRangeModel()

QRangeModel 를 파괴합니다.

모델이 생성된 범위에는 접근할 수 없으며, 모델이 이동된 범위에서 생성된 경우에만 파기됩니다.

[override virtual] QModelIndex QRangeModel::buddy(const QModelIndex &index) const

QAbstractItemModel::buddy(const QModelIndex &index) const를 재구현합니다.

[override virtual] bool QRangeModel::canDropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) const

QAbstractItemModel::canDropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) const를 재구현합니다.

범위에 저장된 항목 유형에 대해 ItemAccess 의 사용자 정의가 사용 가능하고, 해당 사용자 정의가 적절한 canDropMimeData() 클래스 멤버 함수를 구현하는 경우, 이 구현은 해당 함수를 호출하여 결과를 반환합니다.

template <>
struct QRangeModel::ItemAccess<ColorEntry>
{
    static bool canDropMimeData(const QMimeData *mimeData)
    {
        // ...
        return true;
    }
};

그렇지 않은 경우, 범위 내의 행 유형에 대해 적절한 canDropMimeData() 클래스 멤버 함수를 가진 RowOptions 의 사용자 정의가 있다면, 이 구현은 해당 함수를 호출한 결과를 반환합니다.

template <>
struct QRangeModel::RowOptions<ColorEntry>
{
    static bool canDropMimeData(const QMimeData *mimeData)
    {
        // ...
        return true;
    }
};

두 사용자 정의 구현 모두 사용할 수 없는 경우, 이 구현은 기본 QAbstractItemModel 구현의 결과를 반환합니다.

Drag'n'drop handling, RowOptions::canDropMimeData(), ItemAccess::canDropMimeData(), dropMimeData(), mimeTypes() 및 mimeData()도 참조하십시오 .

[override virtual] bool QRangeModel::canFetchMore(const QModelIndex &parent) const

QAbstractItemModel::canFetchMore(const QModelIndex &parent) const를 재구현합니다.

[override virtual] bool QRangeModel::clearItemData(const QModelIndex &index)

QAbstractItemModel::clearItemData(const QModelIndex &index)를 재구현합니다.

index 에 지정된 범위 내에 저장된 값을 기본 생성된 값으로 대체합니다.

읽기 전용 범위에서 작동하는 모델이나, ` the C++ tuple protocol`를 구현하는 행 유형의 읽기 전용 열에서 작동하는 모델의 경우, 이 구현은 즉시 ` false `를 반환합니다.

[override virtual] int QRangeModel::columnCount(const QModelIndex &parent = {}) const

다음 함수를 재구현합니다: ` QAbstractItemModel::columnCount(const QModelIndex &parent) const`.

모델의 열 수를 반환합니다. 이 함수는 모든 parent 인덱스에 대해 동일한 값을 반환합니다.

정적 크기의 행 유형을 사용하는 모델의 경우, 이 반환 값은 모델의 수명 기간 내내 항상 동일합니다. 동적 크기의 행 유형을 사용하는 모델의 경우, 모델은 첫 번째 행의 항목 수를 반환하며, 행이 없는 경우에는 0을 반환합니다.

rowCount 및 insertColumns()도 참조하십시오 .

[override virtual] QVariant QRangeModel::data(const QModelIndex &index, int role = Qt::DisplayRole) const

QAbstractItemModel::data(const QModelIndex &index, int role) const를 재구현합니다.

index 가 가리키는 범위 내의 값에 대해, 주어진 role 에 저장된 데이터를 반환합니다.

해당 인덱스의 항목 유형이 int, Qt::ItemDataRole 또는 QString 에서 QVariant 로 매핑되는 연관 컨테이너인 경우, 해당 컨테이너에서 역할 데이터를 조회하여 반환합니다.

항목이 가젯이거나 QObject 인 경우, 구현체는 roleNames() 매핑에서 role 항목과 일치하는 항목 속성의 값을 반환합니다.

그렇지 않은 경우, 구현체는 Qt::DisplayRole 또는 Qt::EditRole 에 대한 QVariant::fromValue() 을 통해 항목으로 구성된 QVariant 를 반환합니다. 다른 역할의 경우, 구현체는 유효하지 않은 (기본 생성된) QVariant 를 반환합니다.

Qt::ItemDataRole, setData(), headerData()도 참조하십시오 .

[override virtual] bool QRangeModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)

QAbstractItemModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)를 재구현합니다.

범위에 저장된 항목 유형에 대해 ` ItemAccess `의 사용자 정의가 존재하고, 해당 사용자 정의가 적절한 ` dropMimeData()` 클래스 멤버 함수를 구현하고 있다면, 이 구현은 해당 함수를 호출하여 그 결과를 반환합니다.

template <>
struct QRangeModel::ItemAccess<ColorEntry>
{
    static bool dropMimeData(const QMimeData *mimeData, auto inserter)
    {
        QByteArray data = mimeData->data(mimeTypes().first());
        if (data.isEmpty())
            return false;
        QTextStream stream(&data, QIODevice::ReadOnly);
        while (!stream.atEnd()) {
            QString colorName;
            stream >> colorName;
            inserter = ColorEntry(colorName);
        }
        return true;
    }
};

그렇지 않은 경우, 범위 내의 행 유형에 대해 적절한 dropMimeData() 클래스 멤버 함수를 가진 RowOptions 의 사용자 정의가 있다면, 이 구현은 해당 함수를 호출한 결과를 반환합니다.

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;
    }
};

두 사용자 정의 구현 모두 사용할 수 없는 경우, 이 구현은 QAbstractItemModel 의 기본 구현 결과를 반환합니다.

Drag'n'drop handling, RowOptions::dropMimeData(), ItemAccess::dropMimeData(), canDropMimeData(), mimeTypes() 및 mimeData()도 참조하십시오 .

[override virtual protected] bool QRangeModel::event(QEvent *event)

QObject::event(QEvent *e)를 재구현합니다.

[override virtual protected] bool QRangeModel::eventFilter(QObject *object, QEvent *event)

QObject::eventFilter(QObject *watched, QEvent *event)를 재구현합니다.

[override virtual] void QRangeModel::fetchMore(const QModelIndex &parent)

QAbstractItemModel::fetchMore(const QModelIndex &parent)를 재구현합니다.

[override virtual] Qt::ItemFlags QRangeModel::flags(const QModelIndex &index) const

QAbstractItemModel::flags(const QModelIndex &index) const를 재구현합니다.

주어진 index 에 대한 항목 플래그를 반환합니다.

이 구현은 항목(ItemIsEnabled)을 활성화하고 선택할 수 있게 하는(ItemIsSelectable) 플래그 조합을 반환합니다. 변경 가능한 데이터가 포함된 범위를 다루는 모델의 경우, 항목을 편집할 수 있게 하는(ItemIsEditable) 플래그도 설정합니다.

mimeTypes()의 비어 있지 않은 리스트를 반환하는 모델은 Qt::ItemIsDragEnabled 도 설정하며, 읽기 전용이 아닌 한 Qt::ItemIsDropEnabled 플래그도 설정합니다.

플랫 모델은 모든 항목에 대해 Qt::ItemNeverHasChildren 를 설정하는 반면, 계층형 모델은 0보다 위쪽 열에 있는 모든 항목에 대해 해당 플래그를 설정합니다.

자신만의 데이터 유형에 맞게 플래그를 사용자 정의하려면, 행 또는 항목 유형에 대한 RowOptions 및/또는 ItemAccess 의 특화 버전을 제공하고 flags() 정적 멤버 함수를 구현하십시오:

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

Qt::ItemFlags, RowOptions 및 ItemAccess도 참조하십시오 .

[override virtual] bool QRangeModel::hasChildren(const QModelIndex &parent = QModelIndex()) const

QAbstractItemModel::hasChildren(const QModelIndex &parent) const를 재구현합니다.

[override virtual] QVariant QRangeModel::headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole) const

QAbstractItemModel::headerData(int section, Qt::Orientation orientation, int role) const를 재구현합니다.

지정된 orientation 을 가진 헤더에서, 주어진 role 및 section 에 해당하는 데이터를 반환합니다.

가로 방향 헤더의 경우, 섹션 번호는 열 번호에 해당합니다. 마찬가지로, 세로 방향 헤더의 경우, 섹션 번호는 행 번호에 해당합니다.

수평 헤더 및 Qt::DisplayRole role 의 경우, 행 유형으로 배열을 사용하는 범위를 처리하는 모델은 section 를 반환합니다. 행 유형이 튜플인 경우, 구현은 section 에 있는 유형의 이름을 반환합니다. 가젯(gadget) 또는 QObject 유형인 행의 경우, 이 함수는 section 인덱스에 있는 속성의 이름을 반환합니다.

사용자 정의 범위에 대한 가로 헤더 데이터를 사용자 정의하려면, 행 유형에 대해 RowOptions 의 특수화를 제공하고 headerData() 클래스 멤버 함수를 구현하십시오:

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

수직 헤더의 경우, 이 함수는 항상 QAbstractItemModel 의 기본 구현 결과를 반환합니다.

Qt::ItemDataRole, setHeaderData(), QHeaderView 및 RowOptions도 참조하십시오 .

[override virtual] QModelIndex QRangeModel::index(int row, int column, const QModelIndex &parent = {}) const

QAbstractItemModel::index(int row, int column, const QModelIndex &parent) const를 재구현합니다.

parent 에서 row 및 column 위치에 있는 모델 항목의 인덱스를 반환합니다.

유효한 부모를 전달하면 목록 및 테이블 범위를 처리하는 모델의 경우 유효하지 않은 인덱스가 생성됩니다.

parent()도 참조하십시오 .

[override virtual] bool QRangeModel::insertColumns(int column, int count, const QModelIndex &parent = {})

QAbstractItemModel::insertColumns(int column, int count, const QModelIndex &parent)를 재구현합니다.

parent 에 지정된 범위의 모든 행에서 column 에 있는 항목 앞에 count 개의 빈 열을 삽입합니다. 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

읽기 전용 범위나 정적 크기의 행 유형(튜플, 배열, 구조체 등)을 가진 범위에서 작동하는 모델의 경우, 이 구현은 아무런 작업도 수행하지 않고 즉시 false 를 반환합니다. 트리 모델의 경우 항상 이 규칙이 적용됩니다.

[override virtual] bool QRangeModel::insertRows(int row, int count, const QModelIndex &parent = {})

QAbstractItemModel::insertRows(int row, int count, const QModelIndex &parent)을 재구현합니다.

지정된 ` row ` 앞쪽에 ` count ` 개의 빈 행을 ` parent` 위치의 범위 내에 삽입합니다. 성공하면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.

읽기 전용 또는 정적 크기의 범위(예: 배열)에서 작동하는 모델의 경우, 이 구현은 아무 작업도 수행하지 않고 즉시 ` false `를 반환합니다.

[override virtual] QMap<int, QVariant> QRangeModel::itemData(const QModelIndex &index) const

QAbstractItemModel::itemData(const QModelIndex &index) const를 재구현합니다.

index 에 지정된 모델 내의 항목에 대해, 모델에 미리 정의된 모든 역할의 값을 포함하는 맵을 반환합니다.

해당 index 의 항목 유형이 int, Qt::ItemDataRole 또는 QString 을 QVariant 로 매핑하는 연관 컨테이너인 경우, 해당 컨테이너의 데이터가 반환됩니다.

항목 유형이 가젯이나 QObject 의 하위 클래스인 경우, role name 에 해당하는 속성의 값이 반환됩니다.

항목이 연관 컨테이너, 가젯 또는 QObject 의 하위 클래스가 아닌 경우, 이 메서드는 기본 클래스의 구현을 호출합니다.

setItemData(), Qt::ItemDataRole 및 data()도 참조하십시오 .

[override virtual] QModelIndexList QRangeModel::match(const QModelIndex &start, int role, const QVariant &value, int hits, Qt::MatchFlags flags) const

QAbstractItemModel::match(const QModelIndex &start, int role, const QVariant &value, int hits, Qt::MatchFlags flags) const를 재구현합니다.

flags 에서 정의된 일치 기준을 사용하여, role 에 저장된 데이터가 value 와 일치하는 start 열 내 항목들의 인덱스 목록을 반환합니다. 모든 일치하는 항목을 찾으려면 hits = -1을 사용하십시오.

[override virtual] QMimeData *QRangeModel::mimeData(const QModelIndexList &indexes) const

QAbstractItemModel::mimeData(const QModelIndexList &indexes) const를 재구현합니다.

범위에 저장된 항목 유형에 대해 ` ItemAccess `의 사용자 정의가 존재하고, 해당 사용자 정의가 적절한 ` mimeData()` 클래스 멤버 함수를 구현하고 있는 경우, 이 구현은 해당 함수를 호출하여 결과를 반환합니다.

template <>
struct QRangeModel::ItemAccess<ColorEntry>
{
    static QMimeData *mimeData(const auto &range)
    {
        QByteArray data;
        QTextStream stream(&data, QIODevice::WriteOnly);
        for (const auto &[item, index] : range)
            stream << item.colorName() << Qt::endl;

        QMimeData *result = new QMimeData;
        result->setData(mimeTypes().first(), data);
        // Qt handles encoding into the default mime type
        return result;
    }
};

그렇지 않은 경우, 범위 내의 행 유형에 대해 적절한 mimeData() 클래스 멤버 함수를 가진 RowOptions 의 사용자 정의가 있다면, 이 구현은 해당 함수를 호출한 결과를 반환합니다.

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;
    }
};

두 사용자 정의 구현 모두 사용할 수 없는 경우, 이 구현은 기본 QAbstractItemModel 구현의 결과를 반환합니다.

Drag'n'drop handling, RowOptions::mimeData(), ItemAccess::mimeData(), canDropMimeData(), dropMimeData() 및 mimeTypes()도 참조하십시오 .

[override virtual] QStringList QRangeModel::mimeTypes() const

QAbstractItemModel::mimeTypes() const를 재구현합니다.

범위에 저장된 항목 유형에 대해 ` ItemAccess `의 사용자 정의가 존재하고, 해당 사용자 정의가 적절한 ` mimeTypes()` 클래스 멤버 함수를 구현하고 있는 경우, 이 구현은 해당 함수를 호출하여 결과를 반환합니다.

template <>
struct QRangeModel::ItemAccess<ColorEntry>
{
    static QStringList mimeTypes()
    {
        return {
            u"text/plain"_s,
            u"application/x-qabstractitemmodeldatalist"_s
        };
    }
};

그렇지 않은 경우, 범위 내의 행 유형에 대해 적절한 ` mimeTypes()` 클래스 멤버 함수를 가진 ` RowOptions `의 사용자 정의가 사용 가능한 경우, 이 구현은 해당 함수를 호출한 결과를 반환합니다.

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

두 사용자 정의 구현 모두 사용할 수 없는 경우, 이 구현은 기본 QAbstractItemModel 구현의 결과를 반환합니다.

Drag'n'drop handling, RowOptions::mimeTypes(), ItemAccess::mimeTypes(), canDropMimeData(), dropMimeData() 및 mimeData()도 참조하십시오 .

[override virtual] bool QRangeModel::moveColumns(const QModelIndex &sourceParent, int sourceColumn, int count, const QModelIndex &destinationParent, int destinationColumn)

QAbstractItemModel::moveColumns(const QModelIndex &sourceParent, int sourceColumn, int count, const QModelIndex &destinationParent, int destinationChild)를 재구현합니다.

지정된 sourceColumn 을 시작으로, 부모 노드 sourceParent 아래에 있는 count 열들을 부모 노드 destinationParent 아래의 destinationColumn 열로 이동합니다.

컬럼이 성공적으로 이동된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

[override virtual] bool QRangeModel::moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationRow)

QAbstractItemModel::moveRows(const QModelIndex &sourceParent, int sourceRow, int count, const QModelIndex &destinationParent, int destinationChild)를 재구현합니다.

지정된 sourceRow 을 시작으로, 부모 노드 sourceParent 아래에 있는 count 행들을 부모 노드 destinationParent 아래의 행 destinationRow 으로 이동합니다.

행이 성공적으로 이동된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

[override virtual] void QRangeModel::multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const

QAbstractItemModel::multiData(const QModelIndex &index, QModelRoleDataSpan roleDataSpan) const를 재구현합니다.

[override virtual] QModelIndex QRangeModel::parent(const QModelIndex &child) const

QAbstractItemModel::parent(const QModelIndex &index) const를 재구현합니다.

child 인덱스에 있는 항목의 부모를 반환합니다.

이 함수는 목록 및 테이블 범위를 다루는 모델의 경우 항상 유효하지 않은 인덱스를 반환합니다. 트리를 다루는 모델의 경우, 이 함수는 트리 탐색 프로토콜의 parent() 구현에서 반환된 행 항목의 인덱스를 반환합니다.

index() 및 hasChildren()도 참조하십시오 .

[override virtual] bool QRangeModel::removeColumns(int column, int count, const QModelIndex &parent = {})

QAbstractItemModel::removeColumns(int column, int count, const QModelIndex &parent)를 재구현합니다.

parent 에 지정된 범위의 모든 행에서 column 위치에 있는 항목에서 count 열을 제거합니다. 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

읽기 전용 범위나 정적 크기의 행 유형(튜플, 배열, 구조체 등)을 가진 범위에서 작동하는 모델의 경우, 이 구현은 아무 작업도 수행하지 않고 즉시 false 를 반환합니다. 트리 모델의 경우 항상 이 규칙이 적용됩니다.

[override virtual] bool QRangeModel::removeRows(int row, int count, const QModelIndex &parent = {})

QAbstractItemModel::removeRows(int row, int count, const QModelIndex &parent)를 재구현합니다.

parent 에 있는 범위에서, 주어진 row 부터 시작하여 count 행을 제거합니다. 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

읽기 전용이거나 크기가 정적으로 고정된 범위(예: 배열)에서 작동하는 모델의 경우, 이 구현은 아무 작업도 수행하지 않고 즉시 false 를 반환합니다.

[override virtual protected slot] void QRangeModel::resetInternalData()

QAbstractItemModel::resetInternalData()을 재구현합니다.

[override virtual] QHash<int, QByteArray> QRangeModel::roleNames() const

QAbstractItemModel::roleNames() const를 재구현합니다.

참조: setRoleNames().

[override virtual] int QRangeModel::rowCount(const QModelIndex &parent = {}) const

QAbstractItemModel::rowCount(const QModelIndex &parent) const를 재구현합니다.

주어진 ` parent` 아래에 있는 행의 수를 반환합니다. 이는 유효하지 않은 ` parent ` 인덱스에 대한 루트 범위의 항목 수입니다.

parent 인덱스가 유효한 경우, 이 함수는 목록 및 테이블 범위를 다루는 모델에 대해서는 항상 0을 반환합니다. 트리의 경우, 이 함수는 트리 탐색 프로토콜의 childRows() 구현에서 반환하는 범위의 크기를 반환합니다.

columnCount(), insertRows(), hasChildren()도 참조하십시오 .

[override virtual] bool QRangeModel::setData(const QModelIndex &index, const QVariant &data, int role = Qt::EditRole)

QAbstractItemModel::setData(const QModelIndex &index, const QVariant &value, int role)를 재구현합니다.

index 에 있는 항목의 role 데이터를 data 로 설정합니다.

해당 index 의 항목 유형이 int, Qt::ItemDataRole 또는 QString 을 QVariant 으로 매핑하는 연관 컨테이너인 경우, data 는 role 로 지정된 키에 대해 해당 컨테이너에 저장됩니다.

항목이 가젯(gadget)이나 QObject 인 경우, data 는 roleNames() 매핑에서 role 항목과 일치하는 해당 항목의 속성에 기록됩니다. 이 함수는 속성이 발견되었고 data 에 저장된 값이 필요한 유형으로 변환될 수 있는 경우 true 를 반환하며, 그렇지 않은 경우 false 를 반환합니다.

그렇지 않은 경우, 이 구현은 Qt::DisplayRole 및 Qt::EditRole 에 대해 범위 내의 index 에 있는 항목에 data 의 값을 할당하고, true 을 반환합니다. 다른 역할의 경우, 이 구현은 false 을 반환합니다.

읽기 전용 범위에서 작동하는 모델이나, ` the C++ tuple protocol`을 구현하는 행 유형의 읽기 전용 열에서 작동하는 모델의 경우, 이 구현은 즉시 ` false `을 반환합니다.

data()도 참조하십시오 .

[override virtual] bool QRangeModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &data, int role = Qt::EditRole)

QAbstractItemModel::setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role)를 재구현합니다.

headerData()도 참조하십시오 .

[override virtual] bool QRangeModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &data)

QAbstractItemModel::setItemData(const QModelIndex &index, const QMap<int, QVariant> &roles)를 재구현합니다.

해당 index 의 항목 유형이 int 또는 Qt::ItemDataRole 에서 QVariant 로 매핑되는 연관 컨테이너인 경우, data 의 항목들은 해당 컨테이너에 저장됩니다. 연관 컨테이너가 QString 에서 QVariant 로 매핑되는 경우, role names 테이블에 매핑이 존재하는 data 의 값들만 저장됩니다.

항목 유형이 가젯(gadget)이나 QObject 의 하위 클래스인 경우, role name 와 일치하는 속성들은 data 에 있는 해당 값으로 설정됩니다.

data 에 항목이 없는 역할은 수정되지 않습니다.

복사 가능한 항목 유형의 경우, 이 구현은 트랜잭션 방식으로 이루어지며, data 의 모든 항목을 저장할 수 있으면 true를 반환합니다. 업데이트할 수 없는 항목이 하나라도 있으면, 원본 컨테이너는 전혀 수정되지 않으며 함수는 false를 반환합니다.

항목이 연관 컨테이너, 가젯 또는 QObject 의 하위 클래스가 아닌 경우, 이 함수는 기본 클래스 구현을 호출하며, 기본 클래스 구현은 data 의 각 항목에 대해 setData()를 호출합니다.

itemData(), setData(), Qt::ItemDataRole도 참조하십시오 .

[override virtual] QModelIndex QRangeModel::sibling(int row, int column, const QModelIndex &index) const

QAbstractItemModel::sibling(int row, int column, const QModelIndex &index) const를 재구현합니다.

index 에 있는 항목에 대해 row 및 column 에 위치한 형제 노드를 반환하며, 해당 위치에 형제 노드가 없는 경우 무효한 QModelIndex 을 반환합니다.

이 구현은 index 의 parent()을 순차적으로 탐색하는 방식보다 훨씬 빠릅니다.

index(), QModelIndex::row() 및 QModelIndex::column()도 참조하십시오 .

[override virtual] void QRangeModel::sort(int column, Qt::SortOrder order = Qt::AscendingOrder)

QAbstractItemModel::sort(int column, Qt::SortOrder order)를 재구현합니다.

column 내 항목들의 sortRole (기본값:Qt::DisplayRole )에 대한 데이터를 기반으로, 주어진 order 에 따라 기본 범위를 정렬합니다.

sortRole 및 QSortFilterProxyModel도 참조하십시오 .

[override virtual] QSize QRangeModel::span(const QModelIndex &index) const

QAbstractItemModel::span(const QModelIndex &index) const를 재구현합니다.