Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QMdiArea Class Reference
^{[модуль QtGui ]}

The QMdiArea widget provides an area in which MDI windows are displayed. Далее...

 #include <QMdiArea>

Inherits QAbstractScrollArea.

Класс был добавлен в Qt 4.3.

• Список всех членов, включая унаследованные

[править] Открытые типы

• enum AreaOption { DontMaximizeSubWindowOnActivation }
• flags AreaOptions
• enum WindowOrder { CreationOrder, StackingOrder }

[править] Свойства

• background : QBrush

• 2 свойства, унаследованные от QAbstractScrollArea
• 6 свойств, унаследованных от QFrame
• 56 свойств, унаследованных от QWidget
• 1 свойство, унаследованное от QObject

[править] Открытые функции

• QMdiArea ( QWidget * parent = 0 )
• ~QMdiArea ()
• QMdiSubWindow * activeSubWindow () const
• QMdiSubWindow * addSubWindow ( QWidget * widget, Qt::WindowFlags windowFlags = 0 )
• QBrush background () const
• QMdiSubWindow * currentSubWindow () const
• void removeSubWindow ( QWidget * widget )
• void setBackground ( const QBrush & background )
• void setOption ( AreaOption option, bool on = true )
• QList<QMdiSubWindow *> subWindowList ( WindowOrder order = CreationOrder ) const
• bool testOption ( AreaOption option ) const

• 15 открытых функций, унаследованных от QAbstractScrollArea
• 13 открытых функций, унаследованных от QFrame
• 201 свойство, унаследованное от QWidget
• 29 открытых функций, унаследованных от QObject
• 12 открытых функций, унаследованных от QPaintDevice

[править] Открытые слоты

• void activateNextSubWindow ()
• void activatePreviousSubWindow ()
• void cascadeSubWindows ()
• void closeActiveSubWindow ()
• void closeAllSubWindows ()
• void setActiveSubWindow ( QMdiSubWindow * window )
• void tileSubWindows ()

• 19 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject

[править] Сигналы

• void subWindowActivated ( QMdiSubWindow * window )

• 1 сигнал, унаследованный от QWidget
• 1 сигнал, унаследованный от QObject

[править] Защищённые слоты

• void setupViewport ( QWidget * viewport )

• 1 защищенный слот, унаследованный от QAbstractScrollArea
• 1 защищенный слот, унаследованый от QWidget

[править] Дополнительные унаследованные члены

• 4 статических открытых члена, унаследованных от QWidget
• 5 статических открытых членов, унаследованных от QObject
• 16 защищенных функций, унаследованных от QAbstractScrollArea
• 38 защищенных функций, унаследованных от QWidget
• 7 защищенных функций, унаследованных от QObject
• 1 защищенная функция, унаследованных от QPaintDevice

[править] Подробное описание

The QMdiArea widget provides an area in which MDI windows are displayed.

QMdiArea functions, essentially, like a window manager for MDI windows. For instance, it draws the windows it manages on itself and arranges them in a cascading or tile pattern. QMdiArea is commonly used as the center widget in a QMainWindow to create MDI applications, but can also be placed in any layout. The following code adds an area to a main window:

     QMainWindow *mainWindow = new QMainWindow;
     mainWindow->setCentralWidget(mdiArea);

Unlike the window managers for top-level windows, all window flags ( Qt::WindowFlags) are supported by QMdiArea as long as the flags are supported by the current widget style. If a specific flag is not supported by the style (e.g., the WindowShadeButtonHint), you can still shade the window with showShaded().

Subwindows in QMdiArea are instances of QMdiSubWindow. They are added to an MDI area with addSubWindow(). It is common to pass a QWidget, which is set as the internal widget, to this function, but it is also possible to pass a QMdiSubWindow directly.The class inherits QWidget, and you can use the same API as with a normal top-level window when programming. QMdiSubWindow also has behavior that is specific to MDI windows. See the QMdiSubWindow class description for more details.

A subwindow becomes active when it gets the keyboard focus, or when setFocus() is called. The user activates a window by moving focus in the usual ways. The MDI area emits the subWindowActivated() signal when the active window changes, and the activeSubWindow() function returns the active subwindow.

The convenience function subWindowList() returns a list of all subwindows. This information could be used in a popup menu containing a list of windows, for example.

QMdiArea provides two built-in layout strategies for subwindows: cascadeSubWindows() and tileSubWindows(). Both are slots and are easily connected to menu entries.

Файл:Qmdiarea-arrange.png

Note: The default scroll bar property for QMdiArea is Qt::ScrollBarAlwaysOff.

See also QMdiSubWindow.

[править] Описание типов

[править]

enum QMdiArea::AreaOption
flags QMdiArea::AreaOptions

This enum describes options that customize the behavior of the QMdiArea.

The AreaOptions type is a typedef for QFlags<AreaOption>. It stores an OR combination of AreaOption values.

[править]

enum QMdiArea::WindowOrder

Specifies the order in which child windows are returned from subWindowList(). The cascadeSubWindows() and tileSubWindows() functions follow this order when arranging the windows.

[править] Описание cвойств

[править]

background : QBrush

This property holds the background brush for the workspace.

