Класс QToolButton

Класс QToolButton предоставляет кнопку быстрого доступа к командам или параметрам, обычно используемую внутри QToolBar. Подробнее...

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

Типы публичного доступа

Свойства

• arrowType : Qt::ArrowType
• autoRaise : bool
• popupMode : ToolButtonPopupMode
• toolButtonStyle : Qt::ToolButtonStyle

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

Функции публичного доступа

Переопределенные функции публичного доступа

• 21 функция публичного доступа унаследована от QAbstractButton
• 214 функций публичного доступа унаследовано от QWidget
• 34 функции публичного доступа унаследовано от QObject
• 14 функций публичного доступа унаследовано от QPaintDevice

Слот публичного доступа

• 5 слотов публичного доступа унаследовано от QAbstractButton
• 19 слотов публичного доступа унаследовано от QWidget
• 1 слот публичного доступа унаследовано от QObject

Сигналы

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

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

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

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

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

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

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

Класс QToolButton предоставляет кнопку быстрого доступа к командам или параметрам, обычно используемую внутри QToolBar.

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

Кнопки инструмента обычно создаются при создании новых экземпляров QAction с помощью QToolBar::addAction() или при добавлении существующих действий в панель инструментов с помощью QToolBar::addAction(). Также можно создавать кнопки инструмента так же, как и любые другие виджеты, и располагать их рядом с другими виджетами в макетах.

Одним из классических применений кнопки инструмента является выбор инструментов; например, инструмент «ручка» в программе рисования. Это будет реализовано с помощью QToolButton как переключательной кнопки (см. setCheckable()).

QToolButton поддерживает автоматическое поднятие. В режиме автоматического поднятия кнопка рисует 3D рамку только при наведении на неё курсора. Эта функция автоматически включается, когда кнопка используется внутри QToolBar. Изменить её можно с помощью setAutoRaise().

Иконка кнопки инструмента задаётся как QIcon. Это позволяет указать разные пиксельные изображения для состояния отключения и активности. Изображение для состояния отключения используется, когда функциональность кнопки недоступна. Активное изображение отображается, когда кнопка автоматически поднимается, потому что курсор мыши находится над ней.

Внешний вид и размеры кнопки можно настроить с помощью setToolButtonStyle() и setIconSize(). При использовании внутри QToolBar в QMainWindow, кнопка автоматически подстраивается под настройки QMainWindow (см. QMainWindow::setToolButtonStyle() и QMainWindow::setIconSize()). Вместо иконки кнопка инструмента также может отображать символ стрелки, заданный с помощью arrowType.

Кнопка инструмента может предлагать дополнительные варианты в всплывающем меню. Всплывающее меню можно задать с помощью setMenu(). Используйте setPopupMode(), чтобы настроить различные режимы, доступные для кнопок инструмента с заданным меню. По умолчанию используется режим DelayedPopupMode, который иногда используется с кнопкой "Назад" в веб-браузере. После нажатия и удерживания кнопки в течение некоторого времени всплывает меню, отображающее список возможных страниц для перехода. Время ожидания зависит от стиля, см. QStyle::SH_ToolButton_PopupDelay.

Панель инструментов Qt Assistant содержит кнопки инструментов, связанные с действиями, используемыми в других частях главного окна.

См. также QPushButton, QToolBar, QMainWindow, QAction и Справочник по проектированию пользовательского интерфейса: Кнопка.

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

enum QToolButton::ToolButtonPopupMode

Описывает, как должно всплывать меню для кнопок инструментов, имеющих заданное меню или содержащих список действий.

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

QToolButton::QToolButton(QWidget *parent = nullptr)

Создаёт пустую кнопку инструмента с родителем parent.

[virtual] QToolButton::~QToolButton()

Уничтожает объект и освобождает все выделенные ресурсы.

[override virtual protected] void QToolButton::actionEvent(QActionEvent *event)

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

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

Переопределено из QAbstractButton::changeEvent().

QAction *QToolButton::defaultAction() const

Возвращает действие по умолчанию.

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

[override virtual protected] void QToolButton::enterEvent(QEvent *e)

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

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

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

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

Переопределено из QAbstractButton::hitButton().

[protected] void QToolButton::initStyleOption(QStyleOptionToolButton *option) const

Инициализирует option значениями из этой QToolButton. Этот метод полезен для подклассов, когда им нужен QStyleOptionToolButton, но они не хотят заполнять всю информацию самостоятельно.

См. также QStyleOption::initFrom().

[override virtual protected] void QToolButton::leaveEvent(QEvent *e)

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

QMenu *QToolButton::menu() const

Возвращает связанное меню или 0, если меню не определено.

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

[override virtual] QSize QToolButton::minimumSizeHint() const

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

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

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

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

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

[override virtual protected] void QToolButton::nextCheckState()

Переопределено из QAbstractButton::nextCheckState().

[override virtual protected] void QToolButton::paintEvent(QPaintEvent *event)

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

Отображает кнопку в ответ на событие event.

[slot] void QToolButton::setDefaultAction(QAction *action)

Устанавливает действие по умолчанию на action.

Если кнопка инструмента имеет действие по умолчанию, действие определяет свойства кнопки, такие как текст, значок, подсказка и т. д.

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

void QToolButton::setMenu(QMenu *menu)

Связывает указанное меню с этой кнопкой инструмента.

Меню будет отображаться в соответствии с popupMode кнопки.

Владение меню не передается кнопке инструмента.

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

[slot] void QToolButton::showMenu()

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

[override virtual] QSize QToolButton::sizeHint() const

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

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

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

[signal] void QToolButton::triggered(QAction *action)

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

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