QWidgetAction Class

QWidgetAction类通过一个接口扩展了QAction，该接口用于将自定义小部件插入基于操作的容器（如工具栏）中。

Header	#include < QWidgetAction >
qmake	QT += widgets
Inherits	QAction
Inherited By

详细说明

应用程序中的大多数操作都表示为菜单中的项或工具栏中的按钮。但是有时需要更复杂的小部件。例如，字处理器中的缩放动作可以使用QToolBar中的QComboBox来实现，QComboBox表示不同缩放级别的范围。QToolBar提供QToolBar::insertWidget() 作为插入单个小部件的便利函数。但是，如果您想要实现一个在多个容器中使用自定义小部件进行可视化的操作，那么您必须将QWidgetAction子类化。

例如，如果将QWidgetAction添加到QToolBar，则调用QWidgetAction::createWidget() 。该函数的重新实现应该使用指定的父级创建一个新的自定义小部件。

如果从容器小部件中删除了该操作，那么将使用先前创建的自定义小部件作为参数调用QWidgetAction::deleteWidget() 。默认实现隐藏小部件并使用QObject::deleteLater() 将其删除。

如果只有一个自定义小部件，那么可以使用setDefaultWidget() 将其设置为默认小部件。如果将操作添加到QToolBar，或者通常添加到支持QWidgetAction的操作容器中，则将使用该小部件。如果一个只有默认小部件的QWidgetAction同时添加到两个工具栏中，那么默认小部件只显示在该操作添加到的第一个工具栏中。QWidgetAction接管默认小部件的所有权。

请注意，由小部件来激活操作，例如通过重新实现鼠标事件处理程序和调用QAction::trigger() 。

macOS:如果在macOS上向应用程序菜单栏中的菜单添加小部件，则会添加该小部件并使其正常工作，但有一些限制:

小部件将从QMenu重新租入本机菜单视图。如果您在其他地方显示菜单（例如弹出菜单），小部件将不在那里。
小部件的焦点/键盘处理是不可能的。
由于苹果公司的设计，目前该小部件上的鼠标跟踪功能不起作用。
将triggered() 信号连接到打开模式对话框的插槽将导致macOS 10.4崩溃（Apple已确认已知错误），解决方法是使用QueuedConnection而不是DirectConnection。

公共函数

构造和析构

QWidgetAction(QObject *parent)
virtual ~QWidgetAction()

其它

QWidget * defaultWidget() const
void setDefaultWidget(QWidget *widget)
void releaseWidget(QWidget *widget)
QWidget * requestWidget(QWidget *parent)

受保护的函数

virtual QWidget * createWidget(QWidget *parent)

每当将操作添加到支持自定义小部件的容器小部件时，就会调用此函数。如果不希望自定义小部件用作指定父小部件中操作的表示，则应返回0。
QList<QWidget *> createdWidgets() const
virtual void deleteWidget(QWidget *widget)

重写的受保护的函数

virtual bool event(QEvent *event) override
virtual bool eventFilter(QObject *obj, QEvent *event) override

主窗口(10)：【类】QWidgetAction [官翻]相关推荐

QSettings 类【官翻】
文章目录详述基本用法 QVariant和GUI类型 Section 和 Key 的语法后备机制恢复GUI应用程序的状态同时从多个线程或进程访问设置特定于平台的说明应用程序设置的存储位置 ...
QFileDevice 类【官翻】
文章目录一.详述二.公共类型三.公共函数四.重新实现的公共函数五.重新实现受保护的函数 QFileDevice 类 QFileDevice类提供用于读取和写入打开文件的接口. Header: ...
Qt 线程(02)：线程类【官翻】
线程类类名简介 Concurrent Filter and Filter-Reduce Concurrent Map and Map-Reduce Concurrent Run QAtomicIn ...
QFileInfo 类【官翻】
文章目录详述性能问题公共函数创建及析构目录路径.文件名及后缀时间信息缓存属性类型访问权限比较静态公用函数相关的非成员 QFileInfo 类 QFileInfo类提供与系统 ...
QStorageInfo 类【官翻】
文章目录详述公共函数静态公共函数相关非成员 QStorageInfo 类提供有关当前安装的存储和驱动器的信息. Header: #include < QStorageInfo > ...
QFile 类【官翻】
文章目录详述直接读取文件使用流读取文件信号平台特定问题公共类型公共函数重新实现的公共函数静态公用函数 QFile 类 QFile类提供用于读取和写入文件的接口. Header: #i ...
在主窗口中增加绘图类控件时（以QPainter为例）时不显示内容的问题（不应该加addStretch）
问题引出假如我要实现以下GUI,包含一个主窗口,主窗口内又包含1个绘图类控件(QPainter中的QdrawText)和1个单行文本框控件(QLineEdit). 期望效果图开始实现的代码为: ...
Qt应用程序主窗口框架
Qt 应用程序主窗口框架 1. Qt资源系统.菜单栏和工具栏 1.1 使用资源 1.2 编写代码方式添加菜单 1.3 菜单栏 1.4 工具栏 2. 中心部件 3. Dock部件 4. 状态栏 5. 例 ...
Qt应用程序主窗口之一：主窗口框架
对于日常见到的应用程序而言,许多都是基于主窗口的,主窗口中包含了菜单栏.工具栏.状态栏和中心区域等.这一章会详细介绍主窗口的每一个部分,还会涉及资源管理.富文本处理.拖放操作和文档打印等相关内容.重点 ...
QT学习笔记（六）——QT弹出对话框并在主窗口调用对话框的信息
QT弹出对话框并在主窗口调用对话框的信息,显示影像最近封控,大部分时间都在自己学习写代码,有点feel 了哈,自己摸出来一个简单的qt 界面,也实现了自己想要的功能.本篇博客主要记录一下,如何弹出对 ...

主窗口(10)：【类】QWidgetAction [官翻]

文章目录