<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qmdiarea.cpp -->
<title>Qt 4.8: QMdiArea Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtgui.html">QtGui</a></li>
<li>QMdiArea</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#properties">Properties</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#public-slots">Public Slots</a></li>
<li class="level1"><a href="#signals">Signals</a></li>
<li class="level1"><a href="#protected-functions">Protected Functions</a></li>
<li class="level1"><a href="#protected-slots">Protected Slots</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<h1 class="title">QMdiArea Class Reference</h1>
<!-- $$$QMdiArea-brief -->
<p>The QMdiArea widget provides an area in which MDI windows are displayed. <a href="#details">More...</a></p>
<!-- @@@QMdiArea -->
<pre class="cpp"> <span class="preprocessor">#include <QMdiArea></span></pre><p><b>Inherits: </b><a href="qabstractscrollarea.html">QAbstractScrollArea</a>.</p>
<p>This class was introduced in Qt 4.3.</p>
<ul>
<li><a href="qmdiarea-members.html">List of all members, including inherited members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#AreaOption-enum">AreaOption</a></b> { DontMaximizeSubWindowOnActivation }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> flags </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#AreaOption-enum">AreaOptions</a></b></td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#ViewMode-enum">ViewMode</a></b> { SubWindowView, TabbedView }</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> enum </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#WindowOrder-enum">WindowOrder</a></b> { CreationOrder, StackingOrder, ActivationHistoryOrder }</td></tr>
</table>
<a name="properties"></a>
<h2>Properties</h2>
<table class="propsummary">
<tr><td class="topAlign"><ul>
<li class="fn"><b><a href="qmdiarea.html#activationOrder-prop">activationOrder</a></b> : WindowOrder</li>
<li class="fn"><b><a href="qmdiarea.html#background-prop">background</a></b> : QBrush</li>
<li class="fn"><b><a href="qmdiarea.html#documentMode-prop">documentMode</a></b> : bool</li>
<li class="fn"><b><a href="qmdiarea.html#tabPosition-prop">tabPosition</a></b> : QTabWidget::TabPosition</li>
</ul></td><td class="topAlign"><ul>
<li class="fn"><b><a href="qmdiarea.html#tabShape-prop">tabShape</a></b> : QTabWidget::TabShape</li>
<li class="fn"><b><a href="qmdiarea.html#tabsClosable-prop">tabsClosable</a></b> : bool</li>
<li class="fn"><b><a href="qmdiarea.html#tabsMovable-prop">tabsMovable</a></b> : bool</li>
<li class="fn"><b><a href="qmdiarea.html#viewMode-prop">viewMode</a></b> : ViewMode</li>
</ul>
</td></tr>
</table>
<ul>
<li class="fn">2 properties inherited from <a href="qabstractscrollarea.html#properties">QAbstractScrollArea</a></li>
<li class="fn">6 properties inherited from <a href="qframe.html#properties">QFrame</a></li>
<li class="fn">58 properties inherited from <a href="qwidget.html#properties">QWidget</a></li>
<li class="fn">1 property inherited from <a href="qobject.html#properties">QObject</a></li>
</ul>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#QMdiArea">QMdiArea</a></b> ( QWidget * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#dtor.QMdiArea">~QMdiArea</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> WindowOrder </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#activationOrder-prop">activationOrder</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMdiSubWindow * </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#activeSubWindow">activeSubWindow</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMdiSubWindow * </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#addSubWindow">addSubWindow</a></b> ( QWidget * <i>widget</i>, Qt::WindowFlags <i>windowFlags</i> = 0 )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QBrush </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#background-prop">background</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QMdiSubWindow * </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#currentSubWindow">currentSubWindow</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#documentMode-prop">documentMode</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#removeSubWindow">removeSubWindow</a></b> ( QWidget * <i>widget</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#activationOrder-prop">setActivationOrder</a></b> ( WindowOrder <i>order</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#background-prop">setBackground</a></b> ( const QBrush & <i>background</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#documentMode-prop">setDocumentMode</a></b> ( bool <i>enabled</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#setOption">setOption</a></b> ( AreaOption <i>option</i>, bool <i>on</i> = true )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#tabPosition-prop">setTabPosition</a></b> ( QTabWidget::TabPosition <i>position</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#tabShape-prop">setTabShape</a></b> ( QTabWidget::TabShape <i>shape</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#tabsClosable-prop">setTabsClosable</a></b> ( bool <i>closable</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#tabsMovable-prop">setTabsMovable</a></b> ( bool <i>movable</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#viewMode-prop">setViewMode</a></b> ( ViewMode <i>mode</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QList<QMdiSubWindow *> </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#subWindowList">subWindowList</a></b> ( WindowOrder <i>order</i> = CreationOrder ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QTabWidget::TabPosition </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#tabPosition-prop">tabPosition</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QTabWidget::TabShape </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#tabShape-prop">tabShape</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#tabsClosable-prop">tabsClosable</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#tabsMovable-prop">tabsMovable</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#testOption">testOption</a></b> ( AreaOption <i>option</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> ViewMode </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#viewMode-prop">viewMode</a></b> () const</td></tr>
</table>
<a name="reimplemented-public-functions"></a>
<h2>Reimplemented Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual QSize </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#minimumSizeHint">minimumSizeHint</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual QSize </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#sizeHint">sizeHint</a></b> () const</td></tr>
</table>
<ul>
<li class="fn">17 public functions inherited from <a href="qabstractscrollarea.html#public-functions">QAbstractScrollArea</a></li>
<li class="fn">14 public functions inherited from <a href="qframe.html#public-functions">QFrame</a></li>
<li class="fn">221 public functions inherited from <a href="qwidget.html#public-functions">QWidget</a></li>
<li class="fn">29 public functions inherited from <a href="qobject.html#public-functions">QObject</a></li>
<li class="fn">13 public functions inherited from <a href="qpaintdevice.html#public-functions">QPaintDevice</a></li>
</ul>
<a name="public-slots"></a>
<h2>Public Slots</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#activateNextSubWindow">activateNextSubWindow</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#activatePreviousSubWindow">activatePreviousSubWindow</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#cascadeSubWindows">cascadeSubWindows</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#closeActiveSubWindow">closeActiveSubWindow</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#closeAllSubWindows">closeAllSubWindows</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#setActiveSubWindow">setActiveSubWindow</a></b> ( QMdiSubWindow * <i>window</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#tileSubWindows">tileSubWindows</a></b> ()</td></tr>
</table>
<ul>
<li class="fn">19 public slots inherited from <a href="qwidget.html#public-slots">QWidget</a></li>
<li class="fn">1 public slot inherited from <a href="qobject.html#public-slots">QObject</a></li>
</ul>
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#subWindowActivated">subWindowActivated</a></b> ( QMdiSubWindow * <i>window</i> )</td></tr>
</table>
<ul>
<li class="fn">1 signal inherited from <a href="qwidget.html#signals">QWidget</a></li>
<li class="fn">1 signal inherited from <a href="qobject.html#signals">QObject</a></li>
</ul>
<a name="reimplemented-protected-functions"></a>
<h2>Reimplemented Protected Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#childEvent">childEvent</a></b> ( QChildEvent * <i>childEvent</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#event">event</a></b> ( QEvent * <i>event</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#eventFilter">eventFilter</a></b> ( QObject * <i>object</i>, QEvent * <i>event</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#paintEvent">paintEvent</a></b> ( QPaintEvent * <i>paintEvent</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#resizeEvent">resizeEvent</a></b> ( QResizeEvent * <i>resizeEvent</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#scrollContentsBy">scrollContentsBy</a></b> ( int <i>dx</i>, int <i>dy</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#showEvent">showEvent</a></b> ( QShowEvent * <i>showEvent</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#timerEvent">timerEvent</a></b> ( QTimerEvent * <i>timerEvent</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> virtual bool </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#viewportEvent">viewportEvent</a></b> ( QEvent * <i>event</i> )</td></tr>
</table>
<ul>
<li class="fn">18 protected functions inherited from <a href="qabstractscrollarea.html#protected-functions">QAbstractScrollArea</a></li>
<li class="fn">3 protected functions inherited from <a href="qframe.html#protected-functions">QFrame</a></li>
<li class="fn">37 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
<li class="fn">8 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li class="fn">1 protected function inherited from <a href="qpaintdevice.html#protected-functions">QPaintDevice</a></li>
</ul>
<a name="protected-slots"></a>
<h2>Protected Slots</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qmdiarea.html#setupViewport">setupViewport</a></b> ( QWidget * <i>viewport</i> )</td></tr>
</table>
<ul>
<li class="fn">1 protected slot inherited from <a href="qabstractscrollarea.html#protected-slots">QAbstractScrollArea</a></li>
<li class="fn">1 protected slot inherited from <a href="qwidget.html#protected-slots">QWidget</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li class="fn">4 static public members inherited from <a href="qwidget.html#static-public-members">QWidget</a></li>
<li class="fn">7 static public members inherited from <a href="qobject.html#static-public-members">QObject</a></li>
<li class="fn">18 protected functions inherited from <a href="qabstractscrollarea.html#protected-functions">QAbstractScrollArea</a></li>
<li class="fn">3 protected functions inherited from <a href="qframe.html#protected-functions">QFrame</a></li>
<li class="fn">37 protected functions inherited from <a href="qwidget.html#protected-functions">QWidget</a></li>
<li class="fn">8 protected functions inherited from <a href="qobject.html#protected-functions">QObject</a></li>
<li class="fn">1 protected function inherited from <a href="qpaintdevice.html#protected-functions">QPaintDevice</a></li>
</ul>
<a name="details"></a>
<!-- $$$QMdiArea-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QMdiArea widget provides an area in which MDI windows are displayed.</p>
<p>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 <a href="qmainwindow.html">QMainWindow</a> to create MDI applications, but can also be placed in any layout. The following code adds an area to a main window:</p>
<pre class="cpp"> <span class="type"><a href="qmainwindow.html">QMainWindow</a></span> <span class="operator">*</span>mainWindow <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qmainwindow.html">QMainWindow</a></span>;
mainWindow<span class="operator">-</span><span class="operator">></span>setCentralWidget(mdiArea);</pre>
<p>Unlike the window managers for top-level windows, all window flags (<a href="qt.html#WindowType-enum">Qt::WindowFlags</a>) 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 <a href="qt.html#WindowType-enum">WindowShadeButtonHint</a>), you can still shade the window with showShaded().</p>
<p>Subwindows in QMdiArea are instances of <a href="qmdisubwindow.html">QMdiSubWindow</a>. They are added to an MDI area with <a href="qmdiarea.html#addSubWindow">addSubWindow</a>(). It is common to pass a <a href="qwidget.html">QWidget</a>, which is set as the internal widget, to this function, but it is also possible to pass a <a href="qmdisubwindow.html">QMdiSubWindow</a> directly.The class inherits <a href="qwidget.html">QWidget</a>, and you can use the same API as with a normal top-level window when programming. <a href="qmdisubwindow.html">QMdiSubWindow</a> also has behavior that is specific to MDI windows. See the <a href="qmdisubwindow.html">QMdiSubWindow</a> class description for more details.</p>
<p>A subwindow becomes active when it gets the keyboard focus, or when <a href="qwidget.html#setFocus">setFocus</a>() is called. The user activates a window by moving focus in the usual ways. The MDI area emits the <a href="qmdiarea.html#subWindowActivated">subWindowActivated</a>() signal when the active window changes, and the <a href="qmdiarea.html#activeSubWindow">activeSubWindow</a>() function returns the active subwindow.</p>
<p>The convenience function <a href="qmdiarea.html#subWindowList">subWindowList</a>() returns a list of all subwindows. This information could be used in a popup menu containing a list of windows, for example.</p>
<p>The subwindows are sorted by the current <a href="qmdiarea.html#WindowOrder-enum">WindowOrder</a>. This is used for the <a href="qmdiarea.html#subWindowList">subWindowList</a>() and for <a href="qmdiarea.html#activateNextSubWindow">activateNextSubWindow</a>() and acivatePreviousSubWindow(). Also, it is used when cascading or tiling the windows with <a href="qmdiarea.html#cascadeSubWindows">cascadeSubWindows</a>() and <a href="qmdiarea.html#tileSubWindows">tileSubWindows</a>().</p>
<p>QMdiArea provides two built-in layout strategies for subwindows: <a href="qmdiarea.html#cascadeSubWindows">cascadeSubWindows</a>() and <a href="qmdiarea.html#tileSubWindows">tileSubWindows</a>(). Both are slots and are easily connected to menu entries.</p>
<table class="generic">
<tr valign="top" class="odd"><td ><img src="images/mdi-cascade.png" alt="" /></td><td ><img src="images/mdi-tile.png" alt="" /></td></tr>
</table>
<p><b>Note:</b> The default scroll bar property for QMdiArea is <a href="qt.html#ScrollBarPolicy-enum">Qt::ScrollBarAlwaysOff</a>.</p>
</div>
<p><b>See also </b><a href="qmdisubwindow.html">QMdiSubWindow</a>.</p>
<!-- @@@QMdiArea -->
<div class="types">
<h2>Member Type Documentation</h2>
<!-- $$$AreaOption$$$DontMaximizeSubWindowOnActivation -->
<h3 class="flags"><a name="AreaOption-enum"></a>enum QMdiArea::<span class="name">AreaOption</span><br/>flags QMdiArea::<span class="name">AreaOptions</span></h3>
<p>This enum describes options that customize the behavior of the <a href="qmdiarea.html">QMdiArea</a>.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QMdiArea::DontMaximizeSubWindowOnActivation</tt></td><td class="topAlign"><tt>0x1</tt></td><td class="topAlign">When the active subwindow is maximized, the default behavior is to maximize the next subwindow that is activated. Set this option if you do not want this behavior.</td></tr>
</table>
<p>The AreaOptions type is a typedef for <a href="qflags.html">QFlags</a><AreaOption>. It stores an OR combination of AreaOption values.</p>
<!-- @@@AreaOption -->
<!-- $$$ViewMode$$$SubWindowView$$$TabbedView -->
<h3 class="fn"><a name="ViewMode-enum"></a>enum QMdiArea::<span class="name">ViewMode</span></h3>
<p>This enum describes the view mode of the area; i.e. how sub-windows will be displayed.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QMdiArea::SubWindowView</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">Display sub-windows with window frames (default).</td></tr>
<tr><td class="topAlign"><tt>QMdiArea::TabbedView</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">Display sub-windows with tabs in a tab bar.</td></tr>
</table>
<p>This enum was introduced or modified in Qt 4.4.</p>
<p><b>See also </b><a href="qmdiarea.html#viewMode-prop">setViewMode</a>().</p>
<!-- @@@ViewMode -->
<!-- $$$WindowOrder$$$CreationOrder$$$StackingOrder$$$ActivationHistoryOrder -->
<h3 class="fn"><a name="WindowOrder-enum"></a>enum QMdiArea::<span class="name">WindowOrder</span></h3>
<p>Specifies the criteria to use for ordering the list of child windows returned by <a href="qmdiarea.html#subWindowList">subWindowList</a>(). The functions <a href="qmdiarea.html#cascadeSubWindows">cascadeSubWindows</a>() and <a href="qmdiarea.html#tileSubWindows">tileSubWindows</a>() follow this order when arranging the windows.</p>
<table class="valuelist"><tr valign="top" class="odd"><th class="tblConst">Constant</th><th class="tblval">Value</th><th class="tbldscr">Description</th></tr>
<tr><td class="topAlign"><tt>QMdiArea::CreationOrder</tt></td><td class="topAlign"><tt>0</tt></td><td class="topAlign">The windows are returned in the order of their creation.</td></tr>
<tr><td class="topAlign"><tt>QMdiArea::StackingOrder</tt></td><td class="topAlign"><tt>1</tt></td><td class="topAlign">The windows are returned in the order in which they are stacked, with the top-most window being last in the list.</td></tr>
<tr><td class="topAlign"><tt>QMdiArea::ActivationHistoryOrder</tt></td><td class="topAlign"><tt>2</tt></td><td class="topAlign">The windows are returned in the order in which they were activated.</td></tr>
</table>
<p><b>See also </b><a href="qmdiarea.html#subWindowList">subWindowList</a>().</p>
<!-- @@@WindowOrder -->
</div>
<div class="prop">
<h2>Property Documentation</h2>
<!-- $$$activationOrder-prop$$$activationOrder$$$setActivationOrderWindowOrder -->
<h3 class="fn"><a name="activationOrder-prop"></a><span class="name">activationOrder</span> : <span class="type"><a href="qmdiarea.html#WindowOrder-enum">WindowOrder</a></span></h3>
<p>This property holds the ordering criteria for subwindow lists.</p>
<p>This property specifies the ordering criteria for the list of subwindows returned by <a href="qmdiarea.html#subWindowList">subWindowList</a>(). By default, it is the window creation order.</p>
<p>This property was introduced in Qt 4.4.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> WindowOrder </td><td class="memItemRight bottomAlign"><span class="name"><b>activationOrder</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setActivationOrder</b></span> ( WindowOrder <i>order</i> )</td></tr>
</table>
<p><b>See also </b><a href="qmdiarea.html#subWindowList">subWindowList</a>().</p>
<!-- @@@activationOrder -->
<!-- $$$background-prop$$$background$$$setBackgroundconstQBrush& -->
<h3 class="fn"><a name="background-prop"></a><span class="name">background</span> : <span class="type"><a href="qbrush.html">QBrush</a></span></h3>
<p>This property holds the background brush for the workspace.</p>
<p>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).</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QBrush </td><td class="memItemRight bottomAlign"><span class="name"><b>background</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setBackground</b></span> ( const QBrush & <i>background</i> )</td></tr>
</table>
<!-- @@@background -->
<!-- $$$documentMode-prop$$$documentMode$$$setDocumentModebool -->
<h3 class="fn"><a name="documentMode-prop"></a><span class="name">documentMode</span> : <span class="type">bool</span></h3>
<p>This property holds whether the tab bar is set to document mode in tabbed view mode.</p>
<p>Document mode is disabled by default.</p>
<p>This property was introduced in Qt 4.5.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>documentMode</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setDocumentMode</b></span> ( bool <i>enabled</i> )</td></tr>
</table>
<p><b>See also </b><a href="qtabbar.html#documentMode-prop">QTabBar::documentMode</a> and <a href="qmdiarea.html#viewMode-prop">setViewMode</a>().</p>
<!-- @@@documentMode -->
<!-- $$$tabPosition-prop$$$tabPosition$$$setTabPositionQTabWidget::TabPosition -->
<h3 class="fn"><a name="tabPosition-prop"></a><span class="name">tabPosition</span> : <span class="type"><a href="qtabwidget.html#TabPosition-enum">QTabWidget::TabPosition</a></span></h3>
<p>This property holds the position of the tabs in tabbed view mode.</p>
<p>Possible values for this property are described by the <a href="qtabwidget.html#TabPosition-enum">QTabWidget::TabPosition</a> enum.</p>
<p>This property was introduced in Qt 4.4.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QTabWidget::TabPosition </td><td class="memItemRight bottomAlign"><span class="name"><b>tabPosition</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setTabPosition</b></span> ( QTabWidget::TabPosition <i>position</i> )</td></tr>
</table>
<p><b>See also </b><a href="qtabwidget.html#TabPosition-enum">QTabWidget::TabPosition</a> and <a href="qmdiarea.html#viewMode-prop">setViewMode</a>().</p>
<!-- @@@tabPosition -->
<!-- $$$tabShape-prop$$$tabShape$$$setTabShapeQTabWidget::TabShape -->
<h3 class="fn"><a name="tabShape-prop"></a><span class="name">tabShape</span> : <span class="type"><a href="qtabwidget.html#TabShape-enum">QTabWidget::TabShape</a></span></h3>
<p>This property holds the shape of the tabs in tabbed view mode.</p>
<p>Possible values for this property are <a href="qtabwidget.html#TabShape-enum">QTabWidget::Rounded</a> (default) or <a href="qtabwidget.html#TabShape-enum">QTabWidget::Triangular</a>.</p>
<p>This property was introduced in Qt 4.4.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> QTabWidget::TabShape </td><td class="memItemRight bottomAlign"><span class="name"><b>tabShape</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setTabShape</b></span> ( QTabWidget::TabShape <i>shape</i> )</td></tr>
</table>
<p><b>See also </b><a href="qtabwidget.html#TabShape-enum">QTabWidget::TabShape</a> and <a href="qmdiarea.html#viewMode-prop">setViewMode</a>().</p>
<!-- @@@tabShape -->
<!-- $$$tabsClosable-prop$$$tabsClosable$$$setTabsClosablebool -->
<h3 class="fn"><a name="tabsClosable-prop"></a><span class="name">tabsClosable</span> : <span class="type">bool</span></h3>
<p>This property holds whether the tab bar should place close buttons on each tab in tabbed view mode.</p>
<p>Tabs are not closable by default.</p>
<p>This property was introduced in Qt 4.8.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>tabsClosable</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setTabsClosable</b></span> ( bool <i>closable</i> )</td></tr>
</table>
<p><b>See also </b><a href="qtabbar.html#tabsClosable-prop">QTabBar::tabsClosable</a> and <a href="qmdiarea.html#viewMode-prop">setViewMode</a>().</p>
<!-- @@@tabsClosable -->
<!-- $$$tabsMovable-prop$$$tabsMovable$$$setTabsMovablebool -->
<h3 class="fn"><a name="tabsMovable-prop"></a><span class="name">tabsMovable</span> : <span class="type">bool</span></h3>
<p>This property holds whether the user can move the tabs within the tabbar area in tabbed view mode.</p>
<p>Tabs are not movable by default.</p>
<p>This property was introduced in Qt 4.8.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> bool </td><td class="memItemRight bottomAlign"><span class="name"><b>tabsMovable</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setTabsMovable</b></span> ( bool <i>movable</i> )</td></tr>
</table>
<p><b>See also </b><a href="qtabbar.html#movable-prop">QTabBar::movable</a> and <a href="qmdiarea.html#viewMode-prop">setViewMode</a>().</p>
<!-- @@@tabsMovable -->
<!-- $$$viewMode-prop$$$viewMode$$$setViewModeViewMode -->
<h3 class="fn"><a name="viewMode-prop"></a><span class="name">viewMode</span> : <span class="type"><a href="qmdiarea.html#ViewMode-enum">ViewMode</a></span></h3>
<p>This property holds the way sub-windows are displayed in the QMdiArea.</p>
<p>By default, the <a href="qmdiarea.html#ViewMode-enum">SubWindowView</a> is used to display sub-windows.</p>
<p>This property was introduced in Qt 4.4.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary">
<tr><td class="memItemLeft topAlign rightAlign"> ViewMode </td><td class="memItemRight bottomAlign"><span class="name"><b>viewMode</b></span> () const</td></tr>
<tr><td class="memItemLeft topAlign rightAlign"> void </td><td class="memItemRight bottomAlign"><span class="name"><b>setViewMode</b></span> ( ViewMode <i>mode</i> )</td></tr>
</table>
<p><b>See also </b><a href="qmdiarea.html#ViewMode-enum">ViewMode</a>, <a href="qmdiarea.html#tabShape-prop">setTabShape</a>(), and <a href="qmdiarea.html#tabPosition-prop">setTabPosition</a>().</p>
<!-- @@@viewMode -->
</div>
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QMdiArea[overload1]$$$QMdiAreaQWidget* -->
<h3 class="fn"><a name="QMdiArea"></a>QMdiArea::<span class="name">QMdiArea</span> ( <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>parent</i> = 0 )</h3>
<p>Constructs an empty mdi area. <i>parent</i> is passed to <a href="qwidget.html">QWidget</a>'s constructor.</p>
<!-- @@@QMdiArea -->
<!-- $$$~QMdiArea[overload1]$$$~QMdiArea -->
<h3 class="fn"><a name="dtor.QMdiArea"></a>QMdiArea::<span class="name">~QMdiArea</span> ()</h3>
<p>Destroys the MDI area.</p>
<!-- @@@~QMdiArea -->
<!-- $$$activateNextSubWindow[overload1]$$$activateNextSubWindow -->
<h3 class="fn"><a name="activateNextSubWindow"></a><span class="type">void</span> QMdiArea::<span class="name">activateNextSubWindow</span> ()<tt> [slot]</tt></h3>
<p>Gives the keyboard focus to another window in the list of child windows. The window activated will be the next one determined by the current <a href="qmdiarea.html#WindowOrder-enum">activation order</a>.</p>
<p><b>See also </b><a href="qmdiarea.html#activatePreviousSubWindow">activatePreviousSubWindow</a>() and <a href="qmdiarea.html#WindowOrder-enum">QMdiArea::WindowOrder</a>.</p>
<!-- @@@activateNextSubWindow -->
<!-- $$$activatePreviousSubWindow[overload1]$$$activatePreviousSubWindow -->
<h3 class="fn"><a name="activatePreviousSubWindow"></a><span class="type">void</span> QMdiArea::<span class="name">activatePreviousSubWindow</span> ()<tt> [slot]</tt></h3>
<p>Gives the keyboard focus to another window in the list of child windows. The window activated will be the previous one determined by the current <a href="qmdiarea.html#WindowOrder-enum">activation order</a>.</p>
<p><b>See also </b><a href="qmdiarea.html#activateNextSubWindow">activateNextSubWindow</a>() and <a href="qmdiarea.html#WindowOrder-enum">QMdiArea::WindowOrder</a>.</p>
<!-- @@@activatePreviousSubWindow -->
<!-- $$$activeSubWindow[overload1]$$$activeSubWindow -->
<h3 class="fn"><a name="activeSubWindow"></a><span class="type"><a href="qmdisubwindow.html">QMdiSubWindow</a></span> * QMdiArea::<span class="name">activeSubWindow</span> () const</h3>
<p>Returns a pointer to the current active subwindow. If no window is currently active, 0 is returned.</p>
<p>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.</p>
<p><b>See also </b><a href="qmdiarea.html#setActiveSubWindow">setActiveSubWindow</a>() and <a href="qt.html#WindowState-enum">Qt::WindowState</a>.</p>
<!-- @@@activeSubWindow -->
<!-- $$$addSubWindow[overload1]$$$addSubWindowQWidget*Qt::WindowFlags -->
<h3 class="fn"><a name="addSubWindow"></a><span class="type"><a href="qmdisubwindow.html">QMdiSubWindow</a></span> * QMdiArea::<span class="name">addSubWindow</span> ( <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>widget</i>, <span class="type"><a href="qt.html#WindowType-enum">Qt::WindowFlags</a></span> <i>windowFlags</i> = 0 )</h3>
<p>Adds <i>widget</i> as a new subwindow to the MDI area. If <i>windowFlags</i> are non-zero, they will override the flags set on the widget.</p>
<p>The <i>widget</i> can be either a <a href="qmdisubwindow.html">QMdiSubWindow</a> or another <a href="qwidget.html">QWidget</a> (in which case the MDI area will create a subwindow and set the <i>widget</i> as the internal widget).</p>
<p><b>Note:</b> Once the subwindow has been added, its parent will be the <i>viewport widget</i> of the <a href="qmdiarea.html">QMdiArea</a>.</p>
<pre class="cpp"> <span class="type"><a href="qmdiarea.html">QMdiArea</a></span> mdiArea;
<span class="type"><a href="qmdisubwindow.html">QMdiSubWindow</a></span> <span class="operator">*</span>subWindow1 <span class="operator">=</span> <span class="keyword">new</span> <span class="type"><a href="qmdisubwindow.html">QMdiSubWindow</a></span>;
subWindow1<span class="operator">-</span><span class="operator">></span>setWidget(internalWidget1);
subWindow1<span class="operator">-</span><span class="operator">></span>setAttribute(<span class="type"><a href="qt.html">Qt</a></span><span class="operator">::</span>WA_DeleteOnClose);
mdiArea<span class="operator">.</span>addSubWindow(subWindow1);
<span class="type"><a href="qmdisubwindow.html">QMdiSubWindow</a></span> <span class="operator">*</span>subWindow2 <span class="operator">=</span>
mdiArea<span class="operator">.</span>addSubWindow(internalWidget2);</pre>
<p>When you create your own subwindow, you must set the <a href="qt.html#WidgetAttribute-enum">Qt::WA_DeleteOnClose</a> 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.</p>
<p>Returns the <a href="qmdisubwindow.html">QMdiSubWindow</a> that is added to the MDI area.</p>
<p><b>See also </b><a href="qmdiarea.html#removeSubWindow">removeSubWindow</a>().</p>
<!-- @@@addSubWindow -->
<!-- $$$cascadeSubWindows[overload1]$$$cascadeSubWindows -->
<h3 class="fn"><a name="cascadeSubWindows"></a><span class="type">void</span> QMdiArea::<span class="name">cascadeSubWindows</span> ()<tt> [slot]</tt></h3>
<p>Arranges all the child windows in a cascade pattern.</p>
<p><b>See also </b><a href="qmdiarea.html#tileSubWindows">tileSubWindows</a>().</p>
<!-- @@@cascadeSubWindows -->
<!-- $$$childEvent[overload1]$$$childEventQChildEvent* -->
<h3 class="fn"><a name="childEvent"></a><span class="type">void</span> QMdiArea::<span class="name">childEvent</span> ( <span class="type"><a href="qchildevent.html">QChildEvent</a></span> * <i>childEvent</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qobject.html#childEvent">QObject::childEvent</a>().</p>
<!-- @@@childEvent -->
<!-- $$$closeActiveSubWindow[overload1]$$$closeActiveSubWindow -->
<h3 class="fn"><a name="closeActiveSubWindow"></a><span class="type">void</span> QMdiArea::<span class="name">closeActiveSubWindow</span> ()<tt> [slot]</tt></h3>
<p>Closes the active subwindow.</p>
<p><b>See also </b><a href="qmdiarea.html#closeAllSubWindows">closeAllSubWindows</a>().</p>
<!-- @@@closeActiveSubWindow -->
<!-- $$$closeAllSubWindows[overload1]$$$closeAllSubWindows -->
<h3 class="fn"><a name="closeAllSubWindows"></a><span class="type">void</span> QMdiArea::<span class="name">closeAllSubWindows</span> ()<tt> [slot]</tt></h3>
<p>Closes all subwindows by sending a <a href="qcloseevent.html">QCloseEvent</a> to each window. You may receive <a href="qmdiarea.html#subWindowActivated">subWindowActivated</a>() signals from subwindows before they are closed (if the MDI area activates the subwindow when another is closing).</p>
<p>Subwindows that ignore the close event will remain open.</p>
<p><b>See also </b><a href="qmdiarea.html#closeActiveSubWindow">closeActiveSubWindow</a>().</p>
<!-- @@@closeAllSubWindows -->
<!-- $$$currentSubWindow[overload1]$$$currentSubWindow -->
<h3 class="fn"><a name="currentSubWindow"></a><span class="type"><a href="qmdisubwindow.html">QMdiSubWindow</a></span> * QMdiArea::<span class="name">currentSubWindow</span> () const</h3>
<p>Returns a pointer to the current subwindow, or 0 if there is no current subwindow.</p>
<p>This function will return the same as <a href="qmdiarea.html#activeSubWindow">activeSubWindow</a>() if the <a href="qapplication.html">QApplication</a> containing <a href="qmdiarea.html">QMdiArea</a> is active.</p>
<p><b>See also </b><a href="qmdiarea.html#activeSubWindow">activeSubWindow</a>() and <a href="qapplication.html#activeWindow">QApplication::activeWindow</a>().</p>
<!-- @@@currentSubWindow -->
<!-- $$$event[overload1]$$$eventQEvent* -->
<h3 class="fn"><a name="event"></a><span class="type">bool</span> QMdiArea::<span class="name">event</span> ( <span class="type"><a href="qevent.html">QEvent</a></span> * <i>event</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qobject.html#event">QObject::event</a>().</p>
<!-- @@@event -->
<!-- $$$eventFilter[overload1]$$$eventFilterQObject*QEvent* -->
<h3 class="fn"><a name="eventFilter"></a><span class="type">bool</span> QMdiArea::<span class="name">eventFilter</span> ( <span class="type"><a href="qobject.html">QObject</a></span> * <i>object</i>, <span class="type"><a href="qevent.html">QEvent</a></span> * <i>event</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qobject.html#eventFilter">QObject::eventFilter</a>().</p>
<!-- @@@eventFilter -->
<!-- $$$minimumSizeHint[overload1]$$$minimumSizeHint -->
<h3 class="fn"><a name="minimumSizeHint"></a><span class="type"><a href="qsize.html">QSize</a></span> QMdiArea::<span class="name">minimumSizeHint</span> () const<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#minimumSizeHint-prop">QWidget::minimumSizeHint</a>().</p>
<!-- @@@minimumSizeHint -->
<!-- $$$paintEvent[overload1]$$$paintEventQPaintEvent* -->
<h3 class="fn"><a name="paintEvent"></a><span class="type">void</span> QMdiArea::<span class="name">paintEvent</span> ( <span class="type"><a href="qpaintevent.html">QPaintEvent</a></span> * <i>paintEvent</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#paintEvent">QWidget::paintEvent</a>().</p>
<!-- @@@paintEvent -->
<!-- $$$removeSubWindow[overload1]$$$removeSubWindowQWidget* -->
<h3 class="fn"><a name="removeSubWindow"></a><span class="type">void</span> QMdiArea::<span class="name">removeSubWindow</span> ( <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>widget</i> )</h3>
<p>Removes <i>widget</i> from the MDI area. The <i>widget</i> must be either a <a href="qmdisubwindow.html">QMdiSubWindow</a> or a widget that is the internal widget of a subwindow. Note <i>widget</i> is never actually deleted by <a href="qmdiarea.html">QMdiArea</a>. If a <a href="qmdisubwindow.html">QMdiSubWindow</a> is passed in its parent is set to 0 and it is removed, but if an internal widget is passed in the child widget is set to 0 but the <a href="qmdisubwindow.html">QMdiSubWindow</a> is not removed.</p>
<p><b>See also </b><a href="qmdiarea.html#addSubWindow">addSubWindow</a>().</p>
<!-- @@@removeSubWindow -->
<!-- $$$resizeEvent[overload1]$$$resizeEventQResizeEvent* -->
<h3 class="fn"><a name="resizeEvent"></a><span class="type">void</span> QMdiArea::<span class="name">resizeEvent</span> ( <span class="type"><a href="qresizeevent.html">QResizeEvent</a></span> * <i>resizeEvent</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#resizeEvent">QWidget::resizeEvent</a>().</p>
<!-- @@@resizeEvent -->
<!-- $$$scrollContentsBy[overload1]$$$scrollContentsByintint -->
<h3 class="fn"><a name="scrollContentsBy"></a><span class="type">void</span> QMdiArea::<span class="name">scrollContentsBy</span> ( <span class="type">int</span> <i>dx</i>, <span class="type">int</span> <i>dy</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qabstractscrollarea.html#scrollContentsBy">QAbstractScrollArea::scrollContentsBy</a>().</p>
<!-- @@@scrollContentsBy -->
<!-- $$$setActiveSubWindow[overload1]$$$setActiveSubWindowQMdiSubWindow* -->
<h3 class="fn"><a name="setActiveSubWindow"></a><span class="type">void</span> QMdiArea::<span class="name">setActiveSubWindow</span> ( <span class="type"><a href="qmdisubwindow.html">QMdiSubWindow</a></span> * <i>window</i> )<tt> [slot]</tt></h3>
<p>Activates the subwindow <i>window</i>. If <i>window</i> is 0, any current active window is deactivated.</p>
<p><b>See also </b><a href="qmdiarea.html#activeSubWindow">activeSubWindow</a>().</p>
<!-- @@@setActiveSubWindow -->
<!-- $$$setOption[overload1]$$$setOptionAreaOptionbool -->
<h3 class="fn"><a name="setOption"></a><span class="type">void</span> QMdiArea::<span class="name">setOption</span> ( <span class="type"><a href="qmdiarea.html#AreaOption-enum">AreaOption</a></span> <i>option</i>, <span class="type">bool</span> <i>on</i> = true )</h3>
<p>If <i>on</i> is true, <i>option</i> is enabled on the MDI area; otherwise it is disabled. See <a href="qmdiarea.html#AreaOption-enum">AreaOption</a> for the effect of each option.</p>
<p><b>See also </b><a href="qmdiarea.html#AreaOption-enum">AreaOption</a> and <a href="qmdiarea.html#testOption">testOption</a>().</p>
<!-- @@@setOption -->
<!-- $$$setupViewport[overload1]$$$setupViewportQWidget* -->
<h3 class="fn"><a name="setupViewport"></a><span class="type">void</span> QMdiArea::<span class="name">setupViewport</span> ( <span class="type"><a href="qwidget.html">QWidget</a></span> * <i>viewport</i> )<tt> [protected slot]</tt></h3>
<p>This slot is called by <a href="qabstractscrollarea.html">QAbstractScrollArea</a> after <a href="qabstractscrollarea.html#setViewport">setViewport</a>() has been called. Reimplement this function in a subclass of <a href="qmdiarea.html">QMdiArea</a> to initialize the new <i>viewport</i> before it is used.</p>
<p><b>See also </b><a href="qabstractscrollarea.html#setViewport">setViewport</a>().</p>
<!-- @@@setupViewport -->
<!-- $$$showEvent[overload1]$$$showEventQShowEvent* -->
<h3 class="fn"><a name="showEvent"></a><span class="type">void</span> QMdiArea::<span class="name">showEvent</span> ( <span class="type"><a href="qshowevent.html">QShowEvent</a></span> * <i>showEvent</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#showEvent">QWidget::showEvent</a>().</p>
<!-- @@@showEvent -->
<!-- $$$sizeHint[overload1]$$$sizeHint -->
<h3 class="fn"><a name="sizeHint"></a><span class="type"><a href="qsize.html">QSize</a></span> QMdiArea::<span class="name">sizeHint</span> () const<tt> [virtual]</tt></h3>
<p>Reimplemented from <a href="qwidget.html#sizeHint-prop">QWidget::sizeHint</a>().</p>
<!-- @@@sizeHint -->
<!-- $$$subWindowActivated[overload1]$$$subWindowActivatedQMdiSubWindow* -->
<h3 class="fn"><a name="subWindowActivated"></a><span class="type">void</span> QMdiArea::<span class="name">subWindowActivated</span> ( <span class="type"><a href="qmdisubwindow.html">QMdiSubWindow</a></span> * <i>window</i> )<tt> [signal]</tt></h3>
<p><a href="qmdiarea.html">QMdiArea</a> emits this signal after <i>window</i> has been activated. When <i>window</i> is 0, <a href="qmdiarea.html">QMdiArea</a> has just deactivated its last active window, and there are no active windows on the workspace.</p>
<p><b>See also </b><a href="qmdiarea.html#activeSubWindow">QMdiArea::activeSubWindow</a>().</p>
<!-- @@@subWindowActivated -->
<!-- $$$subWindowList[overload1]$$$subWindowListWindowOrder -->
<h3 class="fn"><a name="subWindowList"></a><span class="type"><a href="qlist.html">QList</a></span><<span class="type"><a href="qmdisubwindow.html">QMdiSubWindow</a></span> *> QMdiArea::<span class="name">subWindowList</span> ( <span class="type"><a href="qmdiarea.html#WindowOrder-enum">WindowOrder</a></span> <i>order</i> = CreationOrder ) const</h3>
<p>Returns a list of all subwindows in the MDI area. If <i>order</i> is <a href="qmdiarea.html#WindowOrder-enum">CreationOrder</a> (the default), the windows are sorted in the order in which they were inserted into the workspace. If <i>order</i> is <a href="qmdiarea.html#WindowOrder-enum">StackingOrder</a>, the windows are listed in their stacking order, with the topmost window as the last item in the list. If <i>order</i> is <a href="qmdiarea.html#WindowOrder-enum">ActivationHistoryOrder</a>, the windows are listed according to their recent activation history.</p>
<p><b>See also </b><a href="qmdiarea.html#WindowOrder-enum">WindowOrder</a>.</p>
<!-- @@@subWindowList -->
<!-- $$$testOption[overload1]$$$testOptionAreaOption -->
<h3 class="fn"><a name="testOption"></a><span class="type">bool</span> QMdiArea::<span class="name">testOption</span> ( <span class="type"><a href="qmdiarea.html#AreaOption-enum">AreaOption</a></span> <i>option</i> ) const</h3>
<p>Returns true if <i>option</i> is enabled; otherwise returns false.</p>
<p><b>See also </b><a href="qmdiarea.html#AreaOption-enum">AreaOption</a> and <a href="qmdiarea.html#setOption">setOption</a>().</p>
<!-- @@@testOption -->
<!-- $$$tileSubWindows[overload1]$$$tileSubWindows -->
<h3 class="fn"><a name="tileSubWindows"></a><span class="type">void</span> QMdiArea::<span class="name">tileSubWindows</span> ()<tt> [slot]</tt></h3>
<p>Arranges all child windows in a tile pattern.</p>
<p><b>See also </b><a href="qmdiarea.html#cascadeSubWindows">cascadeSubWindows</a>().</p>
<!-- @@@tileSubWindows -->
<!-- $$$timerEvent[overload1]$$$timerEventQTimerEvent* -->
<h3 class="fn"><a name="timerEvent"></a><span class="type">void</span> QMdiArea::<span class="name">timerEvent</span> ( <span class="type"><a href="qtimerevent.html">QTimerEvent</a></span> * <i>timerEvent</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qobject.html#timerEvent">QObject::timerEvent</a>().</p>
<!-- @@@timerEvent -->
<!-- $$$viewportEvent[overload1]$$$viewportEventQEvent* -->
<h3 class="fn"><a name="viewportEvent"></a><span class="type">bool</span> QMdiArea::<span class="name">viewportEvent</span> ( <span class="type"><a href="qevent.html">QEvent</a></span> * <i>event</i> )<tt> [virtual protected]</tt></h3>
<p>Reimplemented from <a href="qabstractscrollarea.html#viewportEvent">QAbstractScrollArea::viewportEvent</a>().</p>
<!-- @@@viewportEvent -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
