QStandardItemModel Class

QStandardItemModel model(4, 4);
for (int row = 0; row < model.rowCount(); ++row) {
    for (int column = 0; column < model.columnCount(); ++column) {
        QStandardItem *item = new QStandardItem(QString("row %0, column %1").arg(row).arg(column));
        model.setItem(row, column, item);
    }
}

QStandardItemModel model;
QStandardItem *parentItem = model.invisibleRootItem();
for (int i = 0; i < 4; ++i) {
    QStandardItem *item = new QStandardItem(QString("item %0").arg(i));
    parentItem->appendRow(item);
    parentItem = item;
}

QTreeView *treeView = new QTreeView(this);
treeView->setModel(myStandardItemModel);
connect(treeView, &QTreeView::clicked,
        this, &MyWidget::clicked);

void MyWidget::clicked(const QModelIndex &index)
{
    QStandardItem *item = myStandardItemModel->itemFromIndex(index);
    // Do stuff with the item ...
}

treeView->scrollTo(item->index());

멤버 함수 문서

[explicit] QStandardItemModel::QStandardItemModel(QObject *parent = nullptr)

주어진 parent 으로 새 아이템 모델을 구축합니다.

QStandardItemModel::QStandardItemModel(int rows, int columns, QObject *parent = nullptr)

처음에 rows 행과 columns 열이 있고 지정된 parent 을 갖는 새 항목 모델을 구축합니다.

[virtual noexcept] QStandardItemModel::~QStandardItemModel()

모델을 파괴합니다. 모델이 모든 아이템을 파괴합니다.

void QStandardItemModel::appendColumn(const QList<QStandardItem *> &items)

items 을 포함하는 열을 추가합니다. 필요한 경우 행 수를 items 의 크기로 늘립니다.

insertColumn() 및 appendRow()도 참조하세요 .

void QStandardItemModel::appendRow(const QList<QStandardItem *> &items)

items 을 포함하는 행을 추가합니다. 필요한 경우 열 수를 items 의 크기로 늘립니다.

insertRow() 및 appendColumn()도 참조하세요 .

void QStandardItemModel::appendRow(QStandardItem *item)

이 함수는 오버로드된 함수입니다.

열이 하나만 있는 목록이나 트리를 작성할 때 이 함수는 하나의 새 item 을 추가하는 편리한 방법을 제공합니다.

void QStandardItemModel::clear()

모델에서 모든 항목(헤더 항목 포함)을 제거하고 행과 열의 수를 0으로 설정합니다.

removeColumns() 및 removeRows()도 참조하세요 .

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

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

[override virtual] int QStandardItemModel::columnCount(const QModelIndex &parent = QModelIndex()) const

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

setColumnCount()도 참조하십시오 .

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

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

setData()도 참조하십시오 .

[override virtual] bool QStandardItemModel::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).

QList<QStandardItem *> QStandardItemModel::findItems(const QString &text, Qt::MatchFlags flags = Qt::MatchExactly, int column = 0) const

주어진 column 에서 주어진 flags 을 사용하여 주어진 text 과 일치하는 항목의 목록을 반환합니다.

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

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

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

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

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

재구현합니다: QAbstractItemModel::headerData(int 섹션, Qt::오리엔테이션 방향, int 역할) const.

setHeaderData()도 참조하십시오 .

QStandardItem *QStandardItemModel::horizontalHeaderItem(int column) const

가로 헤더 항목이 설정된 경우 column 를 반환하고, 그렇지 않으면 nullptr 을 반환합니다.

setHorizontalHeaderItem() 및 verticalHeaderItem()도 참조하세요 .

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

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

QModelIndex QStandardItemModel::indexFromItem(const QStandardItem *item) const

주어진 item 과 연관된 QModelIndex 을 반환합니다.

QAbstractItemView::scrollTo()와 같이 항목의 QModelIndex 가 필요한 작업을 수행하려는 경우 이 함수를 사용합니다. QStandardItem::index()는 편의상 제공되며, 이 함수를 호출하는 것과 동일합니다.

itemFromIndex() 및 QStandardItem::index()도 참조하세요 .

void QStandardItemModel::insertColumn(int column, const QList<QStandardItem *> &items)

column 에 items 을 포함하는 열을 삽입합니다. 필요한 경우 행 수를 items 의 크기로 늘립니다.

takeColumn(), appendColumn() 및 insertRow()도 참조하세요 .

bool QStandardItemModel::insertColumn(int column, const QModelIndex &parent = QModelIndex())

지정된 parent 의 하위 항목에 지정된 column 앞에 단일 열을 삽입합니다. 열이 삽입되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

insertColumns(), insertRow() 및 removeColumn()도 참조하세요 .

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

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

void QStandardItemModel::insertRow(int row, const QList<QStandardItem *> &items)

