QDesignerFormWindowInterface Class Reference

#include <abstractformwindow.h>

Inheritance diagram for QDesignerFormWindowInterface:

Inheritance graph
[legend]
Collaboration diagram for QDesignerFormWindowInterface:

Collaboration graph
[legend]
List of all members.

Detailed Description

The QDesignerFormWindowInterface class allows you to query and manipulate form windows appearing in Qt Designer's workspace.

QtDesigner

QDesignerFormWindowInterface provides information about the associated form window as well as allowing its properties to be altered. The interface is not intended to be instantiated directly, but to provide access to 's current form windows controlled by 's {QDesignerFormWindowManagerInterface}{form window manager}.

If you are looking for the form window containing a specific widget, you can use the static QDesignerFormWindowInterface::findFormWindow() function:

    QDesignerFormWindowInterface *formWindow;
    formWindow = QDesignerFormWindowInterface::findFormWindow(myWidget);

But in addition, you can access any of the current form windows through 's form window manager: Use the QDesignerFormEditorInterface::formWindowManager() function to retrieve an interface to the manager. Once you have this interface, you have access to all of 's current form windows through the QDesignerFormWindowManagerInterface::formWindow() function. For example:

    QList<QDesignerFormWindowInterface *> forms;
    QDesignerFormWindowInterface *formWindow;

    QDesignerFormWindowManagerInterface *manager = formEditor->formWindowManager();

    for (int i = 0; i < manager->formWindowCount(); i++) {
        formWindow = manager->formWindow(i);
        forms.append(formWindow);
    }

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

Once you have the form window, you can query its properties. For example, a plain custom widget plugin is managed by only at its top level, i.e. none of its child widgets can be resized in 's workspace. But QDesignerFormWindowInterface provides you with functions that enables you to control whether a widget should be managed by , or not:

        if (formWindow->isManaged(myWidget))
            formWindow->manageWidget(myWidget->childWidget);

The complete list of functions concerning widget management is: isManaged(), manageWidget() and unmanageWidget(). There is also several associated signals: widgetManaged(), widgetRemoved(), aboutToUnmanageWidget() and widgetUnmanaged().

In addition to controlling the management of widgets, you can control the current selection in the form window using the selectWidget(), clearSelection() and emitSelectionChanged() functions, and the selectionChanged() signal.

You can also retrieve information about where the form is stored using absoluteDir(), its include files using includeHints(), and its layout and pixmap functions using layoutDefault(), layoutFunction() and pixmapFunction(). You can find out whether the form window has been modified (but not saved) or not, using the isDirty() function. You can retrieve its author(), its contents(), its fileName(), associated comment() and exportMacro(), its mainContainer(), its features(), its grid() and its resourceFiles().

The interface provides you with functions and slots allowing you to alter most of this information as well. The exception is the directory storing the form window. Finally, there is several signals associated with changes to the information mentioned above and to the form window in general.

See also:
QDesignerFormWindowCursorInterface, QDesignerFormEditorInterface, QDesignerFormWindowManagerInterface

Definition at line 40 of file abstractformwindow.h.

Public Types

enum  FeatureFlag

Public Slots

virtual void manageWidget (QWidget *widget)=0
virtual void unmanageWidget (QWidget *widget)=0
virtual void setFeatures (Feature f)=0
virtual void setDirty (bool dirty)=0
virtual void clearSelection (bool changePropertyDisplay=true)=0
virtual void selectWidget (QWidget *w, bool select=true)=0
virtual void setGrid (const QPoint &grid)=0
virtual void setFileName (const QString &fileName)=0
virtual void setContents (const QString &contents)=0
virtual void editWidgets ()=0

Signals

void mainContainerChanged (QWidget *mainContainer)
void toolChanged (int toolIndex)
void fileNameChanged (const QString &fileName)
void featureChanged (Feature f)
void selectionChanged ()
void geometryChanged ()
void resourceFilesChanged ()
void widgetManaged (QWidget *widget)
void widgetUnmanaged (QWidget *widget)
void aboutToUnmanageWidget (QWidget *widget)
void activated (QWidget *widget)
void changed ()
void widgetRemoved (QWidget *w)

Public Member Functions

 QDesignerFormWindowInterface (QWidget *parent=0, Qt::WindowFlags flags=0)
