Класс QCheckBox

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

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

Свойства

• tristate : bool

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

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

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

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

Сигналы

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

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

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

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

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

• 5 public slots унаследовано от QAbstractButton
• 19 public slots унаследовано от QWidget
• 1 public slot унаследовано от 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+А. См. документацию QShortcut для получения подробной информации. Чтобы отобразить фактический амперсанд, используйте '&&'.

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

	Флажок, отображаемый в стиле виджета Macintosh.
	Флажок, отображаемый в стиле виджета Windows Vista.
	Флажок, отображаемый в стиле виджета Fusion.

См. также 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.