Класс QAbstractButton

Класс QAbstractButton является абстрактным базовым классом виджетов кнопок, предоставляя функциональность, общую для кнопок. Подробнее...

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

Свойства

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

Открытые слоты

Сигналы

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

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

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

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

QAbstractButton поддерживает как обычные кнопки, так и переключаемые (кнопки-переключатели). Переключаемые кнопки реализованы в классах QRadioButton и QCheckBox. Обычные кнопки реализованы в классах QPushButton и QToolButton; они также обеспечивают переключаемое поведение, если это необходимо.

Любая кнопка может отображать метку с текстом и иконкой. setText() устанавливает текст; setIcon() устанавливает иконку. Если кнопка отключена, её метка изменяется, чтобы кнопка выглядела "отключённой".

Если кнопка является кнопкой с текстом и строка содержит амперсанд ('&'), QAbstractButton автоматически создаёт сочетание клавиш. Например:

QPushButton *button = new QPushButton(tr("Ro&ck && Roll"), this);

Кнопке назначается сочетание клавиш Alt+C, т.е. при нажатии Alt+C кнопка вызовет animateClick(). Подробности см. в документации QShortcut. Чтобы отобразить фактический амперсанд, используйте '&&'.

Вы также можете установить пользовательское сочетание клавиш, используя функцию setShortcut(). Это полезно в основном для кнопок без текста, которые, следовательно, не могут иметь автоматического сочетания клавиш.

button->setIcon(QIcon(":/images/print.png"));
button->setShortcut(tr("Alt+F7"));

Все кнопки, предоставляемые Qt (QPushButton, QToolButton, QCheckBox и QRadioButton), могут отображать как текст, так и иконки.

Кнопка может быть установлена как кнопка по умолчанию в диалоговом окне с помощью QPushButton::setDefault() и QPushButton::setAutoDefault().

QAbstractButton предоставляет большинство состояний, используемых для кнопок:

• isDown() указывает, нажата ли кнопка.
• isChecked() указывает, выбрана ли кнопка. Только переключаемые кнопки могут быть выбраны и убраны с выбора (см. ниже).
• isEnabled() указывает, может ли пользователь нажать кнопку.

  Примечание: В отличие от других виджетов, кнопки, производные от QAbstractButton, принимают события мыши и контекстного меню, когда они отключены.

• setAutoRepeat() устанавливает, будет ли кнопка автоматически повторять нажатие, если пользователь удерживает её нажатой. autoRepeatDelay и autoRepeatInterval определяют, как происходит автоматическое повторение.
• setCheckable() устанавливает, является ли кнопка переключаемой.

Разница между isDown() и isChecked() заключается в следующем. Когда пользователь нажимает на переключаемую кнопку, чтобы выбрать её, кнопка сначала нажимается, а затем переходит в выбранное состояние. Когда пользователь нажимает на неё снова (чтобы снять выбор), кнопка сначала переходит в нажатое состояние, а затем в невыбранное состояние (isChecked() и isDown() оба равны false).

QAbstractButton предоставляет четыре сигнала:

1. pressed() излучается при нажатии левой кнопки мыши, когда курсор мыши находится внутри кнопки.
2. released() излучается при отпускании левой кнопки мыши.
3. clicked() излучается, когда кнопка сначала нажимается, а затем отпускается, когда нажимается сочетание клавиш, или когда вызывается click() или animateClick().
4. toggled() излучается, когда состояние переключаемой кнопки изменяется.

При наследовании от QAbstractButton необходимо переопределить по крайней мере paintEvent() для отрисовки контура кнопки и её текста или пиксельной карты. Также рекомендуется переопределить sizeHint(), а иногда и hitButton() (чтобы определить, находится ли нажатие на кнопку внутри неё). Для кнопок с более чем двумя состояниями (например, для кнопок с тремя состояниями) также необходимо переопределить checkStateSet() и nextCheckState().

См. также QButtonGroup.

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

QAbstractButton::QAbstractButton(QWidget *parent = nullptr)

Создаёт абстрактную кнопку с parent.

[slot] void QAbstractButton::animateClick(int msec = 100)

Выполняет анимированный клик: кнопка нажимается немедленно, и отпускается через msec миллисекунд (по умолчанию 100 мс).

Вызов этой функции снова до отпускания кнопки сбрасывает таймер отпускания.

Все сигналы, связанные с кликом, генерируются соответствующим образом.

Эта функция ничего не делает, если кнопка выключена.

См. также click().

