Класс QCheckBox

Виджет QCheckBox предоставляет флажок с текстовой меткой. Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Свойства

• tristate : bool

• 11 свойств унаследовано от QAbstractButton
• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

Открытые функции

Переопределенные открытые функции

• 21 открытая функция унаследована от QAbstractButton
• 214 открытых функций унаследовано от QWidget
• 31 открытая функция унаследована от QObject
• 14 открытых функций унаследовано от QPaintDevice

Сигналы

• 4 сигнала унаследовано от QAbstractButton
• 3 сигнала унаследовано от QWidget
• 2 сигнала унаследовано от QObject

Статические открытые члены

• 5 статических открытых членов унаследовано от QWidget
• 9 статических открытых членов унаследовано от QObject

Защищенные функции

Переопределенные защищенные функции

• 14 защищенных функций унаследовано от QAbstractButton
• 35 защищенных функций унаследовано от QWidget
• 9 защищенных функций унаследовано от QObject
• 1 защищенная функция унаследована от QPaintDevice

Дополнительные унаследованные члены

• 5 слотов унаследовано от QAbstractButton
• 19 слотов унаследовано от QWidget
• 1 слот унаследовано от QObject
• 1 защищенный слот унаследовано от QWidget

Подробное описание

Виджет QCheckBox предоставляет флажок с текстовой меткой.

Флажок QCheckBox — это кнопка выбора, которая может быть включена (отмечена) или выключена (не отмечена). Флажки обычно используются для представления функций в приложении, которые можно включать или отключать без влияния на другие. Можно реализовать различные типы поведения. Например, QButtonGroup можно использовать для логического группирования флажков, что позволяет использовать взаимоисключающие флажки. Однако QButtonGroup не предоставляет никакого визуального представления.

На рисунке ниже показаны различия между взаимоисключающими и не взаимоисключающими флажками.

Всякий раз, когда флажок устанавливается или сбрасывается, генерируется сигнал stateChanged(). Подключитесь к этому сигналу, если хотите выполнить действие каждый раз, когда состояние флажка изменяется. Вы можете использовать isChecked(), чтобы определить, отмечен ли флажок.

Помимо обычных отмеченных и не отмеченных состояний, QCheckBox необязательно предоставляет третье состояние, чтобы указать «без изменений». Это полезно, когда нужно предоставить пользователю возможность не устанавливать и не сбрасывать флажок. Если вам нужно это третье состояние, включите его с помощью setTristate(), а с помощью checkState() запросите текущее состояние переключателя.

Как и QPushButton, флажок отображает текст и необязательно небольшой значок. Значок задается с помощью setIcon(). Текст можно задать в конструкторе или с помощью setText(). Краткую клавишу можно указать, поместив перед желаемым символом амперсанд. Например:

QCheckBox *checkbox = new QCheckBox("C&ase sensitive", this);

В этом примере краткая клавиша — Alt+A. Подробности см. в документации QShortcut. Чтобы отобразить фактический амперсанд, используйте '&&'.

Важные унаследованные функции: text(), setText(), text(), pixmap(), setPixmap(), accel(), setAccel(), isToggleButton(), setDown(), isDown(), isOn(), checkState(), autoRepeat(), isExclusiveToggle(), group(), setAutoRepeat(), toggle(), pressed(), released(), clicked(), toggled(), checkState() и stateChanged().

См. также QAbstractButton, QRadioButton и Руководство по проектированию пользовательского интерфейса: Флажок.

Документация по членам-функциям

QCheckBox::QCheckBox(QWidget *parent = nullptr)

Конструирует флажок с заданным parent, но без текста.

parent передается в конструктор QAbstractButton.

QCheckBox::QCheckBox(const QString &text, QWidget *parent = nullptr)

Создаёт флажок с заданным parent и text.

parent передаётся конструктору QAbstractButton.

[virtual] QCheckBox::~QCheckBox()

Деструктор.

Qt::CheckState QCheckBox::checkState() const

Возвращает состояние флажка. Если вам не требуется поддержка трёх состояний, вы также можете использовать QAbstractButton::isChecked(), которая возвращает булево значение.

См. также setCheckState() и Qt::CheckState.

[override virtual protected] void QCheckBox::checkStateSet()

Переопределяет QAbstractButton::checkStateSet().

[override virtual protected] bool QCheckBox::event(QEvent *e)

Переопределяет QAbstractButton::event().

[override virtual protected] bool QCheckBox::hitButton(const QPoint &pos) const

Переопределяет QAbstractButton::hitButton().

[protected] void QCheckBox::initStyleOption(QStyleOptionButton *option) const

Инициализирует option значениями из этого QCheckBox. Этот метод полезен для подклассов, которые требуют QStyleOptionButton, но не хотят заполнять всю информацию сами.

См. также QStyleOption::initFrom().

[override virtual] QSize QCheckBox::minimumSizeHint() const

Переопределяет QWidget::minimumSizeHint().

[override virtual protected] void QCheckBox::mouseMoveEvent(QMouseEvent *e)

Переопределяет QAbstractButton::mouseMoveEvent().

[override virtual protected] void QCheckBox::nextCheckState()

Переопределяет QAbstractButton::nextCheckState().

[override virtual protected] void QCheckBox::paintEvent(QPaintEvent *)

Переопределяет QAbstractButton::paintEvent().

void QCheckBox::setCheckState(Qt::CheckState state)

Устанавливает состояние флажка на state. Если вам не требуется поддержка трёх состояний, вы также можете использовать QAbstractButton::setChecked(), которая принимает булево значение.

См. также checkState() и Qt::CheckState.

[override virtual] QSize QCheckBox::sizeHint() const

Переопределяет QWidget::sizeHint().

[signal] void QCheckBox::stateChanged(int state)

Этот сигнал генерируется всякий раз, когда состояние флажка меняется, т. е. когда пользователь устанавливает или снимает его.

state содержит новое состояние флажка Qt::CheckState.