Класс QCheckBox

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

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

Свойства

• tristate : bool

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

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

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

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

Сигналы

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

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

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

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

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

• 5 открытых слотов унаследовано от QAbstractButton
• 19 открытых слотов унаследовано от QWidget
• 1 открытый слот унаследовано от QObject
• 5 статических открытых членов унаследовано от QWidget
• 11 статических открытых членов унаследовано от 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 = Q_NULLPTR)

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

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

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

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

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

QCheckBox::~QCheckBox()

Деструктор.

Qt::CheckState QCheckBox::checkState() const

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

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

[virtual protected] void QCheckBox::checkStateSet()

Переопределено из QAbstractButton::checkStateSet().

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

Переопределено из QObject::event().

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

Переопределено из QAbstractButton::hitButton().

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

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

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

[virtual] QSize QCheckBox::minimumSizeHint() const

Переопределено из QWidget::minimumSizeHint().

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

Переопределено из QWidget::mouseMoveEvent().

[virtual protected] void QCheckBox::nextCheckState()

Переопределено из QAbstractButton::nextCheckState().

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

Переопределено из QWidget::paintEvent().

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

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

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

[virtual] QSize QCheckBox::sizeHint() const

Переопределено из QWidget::sizeHint().

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

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

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