virtual ~QDesignerFormWindowInterface ()
virtual QString fileName () const=0
virtual QDir absoluteDir () const=0
virtual QString contents () const=0
virtual void setContents (QIODevice *dev)=0
virtual Feature features () const=0
virtual bool hasFeature (Feature f) const=0
virtual QString author () const=0
virtual void setAuthor (const QString &author)=0
virtual QString comment () const=0
virtual void setComment (const QString &comment)=0
virtual void layoutDefault (int *margin, int *spacing)=0
virtual void setLayoutDefault (int margin, int spacing)=0
virtual void layoutFunction (QString *margin, QString *spacing)=0
virtual void setLayoutFunction (const QString &margin, const QString &spacing)=0
virtual QString pixmapFunction () const=0
virtual void setPixmapFunction (const QString &pixmapFunction)=0
virtual QString exportMacro () const=0
virtual void setExportMacro (const QString &exportMacro)=0
virtual QStringList includeHints () const=0
virtual void setIncludeHints (const QStringList &includeHints)=0
virtual QDesignerFormEditorInterfacecore () const
virtual QDesignerFormWindowCursorInterfacecursor () const=0
virtual int toolCount () const=0
virtual int currentTool () const=0
virtual void setCurrentTool (int index)=0
virtual QDesignerFormWindowToolInterfacetool (int index) const=0
virtual void registerTool (QDesignerFormWindowToolInterface *tool)=0
virtual QPoint grid () const=0
virtual QWidgetmainContainer () const=0
virtual void setMainContainer (QWidget *mainContainer)=0
virtual bool isManaged (QWidget *widget) const=0
virtual bool isDirty () const=0
virtual QUndoStackcommandHistory () const=0
virtual void beginCommand (const QString &description)=0
virtual void endCommand ()=0
virtual void simplifySelection (QList< QWidget * > *widgets) const=0
virtual void emitSelectionChanged ()=0
virtual QStringList resourceFiles () const=0
virtual void addResourceFile (const QString &path)=0
virtual void removeResourceFile (const QString &path)=0
virtual void ensureUniqueObjectName (QObject *object)=0

Static Public Member Functions

static QDesignerFormWindowInterfacefindFormWindow (QWidget *w)


Member Enumeration Documentation

enum QDesignerFormWindowInterface::FeatureFlag

This enum describes the features that are available and can be controlled by the form window interface. These values are used when querying the form window to determine which features it supports:

EditFeature Form editing GridFeature Grid display and snap-to-grid facilities for editing TabOrderFeature Tab order management DefaultFeature Support for default features (form editing and grid)

See also:
hasFeature(), features()

Definition at line 44 of file abstractformwindow.h.

00045     {
00046         EditFeature = 0x01,
00047         GridFeature = 0x02,
00048         TabOrderFeature = 0x04,
00049         DefaultFeature = EditFeature | GridFeature
00050     };


Constructor & Destructor Documentation

QDesignerFormWindowInterface::QDesignerFormWindowInterface ( QWidget parent = 0,
Qt::WindowFlags  flags = 0 
)

Constructs a form window interface with the given parent and the specified window flags.

Definition at line 148 of file abstractformwindow.cpp.

00149     : QWidget(parent, flags)
00150 {
00151 }

QDesignerFormWindowInterface::~QDesignerFormWindowInterface (  )  [virtual]

Destroys the form window interface.

Definition at line 156 of file abstractformwindow.cpp.

00157 {
00158 }


Member Function Documentation

QString QDesignerFormWindowInterface::fileName (  )  const [pure virtual]

Returns the file name of the .ui file that describes the form currently being shown.

See also:
setFileName()

Referenced by QDesignerFormWindow::closeEvent(), QDesignerActions::saveForm(), QDesignerActions::saveFormAs(), QDesignerFormWindow::updateChanged(), and qdesigner_internal::ResourceEditor::updateUi().

QDir QDesignerFormWindowInterface::absoluteDir (  )  const [pure virtual]

Returns the absolute location of the directory containing the form shown in the form window.

Referenced by qdesigner_internal::ResourceEditor::itemActivated(), qdesigner_internal::ResourceEditor::itemChanged(), qdesigner_internal::ResourceEditor::newView(), qdesigner_internal::TreeWidgetEditor::on_previewPixmapColumnButton_clicked(), qdesigner_internal::TableWidgetEditor::on_previewPixmapColumnButton_clicked(), qdesigner_internal::TableWidgetEditor::on_previewPixmapRowButton_clicked(), qdesigner_internal::ResourceEditor::openView(), qdesigner_internal::ResourceEditor::qrcName(), qdesigner_internal::ResourceEditor::saveCurrentView(), and qdesigner_internal::ResourceEditor::setCurrentFile().

QString QDesignerFormWindowInterface::contents (  )  const [pure virtual]

Returns details of the contents of the form currently being displayed in the window.

Referenced by SaveFormAsTemplate::accept(), and QDesignerActions::writeOutForm().

void QDesignerFormWindowInterface::setContents ( QIODevice device  )  [pure virtual]

Sets the form's contents using data obtained from the given device.

Data can be read from QFile objects or any other subclass of QIODevice.

Feature QDesignerFormWindowInterface::features (  )  const [pure virtual]

Returns a combination of the features provided by the form window associated with the interface. The value returned can be tested against the Feature enum values to determine which features are supported by the window.

See also:
setFeatures(), hasFeature()

bool QDesignerFormWindowInterface::hasFeature ( Feature  feature  )  const [pure virtual]

Returns true if the form window offers the specified feature; otherwise returns false.

See also:
features()

Referenced by QDesignerWidget::paintEvent(), QLayoutWidget::paintEvent(), and QDesignerDialog::paintEvent().

QString QDesignerFormWindowInterface::author (  )  const [pure virtual]

Returns details of the author or creator of the form currently being displayed in the window.

void QDesignerFormWindowInterface::setAuthor ( const QString author  )  [pure virtual]

Sets the details for the author or creator of the form to the author specified.

