Класс QAbstractButton

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

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

Свойства

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

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

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

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

• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject

Сигналы

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

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

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

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

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

• 5 статические публичные члены, унаследованные от QWidget
• 11 статические публичные члены, унаследованные от QObject
• 1 защищенный слот, унаследованный от QWidget

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

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

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

QAbstractButton::~QAbstractButton()

Удаляет кнопку.

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

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

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

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

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

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

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

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

[virtual protected] void QAbstractButton::checkStateSet()

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

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

[slot] void QAbstractButton::click()

Выполняет щелчок.

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

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

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

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

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

Если кнопка имеет свойство checkable, checked равно true, если кнопка отмечена, или false, если кнопка не отмечена.

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

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

Переопределено из QObject::event().

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

Переопределено из QWidget::focusInEvent().

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

Переопределено из QWidget::focusOutEvent().

QButtonGroup *QAbstractButton::group() const

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

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

См. также QButtonGroup.

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

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

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

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

Переопределено из QWidget::keyPressEvent().

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

Переопределено из QWidget::keyReleaseEvent().

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

Переопределено из QWidget::mouseMoveEvent().

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

Переопределено из QWidget::mousePressEvent().

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

Переопределено из QWidget::mouseReleaseEvent().

[virtual protected] void QAbstractButton::nextCheckState()

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

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

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

Переопределено из QWidget::paintEvent().

[signal] void QAbstractButton::pressed()

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

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

[signal] void QAbstractButton::released()

Этот сигнал испускается при отпускании кнопки.

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

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

Переопределено из QObject::timerEvent().

[slot] void QAbstractButton::toggle()

Переключает состояние кнопки с checkable.

См. также checked.

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

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

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

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

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

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

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

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

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