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
이 열거형은 표준 항목을 설명하는 데 사용되는 유형을 설명합니다.
Constant | 값 | 설명 |
---|---|---|
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
항목의 아이콘을 반환합니다.
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)
column 열에 하위 항목의 count 열을 삽입합니다.
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)
행 row 에 하위 항목의 count 행을 삽입합니다.
insertRow() 및 insertColumns()도 참조하세요 .
bool QStandardItem::isAutoTristate() const
항목이 3상태이고 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
항목이 3상태인지, 즉 세 가지 개별 상태로 체크할 수 있고 사용자가 세 가지 상태를 모두 순환할 수 있는지 여부를 반환합니다.
기본값은 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
인 경우 해당 항목이 삼단계 상태이고 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 이 참이면 사용자가 항목을 선택할 수 있고, 그렇지 않으면 사용자가 항목을 선택할 수 없습니다.
항목 델리게이트는 항목 텍스트 옆에 체크 박스가 있는 체크 가능 항목을 렌더링합니다.
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 이 참이면 사용자가 항목을 끌 수 있고, 그렇지 않으면 사용자가 항목을 끌 수 없습니다.
또한 뷰에서 항목 끌기가 사용하도록 설정되어 있는지 확인해야 합니다( QAbstractItemView::dragEnabled 참조).
isDragEnabled(), setDropEnabled() 및 setFlags()도 참조하십시오 .
void QStandardItem::setDropEnabled(bool dropEnabled)
항목의 드롭 사용 여부를 설정합니다. dropEnabled 이 참이면 항목을 놓기 대상으로 사용할 수 있고, 그렇지 않으면 사용할 수 없습니다.
또한 뷰에서 끌어 놓기가 사용하도록 설정되어 있는지( QWidget::acceptDrops() 참조), 모델이 원하는 끌어 놓기 동작을 지원하는지( QAbstractItemModel::supportedDropActions() 참조) 확인해야 합니다.
isDropEnabled(), setDragEnabled() 및 setFlags()도 참조하십시오 .
void QStandardItem::setEditable(bool editable)
항목의 편집 가능 여부를 설정합니다. editable 이 참이면 사용자가 항목을 편집할 수 있고, 그렇지 않으면 사용자가 항목을 편집할 수 없습니다.
사용자가 뷰에서 항목을 편집할 수 있는 방법은 뷰의 편집 트리거에 따라 결정됩니다( QAbstractItemView::editTriggers 참조).
isEditable() 및 setFlags()도 참조하세요 .
void QStandardItem::setEnabled(bool enabled)
항목의 활성화 여부를 설정합니다. enabled 이 참이면 항목이 활성화되어 사용자가 항목과 상호작용할 수 있고, enabled 이 거짓이면 사용자가 항목과 상호작용할 수 없습니다.
이 플래그는 다른 항목 플래그보다 우선합니다. 예를 들어, 항목이 활성화되지 않은 경우 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 이 참이면 사용자가 항목을 선택할 수 있고, 그렇지 않으면 사용자가 항목을 선택할 수 없습니다.
보기 속성을 조작하여 선택 동작 및 모드를 제어할 수 있습니다( 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)
항목이 3상태이고 사용자가 제어할 수 있는지 여부를 설정합니다. tristate 이 참이면 사용자가 세 가지 상태를 순환할 수 있고, 그렇지 않으면 항목이 두 가지 상태로 체크할 수 있습니다. (이 또한 항목이 체크 가능 상태여야 합니다. 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 스트림에서 item 로 QStandardItem 를 읽습니다.
이 연산자는 QStandardItem::read()를 사용합니다.
Qt 데이터형 직렬화도참조하십시오 .
© 2025 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.