Referenced by FormWindowSettings::accept().

QString QDesignerFormWindowInterface::comment (  )  const [pure virtual]

Returns comments about the form currently being displayed in the window.

void QDesignerFormWindowInterface::setComment ( const QString comment  )  [pure virtual]

Sets the information about the form to the comment specified. This information should be a human-readable comment about the form.

void QDesignerFormWindowInterface::layoutDefault ( int *  margin,
int *  spacing 
) [pure virtual]

Fills in the default margin and spacing for the form's default layout in the margin and spacing variables specified.

Referenced by FormWindowSettings::FormWindowSettings().

void QDesignerFormWindowInterface::setLayoutDefault ( int  margin,
int  spacing 
) [pure virtual]

Sets the default margin and spacing for the form's layout.

See also:
layoutDefault()

Referenced by FormWindowSettings::accept().

void QDesignerFormWindowInterface::layoutFunction ( QString margin,
QString spacing 
) [pure virtual]

Fills in the current margin and spacing for the form's layout in the margin and spacing variables specified.

Referenced by FormWindowSettings::FormWindowSettings().

void QDesignerFormWindowInterface::setLayoutFunction ( const QString margin,
const QString spacing 
) [pure virtual]

Sets the margin and spacing for the form's layout.

The default layout properties will be replaced by the corresponding layout functions when uic generates code for the form, that is, if the functions are specified. This is useful when different environments requires different layouts for the same form.

See also:
layoutFunction()

Referenced by FormWindowSettings::accept().

QString QDesignerFormWindowInterface::pixmapFunction (  )  const [pure virtual]

Returns the name of the function used to load pixmaps into the form window.

See also:
setPixmapFunction()

Referenced by FormWindowSettings::FormWindowSettings().

void QDesignerFormWindowInterface::setPixmapFunction ( const QString pixmapFunction  )  [pure virtual]

Sets the function used to load pixmaps into the form window to the given pixmapFunction.

See also:
pixmapFunction()

Referenced by FormWindowSettings::accept().

QString QDesignerFormWindowInterface::exportMacro (  )  const [pure virtual]

Returns the export macro associated with the form currently being displayed in the window. The export macro is used when the form is compiled to create a widget plugin.

See also:
{Creating Custom Widgets for Qt Designer}

void QDesignerFormWindowInterface::setExportMacro ( const QString exportMacro  )  [pure virtual]

Sets the form window's export macro to exportMacro. The export macro is used when building a widget plugin to export the form's interface to other components.

QStringList QDesignerFormWindowInterface::includeHints (  )  const [pure virtual]

Returns a list of the header files that will be included in the form window's associated .ui file.

Header files may be local, i.e. relative to the project's directory,"mywidget.h", or global, i.e. part of Qt or the compilers standard libraries:<QtGui/QWidget>.

See also:
setIncludeHints()

void QDesignerFormWindowInterface::setIncludeHints ( const QStringList includeHints  )  [pure virtual]

Sets the header files that will be included in the form window's associated .ui file to the specified includeHints.

Header files may be local, i.e. relative to the project's directory,"mywidget.h", or global, i.e. part of Qt or the compilers standard libraries:<QtGui/QWidget>.

See also:
includeHints()

Referenced by FormWindowSettings::accept().

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

Returns a pointer to 's current QDesignerFormEditorInterface object.

Definition at line 164 of file abstractformwindow.cpp.