row 에 items 을 포함하는 행을 삽입합니다. 필요한 경우 열 수를 items 의 크기로 늘립니다.

takeRow(), appendRow() 및 insertColumn()도 참조하세요 .

bool QStandardItemModel::insertRow(int row, const QModelIndex &parent = QModelIndex())

지정된 parent 의 하위 항목에서 지정된 row 앞에 한 행을 삽입합니다. 행이 삽입되면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

insertRows(), insertColumn() 및 removeRow()도 참조하세요 .

void QStandardItemModel::insertRow(int row, QStandardItem *item)

이것은 과부하된 함수입니다.

row 에 item 을 포함하는 행을 삽입합니다.

열이 하나만 있는 목록이나 트리를 만들 때 이 함수는 하나의 새 항목을 편리하게 추가할 수 있는 방법을 제공합니다.

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

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

QStandardItem *QStandardItemModel::invisibleRootItem() const

모델의 보이지 않는 루트 항목을 반환합니다.

보이지 않는 루트 항목은 QStandardItem API를 통해 모델의 최상위 항목에 대한 액세스를 제공하므로 최상위 항목과 그 하위 항목을 일관된 방식으로 처리할 수 있는 함수(예: 트리 모델과 관련된 재귀 함수)를 작성할 수 있습니다.

QStandardItem *QStandardItemModel::item(int row, int column = 0) const

지정된 row 및 column 이 설정된 경우 해당 항목을 반환하고, 그렇지 않으면 nullptr 을 반환합니다.

setItem(), takeItem() 및 itemFromIndex()도 참조하세요 .

[signal] void QStandardItemModel::itemChanged(QStandardItem *item)

이 신호는 item 의 데이터가 변경될 때마다 전송됩니다.

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

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

setItemData()도 참조하십시오 .

QStandardItem *QStandardItemModel::itemFromIndex(const QModelIndex &index) const

주어진 index 과 연결된 QStandardItem 에 대한 포인터를 반환합니다.

이 함수를 호출하는 것은 일반적으로 QAbstractItemView::activated()와 같은 뷰에서 QModelIndex 기반 신호를 처리할 때 초기 단계입니다. 슬롯에서 신호가 전달한 QModelIndex 을 인수로 사용하여 itemFromIndex()를 호출하여 해당 QStandardItem 에 대한 포인터를 얻습니다.

이 함수는 해당 인덱스에 아직 항목이 없는 경우 itemPrototype()를 사용하여 인덱스에 대한 항목을 느리게 생성하고 부모 항목의 하위 테이블에 설정합니다.

index 이 잘못된 인덱스인 경우 이 함수는 nullptr 을 반환합니다.

indexFromItem()도 참조하세요 .

const QStandardItem *QStandardItemModel::itemPrototype() const

모델에서 사용하는 항목 프로토타입을 반환합니다. 모델은 필요에 따라 새 항목을 구성해야 하는 경우(예: 뷰 또는 항목 위임자가 setData()를 호출하는 경우) 항목 프로토타입을 항목 팩토리로 사용합니다.

setItemPrototype()도 참조하십시오 .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

reimp

[override virtual] int QStandardItemModel::rowCount(const QModelIndex &parent = QModelIndex()) const

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

setRowCount()도 참조하십시오 .

void QStandardItemModel::setColumnCount(int columns)

이 모델의 열 수를 columns 로 설정합니다. columnCount()보다 작으면 원하지 않는 열의 데이터가 삭제됩니다.

columnCount() 및 setRowCount()도 참조하세요 .

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

재구현합니다: QAbstractItemModel::setData(const Q모델인덱스 &index, const Q변수 &value, int 역할).

data()도 참조하세요 .

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

재구현합니다: QAbstractItemModel::setHeaderData(int section, Qt::오리엔테이션 오리엔테이션, const QVariant &value, int role).

headerData()도 참조하십시오 .

void QStandardItemModel::setHorizontalHeaderItem(int column, QStandardItem *item)

column 의 가로 헤더 항목을 item 으로 설정합니다. 이 모델은 항목의 소유권을 갖습니다. 필요한 경우 항목에 맞게 열 수가 증가합니다. 이전 헤더 항목(있는 경우)은 삭제됩니다.

horizontalHeaderItem(), setHorizontalHeaderLabels() 및 setVerticalHeaderItem()도 참조하세요 .

void QStandardItemModel::setHorizontalHeaderLabels(const QStringList &labels)

labels 을 사용하여 가로 헤더 레이블을 설정합니다. 필요한 경우 열 수를 labels 의 크기로 늘립니다.

setHorizontalHeaderItem()도 참조하세요 .

void QStandardItemModel::setItem(int row, int column, QStandardItem *item)

