QStandardItem Class
QStandardItem 클래스는 QStandardItemModel 클래스와 함께 사용할 수 있는 항목을 제공합니다. 더 보기...
| 헤더: | #include <QStandardItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
공개 유형
| enum | ItemType { Type, UserType } |
공개 함수
| QStandardItem() | |
| QStandardItem(const QString &text) | |
| QStandardItem(const QIcon &icon, const QString &text) | |
| QStandardItem(int rows, int columns = 1) | |
| virtual | ~QStandardItem() |
| QString | accessibleDescription() const |
| QString | accessibleText() const |
| void | appendColumn(const QList<QStandardItem *> &items) |
| void | appendRow(const QList<QStandardItem *> &items) |
| void | appendRow(QStandardItem *item) |
| void | appendRows(const QList<QStandardItem *> &items) |
| QBrush | background() const |
| Qt::CheckState | checkState() const |
| QStandardItem * | child(int row, int column = 0) const |
| void | clearData() |
| virtual QStandardItem * | clone() const |
| int | column() const |
| int | columnCount() const |
| virtual QVariant | data(int role = Qt::UserRole + 1) const |
| Qt::ItemFlags | flags() const |
| QFont | font() const |
| QBrush | foreground() const |
| bool | hasChildren() const |
| QIcon | icon() const |
| QModelIndex | index() const |
| void | insertColumn(int column, const QList<QStandardItem *> &items) |
| void | insertColumns(int column, int count) |
| void | insertRow(int row, const QList<QStandardItem *> &items) |
| void | insertRow(int row, QStandardItem *item) |
| void | insertRows(int row, const QList<QStandardItem *> &items) |
| void | insertRows(int row, int count) |
| bool | isAutoTristate() const |
| bool | isCheckable() const |
| bool | isDragEnabled() const |
| bool | isDropEnabled() const |
| bool | isEditable() const |
| bool | isEnabled() const |
| bool | isSelectable() const |
| bool | isUserTristate() const |
| QStandardItemModel * | model() const |
(since 6.0) virtual void | multiData(QModelRoleDataSpan roleDataSpan) const |
| QStandardItem * | parent() const |
| virtual void | read(QDataStream &in) |
| void | removeColumn(int column) |
| void | removeColumns(int column, int count) |
| void | removeRow(int row) |
| void | removeRows(int row, int count) |
| int | row() const |
| int | rowCount() const |
| void | setAccessibleDescription(const QString &accessibleDescription) |
| void | setAccessibleText(const QString &accessibleText) |
| void | setAutoTristate(bool tristate) |
| void | setBackground(const QBrush &brush) |
| void | setCheckState(Qt::CheckState state) |
| void | setCheckable(bool checkable) |
| void | setChild(int row, int column, QStandardItem *item) |
| void | setChild(int row, QStandardItem *item) |
| void | setColumnCount(int columns) |
| virtual void | setData(const QVariant &value, int role = Qt::UserRole + 1) |
| void | setDragEnabled(bool dragEnabled) |
| void | setDropEnabled(bool dropEnabled) |
| void | setEditable(bool editable) |
| void | setEnabled(bool enabled) |
| void | setFlags(Qt::ItemFlags flags) |
| void | setFont(const QFont &font) |
| void | setForeground(const QBrush &brush) |
| void | setIcon(const QIcon &icon) |
| void | setRowCount(int rows) |
| void | setSelectable(bool selectable) |
| void | setSizeHint(const QSize &size) |
| void | setStatusTip(const QString &statusTip) |
| void | setText(const QString &text) |
| void | setTextAlignment(Qt::Alignment alignment) |
| void | setToolTip(const QString &toolTip) |
| void | setUserTristate(bool tristate) |
| void | setWhatsThis(const QString &whatsThis) |
| QSize | sizeHint() const |
| void | sortChildren(int column, Qt::SortOrder order = Qt::AscendingOrder) |
| QString | statusTip() const |
| QStandardItem * | takeChild(int row, int column = 0) |
| QList<QStandardItem *> | takeColumn(int column) |
| QList<QStandardItem *> | takeRow(int row) |
| QString | text() const |
| Qt::Alignment | textAlignment() const |
| QString | toolTip() const |
| virtual int | type() const |
| QString | whatsThis() const |
| virtual void | write(QDataStream &out) const |
| virtual bool | operator<(const QStandardItem &other) const |
보호된 함수
| QStandardItem(const QStandardItem &other) | |
| void | emitDataChanged() |
| QStandardItem & | operator=(const QStandardItem &other) |
관련 비멤버
| QDataStream & | operator<<(QDataStream &out, const QStandardItem &item) |
| QDataStream & | operator>>(QDataStream &in, QStandardItem &item) |
상세 설명
항목에는 일반적으로 텍스트, 아이콘 또는 확인란이 포함됩니다.
각 항목은 setBackground() 함수를 사용하여 설정된 고유한 배경 브러시를 가질 수 있습니다. 현재 배경 브러시는 background()를 통해 확인할 수 있습니다. 각 항목의 텍스트 레이블은 고유한 글꼴과 브러시로 렌더링될 수 있습니다. 이는 setFont() 및 setForeground() 함수로 지정되며, font() 및 foreground()를 통해 읽을 수 있습니다.
기본적으로 항목은 활성화되어 있으며, 편집 및 선택이 가능하고, 체크할 수 있으며, 드래그 앤 드롭 작업의 소스 및 드롭 대상으로 모두 사용될 수 있습니다. 각 항목의 플래그는 setFlags() 함수를 호출하여 변경할 수 있습니다. 체크 가능한 항목은 ` setCheckState()` 함수를 사용하여 체크하거나 체크 해제할 수 있습니다. 이에 대응하는 ` checkState()` 함수는 항목이 현재 체크되어 있는지 여부를 나타냅니다.
setData()를 호출하여 항목에 애플리케이션별 데이터를 저장할 수 있습니다.
각 항목은 자식 항목으로 구성된 2차원 테이블을 가질 수 있습니다. 이를 통해 항목의 계층 구조를 구축할 수 있습니다. 일반적인 계층 구조는 트리이며, 이 경우 자식 테이블은 단일 열로 구성된 테이블(목록)입니다.
자식 테이블의 차원은 setRowCount() 및 setColumnCount()을 사용하여 설정할 수 있습니다. setChild()을 사용하여 자식 테이블 내에 항목을 배치할 수 있습니다. child()을 사용하여 자식 항목에 대한 포인터를 얻을 수 있습니다. 또한 insertRow() 및 insertColumn()을 사용하여 자식의 새 행과 열을 삽입하거나, appendRow() 및 appendColumn()을 사용하여 추가할 수 있습니다. 추가 및 삽입 함수를 사용할 때 자식 테이블의 차원은 필요에 따라 확장됩니다.
기존의 자식 행은 removeRow() 또는 takeRow()을 사용하여 제거할 수 있으며, 마찬가지로 열은 removeColumn() 또는 takeColumn()을 사용하여 제거할 수 있습니다.
sortChildren()를 호출하여 항목의 자식들을 정렬할 수 있습니다.
서브클래스 생성
사용자 정의 항목을 제공하기 위해 QStandardItem을 서브클래싱할 때, 기본 클래스와 구별될 수 있도록 해당 항목에 대한 새로운 유형을 정의할 수 있습니다. type() 함수는 UserType 보다 크거나 같은 새로운 유형의 값을 반환하도록 재구현해야 합니다.
데이터 쿼리를 사용자 정의 방식으로 처리하거나 항목 데이터의 표현 방식을 제어하려면 data() 및 setData()을 재구현하십시오.
QStandardItemModel 가 필요에 따라 사용자 정의 항목 클래스의 인스턴스를 생성할 수 있도록 하려면 clone()을 재구현하십시오( QStandardItemModel::setItemPrototype() 참조).
항목이 직렬화된 형태로 어떻게 표현되는지 제어하려면 read() 및 write()를 재구현하십시오.
항목 비교의 의미를 제어하려면 operator<()을 재구현하십시오. operator<()은 sortChildren() 또는 QStandardItemModel::sort()을 사용하여 항목을 정렬할 때의 정렬 순서를 결정합니다.
QStandardItemModel, 아이템 뷰 편의 클래스 및 모델/뷰 프로그래밍항목도 참조하십시오 .
멤버 유형 문서
enum QStandardItem::ItemType
이 열거형은 표준 항목을 설명하는 데 사용되는 유형들을 정의합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QStandardItem::Type | 0 | 표준 항목의 기본 유형입니다. |
QStandardItem::UserType | 1000 | 사용자 정의 유형의 최소 값입니다. UserType보다 작은 값은 Qt에서 예약되어 있습니다. |
QStandardItem 의 서브클래스에서 새로운 사용자 정의 유형을 정의하여, 예를 들어 항목을 정렬할 때와 같이 사용자 정의 항목이 특별히 처리되도록 할 수 있습니다.
type()도 참조하십시오 .
멤버 함수 문서
QStandardItem::QStandardItem()
항목을 생성합니다.
[explicit] QStandardItem::QStandardItem(const QString &text)
지정된 ` text`를 사용하여 항목을 생성합니다.
QStandardItem::QStandardItem(const QIcon &icon, const QString &text)
지정된 ` icon ` 및 ` text`을 사용하여 항목을 생성합니다.
[explicit] QStandardItem::QStandardItem(int rows, int columns = 1)
rows 개의 행과 columns 개의 열로 구성된 자식 항목을 가진 항목을 생성합니다.
[protected] QStandardItem::QStandardItem(const QStandardItem &other)
other 의 복사본을 생성합니다. model()은 복사되지 않는다는 점에 유의하십시오.
이 함수는 clone()을 재구현할 때 유용합니다.
[virtual noexcept] QStandardItem::~QStandardItem()
항목을 파기합니다. 이로 인해 해당 항목의 자식 항목들도 함께 파기됩니다.
QString QStandardItem::accessibleDescription() const
항목의 접근성 설명을 반환합니다.
접근성 설명은 보조 기술(즉, 기존의 상호작용 방식을 사용할 수 없는 사용자를 위한 기술)에서 사용됩니다.
setAccessibleDescription() 및 accessibleText()도 참조하십시오 .
QString QStandardItem::accessibleText() const
항목의 접근 가능한 텍스트를 반환합니다.
접근 가능한 텍스트는 보조 기술(즉, 일반적인 상호작용 방식을 사용할 수 없는 사용자를 위한 기술)에서 사용됩니다.
setAccessibleText() 및 accessibleDescription()도 참조하십시오 .
void QStandardItem::appendColumn(const QList<QStandardItem *> &items)
items 를 포함하는 열을 추가합니다. 필요한 경우, 행 수는 items 의 크기로 증가됩니다.
insertColumn()도 참조하십시오 .
void QStandardItem::appendRow(const QList<QStandardItem *> &items)
items 를 포함하는 행을 추가합니다. 필요한 경우, 열 개수는 items 의 크기로 늘어납니다.
insertRow()도 참조하십시오 .
void QStandardItem::appendRow(QStandardItem *item)
item 를 포함하는 행을 추가합니다.
열이 하나뿐인 목록이나 트리를 구축할 때, 이 함수는 새로운 항목 하나를 추가하는 편리한 방법을 제공합니다.
이 함수는 오버로드된 함수입니다.
void QStandardItem::appendRows(const QList<QStandardItem *> &items)
items 를 포함하는 행을 추가합니다. 열 개수는 변하지 않습니다.
insertRow()도 참조하십시오 .
QBrush QStandardItem::background() const
항목의 배경을 렌더링하는 데 사용된 브러시를 반환합니다.
foreground() 및 setBackground()도 참조하십시오 .
Qt::CheckState QStandardItem::checkState() const
항목의 선택 상태를 반환합니다.
setCheckState() 및 isCheckable()도 참조하십시오 .
QStandardItem *QStandardItem::child(int row, int column = 0) const
(row, column)에 자식 항목이 설정되어 있으면 해당 항목을 반환하고, 그렇지 않으면 nullptr 를 반환합니다.
setChild(), takeChild() 및 parent()도 참조하십시오 .
void QStandardItem::clearData()
이전에 설정된 모든 역할의 데이터를 모두 삭제합니다.
[virtual] QStandardItem *QStandardItem::clone() const
이 항목의 복사본을 반환합니다. 항목의 자식 항목은 복사되지 않습니다.
QStandardItem 를 상속할 때, 이 함수를 재구현하여 QStandardItemModel 에 필요에 따라 새 항목을 생성하는 데 사용할 수 있는 팩토리를 제공할 수 있습니다.
QStandardItemModel::setItemPrototype() 및 operator=()도 참조하십시오 .
int QStandardItem::column() const
항목이 부모 테이블의 자식 테이블 내에서 위치한 열을 반환하며, 항목에 부모가 없는 경우 -1을 반환합니다.
int QStandardItem::columnCount() const
해당 항목에 포함된 하위 항목 열의 개수를 반환합니다.
setColumnCount() 및 rowCount()도 참조하십시오 .
[virtual] QVariant QStandardItem::data(int role = Qt::UserRole + 1) const
지정된 역할( role)에 대한 항목의 데이터를 반환하거나, 해당 역할에 대한 데이터가 없는 경우 유효하지 않은 역할( QVariant )을 반환합니다.
이 함수를 재구현하는 경우, 처리하지 않는 역할에 대해서는 기본 구현을 호출해야 합니다. 그렇지 않으면 flags(), isCheckable(), isEditable() 등을 호출하여 플래그를 가져오는 기능이 작동하지 않습니다.
참고: 기본구현에서는 Qt::EditRole 와 Qt::DisplayRole 를 동일한 데이터를 가리키는 것으로 취급합니다.
setData()항목도 참조하십시오 .
[protected] void QStandardItem::emitDataChanged()
이 항목과 연관된 모델이 해당 항목에 대해 ` dataChanged()` 신호를 발생시키도록 합니다.
일반적으로 이 함수는 ` QStandardItem `를 상속받아 ` data()` 및/또는 ` setData()`를 재구현한 경우에만 호출하면 됩니다.
setData()도 참조하십시오 .
Qt::ItemFlags QStandardItem::flags() const
해당 항목에 대한 항목 플래그를 반환합니다.
항목 플래그는 사용자가 해당 항목과 어떻게 상호작용할 수 있는지를 결정합니다.
기본적으로 항목은 활성화되어 있으며, 편집 가능하고, 선택 가능하며, 체크할 수 있고, 드래그 앤 드롭 작업의 소스 및 드롭 대상 모두로 사용될 수 있습니다.
setFlags()도 참조하십시오 .
QFont QStandardItem::font() const
항목의 텍스트를 렌더링하는 데 사용된 글꼴을 반환합니다.
setFont()도 참조하십시오 .
QBrush QStandardItem::foreground() const
항목의 전경(예: 텍스트)을 렌더링하는 데 사용된 브러시를 반환합니다.
setForeground() 및 background()도 참조하십시오 .
bool QStandardItem::hasChildren() const
이 항목에 자식 노드가 있으면 ` true `를 반환하고, 그렇지 않으면 ` false`를 반환합니다.
rowCount(), columnCount(), child()도 참조하십시오 .
QIcon QStandardItem::icon() const
항목의 아이콘을 반환합니다.
setIcon() 및 iconSize도 참조하십시오 .
QModelIndex QStandardItem::index() const
이 항목과 연관된 QModelIndex 를 반환합니다.
QModelIndex 기반 API(예: QAbstractItemView)에서 항목 기능을 호출해야 할 경우, 이 함수를 호출하여 모델 내 항목의 위치에 해당하는 인덱스를 얻을 수 있습니다.
항목이 모델과 연결되어 있지 않은 경우, 유효하지 않은 QModelIndex 가 반환됩니다.
model() 및 QStandardItemModel::itemFromIndex()도 참조하십시오 .
void QStandardItem::insertColumn(int column, const QList<QStandardItem *> &items)
column 위치에 items 값을 포함하는 열을 삽입합니다. 필요한 경우, 행 수는 items 크기로 증가됩니다.
insertColumns() 및 insertRow()도 참조하십시오 .
void QStandardItem::insertColumns(int column, int count)
count 개의 자식 항목 열을 column 열에 삽입합니다.
insertColumn() 및 insertRows()도 참조하십시오 .
void QStandardItem::insertRow(int row, const QList<QStandardItem *> &items)
row 위치에 items 값을 포함하는 행을 삽입합니다. 필요한 경우, 열 개수는 items 크기로 늘어납니다.
insertRows() 및 insertColumn()도 참조하십시오 .
void QStandardItem::insertRow(int row, QStandardItem *item)
row 에 item 를 포함하는 행을 삽입합니다.
열이 하나뿐인 리스트나 트리를 생성할 때, 이 함수는 새로운 항목을 하나 삽입하는 편리한 방법을 제공합니다.
이 함수는 오버로드된 함수입니다.
void QStandardItem::insertRows(int row, const QList<QStandardItem *> &items)
row 에 items 를 삽입합니다. 열 수는 변경되지 않습니다.
insertRow() 및 insertColumn()도 참조하십시오 .
void QStandardItem::insertRows(int row, int count)
count 개의 자식 항목 행을 row 행에 삽입합니다.
insertRow() 및 insertColumns()도 참조하십시오 .
bool QStandardItem::isAutoTristate() const
해당 항목이 트라이스테이트(tristate)인지, 그리고 ` QTreeWidget`에 의해 제어되는지 여부를 반환합니다.
기본값은 false입니다.
setAutoTristate(), isCheckable() 및 checkState()도 참조하십시오 .
bool QStandardItem::isCheckable() const
해당 항목이 사용자가 직접 확인할 수 있는지 여부를 반환합니다.
기본값은 false입니다.
setCheckable(), checkState(), isUserTristate(), isAutoTristate()도 참조하십시오 .
bool QStandardItem::isDragEnabled() const
해당 항목의 드래그가 허용되는지 여부를 반환합니다. 드래그가 허용된 항목은 사용자가 드래그할 수 있습니다.
기본값은 true입니다.
드래그 기능이 작동하려면 뷰에서 항목 드래그가 활성화되어 있어야 합니다. 자세한 내용은 QAbstractItemView::dragEnabled 를 참조하십시오.
setDragEnabled(), isDropEnabled(), flags()도 참조하십시오 .
bool QStandardItem::isDropEnabled() const
해당 아이템이 드롭 가능한지 여부를 반환합니다. 아이템이 드롭 가능한 경우, 드롭 대상으로 사용할 수 있습니다.
기본값은 true입니다.
setDropEnabled(), isDragEnabled(), flags()도 참조하십시오 .
bool QStandardItem::isEditable() const
사용자가 해당 항목을 편집할 수 있는지 여부를 반환합니다.
항목이 편집 가능(그리고 활성화됨)한 경우, 사용자는 뷰의 편집 트리거 중 하나를 호출하여 해당 항목을 편집할 수 있습니다. 자세한 내용은 QAbstractItemView::editTriggers 를 참조하십시오.
기본값은 true입니다.
setEditable() 및 flags()도 참조하십시오 .
bool QStandardItem::isEnabled() const
해당 항목이 활성화되어 있는지 여부를 반환합니다.
항목이 활성화된 경우, 사용자는 해당 항목과 상호작용할 수 있습니다. 가능한 상호작용 유형은 isEditable() 및 isSelectable()와 같은 다른 항목 플래그에 의해 지정됩니다.
기본값은 true입니다.
setEnabled() 및 flags()도 참조하십시오 .
bool QStandardItem::isSelectable() const
해당 항목을 사용자가 선택할 수 있는지 여부를 반환합니다.
기본값은 true입니다.
setSelectable() 및 flags()도 참조하십시오 .
bool QStandardItem::isUserTristate() const
해당 항목이 트라이스테이트인지 여부를 반환합니다. 즉, 세 가지 별개의 상태로 표시될 수 있으며 사용자가 이 세 가지 상태를 순환하여 전환할 수 있는지 여부를 나타냅니다.
기본값은 false입니다.
setUserTristate(), isCheckable(), checkState()도 참조하십시오 .
QStandardItemModel *QStandardItem::model() const
이 항목이 속한 QStandardItemModel 를 반환합니다.
해당 항목이 모델에 속하는 다른 항목의 자식이 아닌 경우, 이 함수는 ` nullptr`를 반환합니다.
index()도 참조하십시오 .
[virtual, since 6.0] void QStandardItem::multiData(QModelRoleDataSpan roleDataSpan) const
roleDataSpan 스팬을 이 항목의 데이터로 채웁니다.
기본 구현은 스팬 내의 각 역할에 대해 data()을 호출하기만 합니다.
이 함수는 Qt 6.0에서 도입되었습니다.
data()도 참조하십시오 .
QStandardItem *QStandardItem::parent() const
항목의 상위 항목을 반환하며, 항목에 상위 항목이 없는 경우 nullptr 를 반환합니다.
참고: 최상위 항목의 경우 parent()는 nullptr 를 반환합니다. 최상위 항목의 부모를 얻으려면 대신 QStandardItemModel::invisibleRootItem()를 사용하십시오.
참조: ` child()` 및 ` QStandardItemModel::invisibleRootItem()`.
[virtual] void QStandardItem::read(QDataStream &in)
in 스트림에서 항목을 읽습니다. 항목의 데이터와 플래그만 읽으며, 하위 항목은 읽지 않습니다.
write()도 참조하십시오 .
void QStandardItem::removeColumn(int column)
지정된 column 를 제거합니다. 해당 컬럼에 있던 항목들이 삭제됩니다.
takeColumn(), removeColumns(), removeRow()도 참조하십시오 .
void QStandardItem::removeColumns(int column, int count)
column 열에 있는 count 열을 제거합니다. 해당 열에 있던 항목들은 삭제됩니다.
removeColumn() 및 removeRows()도 참조하십시오 .
void QStandardItem::removeRow(int row)
지정된 row 을 제거합니다. 해당 행에 있던 항목들이 삭제됩니다.
takeRow(), removeRows(), removeColumn()도 참조하십시오 .
void QStandardItem::removeRows(int row, int count)
행 row 에서 count 행을 제거합니다. 해당 행에 있던 항목들은 삭제됩니다.
removeRow() 및 removeColumn()도 참조하십시오 .
int QStandardItem::row() const
해당 항목이 상위 테이블의 자식 테이블 내에서 위치한 행을 반환하며, 해당 항목에 상위 테이블이 없는 경우 -1을 반환합니다.
int QStandardItem::rowCount() const
해당 항목이 가진 하위 항목 행의 개수를 반환합니다.
setRowCount() 및 columnCount()도 참조하십시오 .
void QStandardItem::setAccessibleDescription(const QString &accessibleDescription)
항목의 접근성 설명을 accessibleDescription 로 지정된 문자열로 설정합니다.
접근성 설명은 보조 기술에서 사용됩니다(즉, 일반적인 상호작용 방식을 사용할 수 없는 사용자를 위한 것입니다).
accessibleDescription() 및 setAccessibleText()도 참조하십시오 .
void QStandardItem::setAccessibleText(const QString &accessibleText)
항목의 접근성 텍스트를 ` accessibleText`로 지정된 문자열로 설정합니다.
접근성 텍스트는 보조 기술(즉, 일반적인 상호작용 수단을 사용할 수 없는 사용자를 위한 기술)에서 사용됩니다.
accessibleText() 및 setAccessibleDescription()도 참조하십시오 .
void QStandardItem::setAutoTristate(bool tristate)
tristate 가 true 인 경우, 해당 항목이 트라이스테이트(tristate)이며 QTreeWidget 에 의해 제어된다고 판단합니다. 이를 통해 QTreeWidget 에서 상위 항목의 상태를 자동으로 관리할 수 있습니다(모든 하위 항목이 선택된 경우 선택, 모든 하위 항목이 선택 해제된 경우 선택 해제, 일부 하위 항목만 선택된 경우 부분 선택).
isAutoTristate(), setCheckable() 및 setCheckState()도 참조하십시오 .
void QStandardItem::setBackground(const QBrush &brush)
항목의 배경 브러시를 지정된 brush 로 설정합니다.
background() 및 setForeground()도 참조하십시오 .
void QStandardItem::setCheckState(Qt::CheckState state)
항목의 선택 상태를 ‘ state ’로 설정합니다.
checkState() 및 setCheckable()도 참조하십시오 .
void QStandardItem::setCheckable(bool checkable)
해당 항목을 사용자가 선택할 수 있도록 할지 여부를 설정합니다. ` checkable `가 true인 경우, 사용자가 해당 항목을 선택할 수 있으며, 그렇지 않은 경우 사용자는 해당 항목을 선택할 수 없습니다.
항목 델리게이트는 항목 텍스트 옆에 체크박스가 있는 선택 가능한 항목을 렌더링합니다.
isCheckable(), setCheckState(), setUserTristate(), setAutoTristate()도 참조하십시오 .
void QStandardItem::setChild(int row, int column, QStandardItem *item)
(row, column)에 있는 하위 항목을 item 로 설정합니다. 이 항목(상위 항목)이 item 의 소유권을 가져갑니다. 필요한 경우, 해당 항목을 수용할 수 있도록 행 수와 열 수가 증가합니다.
참고: nullptr 을 item 으로전달하면 해당 항목이 제거됩니다.
child()도 참조하십시오 .
void QStandardItem::setChild(int row, QStandardItem *item)
row 에 있는 자식 요소를 item 로 설정합니다.
이 함수는 오버로드된 함수입니다.
void QStandardItem::setColumnCount(int columns)
자식 항목 열의 개수를 columns 로 설정합니다. 이 값이 columnCount()보다 작을 경우, 원하지 않는 열의 데이터는 제거됩니다.
columnCount() 및 setRowCount()도 참조하십시오 .
[virtual] void QStandardItem::setData(const QVariant &value, int role = Qt::UserRole + 1)
지정된 ` role `에 대한 항목의 데이터를 지정된 ` value`로 설정합니다.
QStandardItem 을 상속받아 이 함수를 재구현하는 경우, 재구현된 함수에서는 다음을 수행해야 합니다:
- setData()의 기본 구현을 호출하지 않는 경우, emitDataChanged()를 호출해야 합니다. 이렇게 하면 예를 들어 해당 모델을 사용하는 뷰에 변경 사항이 알림됩니다.
- 처리하지 않는 역할에 대해서는 기본 구현을 호출해야 합니다. 그렇지 않으면 setFlags(), setCheckable(), setEditable() 등을 호출하여 플래그를 설정하는 등의 작업이 제대로 작동하지 않습니다.
참고: 기본구현에서는 Qt::EditRole 와 Qt::DisplayRole 를 동일한 데이터를 참조하는 것으로 처리합니다.
Qt::ItemDataRole, data() 및 setFlags()도 참조하십시오 .
void QStandardItem::setDragEnabled(bool dragEnabled)
항목의 드래그 기능을 활성화할지 여부를 설정합니다. ` dragEnabled `가 true인 경우, 사용자가 항목을 드래그할 수 있으며, 그렇지 않은 경우 사용자는 항목을 드래그할 수 없습니다.
뷰에서 항목 드래그가 활성화되어 있는지 확인해야 합니다. 자세한 내용은 ` QAbstractItemView::dragEnabled`을 참조하십시오.
isDragEnabled(), setDropEnabled(), setFlags()도 참조하십시오 .
void QStandardItem::setDropEnabled(bool dropEnabled)
항목에 드롭 기능이 허용되는지 여부를 설정합니다. ` dropEnabled `가 true인 경우, 해당 항목은 드롭 대상 olarak 사용될 수 있으며, 그렇지 않은 경우 사용할 수 없습니다.
또한 뷰에서 드롭이 활성화되어 있는지 확인해야 합니다( QWidget::acceptDrops() 참조). 또한 모델이 원하는 드롭 동작을 지원하는지 확인해야 합니다( QAbstractItemModel::supportedDropActions() 참조).
isDropEnabled(), setDragEnabled(), setFlags()도 참조하십시오 .
void QStandardItem::setEditable(bool editable)
항목을 편집할 수 있는지 여부를 설정합니다. ` editable `가 true인 경우, 사용자는 해당 항목을 편집할 수 있으며, 그렇지 않은 경우 사용자는 해당 항목을 편집할 수 없습니다.
사용자가 뷰에서 항목을 편집하는 방법은 뷰의 편집 트리거에 의해 결정됩니다. 자세한 내용은 QAbstractItemView::editTriggers 를 참조하십시오.
isEditable() 및 setFlags()도 참조하십시오 .
void QStandardItem::setEnabled(bool enabled)
항목이 활성화되어 있는지 여부를 설정합니다. ` enabled `가 `true`인 경우 항목이 활성화되어 사용자가 해당 항목과 상호 작용할 수 있으며, ` enabled `가 `false`인 경우 사용자는 해당 항목과 상호 작용할 수 없습니다.
이 플래그는 다른 항목 플래그보다 우선합니다. 예를 들어, 항목이 활성화되지 않은 경우, Qt::ItemIsSelectable 플래그가 설정되어 있더라도 사용자가 해당 항목을 선택할 수 없습니다.
isEnabled(), Qt::ItemIsEnabled 및 setFlags()도 참조하십시오 .
void QStandardItem::setFlags(Qt::ItemFlags flags)
해당 아이템의 플래그를 ‘ flags ’로 설정합니다.
항목 플래그는 사용자가 해당 항목과 어떻게 상호작용할 수 있는지를 결정합니다. 이 기능은 주로 항목을 비활성화하는 데 사용됩니다.
void QStandardItem::setFont(const QFont &font)
항목의 텍스트를 표시하는 데 사용되는 글꼴을 지정된 font 로 설정합니다.
font(), setText(), setForeground()도 참조하십시오 .
void QStandardItem::setForeground(const QBrush &brush)
항목의 전경(예: 텍스트)을 표시하는 데 사용되는 브러시를 지정된 brush 로 설정합니다.
foreground(), setBackground(), setFont()도 참조하십시오 .
void QStandardItem::setIcon(const QIcon &icon)
항목의 아이콘을 지정된 icon 로 설정합니다.
icon()도 참조하십시오 .
void QStandardItem::setRowCount(int rows)
자식 항목 행의 수를 rows 로 설정합니다. 이 값이 rowCount()보다 작으면, 필요 없는 행의 데이터는 삭제됩니다.
rowCount() 및 setColumnCount()도 참조하십시오 .
void QStandardItem::setSelectable(bool selectable)
항목을 선택할 수 있는지 여부를 설정합니다. ` selectable `가 true인 경우, 사용자가 해당 항목을 선택할 수 있으며, 그렇지 않은 경우 사용자는 해당 항목을 선택할 수 없습니다.
뷰 속성을 조작하여 선택 동작과 모드를 제어할 수 있습니다. 자세한 내용은 QAbstractItemView::selectionMode 및 QAbstractItemView::selectionBehavior 을 참조하십시오.
isSelectable() 및 setFlags()도 참조하십시오 .
void QStandardItem::setSizeHint(const QSize &size)
항목의 크기 힌트를 size 로 설정합니다. 크기 힌트가 설정되지 않은 경우, 항목 델리게이트가 항목 데이터를 기반으로 크기 힌트를 계산합니다.
sizeHint()도 참조하십시오 .
void QStandardItem::setStatusTip(const QString &statusTip)
항목의 상태 툴팁을 statusTip 에서 지정한 문자열로 설정합니다.
statusTip(), setToolTip() 및 setWhatsThis()도 참조하십시오 .
void QStandardItem::setText(const QString &text)
항목의 텍스트를 지정된 text 으로 설정합니다.
text(), setFont(), setForeground()도 참조하십시오 .
void QStandardItem::setTextAlignment(Qt::Alignment alignment)
항목 텍스트의 정렬 방식을 지정된 alignment 로 설정합니다.
textAlignment()도 참조하십시오 .
void QStandardItem::setToolTip(const QString &toolTip)
항목의 툴팁을 toolTip 에서 지정한 문자열로 설정합니다.
toolTip(), setStatusTip(), setWhatsThis()도 참조하십시오 .
void QStandardItem::setUserTristate(bool tristate)
해당 항목이 트라이스테이트(tristate)이며 사용자가 제어할 수 있는지 여부를 설정합니다. tristate 가 true인 경우, 사용자는 세 가지 별개의 상태를 순차적으로 전환할 수 있으며, 그렇지 않은 경우 해당 항목은 두 가지 상태를 갖는 체크박스입니다. (이 경우 해당 항목이 체크박스여야 한다는 점에 유의하십시오. isCheckable()를 참조하십시오.)
isUserTristate(), setCheckable() 및 setCheckState()도 참조하십시오 .
void QStandardItem::setWhatsThis(const QString &whatsThis)
항목의 “이게 뭐죠?” 도움말 내용을 whatsThis 에서 지정한 문자열로 설정합니다.
whatsThis(), setStatusTip() 및 setToolTip()도 참조하십시오 .
QSize QStandardItem::sizeHint() const
해당 항목에 설정된 크기 힌트를 반환하거나, 크기 힌트가 설정되지 않은 경우 유효하지 않은 QSize 를 반환합니다.
크기 힌트가 설정되지 않은 경우, 항목 델리게이트는 항목 데이터를 기반으로 크기 힌트를 계산합니다.
setSizeHint()도 참조하십시오 .
void QStandardItem::sortChildren(int column, Qt::SortOrder order = Qt::AscendingOrder)
주어진 ` order`을 사용하여, 주어진 ` column`의 값에 따라 항목의 자식 노드들을 정렬합니다.
참고: 이 함수는 재귀적이므로, 해당 항목의 자식 노드뿐만 아니라 그 손자 노드 등도 정렬합니다.
operator<()함수도 참조하십시오 .
QString QStandardItem::statusTip() const
항목의 상태 툴팁을 반환합니다.
setStatusTip(), toolTip(), whatsThis()도 참조하십시오 .
QStandardItem *QStandardItem::takeChild(int row, int column = 0)
(row, column) 위치에 있는 자식 항목을 삭제하지 않고 제거한 후, 해당 항목에 대한 포인터를 반환합니다. 지정된 위치에 자식 항목이 없는 경우, 이 함수는 nullptr 를 반환합니다.
이 함수는 takeRow() 및 takeColumn()와 달리 자식 테이블의 크기에 영향을 미치지 않는다는 점에 유의하십시오.
child(), takeRow() 및 takeColumn()도 참조하십시오 .
QList<QStandardItem *> QStandardItem::takeColumn(int column)
column 를 열 항목을 삭제하지 않고 제거하며, 제거된 항목에 대한 포인터 목록을 반환합니다. 해당 열에서 설정되지 않은 항목의 경우, 목록 내의 해당 포인터는 nullptr 가 됩니다.
removeColumn(), insertColumn(), takeRow()도 참조하십시오 .
QList<QStandardItem *> QStandardItem::takeRow(int row)
row 를 행 항목을 삭제하지 않고 제거하며, 제거된 항목에 대한 포인터 목록을 반환합니다. 행 내에서 설정되지 않은 항목의 경우, 목록 내 해당 포인터는 nullptr 가 됩니다.
removeRow(), insertRow(), takeColumn()도 참조하십시오 .
QString QStandardItem::text() const
항목의 텍스트를 반환합니다. 이 텍스트는 뷰에서 사용자에게 표시되는 내용입니다.
setText()도 참조하십시오 .
Qt::Alignment QStandardItem::textAlignment() const
항목 텍스트의 정렬 방식을 반환합니다.
setTextAlignment()도 참조하십시오 .
QString QStandardItem::toolTip() const
항목의 툴팁을 반환합니다.
setToolTip(), statusTip(), whatsThis()도 참조하십시오 .
[virtual] int QStandardItem::type() const
이 항목의 유형을 반환합니다. 이 유형은 사용자 정의 항목을 기본 클래스와 구별하는 데 사용됩니다. ` QStandardItem`을 상속하여 하위 클래스를 만들 때는 이 함수를 재구현하고, ` UserType`보다 크거나 같은 새로운 값을 반환해야 합니다.
QStandardItem::Type도 참조하십시오 .
QString QStandardItem::whatsThis() const
해당 항목의 “이게 뭐죠?” 도움말을 반환합니다.
setWhatsThis(), toolTip() 및 statusTip()도 참조하십시오 .
[virtual] void QStandardItem::write(QDataStream &out) const
항목을 out 스트림에 기록합니다. 항목의 데이터와 플래그만 기록되며, 하위 항목은 기록되지 않습니다.
read()도 참조하십시오 .
[virtual] bool QStandardItem::operator<(const QStandardItem &other) const
이 항목이 other 보다 작으면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.
기본 구현은 항목이 모델에 속하는 경우 해당 항목의 정렬 역할( QStandardItemModel::sortRole 참조)에 대한 데이터를 사용하여 비교를 수행하며, 그렇지 않은 경우 해당 항목의 Qt::DisplayRole (text())에 대한 데이터를 사용하여 비교를 수행합니다.
sortChildren() 및 QStandardItemModel::sort()는 항목을 정렬할 때 이 함수를 사용합니다. 사용자 정의 정렬을 원한다면 QStandardItem 의 서브클래스를 생성하고 이 함수를 재구현할 수 있습니다.
[protected] QStandardItem &QStandardItem::operator=(const QStandardItem &other)
other 의 데이터와 플래그를 이 항목에 할당합니다. type() 및 model()는 복사되지 않는다는 점에 유의하십시오.
이 함수는 ` clone()`를 재구현할 때 유용합니다.
관련 비멤버 함수
QDataStream &operator<<(QDataStream &out, const QStandardItem &item)
QStandardItem item 를 out 스트림에 기록합니다.
이 연산자는 QStandardItem::write()를 사용합니다.
'Qt 데이터 유형 직렬화'항목도 참조하십시오 .
QDataStream &operator>>(QDataStream &in, QStandardItem &item)
스트림 in 에서 QStandardItem 를 읽어와 item 에 저장합니다.
이 연산자는 QStandardItem::read()을 사용합니다.
Qt 데이터 유형의 직렬화항목도 참조하십시오 .
© 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.