Contents

• Public Functions
• Public Slots
• Signals
• Detailed Description

Detailed Description

TheQDesignerFormWindowManagerInterface 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 toQt Designer's form window manager using theQDesignerFormEditorInterface::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 toQt Designer's currentQDesignerFormEditorInterface object (formEditor in the example above) is provided by theQDesignerCustomWidgetInterface::initialize() function's parameter. You must subclass theQDesignerCustomWidgetInterface to expose your plugin to Qt Designer.

The form window manager interface provides thecreateFormWindow() 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 theaddFormWindow() slot. It also provides theformWindowCount() function returning the number of form windows currently under the manager's control, theformWindow() function returning the form window associated with a given index, and theactiveFormWindow() function returning the currently selected form window. TheremoveFormWindow() slot allows you to reduce the number of form windows the manager must maintain, and thesetActiveFormWindow() slot allows you to change the form window focus inQt Designer's workspace.

In addition,QDesignerFormWindowManagerInterface contains a collection of functions that enables you to intervene and controlQt 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.

Member Function Documentation

QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface(QObject * parent = 0)

Constructs an interface with the givenparent for the form window manager.

[virtual]QDesignerFormWindowManagerInterface::~QDesignerFormWindowManagerInterface()

Destroys the interface for the form window manager.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionAdjustSize() const

Allows you to intervene and controlQt Designer's "adjust size" action. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionBreakLayout() const

Allows you to intervene and controlQt Designer's "break layout" action. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionCopy() const

Allows you to intervene and controlQt Designer's "copy" action. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionCut() const

Allows you to intervene and controlQt Designer's "cut" action. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionDelete() const

Allows you to intervene and controlQt Designer's "delete" action. The function returns the original action.

See alsoQAction.

QAction * QDesignerFormWindowManagerInterface::actionFormLayout() const

Allows you to intervene and controlQt Designer's "form layout" action. The function returns the original action.

FormWindowManagerPrivateMap *fwmpm = g_FormWindowManagerPrivateMap();

This function was introduced in Qt 4.4.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionGridLayout() const

Allows you to intervene and control a request for grid layout for a form window inQt Designer's workspace. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionHorizontalLayout() const

Allows you to intervene and control a request for horizontal layout for a form window inQt Designer's workspace. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionLower() const

Allows you to intervene and control the action of lowering a form window inQt Designer's workspace. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionPaste() const

Allows you to intervene and controlQt Designer's "paste" action. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionRaise() const

Allows you to intervene and control the action of raising of a form window inQt Designer's workspace. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionRedo() const

Allows you to intervene and controlQt Designer's "redo" action. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionSelectAll() const

Allows you to intervene and controlQt Designer's "select all" action. The function returns the original action.

See alsoQAction.

QAction * QDesignerFormWindowManagerInterface::actionSimplifyLayout() const

Allows you to intervene and controlQt Designer's "simplify layout" action. The function returns the original action.

This function was introduced in Qt 4.4.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionSplitHorizontal() const

Allows you to intervene and controlQt Designer's "split horizontal" action. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionSplitVertical() const

Allows you to intervene and controlQt Designer's "split vertical" action. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionUndo() const

Allows you to intervene and controlQt Designer's "undo" action. The function returns the original action.

See alsoQAction.

[virtual]QAction * QDesignerFormWindowManagerInterface::actionVerticalLayout() const

Allows you to intervene and control a request for vertical layout for a form window inQt Designer's workspace. The function returns the original action.

See alsoQAction.

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

Returns the currently active form window inQt Designer's workspace.

See alsosetActiveFormWindow() andremoveFormWindow().

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

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

See alsoactiveFormWindow().

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

Adds the givenformWindow to the collection of windows thatQt Designer's form window manager maintains.

See alsoformWindowAdded().

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

Returns a pointer toQt Designer's currentQDesignerFormEditorInterface object.

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

Creates a form window with the givenparent and the given windowflags.

See alsoaddFormWindow().

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

Returns the form window at the givenindex.

See alsosetActiveFormWindow() andremoveFormWindow().

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

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

See alsoaddFormWindow() andsetActiveFormWindow().

[virtual]int QDesignerFormWindowManagerInterface::formWindowCount() const

Returns the number of form windows maintained byQt 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 thatQt Designer's form window manager maintains. A pointer to the removedformWindow is passed as an argument.

See alsoremoveFormWindow().

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

Removes the givenformWindow from the collection of windows thatQt Designer's form window manager maintains.

See alsoformWindow() andformWindowRemoved().

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

Sets the givenformWindow to be the currently active form window inQt Designer's workspace.

See alsoactiveFormWindow() andactiveFormWindowChanged().