QTableWidgetItem Class
QTableWidgetItem 클래스는 QTableWidget 클래스와 함께 사용할 수 있는 항목을 제공합니다. 더 보기...
| 헤더: | #include <QTableWidgetItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
공개 타입
| enum | ItemType { Type, UserType } |
공개 함수
| QTableWidgetItem(int type = Type) | |
| QTableWidgetItem(const QString &text, int type = Type) | |
| QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type) | |
| QTableWidgetItem(const QTableWidgetItem &other) | |
| virtual | ~QTableWidgetItem() |
| QBrush | background() const |
| Qt::CheckState | checkState() const |
| virtual QTableWidgetItem * | clone() const |
| int | column() const |
| virtual QVariant | data(int role) const |
| Qt::ItemFlags | flags() const |
| QFont | font() const |
| QBrush | foreground() const |
| QIcon | icon() const |
| bool | isSelected() const |
| virtual void | read(QDataStream &in) |
| int | row() const |
| void | setBackground(const QBrush &brush) |
| void | setCheckState(Qt::CheckState state) |
| virtual void | setData(int role, const QVariant &value) |
| void | setFlags(Qt::ItemFlags flags) |
| void | setFont(const QFont &font) |
| void | setForeground(const QBrush &brush) |
| void | setIcon(const QIcon &icon) |
| void | setSelected(bool select) |
| void | setSizeHint(const QSize &size) |
| void | setStatusTip(const QString &statusTip) |
| void | setText(const QString &text) |
(since 6.4) void | setTextAlignment(Qt::Alignment alignment) |
| void | setToolTip(const QString &toolTip) |
| void | setWhatsThis(const QString &whatsThis) |
| QSize | sizeHint() const |
| QString | statusTip() const |
| QTableWidget * | tableWidget() const |
| QString | text() const |
| int | textAlignment() const |
| QString | toolTip() const |
| int | type() const |
| QString | whatsThis() const |
| virtual void | write(QDataStream &out) const |
| virtual bool | operator<(const QTableWidgetItem &other) const |
| QTableWidgetItem & | operator=(const QTableWidgetItem &other) |
관련 비멤버
| QDataStream & | operator<<(QDataStream &out, const QTableWidgetItem &item) |
| QDataStream & | operator>>(QDataStream &in, QTableWidgetItem &item) |
상세 설명
테이블 항목은 테이블 위젯에 대한 정보를 담는 데 사용됩니다. 항목에는 일반적으로 텍스트, 아이콘 또는 체크박스가 포함됩니다.
QTableWidgetItem 클래스는 Qt 3에서 QTableItem 클래스를 대체하는 편의 클래스입니다. 이 클래스는 QTableWidget 클래스와 함께 사용할 항목을 제공합니다.
최상위 항목은 부모 없이 생성된 후, 행 번호와 열 번호 쌍으로 지정된 위치에 삽입됩니다:
QTableWidgetItem *newItem = new QTableWidgetItem(tr("%1").arg(
pow(row, column+1)));
tableWidget->setItem(row, column, newItem);각 항목은 setBackground() 함수를 통해 설정되는 고유한 배경 브러시를 가질 수 있습니다. 현재 배경 브러시는 background()를 통해 확인할 수 있습니다. 각 항목의 텍스트 레이블은 고유한 글꼴과 브러시로 렌더링될 수 있습니다. 이는 setFont() 및 setForeground() 함수를 통해 지정되며, font() 및 foreground()를 통해 읽을 수 있습니다.
기본적으로 항목은 활성화되어 있으며, 편집 및 선택이 가능하고, 체크할 수 있으며, 드래그 앤 드롭 작업의 소스 및 드롭 대상 모두로 사용될 수 있습니다. 각 항목의 플래그는 적절한 값을 사용하여 setFlags()를 호출함으로써 변경할 수 있습니다( Qt::ItemFlags 참조). 체크 가능한 항목은 ` setCheckState()` 함수를 사용하여 체크하거나 체크를 해제할 수 있습니다. 이에 대응하는 ` checkState()` 함수는 항목이 현재 체크되어 있는지 여부를 나타냅니다.
서브클래스 생성
사용자 정의 항목을 제공하기 위해 QTableWidgetItem을 상속할 때, 표준 항목과 구별될 수 있도록 해당 항목에 대한 새로운 유형을 정의할 수 있습니다. 이 기능이 필요한 하위 클래스의 생성자는 UserType 보다 크거나 같은 새로운 유형 값을 사용하여 기본 클래스의 생성자를 호출해야 합니다.
QTableWidget, 모델/뷰 프로그래밍(Model/View Programming), QListWidgetItem 및 QTreeWidgetItem도 참조하십시오 .
멤버 유형 문서
enum QTableWidgetItem::ItemType
이 열거형은 테이블 위젯 항목을 설명하는 데 사용되는 유형을 정의합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QTableWidgetItem::Type | 0 | 테이블 위젯 항목의 기본 유형입니다. |
QTableWidgetItem::UserType | 1000 | 사용자 정의 유형의 최소 값입니다. UserType보다 작은 값은 Qt에서 예약되어 있습니다. |
QTableWidgetItem 의 하위 클래스에서 새로운 사용자 유형을 정의하여 사용자 정의 항목이 특별하게 처리되도록 할 수 있습니다.
type()도 참조하십시오 .
멤버 함수 설명서
[explicit] QTableWidgetItem::QTableWidgetItem(int type = Type)
지정된 type 에 속하지만 어떤 테이블에도 속하지 않는 테이블 항목을 생성합니다.
type()도 참조하십시오 .
[explicit] QTableWidgetItem::QTableWidgetItem(const QString &text, int type = Type)
지정된 ` text`를 사용하여 테이블 항목을 생성합니다.
type()도 참조하십시오 .
[explicit] QTableWidgetItem::QTableWidgetItem(const QIcon &icon, const QString &text, int type = Type)
지정된 ` icon ` 및 ` text`을 사용하여 테이블 항목을 생성합니다.
type()도 참조하십시오 .
QTableWidgetItem::QTableWidgetItem(const QTableWidgetItem &other)
other 의 복사본을 생성합니다. type() 및 tableWidget()는 복사되지 않는다는 점에 유의하십시오.
이 함수는 clone()을 재구현할 때 유용합니다.
[virtual noexcept] QTableWidgetItem::~QTableWidgetItem()
테이블 항목을 삭제합니다.
QBrush QTableWidgetItem::background() const
항목의 배경을 렌더링하는 데 사용된 브러시를 반환합니다.
setBackground() 및 foreground()도 참조하십시오 .
Qt::CheckState QTableWidgetItem::checkState() const
테이블 항목의 선택 상태를 반환합니다.
setCheckState() 및 flags()도 참조하십시오 .
[virtual] QTableWidgetItem *QTableWidgetItem::clone() const
항목의 복사본을 생성합니다.
int QTableWidgetItem::column() const
테이블에 있는 항목의 열을 반환합니다. 항목이 테이블에 없는 경우, 이 함수는 -1을 반환합니다.
row()함수도 참조하십시오 .
[virtual] QVariant QTableWidgetItem::data(int role) const
지정된 ` role`에 대한 항목의 데이터를 반환합니다.
setData()도 참조하십시오 .
Qt::ItemFlags QTableWidgetItem::flags() const
해당 항목을 설명하는 데 사용되는 플래그를 반환합니다. 이 플래그들은 해당 항목을 체크, 편집 및 선택할 수 있는지 여부를 결정합니다.
setFlags()도 참조하십시오 .
QFont QTableWidgetItem::font() const
항목의 텍스트를 렌더링하는 데 사용된 글꼴을 반환합니다.
setFont()도 참조하십시오 .
QBrush QTableWidgetItem::foreground() const
항목의 전경(예: 텍스트)을 렌더링하는 데 사용된 브러시를 반환합니다.
setForeground() 및 background()도 참조하십시오 .
QIcon QTableWidgetItem::icon() const
항목의 아이콘을 반환합니다.
setIcon() 및 iconSize도 참조하십시오 .
bool QTableWidgetItem::isSelected() const
항목이 선택된 경우 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.
setSelected()도 참조하십시오 .
[virtual] void QTableWidgetItem::read(QDataStream &in)
in 스트림에서 항목을 읽습니다.
write()도 참조하십시오 .
int QTableWidgetItem::row() const
테이블에 있는 항목의 행을 반환합니다. 항목이 테이블에 없는 경우, 이 함수는 -1을 반환합니다.
column()함수도 참조하십시오 .
void QTableWidgetItem::setBackground(const QBrush &brush)
항목의 배경 브러시를 지정된 brush 로 설정합니다. 기본 생성된 브러시를 설정하면 뷰에서 스타일의 기본 색상을 사용하게 됩니다.
background() 및 setForeground()도 참조하십시오 .
void QTableWidgetItem::setCheckState(Qt::CheckState state)
테이블 항목의 선택 상태를 ‘ state ’로 설정합니다.
checkState()도 참조하십시오 .
[virtual] void QTableWidgetItem::setData(int role, const QVariant &value)
지정된 role 에 대한 항목의 데이터를 지정된 value 로 설정합니다.
참고: 기본구현에서는 Qt::EditRole 와 Qt::DisplayRole 를 동일한 데이터를 가리키는 것으로 취급합니다.
Qt::ItemDataRole 및 data()도 참조하십시오 .
void QTableWidgetItem::setFlags(Qt::ItemFlags flags)
항목의 플래그를 지정된 flags 로 설정합니다. 이 플래그는 해당 항목을 선택하거나 수정할 수 있는지 여부를 결정합니다.
flags()도 참조하십시오 .
void QTableWidgetItem::setFont(const QFont &font)
항목의 텍스트를 표시하는 데 사용되는 글꼴을 지정된 font 로 설정합니다.
font(), setText(), setForeground()도 참조하십시오 .
void QTableWidgetItem::setForeground(const QBrush &brush)
항목의 전경 브러시를 지정된 brush 로 설정합니다. 기본 생성된 브러시를 설정하면 뷰에서 스타일의 기본 색상을 사용하게 됩니다.
foreground() 및 setBackground()도 참조하십시오 .
void QTableWidgetItem::setIcon(const QIcon &icon)
항목의 아이콘을 지정된 icon 로 설정합니다.
icon(), setText() 및 iconSize도 참조하십시오 .
void QTableWidgetItem::setSelected(bool select)
항목의 선택 상태를 ‘ select ’로 설정합니다.
isSelected()도 참조하십시오 .
void QTableWidgetItem::setSizeHint(const QSize &size)
테이블 항목의 크기 힌트를 ` size`로 설정합니다. 크기 힌트가 설정되지 않았거나 ` size `가 유효하지 않은 경우, 항목 델리게이트는 항목 데이터를 기반으로 크기 힌트를 계산합니다.
sizeHint()도 참조하십시오 .
void QTableWidgetItem::setStatusTip(const QString &statusTip)
테이블 항목의 상태 툴팁을 statusTip 에서 지정한 텍스트로 설정합니다. 이 기능을 사용하려면 QTableWidget 마우스 추적 기능이 활성화되어 있어야 합니다.
statusTip(), setToolTip() 및 setWhatsThis()도 참조하십시오 .
void QTableWidgetItem::setText(const QString &text)
항목의 텍스트를 지정된 text 로 설정합니다.
text(), setFont(), setForeground()도 참조하십시오 .
[since 6.4] void QTableWidgetItem::setTextAlignment(Qt::Alignment alignment)
항목 텍스트의 정렬 방식을 지정된 ` alignment `로 설정합니다.
이 함수는 Qt 6.4에서 도입되었습니다.
textAlignment()도 참조하십시오 .
void QTableWidgetItem::setToolTip(const QString &toolTip)
항목의 툴팁을 toolTip 에서 지정한 문자열로 설정합니다.
toolTip(), setStatusTip() 및 setWhatsThis()도 참조하십시오 .
void QTableWidgetItem::setWhatsThis(const QString &whatsThis)
항목의 “이게 뭐죠?” 도움말 내용을 whatsThis 에 지정된 문자열로 설정합니다.
whatsThis(), setStatusTip() 및 setToolTip()도 참조하십시오 .
QSize QTableWidgetItem::sizeHint() const
테이블 항목에 설정된 크기 힌트를 반환합니다.
setSizeHint()도 참조하십시오 .
QString QTableWidgetItem::statusTip() const
항목의 상태 툴팁을 반환합니다.
setStatusTip()도 참조하십시오 .
QTableWidget *QTableWidgetItem::tableWidget() const
해당 항목을 포함하는 테이블 위젯을 반환합니다.
QString QTableWidgetItem::text() const
항목의 텍스트를 반환합니다.
setText()도 참조하십시오 .
int QTableWidgetItem::textAlignment() const
항목 텍스트의 정렬 방식을 반환합니다.
참고: 이 함수는 역사적인 이유로 int 형식을 반환합니다. Qt 7에서는 Qt::Alignment 를 반환하도록 수정될 예정입니다.
setTextAlignment() 및 Qt::Alignment도 참조하십시오 .
QString QTableWidgetItem::toolTip() const
항목의 툴팁을 반환합니다.
setToolTip()도 참조하십시오 .
int QTableWidgetItem::type() const
QTableWidgetItem 생성자에 전달된 타입을 반환합니다.
QString QTableWidgetItem::whatsThis() const
해당 항목의 “이게 뭐죠?” 도움말을 반환합니다.
setWhatsThis()도 참조하십시오 .
[virtual] void QTableWidgetItem::write(QDataStream &out) const
항목을 out 스트림에 기록합니다.
read()도 참조하십시오 .
[virtual] bool QTableWidgetItem::operator<(const QTableWidgetItem &other) const
해당 항목이 other 항목보다 작으면 true 를 반환하고, 그렇지 않으면 false를 반환합니다.
QTableWidgetItem &QTableWidgetItem::operator=(const QTableWidgetItem &other)
other 의 데이터와 플래그를 이 항목에 할당합니다. 단, type() 및 tableWidget()는 복사되지 않는다는 점에 유의하십시오.
이 함수는 clone()을 재구현할 때 유용합니다.
관련 비멤버
QDataStream &operator<<(QDataStream &out, const QTableWidgetItem &item)
테이블 위젯 항목 item 을 스트림 out 에 기록합니다.
이 연산자는 QTableWidgetItem::write()을 사용합니다.
Qt 데이터 유형 직렬화항목도 참조하십시오 .
QDataStream &operator>>(QDataStream &in, QTableWidgetItem &item)
in 스트림에서 테이블 위젯 항목을 읽어와 item 에 저장합니다.
이 연산자는 QTableWidgetItem::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.