QDesignerFormWindowManagerInterface 类
QDesignerFormWindowManagerInterface 类允许您操作 Qt Designer 中的表单窗口集合,并控制 Qt Designer 的表单编辑操作。 更多...
头文件 | #include <QDesignerFormWindowManagerInterface> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Designer) target_link_libraries(mytarget PRIVATE Qt6::Designer) |
qmake | QT += designer |
继承 | QObject |
公共类型
枚举 | Action { CutAction, CopyAction, PasteAction, DeleteAction, SelectAllAction, …, FormWindowSettingsDialogAction } |
枚举 | ActionGroup { StyledPreviewActionGroup } |
公共函数
QDesignerFormWindowManagerInterface(QObject *parent = nullptr) | |
虚函数 | ~QDesignerFormWindowManagerInterface() |
虚函数 | action(QDesignerFormWindowManagerInterface::Action action) const = 0 |
虚函数 | actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const = 0 |
虚函数 | activeFormWindow() const = 0 |
虚函数 | core() const = 0 |
虚函数 | createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags()) = 0 |
虚函数 | createPreviewPixmap() const = 0 |
虚函数 | formWindow(int index) const = 0 |
虚函数 | formWindowCount() const = 0 |
公共槽
虚函数 | addFormWindow(QDesignerFormWindowInterface *formWindow) = 0 |
虚函数 | 关闭所有预览() = 0 |
虚函数 | removeFormWindow(QDesignerFormWindowInterface *formWindow) = 0 |
虚函数 | setActiveFormWindow(QDesignerFormWindowInterface *formWindow) = 0 |
虚函数 | 显示插件对话框() = 0 |
虚函数 | 显示预览() = 0 |
信号
void | activeFormWindowChanged(QDesignerFormWindowInterface *formWindow) |
void | formWindowAdded(QDesignerFormWindowInterface *formWindow) |
void | formWindowRemoved(QDesignerFormWindowInterface *formWindow) |
void | formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow) |
详细说明
QDesignerFormWindowManagerInterface 不应该直接实例化。 Qt Designer 使用表单窗口管理器来控制其工作空间中的各种表单窗口。您可以使用 QDesignerFormEditorInterface::formWindowManager() 函数获取 Qt Designer 的表单窗口管理器的接口。例如
auto *manager = formEditor->formWindowManager(); auto *formWindow = manager->formWindow(0); manager->setActiveFormWindow(formWindow);
在实现自定义小部件插件时,由 QDesignerCustomWidgetInterface::initialize() 函数的参数提供指向 Qt Designer 当前 QDesignerFormEditorInterface 对象的指针(例如上面示例中的 formEditor
)。您必须继承 QDesignerCustomWidgetInterface 以将您的插件公开给 Qt Designer。
表单窗口管理器接口提供了 createFormWindow() 函数,它允许您创建新的表单窗口,并将其添加到管理器维护的表单窗口集合中,使用 addFormWindow() slot。它还提供了返回当前管理器控制的表单窗口数量的 formWindowCount() 函数,返回与给定索引关联的表单窗口的 formWindow() 函数,以及返回当前选定的表单窗口的 activeFormWindow() 函数。removeFormWindow() slot 允许您减少管理器必须维护的表单窗口数量,而 setActiveFormWindow() slot 允许您在 Qt Designer 的工作空间中更改表单窗口的焦点。
此外,QDesignerFormWindowManagerInterface 包含一系列函数,这些函数允许您干预和控制 Qt Designer 的表单编辑操作。所有这些函数都返回原始操作,使得在干预后可以进一步传播该函数。
最后,该接口提供了三个信号,分别用于向添加表单窗口时、当前选定的表单窗口更改时,或向删除表单窗口时发射。所有信号都携带相关表单窗口作为其参数。
另请参阅QDesignerFormEditorInterface 和 QDesignerFormWindowInterface。
成员类型文档
enum QDesignerFormWindowManagerInterface::Action
指定 Qt Designer 的一个操作。
常量 | 值 | 描述 |
---|---|---|
QDesignerFormWindowManagerInterface::CutAction | 100 | 剪贴板剪切 |
QDesignerFormWindowManagerInterface::CopyAction | 101 | 剪贴板复制 |
QDesignerFormWindowManagerInterface::PasteAction | 102 | 剪贴板粘贴 |
QDesignerFormWindowManagerInterface::DeleteAction | 103 | 剪贴板删除 |
QDesignerFormWindowManagerInterface::SelectAllAction | 104 | 全选 |
QDesignerFormWindowManagerInterface::LowerAction | 200 | 降低当前小部件 |
QDesignerFormWindowManagerInterface::RaiseAction | 201 | 提升当前小部件 |
QDesignerFormWindowManagerInterface::UndoAction | 300 | 撤销 |
QDesignerFormWindowManagerInterface::RedoAction | 301 | 重复 |
QDesignerFormWindowManagerInterface::HorizontalLayoutAction | 400 | 使用 QHBoxLayout 布局 |
QDesignerFormWindowManagerInterface::VerticalLayoutAction | 401 | 使用 QVBoxLayout 布局 |
QDesignerFormWindowManagerInterface::SplitHorizontalAction | 402 | 使用 QSplitter 水平布局 |
QDesignerFormWindowManagerInterface::SplitVerticalAction | 403 | 使用 QSplitter 垂直布局 |
QDesignerFormWindowManagerInterface::GridLayoutAction | 404 | 使用 QGridLayout 布局 |
QDesignerFormWindowManagerInterface::FormLayoutAction | 405 | 使用 QFormLayout 布局 |
QDesignerFormWindowManagerInterface::BreakLayoutAction | 406 | 断开现有布局 |
QDesignerFormWindowManagerInterface::AdjustSizeAction | 407 | 调整大小 |
QDesignerFormWindowManagerInterface::SimplifyLayoutAction | 408 | 简化 QGridLayout 或 QFormLayout |
QDesignerFormWindowManagerInterface::DefaultPreviewAction | 500 | 以默认样式创建预览 |
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction | 600 | 显示包含表格设置的对话框 |
另请参阅 action。
枚举 QDesignerFormWindowManagerInterface::ActionGroup
指定 Qt Designer 的操作组。
常量 | 值 | 描述 |
---|---|---|
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup | 100 | 包含带样式的预览操作的组 |
另请参阅 actionGroup。
成员函数文档
[(explicit)]
QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface(QObject *parent = nullptr)
为表单窗口管理器构建具有给定 parent 的接口。
[虚拟 noexcept]
QDesignerFormWindowManagerInterface::~QDesignerFormWindowManagerInterface()
销毁表单窗口管理器接口。
[纯虚拟]
QAction *QDesignerFormWindowManagerInterface::action(QDesignerFormWindowManagerInterface::Action action) const
返回由枚举值 action 指定的操作。
过时了 Qt 4.X 的操作访问器。
[纯虚拟]
QActionGroup *QDesignerFormWindowManagerInterface::actionGroup(QDesignerFormWindowManagerInterface::ActionGroup actionGroup) const
返回由枚举值 actionGroup 指定的操作组。
[纯虚拟]
QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::activeFormWindow() const
返回在 Qt Designer 工作区中当前活动表单窗口。
另请参阅 setActiveFormWindow() 和 removeFormWindow。
[信号]
void QDesignerFormWindowManagerInterface::activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)
当 Qt Designer 工作区中当前活动的表单窗口内容发生变化时,发出此信号。作为参数传递当前活动的 formWindow 指针。
另请参阅 activeFormWindow。
[纯虚拟槽]
void QDesignerFormWindowManagerInterface::addFormWindow(QDesignerFormWindowInterface *formWindow)
将给定的 formWindow 添加到 Qt Designer 表单窗口管理器维护的窗口集合中。
另请参阅formWindowAdded().
[纯虚函数槽]
void QDesignerFormWindowManagerInterface::closeAllPreviews()
关闭所有当前打开的预览。
另请参阅showPreview().
[纯虚函数]
QDesignerFormEditorInterface *QDesignerFormWindowManagerInterface::core() const
返回指向Qt Designer当前QDesignerFormEditorInterface对象的指针。
[纯虚函数]
QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::createFormWindow(QWidget *parent = nullptr, Qt::WindowFlags flags = Qt::WindowFlags())
使用给定的parent和窗口flags创建一个表单窗口。
另请参阅addFormWindow().
[纯虚函数]
QPixmap QDesignerFormWindowManagerInterface::createPreviewPixmap() const
创建代表当前活动表单预览的位图。
[纯虚函数]
QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::formWindow(int index) const
返回指定索引处的表单窗口。
另请参阅 setActiveFormWindow() 和 removeFormWindow。
[信号]
void QDesignerFormWindowManagerInterface::formWindowAdded(QDesignerFormWindowInterface *formWindow)
当向Qt Designer表单窗口管理器维护的窗口集合中添加新表单窗口时,发出此信号。作为参数传递新formWindow的指针。
另请参阅addFormWindow() 和 setActiveFormWindow().
[纯虚函数]
int QDesignerFormWindowManagerInterface::formWindowCount() const
返回Qt Designer表单窗口管理器维护的表单窗口数量。
[信号]
void QDesignerFormWindowManagerInterface::formWindowRemoved(QDesignerFormWindowInterface *formWindow)
当从Qt Designer表单窗口管理器维护的窗口集合中删除表单窗口时,发出此信号。作为参数传递被删除的formWindow的指针。
另请参阅removeFormWindow().
[信号]
void QDesignerFormWindowManagerInterface::formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)
当表单窗口的设置更改时,会发出此信号。它可以用来相应地更新窗口标题等。通过参数传递了一个指向formWindow的指针。
另请参阅:FormWindowSettingsDialogAction。
[纯虚函数]
void QDesignerFormWindowManagerInterface::removeFormWindow(QDesignerFormWindowInterface *formWindow)
从Qt Designer的表单窗口管理器维护的窗口集合中删除指定的formWindow。
另请参阅:formWindow() 和 formWindowRemoved。
[纯虚函数]
void QDesignerFormWindowManagerInterface::setActiveFormWindow(QDesignerFormWindowInterface *formWindow)
将指定的formWindow设置为Qt Designer工作空间中的当前活动表单窗口。
另请参阅:activeFormWindow() 和 activeFormWindowChanged。
[纯虚函数]
void QDesignerFormWindowManagerInterface::showPluginDialog()
打开一个对话框,显示由Qt Designer及其插件加载失败。
[纯虚函数]
void QDesignerFormWindowManagerInterface::showPreview()
使用默认参数显示当前表单的预览。
另请参阅:closeAllPreviews。
© 2024 The Qt Company Ltd. 本文档中的文档贡献是各自所有者的版权。本文档受GNU自由文档许可证版本1.3的条款许可,由自由软件基金会发布。Qt及其相应标志是The Qt Company Ltd.在芬兰和/或其他国家的商标。所有其他商标均为其各自所有者的财产。