[slot] void QAbstractButton::click()

Выполняет клик.

Все обычные сигналы, связанные с кликом, генерируются соответствующим образом. Если кнопка выбираема, её состояние переключается.

Эта функция ничего не делает, если кнопка выключена.

См. также animateClick().

[signal] void QAbstractButton::clicked(bool checked = false)

Этот сигнал испускается, когда кнопка активирована (то есть, нажата и отпущена, при этом курсор мыши находится внутри кнопки), когда нажата комбинация клавиш, или когда вызываются click() или animateClick(). Обратите внимание, что этот сигнал не испускается, если вызываются setDown(), setChecked() или toggle().

Если кнопка изменяет состояние, то checked имеет значение true, если кнопка выбрана, или false, если кнопка не выбрана.

См. также pressed(), released() и toggled().

[signal] void QAbstractButton::pressed()

Этот сигнал испускается, когда кнопка нажата.

См. также released() и clicked().

[signal] void QAbstractButton::released()

Этот сигнал испускается, когда кнопка отпущена.

См. также pressed(), clicked() и toggled().

[slot] void QAbstractButton::toggle()

Переключает состояние кнопки, которая может изменять своё состояние.

См. также checked.

[signal] void QAbstractButton::toggled(bool checked)

Этот сигнал испускается всякий раз, когда кнопка, изменяющая состояние, изменяет своё состояние. checked имеет значение true, если кнопка выбрана, или false, если кнопка не выбрана.

Это может быть результатом действия пользователя, активации слота click() или вызова setChecked().

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

Например, слот, который реагирует на сигналы, испускаемые только что выбранными кнопками, но игнорирует сигналы от кнопок, которые были отключены, может быть реализован с помощью следующего шаблона:

void MyWidget::reactToToggle(bool checked)
{
   if (checked) {
      // Examine the new button states.
      ...
   }
}

Группы кнопок можно создавать с помощью класса QButtonGroup, а обновления состояний кнопок можно отслеживать с помощью сигнала QButtonGroup::buttonClicked().

Примечание: Сигнал уведомления для свойства checked.

См. также checked и clicked().

[virtual] QAbstractButton::~QAbstractButton()

Уничтожает кнопку.

[override virtual protected] void QAbstractButton::changeEvent(QEvent *e)

Переопределяет: QWidget::changeEvent(QEvent *event).

[virtual protected] void QAbstractButton::checkStateSet()

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

См. также nextCheckState().

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

Переопределяет: QWidget::event(QEvent *event).

[override virtual protected] void QAbstractButton::focusInEvent(QFocusEvent *e)

Переопределяет: QWidget::focusInEvent(QFocusEvent *event).

[override virtual protected] void QAbstractButton::focusOutEvent(QFocusEvent *e)

Переопределяет: QWidget::focusOutEvent(QFocusEvent *event).

QButtonGroup *QAbstractButton::group() const

Возвращает группу, к которой принадлежит эта кнопка.

Если кнопка не является членом какой-либо группы QButtonGroup, эта функция возвращает nullptr.

См. также QButtonGroup.

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

Возвращает true если pos находится внутри прямоугольника кликабельной кнопки; в противном случае возвращает false.

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

[override virtual protected] void QAbstractButton::keyPressEvent(QKeyEvent *e)

Переопределяет: QWidget::keyPressEvent(QKeyEvent *event).

[override virtual protected] void QAbstractButton::keyReleaseEvent(QKeyEvent *e)

Переопределяет: QWidget::keyReleaseEvent(QKeyEvent *event).

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

Переопределяет: QWidget::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QAbstractButton::mousePressEvent(QMouseEvent *e)

Переопределяет: QWidget::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QAbstractButton::mouseReleaseEvent(QMouseEvent *e)

Переопределяет: QWidget::mouseReleaseEvent(QMouseEvent *event).

[virtual protected] void QAbstractButton::nextCheckState()

Этот виртуальный обработчик вызывается при нажатии кнопки. По умолчанию, он вызывает setChecked(!isChecked()) если кнопка isCheckable(). Это позволяет подклассам реализовывать промежуточные состояния кнопок.

См. также checkStateSet().

[override pure virtual protected] void QAbstractButton::paintEvent(QPaintEvent *e)

Переопределяет: QWidget::paintEvent(QPaintEvent *event).

[override virtual protected] void QAbstractButton::timerEvent(QTimerEvent *e)

Переопределяет: QObject::timerEvent(QTimerEvent *event).