QCheckBox Class
QCheckBox 위젯은 텍스트 레이블이 있는 체크박스를 제공합니다. 더 보기...
| 헤더: | #include <QCheckBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 상속: | QAbstractButton |
속성
- tristate : bool
공개 함수
| QCheckBox(QWidget *parent = nullptr) | |
| QCheckBox(const QString &text, QWidget *parent = nullptr) | |
| virtual | ~QCheckBox() |
| Qt::CheckState | checkState() const |
| bool | isTristate() const |
| void | setCheckState(Qt::CheckState state) |
| void | setTristate(bool y = true) |
재구현된 공용 함수
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
신호
(since 6.7) void | checkStateChanged(Qt::CheckState state) |
보호된 함수
| virtual void | initStyleOption(QStyleOptionButton *option) const |
재구현된 보호 함수
| virtual void | checkStateSet() override |
| virtual bool | event(QEvent *e) override |
| virtual bool | hitButton(const QPoint &pos) const override |
| virtual void | mouseMoveEvent(QMouseEvent *e) override |
| virtual void | nextCheckState() override |
| virtual void | paintEvent(QPaintEvent *) override |
상세 설명

QCheckBox는 켜기(선택) 또는 끄기(선택 해제)로 전환할 수 있는 옵션 버튼입니다. 체크박스는 일반적으로 다른 기능에 영향을 주지 않고 활성화하거나 비활성화할 수 있는 애플리케이션의 기능을 나타내는 데 사용됩니다. 다양한 유형의 동작을 구현할 수 있습니다. 예를 들어, ` QButtonGroup `을 사용하면 체크 버튼을 논리적으로 그룹화하여 배타적 체크박스를 구현할 수 있습니다. 그러나 ` QButtonGroup `은 시각적인 표현을 제공하지 않습니다.
아래 이미지는 배타적 체크박스와 비배타적 체크박스의 차이점을 더 자세히 보여줍니다.
![]() | ![]() |
체크박스가 선택되거나 선택 해제될 때마다 checkStateChanged() 신호가 발생합니다. 체크박스의 상태가 변경될 때마다 특정 동작을 트리거하려면 이 신호에 연결하십시오. isChecked()를 사용하여 체크박스가 선택되었는지 여부를 조회할 수 있습니다.
일반적인 ‘선택됨’ 및 ‘선택 해제됨’ 상태 외에도, QCheckBox는 선택적으로 “변경 없음”을 나타내는 세 번째 상태를 제공합니다. 이는 사용자에게 체크박스를 선택하거나 선택 해제하지 않을 수 있는 옵션을 제공해야 할 때 유용합니다. 이 세 번째 상태가 필요한 경우, ` setTristate()`를 사용하여 활성화하고, ` checkState()`를 사용하여 현재 토글 상태를 조회하십시오.
QPushButton 와 마찬가지로, 체크박스는 텍스트를 표시하며, 선택적으로 작은 아이콘도 표시할 수 있습니다. 아이콘은 setIcon()를 사용하여 설정합니다. 텍스트는 생성자에서 설정하거나 setText()를 사용하여 설정할 수 있습니다. 단축키는 원하는 문자 앞에 앰퍼샌드(&)를 붙여 지정할 수 있습니다. 예를 들면 다음과 같습니다.
이 예제에서 단축키는 Alt+A입니다. 자세한 내용은 QShortcut 문서를 참조하십시오. 실제 앰퍼샌드를 표시하려면 '&&'를 사용하십시오.
QAbstractButton 및 QRadioButton도 참조하십시오 .
속성 문서
tristate : bool
이 속성은 체크박스가 3상태 체크박스인지 여부를 나타냅니다.
기본값은 false이며, 즉 체크박스는 두 가지 상태만 가집니다.
Access 함수:
| bool | isTristate() const |
| void | setTristate(bool y = true) |
멤버 함수 설명서
[explicit] QCheckBox::QCheckBox(QWidget *parent = nullptr)
지정된 ` parent`를 사용하여 텍스트가 없는 체크박스를 생성합니다.
parent QAbstractButton 생성자에 전달됩니다.
[explicit] QCheckBox::QCheckBox(const QString &text, QWidget *parent = nullptr)
지정된 ` parent ` 및 ` text`을 사용하여 체크박스를 생성합니다.
parent QAbstractButton 생성자에 전달됩니다.
[virtual noexcept] QCheckBox::~QCheckBox()
소멸자.
Qt::CheckState QCheckBox::checkState() const
체크박스의 선택 상태를 반환합니다. 트라이스테이트 지원이 필요하지 않은 경우, 부울 값을 반환하는 QAbstractButton::isChecked()을 사용할 수도 있습니다.
setCheckState() 및 Qt::CheckState도 참조하십시오 .
[signal, since 6.7] void QCheckBox::checkStateChanged(Qt::CheckState state)
이 신호는 체크박스의 상태가 변경될 때마다, 즉 사용자가 체크박스를 선택하거나 선택 해제할 때마다 발생합니다.
state 체크박스의 새로운 Qt::CheckState 값을 포함합니다.
이 함수는 Qt 6.7에서 도입되었습니다.
[override virtual protected] void QCheckBox::checkStateSet()
QAbstractButton::checkStateSet()을 재구현합니다.
[override virtual protected] bool QCheckBox::event(QEvent *e)
QAbstractButton::event(QEvent *e)를 재구현합니다.
[override virtual protected] bool QCheckBox::hitButton(const QPoint &pos) const
QAbstractButton::hitButton(const QPoint &pos) const를 재구현합니다.
[virtual protected] void QCheckBox::initStyleOption(QStyleOptionButton *option) const
이 QCheckBox 의 값을 사용하여 option 를 초기화합니다. 이 메서드는 QStyleOptionButton 가 필요하지만, 모든 정보를 직접 입력하고 싶지 않은 하위 클래스에 유용합니다.
QStyleOption::initFrom()도 참조하십시오 .
[override virtual] QSize QCheckBox::minimumSizeHint() const
QWidget::minimumSizeHint 속성에 대한 액세스 함수를 다시 구현합니다.
[override virtual protected] void QCheckBox::mouseMoveEvent(QMouseEvent *e)
QAbstractButton::mouseMoveEvent(QMouseEvent *e)를 재구현합니다.
[override virtual protected] void QCheckBox::nextCheckState()
QAbstractButton::nextCheckState() 메서드를 재구현합니다.
[override virtual protected] void QCheckBox::paintEvent(QPaintEvent *)
QAbstractButton::paintEvent(QPaintEvent *e)를 재구현합니다.
void QCheckBox::setCheckState(Qt::CheckState state)
체크박스의 선택 상태를 ‘ state ’로 설정합니다. 트라이스테이트 지원이 필요하지 않은 경우, 부울 값을 매개변수로 받는 QAbstractButton::setChecked()을 사용할 수도 있습니다.
checkState() 및 Qt::CheckState도 참조하십시오 .
[override virtual] QSize QCheckBox::sizeHint() const
QWidget::sizeHint 속성에 대한 액세스 함수를 재구현합니다.
© 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.