Referenced by qdesigner_internal::Layout::breakLayout(), qdesigner_internal::QDesignerTaskMenu::changeObjectName(), QDesignerQ3WidgetStack::container(), QView3DTool::core(), QLayoutSupport::core(), qdesigner_internal::TabOrderEditorTool::core(), qdesigner_internal::SignalSlotEditorTool::core(), qdesigner_internal::BuddyEditorTool::core(), QDesignerMenu::createAction(), QDesignerToolBar::createAction(), QDesignerMenuBar::createAction(), qdesigner_internal::SignalSlotEditor::createConnection(), QDesignerMenu::createRealMenuAction(), qdesigner_internal::HorizontalLayout::doLayout(), qdesigner_internal::VerticalLayout::doLayout(), qdesigner_internal::GridLayout::doLayout(), qdesigner_internal::Layout::finishLayout(), QDesignerFormWindow::geometryChanged(), qdesigner_internal::QDesignerFormWindowCommand::hasLayout(), qdesigner_internal::SetPropertyCommand::init(), qdesigner_internal::DeleteWidgetCommand::init(), qdesigner_internal::CreateStatusBarCommand::init(), qdesigner_internal::AddToolBarCommand::init(), qdesigner_internal::AddStackedWidgetPageCommand::init(), qdesigner_internal::TabOrderCommand::init(), qdesigner_internal::SetFormPropertyCommand::init(), qdesigner_internal::AddToolBoxPageCommand::init(), qdesigner_internal::AddDockWidgetCommand::init(), qdesigner_internal::ResetPropertyCommand::init(), qdesigner_internal::BreakLayoutCommand::init(), qdesigner_internal::CreateMenuBarCommand::init(), qdesigner_internal::AddContainerWidgetPageCommand::init(), qdesigner_internal::InsertWidgetCommand::init(), qdesigner_internal::AddTabPageCommand::init(), qdesigner_internal::TabOrderEditor::initTabOrder(), QLayoutSupport::insertWidget(), qdesigner_internal::isPageOfContainerWidget(), qdesigner_internal::SignalSlotEditor::modifyConnection(), qdesigner_internal::TreeWidgetEditor::on_previewPixmapColumnButton_clicked(), qdesigner_internal::TableWidgetEditor::on_previewPixmapColumnButton_clicked(), qdesigner_internal::TableWidgetEditor::on_previewPixmapItemButton_clicked(), qdesigner_internal::TreeWidgetEditor::on_previewPixmapItemButton_clicked(), qdesigner_internal::ListWidgetEditor::on_previewPixmapItemButton_clicked(), qdesigner_internal::TableWidgetEditor::on_previewPixmapRowButton_clicked(), qdesigner_internal::Layout::prepareLayout(), qdesigner_internal::QDesignerTaskMenu::promoteToCustomWidget(), QLayoutSupport::QLayoutSupport(), QLayoutSupport::rebuildGridLayout(), qdesigner_internal::InsertWidgetCommand::redo(), qdesigner_internal::DeleteWidgetCommand::redo(), qdesigner_internal::AddDockWidgetCommand::redo(), qdesigner_internal::SetDockWidgetCommand::redo(), qdesigner_internal::ResetPropertyCommand::redo(), qdesigner_internal::AddToolBarCommand::redo(), qdesigner_internal::CreateMenuBarCommand::redo(), qdesigner_internal::BreakLayoutCommand::redo(), qdesigner_internal::CreateStatusBarCommand::redo(), QDesignerMenu::removeRealMenu(), qdesigner_internal::replace_widget_item(), Spacer::resizeEvent(), QDesignerDockWidget::setDocked(), qdesigner_internal::ObjectInspector::setFormWindow(), Spacer::setOrientation(), Spacer::setSizeHint(), qdesigner_internal::Layout::setup(), qdesigner_internal::SignalSlotEditor::SignalSlotEditor(), qdesigner_internal::TabOrderEditor::skipWidget(), qdesigner_internal::StyleSheetEditorDialog::StyleSheetEditorDialog(), qdesigner_internal::CreateStatusBarCommand::undo(), qdesigner_internal::InsertWidgetCommand::undo(), qdesigner_internal::LayoutCommand::undo(), qdesigner_internal::DeleteWidgetCommand::undo(), qdesigner_internal::AddDockWidgetCommand::undo(), qdesigner_internal::CreateMenuBarCommand::undo(), qdesigner_internal::AddToolBarCommand::undo(), qdesigner_internal::Layout::undoLayout(), qdesigner_internal::QDesignerFormWindowCommand::updateBuddies(), QView3D::updateForm(), qdesigner_internal::ResourceEditor::updateUi(), and qdesigner_internal::SignalSlotEditor::widgetAt().

00165 {
00166     return 0;
00167 }

QDesignerFormWindowCursorInterface * QDesignerFormWindowInterface::cursor (  )  const [pure virtual]

Returns the cursor interface used by the form window.

Reimplemented from QWidget.

Referenced by qdesigner_internal::StyleSheetEditorDialog::applyStyleSheet(), qdesigner_internal::QDesignerTaskMenu::changeObjectName(), qdesigner_internal::TabOrderEditor::initTabOrder(), qdesigner_internal::ObjectInspector::setFormWindow(), qdesigner_internal::setTopMinMaxSize(), QDesignerActions::showWidgetSpecificHelp(), qdesigner_internal::QDesignerIntegration::updateSelection(), and qdesigner_internal::GroupBoxTaskMenu::updateText().

int QDesignerFormWindowInterface::toolCount (  )  const [pure virtual]

Returns the number of tools available.

int QDesignerFormWindowInterface::currentTool (  )  const [pure virtual]

Returns the index of the current tool in use.

See also:
setCurrentTool()

Referenced by QDesignerWidget::paintEvent(), Spacer::paintEvent(), QDesignerDialog::paintEvent(), and QLayoutWidget::paintEvent().

void QDesignerFormWindowInterface::setCurrentTool ( int  index  )  [pure virtual]

Sets the current tool to be the one with the given index.

See also:
currentTool()

QDesignerFormWindowToolInterface * QDesignerFormWindowInterface::tool ( int  index  )  const [pure virtual]

Returns an interface to the tool with the given index.

void QDesignerFormWindowInterface::registerTool ( QDesignerFormWindowToolInterface tool  )  [pure virtual]

Registers the given tool with the form window.

Referenced by qdesigner_internal::TabOrderEditorPlugin::addFormWindow(), qdesigner_internal::BuddyEditorPlugin::addFormWindow(), QView3DPlugin::addFormWindow(), and qdesigner_internal::SignalSlotEditorPlugin::addFormWindow().

QPoint QDesignerFormWindowInterface::grid (  )  const [pure virtual]

Returns the grid spacing used by the form window.

See also:
setGrid()

