Класс 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).