QDesignerFormWindowManagerInterface Class

The QDesignerFormWindowManagerInterface class allows you to manipulate the collection of form windows in Qt Designer, and control Qt Designer's form editing actions. 更多...

头文件: #include <QDesignerFormWindowManagerInterface>
qmake: QT += designer
基类: QObject
派生类:

qdesigner_internal::QDesignerFormWindowManager

公有类型

enum Action { CutAction, CopyAction, PasteAction, DeleteAction, ..., FormWindowSettingsDialogAction }
enum ActionGroup { StyledPreviewActionGroup }

公有函数

QDesignerFormWindowManagerInterface(QObject *parent = Q_NULLPTR)
virtual ~QDesignerFormWindowManagerInterface()
virtual QAction *action(Action action) const = 0
virtual QActionGroup *actionGroup(ActionGroup actionGroup) const = 0
virtual QDesignerFormWindowInterface *activeFormWindow() const = 0
virtual QDesignerFormEditorInterface *core() const = 0
virtual QDesignerFormWindowInterface *createFormWindow(QWidget *parent = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags()) = 0
virtual QPixmap createPreviewPixmap() const = 0
virtual QDesignerFormWindowInterface *formWindow(int index) const = 0
virtual int formWindowCount() const = 0
  • 32 个公有函数继承自 QObject

公有槽函数

virtual void addFormWindow(QDesignerFormWindowInterface *formWindow) = 0
virtual void closeAllPreviews() = 0
virtual void removeFormWindow(QDesignerFormWindowInterface *formWindow) = 0
virtual void setActiveFormWindow(QDesignerFormWindowInterface *formWindow) = 0
virtual void showPluginDialog() = 0
virtual void showPreview() = 0
  • 1 个公有槽函数继承自 QObject

信号

void activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)
void formWindowAdded(QDesignerFormWindowInterface *formWindow)
void formWindowRemoved(QDesignerFormWindowInterface *formWindow)
void formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)

其他继承的成员

  • 1 个属性继承自 QObject
  • 1 个公有变量继承自 QObject
  • 10 个静态公有成员继承自 QObject
  • 9 个受保护的函数继承自 QObject
  • 2 个受保护的变量继承自 QObject

详细描述

The QDesignerFormWindowManagerInterface class allows you to manipulate the collection of form windows in Qt Designer, and control Qt Designer's form editing actions.

QDesignerFormWindowManagerInterface is not intended to be instantiated directly. Qt Designer uses the form window manager to control the various form windows in its workspace. You can retrieve an interface to Qt Designer's form window manager using the QDesignerFormEditorInterface::formWindowManager() function. For example:


          QDesignerFormWindowManagerInterface *manager = 0;
          QDesignerFormWindowInterface *formWindow = 0;

          manager = formEditor->formWindowManager();
          formWindow = manager->formWindow(0);

          manager->setActiveFormWindow(formWindow);

When implementing a custom widget plugin, a pointer to Qt Designer's current QDesignerFormEditorInterface object (formEditor in the example above) is provided by the QDesignerCustomWidgetInterface::initialize() function's parameter. You must subclass the QDesignerCustomWidgetInterface to expose your plugin to Qt Designer.

The form window manager interface provides the createFormWindow() function that enables you to create a new form window which you can add to the collection of form windows that the manager maintains, using the addFormWindow() slot. It also provides the formWindowCount() function returning the number of form windows currently under the manager's control, the formWindow() function returning the form window associated with a given index, and the activeFormWindow() function returning the currently selected form window. The removeFormWindow() slot allows you to reduce the number of form windows the manager must maintain, and the setActiveFormWindow() slot allows you to change the form window focus in Qt Designer's workspace.

In addition, QDesignerFormWindowManagerInterface contains a collection of functions that enables you to intervene and control Qt Designer's form editing actions. All these functions return the original action, making it possible to propagate the function further after intervention.

Finally, the interface provides three signals which are emitted when a form window is added, when the currently selected form window changes, or when a form window is removed, respectively. All the signals carry the form window in question as their parameter.

参见 QDesignerFormEditorInterface and QDesignerFormWindowInterface.

成员类型

enum QDesignerFormWindowManagerInterface::Action

Specifies an action of Qt Designer.

ConstantValueDescription
QDesignerFormWindowManagerInterface::CutAction100Clipboard Cut
QDesignerFormWindowManagerInterface::CopyAction101Clipboard Copy
QDesignerFormWindowManagerInterface::PasteAction102Clipboard Paste
QDesignerFormWindowManagerInterface::DeleteAction103Clipboard Delete
QDesignerFormWindowManagerInterface::SelectAllAction104Select All
QDesignerFormWindowManagerInterface::LowerAction200Lower current widget
QDesignerFormWindowManagerInterface::RaiseAction201Raise current widget
QDesignerFormWindowManagerInterface::UndoAction300Undo
QDesignerFormWindowManagerInterface::RedoAction301Redo
QDesignerFormWindowManagerInterface::HorizontalLayoutAction400Lay out using QHBoxLayout
QDesignerFormWindowManagerInterface::VerticalLayoutAction401Lay out using QVBoxLayout
QDesignerFormWindowManagerInterface::SplitHorizontalAction402Lay out in horizontal QSplitter
QDesignerFormWindowManagerInterface::SplitVerticalAction403Lay out in vertical QSplitter
QDesignerFormWindowManagerInterface::GridLayoutAction404Lay out using QGridLayout
QDesignerFormWindowManagerInterface::FormLayoutAction405Lay out using QFormLayout
QDesignerFormWindowManagerInterface::BreakLayoutAction406Break existing layout
QDesignerFormWindowManagerInterface::AdjustSizeAction407Adjust size
QDesignerFormWindowManagerInterface::SimplifyLayoutAction408Simplify QGridLayout or QFormLayout
QDesignerFormWindowManagerInterface::DefaultPreviewAction500Create a preview in default style
QDesignerFormWindowManagerInterface::FormWindowSettingsDialogAction600Show dialog with form settings