Referenced by qdesigner_internal::LayoutCommand::init(), qdesigner_internal::BreakLayoutCommand::init(), and paintGrid().

QWidget * QDesignerFormWindowInterface::mainContainer (  )  const [pure virtual]

Returns the main container widget for the form window.

See also:
setMainContainer()

Referenced by qdesigner_internal::Layout::breakLayout(), qdesigner_internal::WidgetEditorTool::editor(), qdesigner_internal::findActionIn(), qdesigner_internal::InPlaceEditor::InPlaceEditor(), qdesigner_internal::Utils::isCentralWidget(), qdesigner_internal::isMainContainer(), QDesignerFormWindow::resizeEvent(), SaveFormAsTemplate::SaveFormAsTemplate(), qdesigner_internal::ActionEditor::setFormWindow(), qdesigner_internal::ObjectInspector::setFormWindow(), qdesigner_internal::setTopMinMaxSize(), qdesigner_internal::Layout::setup(), QDesignerToolBar::slotNewToolBar(), qdesigner_internal::QDesignerTaskMenu::taskActions(), qdesigner_internal::Layout::undoLayout(), QView3D::updateForm(), QDesignerFormWindow::updateWindowTitle(), and qdesigner_internal::SignalSlotEditor::widgetAt().

void QDesignerFormWindowInterface::setMainContainer ( QWidget mainContainer  )  [pure virtual]

Sets the main container widget on the form to the specified mainContainer.

See also:
mainContainer(), mainContainerChanged()

bool QDesignerFormWindowInterface::isManaged ( QWidget widget  )  const [pure virtual]

Returns true if the specified widget is managed by the form window; otherwise returns false.

See also:
manageWidget()

Referenced by qdesigner_internal::Layout::finishLayout(), and qdesigner_internal::ObjectInspector::setFormWindow().

bool QDesignerFormWindowInterface::isDirty (  )  const [pure virtual]

Returns true if the form window is "dirty" (modified but not saved); otherwise returns false.

See also:
setDirty()

Referenced by QDesignerFormWindow::closeEvent(), and QDesignerFormWindow::updateChanged().

QDesignerFormWindowInterface * QDesignerFormWindowInterface::findFormWindow ( QWidget widget  )  [static]

Returns the form window interface for the given widget.

Definition at line 174 of file abstractformwindow.cpp.

References QWidget::parentWidget(), and w.

Referenced by QDesignerStackedWidget::addPage(), QDesignerToolBox::addPage(), QDesignerToolBox::addPageAfter(), QDesignerStackedWidget::addPageAfter(), QDesignerToolBox::changeOrder(), QDesignerStackedWidget::changeOrder(), qdesigner_internal::PropertyEditor::createPropertySheet(), qdesigner_internal::WidgetFactory::createWidget(), MultiPageWidgetPlugin::currentIndexChanged(), qdesigner_internal::ComboBoxTaskMenu::editItems(), qdesigner_internal::TreeWidgetTaskMenu::editItems(), qdesigner_internal::ListWidgetTaskMenu::editItems(), qdesigner_internal::TableWidgetTaskMenu::editItems(), qdesigner_internal::LabelTaskMenu::editText(), qdesigner_internal::ButtonTaskMenu::editText(), qdesigner_internal::LineEditTaskMenu::editText(), qdesigner_internal::TextEditTaskMenu::editText(), qdesigner_internal::ToolBarTaskMenu::editToolBar(), qdesigner_internal::FormWindow::findFormWindow(), qdesigner_internal::QDesignerTaskMenu::formWindow(), qdesigner_internal::ContainerWidgetTaskMenu::formWindow(), QDesignerMenuBar::formWindow(), QDesignerQ3WidgetStack::formWindow(), QDesignerTabWidget::formWindow(), QDesignerMenu::formWindow(), QDesignerToolBar::formWindow(), QDesignerDockWidget::formWindow(), QDesignerStackedWidget::nextPage(), MultiPageWidgetPlugin::pageTitleChanged(), QDesignerStackedWidget::prevPage(), QDesignerStackedWidget::removeCurrentPage(), QDesignerToolBox::removeCurrentPage(), TicTacToeDialog::saveState(), qdesigner_internal::FormWindowManager::setItemsPos(), QDesignerToolBox::slotCurrentChanged(), QDesignerStackedWidget::slotCurrentChanged(), Spacer::Spacer(), and qdesigner_internal::QDesignerTaskMenu::taskActions().

00175 {
00176     while (w != 0) {
00177         if (QDesignerFormWindowInterface *fw = qobject_cast<QDesignerFormWindowInterface*>(w)) {
00178             return fw;
00179         } else if (w->isWindow()) {
00180             break;
00181         }
00182 
00183         w = w->parentWidget();
00184     }
00185 
00186     return 0;
00187 }

Here is the call graph for this function:

QUndoStack * QDesignerFormWindowInterface::commandHistory (  )  const [pure virtual]

Returns an object that can be used to obtain the commands used so far in the construction of the form.

