Класс QAbstractButton

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

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

Свойства

• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

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

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

Публичные слоты

• 19 публичных слотов унаследовано от QWidget
• 1 публичный слот унаследовано от QObject

Сигналы

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

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

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

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

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

• 1 общедоступная переменная, унаследованная от QObject
• 5 статические общедоступные члены, унаследованные от QWidget
• 10 статических общедоступных членов, унаследованных от QObject
• 1 защищённый слот, унаследованный от QWidget
• 2 защищённые переменные, унаследованные от QObject
• 1 защищённый тип, унаследованный от QPaintDevice

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

Класс 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), могут отображать и текст text, и значки icons.

Кнопка может быть установлена как кнопка по умолчанию в диалоговом окне с помощью 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.

[virtual] QAbstractButton::~QAbstractButton()

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

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

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

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

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

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

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

[override 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().

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

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

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

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

[override 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.

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

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

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

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

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

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

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

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

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

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

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

[virtual protected] void QAbstractButton::nextCheckState()

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

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

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

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

[signal] void QAbstractButton::pressed()

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

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

[signal] void QAbstractButton::released()

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

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

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

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

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