This property sets the background brush for the workspace area itself. By default, it is a gray color, but can be any brush (e.g., colors, gradients or pixmaps).

Функции доступа:

• QBrush background () const
• void setBackground ( const QBrush & background )

[править] Описание функций-членов

[править]

QMdiArea::QMdiArea ( QWidget * parent = 0 )

Constructs an empty mdi area. parent is passed to QWidget's constructor.

[править]

QMdiArea::~QMdiArea ()

Destroys the MDI area.

[править]

void QMdiArea::activateNextSubWindow () [slot]

Gives the keyboard focus to the next window in the list of child windows. The windows are activated in the order in which they are created ( CreationOrder).

See also activatePreviousSubWindow().

[править]

void QMdiArea::activatePreviousSubWindow () [slot]

Gives the keyboard focus to the previous window in the list of child windows. The windows are activated in the order in which they are created ( CreationOrder).

See also activateNextSubWindow().

[править]

QMdiSubWindow * QMdiArea::activeSubWindow () const

Returns a pointer to the current active subwindow. If no window is currently active, 0 is returned.

Subwindows are treated as top-level windows with respect to window state, i.e., if a widget outside the MDI area is the active window, no subwindow will be active. Note that if a widget in the window in which the MDI area lives gains focus, the window will be activated.

See also setActiveSubWindow() and Qt::WindowState.

[править]

QMdiSubWindow * QMdiArea::addSubWindow ( QWidget * widget, Qt::WindowFlags windowFlags = 0 )

Adds widget as a new subwindow to the MDI area. If windowFlags are non-zero, they will override the flags set on the widget.

The widget can be either a QMdiSubWindow or another QWidget (in which case the MDI area will create a subwindow and set the widget as the internal widget).

     QMdiArea mdiArea;
     QMdiSubWindow *subWindow1 = new QMdiSubWindow;
     subWindow1->setWidget(internalWidget1);
     subWindow1->setAttribute(Qt::WA_DeleteOnClose);
     mdiArea.addSubWindow(subWindow1);
 
     QMdiSubWindow *subWindow2 =
         mdiArea.addSubWindow(internalWidget2);

When you create your own subwindow, you must set the Qt::WA_DeleteOnClose widget attribute if you want the window to be deleted when closed in the MDI area. If not, the window will be hidden and the MDI area will not activate the next subwindow.

Returns the QMdiSubWindow that is added to the MDI area.

See also removeSubWindow().

[править]

void QMdiArea::cascadeSubWindows () [slot]

Arranges all the child windows in a cascade pattern.

See also tileSubWindows().

[править]

void QMdiArea::closeActiveSubWindow () [slot]

Closes the active subwindow.

See also closeAllSubWindows().

[править]

void QMdiArea::closeAllSubWindows () [slot]

Closes all subwindows by sending a QCloseEvent to each window. You may receive subWindowActivated() signals from subwindows before they are closed (if the MDI area activates the subwindow when another is closing).

Subwindows that ignore the close event will remain open.

See also closeActiveSubWindow().

[править]

QMdiSubWindow * QMdiArea::currentSubWindow () const

Returns a pointer to the current subwindow, or 0 if there is no current subwindow.

This function will return the same as activeSubWindow() if the QApplication containing QMdiArea is active.

See also activeSubWindow() and QApplication::activeWindow().

[править]

void QMdiArea::removeSubWindow ( QWidget * widget )

Removes widget from the MDI area. The widget must be either a QMdiSubWindow or a widget that is the internal widget of a subwindow. Note that the subwindow is not deleted by QMdiArea and that its parent is set to 0.

See also addSubWindow().

[править]

void QMdiArea::setActiveSubWindow ( QMdiSubWindow * window ) [slot]

Activates the subwindow window. If window is 0, any current active window is deactivated.

See also activeSubWindow().

[править]

void QMdiArea::setOption ( AreaOption option, bool on = true )

If on is true, option is enabled on the MDI area; otherwise it is disabled. See AreaOption for the effect of each option.

See also AreaOption and testOption().

[править]

void QMdiArea::setupViewport ( QWidget * viewport ) [protected slot]

This slot is called by QAbstractScrollArea after setViewport() has been called. Reimplement this function in a subclass of QMdiArea to initialize the new viewport before it is used.

See also setViewport().

[править]

void QMdiArea::subWindowActivated ( QMdiSubWindow * window ) [signal]

QMdiArea emits this signal after window has been activated. When window is 0, QMdiArea has just deactivated its last active window, and there are no active windows on the workspace.

See also QMdiArea::activeSubWindow().

[править]

QList< QMdiSubWindow *> QMdiArea::subWindowList ( WindowOrder order = CreationOrder ) const

Returns a list of all subwindows in the MDI area. If order is CreationOrder (the default), the windows are sorted in the order in which they were inserted into the workspace. If order is StackingOrder, the windows are listed in their stacking order, with the topmost window as the last item in the list.

See also WindowOrder.

[править]

bool QMdiArea::testOption ( AreaOption option ) const

Returns true if option is enabled; otherwise returns false.

See also AreaOption and setOption().

[править]

void QMdiArea::tileSubWindows () [slot]

Arranges all child windows in a tile pattern.

See also cascadeSubWindows().