This enum was introduced or modified in Qt 5.0.

参见 action().

enum QDesignerFormWindowManagerInterface::ActionGroup

Specifies an action group of Qt Designer.

ConstantValueDescription
QDesignerFormWindowManagerInterface::StyledPreviewActionGroup100Action group containing styled preview actions

This enum was introduced or modified in Qt 5.0.

参见 actionGroup().

成员函数

QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface(QObject *parent = Q_NULLPTR)

Constructs an interface with the given parent for the form window manager.

[virtual] QDesignerFormWindowManagerInterface::~QDesignerFormWindowManagerInterface()

Destroys the interface for the form window manager.

[pure virtual] QAction *QDesignerFormWindowManagerInterface::action(Action action) const

Returns the action specified by the enumeration value action.

Obsoletes the action accessors of Qt 4.X.

This function was introduced in Qt 5.0.

[pure virtual] QActionGroup *QDesignerFormWindowManagerInterface::actionGroup(ActionGroup actionGroup) const

Returns the action group specified by the enumeration value actionGroup.

This function was introduced in Qt 5.0.

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::activeFormWindow() const

Returns the currently active form window in Qt Designer's workspace.

参见 setActiveFormWindow() and removeFormWindow().

[signal] void QDesignerFormWindowManagerInterface::activeFormWindowChanged(QDesignerFormWindowInterface *formWindow)

This signal is emitted when the contents of the currently active form window in Qt Designer's workspace changed. A pointer to the currently active formWindow is passed as an argument.

参见 activeFormWindow().

[pure virtual slot] void QDesignerFormWindowManagerInterface::addFormWindow(QDesignerFormWindowInterface *formWindow)

Adds the given formWindow to the collection of windows that Qt Designer's form window manager maintains.

参见 formWindowAdded().

[pure virtual slot] void QDesignerFormWindowManagerInterface::closeAllPreviews()

Close all currently open previews.

This function was introduced in Qt 5.0.

参见 showPreview().

[pure virtual] QDesignerFormEditorInterface *QDesignerFormWindowManagerInterface::core() const

Returns a pointer to Qt Designer's current QDesignerFormEditorInterface object.

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::createFormWindow(QWidget *parent = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags())

Creates a form window with the given parent and the given window flags.

参见 addFormWindow().

[pure virtual] QPixmap QDesignerFormWindowManagerInterface::createPreviewPixmap() const

[pure virtual] QDesignerFormWindowInterface *QDesignerFormWindowManagerInterface::formWindow(int index) const

Returns the form window at the given index.

参见 setActiveFormWindow() and removeFormWindow().

[signal] void QDesignerFormWindowManagerInterface::formWindowAdded(QDesignerFormWindowInterface *formWindow)

This signal is emitted when a new form window is added to the collection of windows that Qt Designer's form window manager maintains. A pointer to the new formWindow is passed as an argument.

参见 addFormWindow() and setActiveFormWindow().

[pure virtual] int QDesignerFormWindowManagerInterface::formWindowCount() const

Returns the number of form windows maintained by Qt Designer's form window manager.

[signal] void QDesignerFormWindowManagerInterface::formWindowRemoved(QDesignerFormWindowInterface *formWindow)

This signal is emitted when a form window is removed from the collection of windows that Qt Designer's form window manager maintains. A pointer to the removed formWindow is passed as an argument.

参见 removeFormWindow().

[signal] void QDesignerFormWindowManagerInterface::formWindowSettingsChanged(QDesignerFormWindowInterface *formWindow)

This signal is emitted when the settings of the form window change. It can be used to update window titles, etc. accordingly. A pointer to the formWindow is passed as an argument.

参见 FormWindowSettingsDialogAction.

[pure virtual slot] void QDesignerFormWindowManagerInterface::removeFormWindow(QDesignerFormWindowInterface *formWindow)

Removes the given formWindow from the collection of windows that Qt Designer's form window manager maintains.

参见 formWindow() and formWindowRemoved().

[pure virtual slot] void QDesignerFormWindowManagerInterface::setActiveFormWindow(QDesignerFormWindowInterface *formWindow)

Sets the given formWindow to be the currently active form window in Qt Designer's workspace.

参见 activeFormWindow() and activeFormWindowChanged().

[pure virtual slot] void QDesignerFormWindowManagerInterface::showPluginDialog()

Opens a dialog showing the plugins loaded by Qt Designer's and its plugin load failures.

This function was introduced in Qt 5.0.

[pure virtual slot] void QDesignerFormWindowManagerInterface::showPreview()

Show a preview of the current form using the default parameters.

This function was introduced in Qt 5.0.

参见 closeAllPreviews().