주어진 row 및 column 에 대한 항목을 item 로 설정합니다. 모델이 항목의 소유권을 갖습니다. 필요한 경우 항목에 맞게 행 수와 열 수가 증가합니다. 지정된 위치의 이전 항목(있는 경우)이 삭제됩니다.

item()도 참조하세요 .

void QStandardItemModel::setItem(int row, QStandardItem *item)

과부하가 걸린 기능입니다.

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

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

itemData()도 참조하세요 .

void QStandardItemModel::setItemPrototype(const QStandardItem *item)

모델의 항목 프로토타입을 지정된 item 으로 설정합니다. 모델이 프로토타입의 소유권을 갖습니다.

아이템 프로토타입은 QStandardItem::clone() 함수에 의존하여 QStandardItem 팩토리 역할을 합니다. 자체 프로토타입을 제공하려면 QStandardItem 서브클래스 QStandardItem::clone()를 다시 구현하고 프로토타입을 사용자 정의 클래스의 인스턴스로 설정합니다. QStandardItemModel 에서 필요에 따라 항목을 만들어야 할 때마다(예: 뷰 또는 항목 위임자가 setData())) 새 항목이 사용자 지정 클래스의 인스턴스가 됩니다.

itemPrototype() 및 QStandardItem::clone()도 참조하세요 .

void QStandardItemModel::setItemRoleNames(const QHash<int, QByteArray> &roleNames)

항목 역할 이름을 roleNames 로 설정합니다.

void QStandardItemModel::setRowCount(int rows)

이 모델의 행 수를 rows 로 설정합니다. rowCount()보다 작으면 원하지 않는 행의 데이터가 삭제됩니다.

rowCount() 및 setColumnCount()도 참조하세요 .

void QStandardItemModel::setVerticalHeaderItem(int row, QStandardItem *item)

row 의 세로 헤더 항목을 item 으로 설정합니다. 이 모델은 항목의 소유권을 갖습니다. 필요한 경우 항목에 맞게 행 수가 증가합니다. 이전 헤더 항목(있는 경우)은 삭제됩니다.

verticalHeaderItem(), setVerticalHeaderLabels() 및 setHorizontalHeaderItem()도 참조하세요 .

void QStandardItemModel::setVerticalHeaderLabels(const QStringList &labels)

labels 을 사용하여 세로 헤더 레이블을 설정합니다. 필요한 경우 행 수를 labels 의 크기로 늘립니다.

setVerticalHeaderItem()도 참조하세요 .

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

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

[override virtual] Qt::DropActions QStandardItemModel::supportedDropActions() const

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

QStandardItemModel 는 복사와 이동을 모두 지원합니다.

QList<QStandardItem *> QStandardItemModel::takeColumn(int column)

열 항목을 삭제하지 않고 주어진 column 을 제거하고 제거된 항목에 대한 포인터 목록을 반환합니다. 이 모델은 항목의 소유권을 해제합니다. 열의 항목 중 설정되지 않은 항목의 경우 목록의 해당 포인터는 nullptr 입니다.

takeRow()도 참조하세요 .

QStandardItem *QStandardItemModel::takeHorizontalHeaderItem(int column)

가로 헤더 항목( column )을 삭제하지 않고 헤더에서 제거하고 항목에 대한 포인터를 반환합니다. 이 모델은 항목의 소유권을 해제합니다.

horizontalHeaderItem() 및 takeVerticalHeaderItem()도 참조하세요 .

QStandardItem *QStandardItemModel::takeItem(int row, int column = 0)

(row, column)에서 항목을 삭제하지 않고 제거합니다. 이 모델은 항목의 소유권을 해제합니다.

item(), takeRow() 및 takeColumn()도 참조하세요 .

QList<QStandardItem *> QStandardItemModel::takeRow(int row)

행 항목을 삭제하지 않고 주어진 row 을 제거하고 제거된 항목에 대한 포인터 목록을 반환합니다. 이 모델은 항목의 소유권을 해제합니다. 행의 항목 중 설정되지 않은 항목의 경우 목록의 해당 포인터는 nullptr 입니다.

takeColumn()도 참조하세요 .

QStandardItem *QStandardItemModel::takeVerticalHeaderItem(int row)

세로형 헤더 항목( row )을 삭제하지 않고 헤더에서 제거하고 항목에 대한 포인터를 반환합니다. 이 모델은 항목의 소유권을 해제합니다.

verticalHeaderItem() 및 takeHorizontalHeaderItem()도 참조하세요 .

QStandardItem *QStandardItemModel::verticalHeaderItem(int row) const

행의 세로 헤더 항목이 설정된 경우 row 을 반환하고, 설정되지 않은 경우 nullptr 을 반환합니다.

setVerticalHeaderItem() 및 horizontalHeaderItem()도 참조하세요 .