Класс QCheckBox

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

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

Свойства

• tristate : bool

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

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

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

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

Сигналы

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

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

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

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

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

• 5 открытых слотов, унаследованных от QAbstractButton
• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject
• 1 открытая переменная, унаследованная от QObject
• 5 статических открытых членов, унаследованных от QWidget
• 10 статических открытых членов, унаследованных от QObject
• 1 защищённый слот, унаследованный от QWidget
• 2 защищённых переменных, унаследованных от QObject
• 1 защищённый тип, унаследованный от QPaintDevice

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

Виджет 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.