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, 모델/보기 프로그래밍, QListWidgetItem, 및 QTreeWidgetItem 을참조하세요 .
멤버 타입 문서
enum QTableWidgetItem::ItemType
이 열거형은 테이블 위젯 항목을 설명하는 데 사용되는 유형을 설명합니다.
Constant | 값 | 설명 |
---|---|---|
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
항목의 아이콘을 반환합니다.
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
항목 텍스트의 텍스트 맞춤을 반환합니다.
참고: 이 함수는 기록상의 이유로 정수를 반환합니다. 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 데이터 유형 직렬화도참조하십시오 .
© 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.