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) |
(until 6.9) void | stateChanged(int 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상태 체크박스인지 여부를 보유합니다.
기본값은 거짓, 즉 확인란에 두 개의 상태만 있는 경우입니다.
함수에 액세스합니다:
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
체크박스의 체크 상태를 반환합니다. 3단계 지원이 필요하지 않은 경우 부울을 반환하는 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.
[signal, until 6.9]
void QCheckBox::stateChanged(int state)
이 기능은 버전 6.9에서 더 이상 사용되지 않을 예정입니다.
대신 checkStateChanged(Qt::CheckState)를 사용하세요.
이 신호는 체크박스의 상태가 변경될 때마다(즉, 사용자가 체크박스를 선택하거나 선택 취소할 때마다) 전송됩니다.
state 체크박스의 새로운 Qt::CheckState 을 포함합니다.
© 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.