Referenced by qdesigner_internal::ContainerWidgetTaskMenu::addPage(), qdesigner_internal::ContainerWidgetTaskMenu::addPageAfter(), QDesignerToolBox::changeOrder(), QDesignerStackedWidget::changeOrder(), QDesignerToolBar::createAction(), QDesignerMenu::createAction(), QDesignerMenuBar::createAction(), QDesignerMenu::deleteAction(), QDesignerMenuBar::deleteMenu(), qdesigner_internal::QDesignerTaskMenu::demoteFromCustomWidget(), QDesignerToolBar::dropEvent(), QDesignerMenu::dropEvent(), QDesignerMenuBar::dropEvent(), qdesigner_internal::ActionEditor::editAction(), QDesignerMenu::enterEditMode(), QDesignerTabWidget::eventFilter(), qdesigner_internal::TableWidgetEditor::fillTableWidgetFromContents(), qdesigner_internal::TreeWidgetEditor::fillTreeWidgetFromContents(), QDesignerMenuBar::leaveEditMode(), QDesignerMenu::leaveEditMode(), qdesigner_internal::TabOrderEditor::mousePressEvent(), qdesigner_internal::QDesignerTaskMenu::promoteToCustomWidget(), QDesignerFormWindow::QDesignerFormWindow(), qdesigner_internal::ContainerWidgetTaskMenu::removeCurrentPage(), qdesigner_internal::ActionEditor::slotDeleteAction(), QDesignerToolBar::slotInsertSeparator(), qdesigner_internal::ActionEditor::slotNewAction(), QDesignerToolBar::slotNewToolBar(), QDesignerMenuBar::slotRemoveMenuBar(), QDesignerToolBar::slotRemoveSelectedAction(), QDesignerMenu::slotRemoveSelectedAction(), QDesignerMenuBar::slotRemoveSelectedAction(), QDesignerToolBar::slotRemoveToolBar(), QDesignerMenuBar::startDrag(), QDesignerMenu::startDrag(), QDesignerToolBar::startDrag(), QDesignerMenu::swap(), and QDesignerMenuBar::swap().

void QDesignerFormWindowInterface::beginCommand ( const QString description  )  [pure virtual]

Begins execution of a command with the given description. Commands are executed between beginCommand() and endCommand() function calls to ensure that they are recorded on the undo stack.

See also:
endCommand()

Referenced by QDesignerToolBox::changeOrder(), QDesignerStackedWidget::changeOrder(), QDesignerMenuBar::deleteMenu(), QDesignerMenu::dropEvent(), qdesigner_internal::ActionEditor::editAction(), QDesignerMenu::enterEditMode(), QDesignerMenuBar::leaveEditMode(), QDesignerMenu::leaveEditMode(), qdesigner_internal::SignalSlotEditor::setSignal(), qdesigner_internal::SignalSlotEditor::setSlot(), qdesigner_internal::SignalSlotEditor::setSource(), qdesigner_internal::SignalSlotEditor::setTarget(), QDesignerToolBar::slotInsertSeparator(), QDesignerMenu::swap(), and QDesignerMenuBar::swap().

void QDesignerFormWindowInterface::endCommand (  )  [pure virtual]

Ends execution of the current command.

See also:
beginCommand()

Referenced by QDesignerToolBox::changeOrder(), QDesignerStackedWidget::changeOrder(), QDesignerMenuBar::deleteMenu(), QDesignerMenu::dropEvent(), qdesigner_internal::ActionEditor::editAction(), QDesignerMenu::enterEditMode(), QDesignerMenuBar::leaveEditMode(), QDesignerMenu::leaveEditMode(), qdesigner_internal::SignalSlotEditor::setSignal(), qdesigner_internal::SignalSlotEditor::setSlot(), qdesigner_internal::SignalSlotEditor::setSource(), qdesigner_internal::SignalSlotEditor::setTarget(), QDesignerToolBar::slotInsertSeparator(), QDesignerMenu::swap(), and QDesignerMenuBar::swap().

void QDesignerFormWindowInterface::simplifySelection ( QList< QWidget * > *  widgets  )  const [pure virtual]

Simplifies the selection of widgets specified by widgets.

See also:
selectionChanged()

Referenced by qdesigner_internal::LayoutCommand::init().

void QDesignerFormWindowInterface::emitSelectionChanged (  )  [pure virtual]

Emits the selectionChanged() signal.

See also:
selectWidget(), clearSelection()

Referenced by qdesigner_internal::DeleteToolBarCommand::redo(), qdesigner_internal::AddDockWidgetCommand::redo(), qdesigner_internal::DeleteWidgetCommand::redo(), qdesigner_internal::InsertWidgetCommand::redo(), qdesigner_internal::AddToolBarCommand::redo(), qdesigner_internal::CreateMenuBarCommand::redo(), qdesigner_internal::DeleteStatusBarCommand::redo(), qdesigner_internal::CreateStatusBarCommand::redo(), qdesigner_internal::DeleteMenuBarCommand::redo(), QDesignerDockWidget::setDocked(), qdesigner_internal::DeleteMenuBarCommand::undo(), qdesigner_internal::CreateStatusBarCommand::undo(), qdesigner_internal::DeleteToolBarCommand::undo(), qdesigner_internal::InsertWidgetCommand::undo(), qdesigner_internal::AddDockWidgetCommand::undo(), qdesigner_internal::DeleteWidgetCommand::undo(), qdesigner_internal::AddToolBarCommand::undo(), qdesigner_internal::DeleteStatusBarCommand::undo(), and qdesigner_internal::CreateMenuBarCommand::undo().

