Класс QCheckBox

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

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

Свойства

• tristate : bool

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

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

Сигналы

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

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

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

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(const QString &text, QWidget *parent = nullptr)

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

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

QCheckBox::QCheckBox(QWidget *parent = nullptr)

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

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

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

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

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

[virtual] QCheckBox::~QCheckBox()

Деструктор.

Qt::CheckState QCheckBox::checkState() const

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

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

[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

Инициализирует option значениями из этого QCheckBox. Этот метод полезен для подклассов, которые требуют 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.