Класс QWidgetAction

Класс QWidgetAction расширяет класс QAction интерфейсом для вставки пользовательских виджетов в контейнеры действий, такие как панели инструментов. Подробнее...

Этот класс был представлен в Qt 4.2.

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

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

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

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

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

Большинство действий в приложении представляются как элементы меню или кнопки на панелях инструментов. Однако иногда необходимы более сложные виджеты. Например, действие масштабирования в текстовом редакторе может быть реализовано с помощью QComboBox на QToolBar, представляя диапазон различных уровней масштабирования. QToolBar предоставляет QToolBar::insertWidget() в качестве удобной функции для вставки одного виджета. Однако, если вы хотите реализовать действие, которое использует пользовательские виджеты для визуализации в нескольких контейнерах, то вам нужно создать подкласс QWidgetAction.

Если QWidgetAction добавлен, например, в QToolBar, то вызывается QWidgetAction::createWidget(). Реализации этой функции должны создавать новый пользовательский виджет с указанным родителем.

Если действие удалено из контейнера, то вызывается QWidgetAction::deleteWidget() с ранее созданным пользовательским виджетом в качестве аргумента. По умолчанию реализация скрывает виджет и удаляет его с помощью QObject::deleteLater().

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

Обратите внимание, что виджету необходимо активировать действие, например, переопределяя обработчики событий мыши и вызывая QAction::trigger().

macOS: Если вы добавляете виджет в меню в строке меню приложения на macOS, виджет будет добавлен и он будет работать, но с некоторыми ограничениями:

1. Виджет перемещается из QMenu в нативный просмотр меню. Если вы показываете меню в другом месте (например, как всплывающее меню), виджета там не будет.
2. Обработка фокуса/клавиатуры виджета невозможна.
3. Из-за дизайна Apple отслеживание мыши на виджете в настоящее время не работает.
4. Подключение сигнала triggered() к слоту, который открывает модальное диалоговое окно, приведет к сбою на macOS 10.4 (известная ошибка, признанная Apple), обходным путем является использование QueuedConnection вместо DirectConnection.

См. также QAction, QActionGroup и QWidget.

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

QWidgetAction::QWidgetAction(QObject *parent)

Создаёт действие с parent.

[virtual] QWidgetAction::~QWidgetAction()

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

[virtual protected] QWidget *QWidgetAction::createWidget(QWidget *parent)

Эта функция вызывается всякий раз, когда действие добавляется в контейнер виджетов, который поддерживает пользовательские виджеты. Если вы не хотите, чтобы пользовательский виджет использовался в качестве представления действия в указанном виджете parent, то должен быть возвращен 0.

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

[protected] QList<QWidget *> QWidgetAction::createdWidgets() const

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

QWidget *QWidgetAction::defaultWidget() const

Возвращает стандартный виджет.

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

[virtual protected] void QWidgetAction::deleteWidget(QWidget *widget)

Эта функция вызывается всякий раз, когда действие удаляется из контейнера виджетов, который отображает действие с помощью пользовательского widget, ранее созданного с помощью createWidget(). По умолчанию реализация скрывает widget и планирует его удаление с помощью QObject::deleteLater().

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

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

Переопределяет: QAction::event(QEvent *e).

[override virtual protected] bool QWidgetAction::eventFilter(QObject *obj, QEvent *event)

Переопределяет: QObject::eventFilter(QObject *watched, QEvent *event).

void QWidgetAction::releaseWidget(QWidget *widget)

Освобождает указанный widget.

Контейнерные виджеты, которые поддерживают действия, вызывают эту функцию, когда действие виджета удалено.

См. также requestWidget(), deleteWidget() и defaultWidget().

QWidget *QWidgetAction::requestWidget(QWidget *parent)

Возвращает виджет, который представляет действие, с заданным parent.

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

См. также releaseWidget(), createWidget() и defaultWidget().

void QWidgetAction::setDefaultWidget(QWidget *widget)

Устанавливает widget в качестве стандартного виджета. Владение передаётся QWidgetAction. Если createWidget() не переопределён подклассом для возврата нового виджета, то стандартный виджет используется, когда контейнерный виджет запрашивает виджет через requestWidget().

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