QStringList QDesignerFormWindowInterface::resourceFiles (  )  const [pure virtual]

Returns a list of paths to resource files that are currently being used by the form window.

See also:
addResourceFile(), removeResourceFile()

Referenced by qdesigner_internal::ResourceEditor::updateQrcStack().

void QDesignerFormWindowInterface::addResourceFile ( const QString path  )  [pure virtual]

Adds the resource file at the given path to those used by the form.

See also:
resourceFiles(), resourceFilesChanged()

Referenced by qdesigner_internal::ResourceEditor::addView(), and qdesigner_internal::ResourceEditor::saveCurrentView().

void QDesignerFormWindowInterface::removeResourceFile ( const QString path  )  [pure virtual]

Removes the resource file at the specified path from the list of those used by the form.

See also:
resourceFiles(), resourceFilesChanged()

Referenced by qdesigner_internal::ResourceEditor::removeCurrentView().

void QDesignerFormWindowInterface::ensureUniqueObjectName ( QObject object  )  [pure virtual]

Ensures that the specified object has a unique name amongst the other objects on the form.

Referenced by QDesignerMenu::createAction(), QDesignerToolBar::createAction(), QDesignerMenuBar::createAction(), QDesignerMenu::createRealMenuAction(), qdesigner_internal::AddStackedWidgetPageCommand::init(), qdesigner_internal::AddToolBoxPageCommand::init(), qdesigner_internal::AddContainerWidgetPageCommand::init(), qdesigner_internal::AddTabPageCommand::init(), qdesigner_internal::Layout::prepareLayout(), qdesigner_internal::AddDockWidgetCommand::redo(), qdesigner_internal::AddToolBarCommand::redo(), qdesigner_internal::CreateMenuBarCommand::redo(), and qdesigner_internal::CreateStatusBarCommand::redo().

void QDesignerFormWindowInterface::manageWidget ( QWidget widget  )  [pure virtual, slot]

Instructs the form window to manage the specified widget.

See also:
isManaged(), unmanageWidget(), widgetManaged()

Referenced by qdesigner_internal::Layout::finishLayout(), qdesigner_internal::InsertWidgetCommand::redo(), qdesigner_internal::AddDockWidgetCommand::redo(), qdesigner_internal::PromoteToCustomWidgetCommand::redo(), qdesigner_internal::DeleteWidgetCommand::undo(), and qdesigner_internal::PromoteToCustomWidgetCommand::undo().

void QDesignerFormWindowInterface::unmanageWidget ( QWidget widget  )  [pure virtual, slot]

Instructs the form window not to manage the specified widget.

See also:
aboutToUnmanageWidget(), widgetUnmanaged()

Referenced by qdesigner_internal::Layout::breakLayout(), qdesigner_internal::DeleteWidgetCommand::redo(), qdesigner_internal::SetDockWidgetCommand::redo(), qdesigner_internal::InsertWidgetCommand::undo(), qdesigner_internal::PromoteToCustomWidgetCommand::undo(), qdesigner_internal::AddDockWidgetCommand::undo(), and qdesigner_internal::Layout::undoLayout().

void QDesignerFormWindowInterface::setFeatures ( Feature  features  )  [pure virtual, slot]

Enables the specified features for the form window.

See also:
features(), featureChanged()

void QDesignerFormWindowInterface::setDirty ( bool  dirty  )  [pure virtual, slot]

If dirty is true, the form window is marked as dirty, meaning that it is modified but not saved. If dirty is false, the form window is considered to be unmodified.

See also:
isDirty()

Referenced by FormWindowSettings::accept(), QDesignerFormWindow::closeEvent(), QDesignerWorkbench::handleClose(), QDesignerActions::readInForm(), QDesignerFormWindow::resizeEvent(), QDesignerActions::showFormSettings(), and QDesignerActions::writeOutForm().

void QDesignerFormWindowInterface::clearSelection ( bool  update = true  )  [pure virtual, slot]

Clears the current selection in the form window. If update is true, the emitSelectionChanged() function is called, emitting the selectionChanged() signal.

See also:
selectWidget()

Referenced by qdesigner_internal::ChangeLayoutItemGeometry::changeItemPosition(), qdesigner_internal::PromoteToCustomWidgetCommand::redo(), qdesigner_internal::BreakLayoutCommand::redo(), qdesigner_internal::BreakLayoutCommand::undo(), and qdesigner_internal::PromoteToCustomWidgetCommand::undo().

void QDesignerFormWindowInterface::selectWidget ( QWidget widget,
bool  select = true 
) [pure virtual, slot]

If select is true, the given widget is selected; otherwise the widget is deselected.

See also:
clearSelection(), selectionChanged()

