Класс 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() оба ложны).

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).