Qt Reference Documentation

- Qt 4.8
- ALL VERSIONS

- A
- A
- A
- Print

# QDesignerFormWindowManagerInterface Class Reference

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

     #include <QDesignerFormWindowManagerInterface>

Inherits: QObject.

- List of all members, including inherited members

## Public Functions

| QDesignerFormWindowManagerInterface ( QObject * parent = 0 )
virtual | ~QDesignerFormWindowManagerInterface ()
virtual QAction * | actionAdjustSize () const
virtual QAction * | actionBreakLayout () const
virtual QAction * | actionCopy () const
virtual QAction * | actionCut () const
virtual QAction * | actionDelete () const
QAction * | actionFormLayout () const
virtual QAction * | actionGridLayout () const
virtual QAction * | actionHorizontalLayout () const
virtual QAction * | actionLower () const
virtual QAction * | actionPaste () const
virtual QAction * | actionRaise () const
virtual QAction * | actionRedo () const
virtual QAction * | actionSelectAll () const
QAction * | actionSimplifyLayout () const
virtual QAction * | actionSplitHorizontal () const
virtual QAction * | actionSplitVertical () const
virtual QAction * | actionUndo () const
virtual QAction * | actionVerticalLayout () const
virtual QDesignerFormWindowInterface * | activeFormWindow () const
virtual QDesignerFormEditorInterface * | core () const
virtual QDesignerFormWindowInterface * | createFormWindow ( QWidget * parent = 0, Qt::WindowFlags flags = 0 )
virtual QDesignerFormWindowInterface * | formWindow ( int index ) const
virtual int | formWindowCount () const

- 29 public functions inherited from QObject

## Public Slots

virtual void | addFormWindow ( QDesignerFormWindowInterface * formWindow )
virtual void | removeFormWindow ( QDesignerFormWindowInterface * formWindow )
virtual void | setActiveFormWindow ( QDesignerFormWindowInterface * formWindow )

- 1 public slot inherited from QObject

## Signals

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

- 1 signal inherited from QObject

### Additional Inherited Members

- 1 property inherited from QObject
- 7 static public members inherited from QObject
- 8 protected functions inherited from QObject

## Detailed Description

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.

See also QDesignerFormEditorInterface and QDesignerFormWindowInterface.

## Member Function Documentation

### QDesignerFormWindowManagerInterface::QDesignerFormWindowManagerInterface ( QObject * parent = 0 )

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

### QDesignerFormWindowManagerInterface::~QDesignerFormWindowManagerInterface ()`[virtual]`

Destroys the interface for the form window manager.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

### QAction * QDesignerFormWindowManagerInterface::actionFormLayout () const

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

FormWindowManagerPrivateMap *fwmpm = g_FormWindowManagerPrivateMap();

This function was introduced in Qt 4.4.

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

### QAction * QDesignerFormWindowManagerInterface::actionSimplifyLayout () const

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

This function was introduced in Qt 4.4.

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also QAction.

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

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

See also setActiveFormWindow() and removeFormWindow().

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

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.

See also activeFormWindow().

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

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

See also formWindowAdded().

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

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

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

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

See also addFormWindow().

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

Returns the form window at the given index.

See also setActiveFormWindow() and removeFormWindow().

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

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.

See also addFormWindow() and setActiveFormWindow().

### int QDesignerFormWindowManagerInterface::formWindowCount () const`[virtual]`

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

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

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.

See also removeFormWindow().

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

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

See also formWindow() and formWindowRemoved().

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

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

See also activeFormWindow() and activeFormWindowChanged().