Referenced by qdesigner_internal::Layout::breakLayout(), qdesigner_internal::ChangeLayoutItemGeometry::changeItemPosition(), qdesigner_internal::Layout::finishLayout(), qdesigner_internal::PromoteToCustomWidgetCommand::redo(), qdesigner_internal::PromoteToCustomWidgetCommand::undo(), and qdesigner_internal::Layout::undoLayout().

void QDesignerFormWindowInterface::setGrid ( const QPoint grid  )  [pure virtual, slot]

Sets the grid size for the form window to the point specified by grid. In this function, the coordinates in the QPoint are used to specify the dimensions of a rectangle in the grid.

See also:
grid()

void QDesignerFormWindowInterface::setFileName ( const QString fileName  )  [pure virtual, slot]

Sets the file name for the form to the given fileName.

See also:
fileName(), fileNameChanged()

Referenced by NewForm::on_buttonBox_clicked(), QDesignerActions::saveFormAs(), and QDesignerActions::writeOutForm().

void QDesignerFormWindowInterface::setContents ( const QString contents  )  [pure virtual, slot]

Sets the contents of the form using data read from the specified contents string.

See also:
contents()

void QDesignerFormWindowInterface::editWidgets (  )  [pure virtual, slot]

Switches the form window into editing mode.

See also:
{Qt Designer's Form Editing Mode}

Referenced by QDesignerActions::editWidgetsSlot().

void QDesignerFormWindowInterface::mainContainerChanged ( QWidget mainContainer  )  [signal]

This signal is emitted whenever the main container changes. The new container is specified by mainContainer.

See also:
setMainContainer()

Referenced by qdesigner_internal::FormWindow::setMainContainer().

void QDesignerFormWindowInterface::toolChanged ( int  toolIndex  )  [signal]

This signal is emitted whenever the current tool changes. The specified toolIndex is the index of the new tool in the list of tools in the widget box.

Referenced by qdesigner_internal::FormWindow::init().

void QDesignerFormWindowInterface::fileNameChanged ( const QString fileName  )  [signal]

This signal is emitted whenever the file name of the form changes. The new file name is specified by fileName.

See also:
setFileName()

Referenced by qdesigner_internal::FormWindow::setFileName().

void QDesignerFormWindowInterface::featureChanged ( Feature  feature  )  [signal]

This signal is emitted whenever a feature changes in the form. The new feature is specified by feature.

See also:
setFeatures()

Referenced by qdesigner_internal::FormWindow::setFeatures().

void QDesignerFormWindowInterface::selectionChanged (  )  [signal]

This signal is emitted whenever the selection in the form changes.

See also:
selectWidget(), clearSelection()

Referenced by qdesigner_internal::FormWindow::selectionChangedTimerDone().

void QDesignerFormWindowInterface::geometryChanged (  )  [signal]

This signal is emitted whenever the form's geometry changes.

Referenced by qdesigner_internal::FormWindow::init().

void QDesignerFormWindowInterface::resourceFilesChanged (  )  [signal]

This signal is emitted whenever the list of resource files used by the form changes.

See also:
resourceFiles()

Referenced by qdesigner_internal::FormWindow::addResourceFile(), and qdesigner_internal::FormWindow::removeResourceFile().

void QDesignerFormWindowInterface::widgetManaged ( QWidget widget  )  [signal]

This signal is emitted whenever a widget on the form becomes managed. The newly managed widget is specified by widget.

See also:
manageWidget()

Referenced by qdesigner_internal::FormWindow::manageWidget().

void QDesignerFormWindowInterface::widgetUnmanaged ( QWidget widget  )  [signal]

This signal is emitted whenever a widget on the form becomes unmanaged. The newly released widget is specified by widget.

See also:
unmanageWidget(), aboutToUnmanageWidget()

Referenced by qdesigner_internal::FormWindow::unmanageWidget().

void QDesignerFormWindowInterface::aboutToUnmanageWidget ( QWidget widget  )  [signal]

This signal is emitted whenever a widget on the form is about to become unmanaged. When this signal is emitted, the specified widget is still managed, and a widgetUnmanaged() signal will follow, indicating when it is no longer managed.

See also:
unmanageWidget(), isManaged()

Referenced by qdesigner_internal::FormWindow::unmanageWidget().

void QDesignerFormWindowInterface::activated ( QWidget widget  )  [signal]

This signal is emitted whenever a widget is activated on the form. The activated widget is specified by widget.

Referenced by qdesigner_internal::FormWindow::handleMouseButtonDblClickEvent().

void QDesignerFormWindowInterface::changed (  )  [signal]

This signal is emitted whenever a form is changed.

Referenced by qdesigner_internal::FormWindow::init(), qdesigner_internal::FormWindow::manageWidget(), qdesigner_internal::FormWindow::setContents(), and qdesigner_internal::FormWindow::unmanageWidget().

void QDesignerFormWindowInterface::widgetRemoved ( QWidget widget  )  [signal]

This signal is emitted whenever a widget is removed from the form. The widget that was removed is specified by widget.

Referenced by qdesigner_internal::FormWindow::deleteWidgets().


The documentation for this class was generated from the following files:
Generated on Thu Mar 15 17:15:42 2007 for Qt 4.2 User's Guide by  doxygen 1.5.1