<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html> <html lang="en"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <!-- qdesktopwidget.qdoc --> <title>Obsolete Members for QDesktopWidget | Qt Widgets 5.12.6</title> <link rel="stylesheet" type="text/css" href="style/offline-simple.css" /> <script type="text/javascript"> document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css"); // loading style sheet breaks anchors that were jumped to before // so force jumping to anchor again setTimeout(function() { var anchor = location.hash; // need to jump to different anchor first (e.g. none) location.hash = "#"; setTimeout(function() { location.hash = anchor; }, 0); }, 0); </script> </head> <body> <div class="header" id="qtdocheader"> <div class="main"> <div class="main-rounded"> <div class="navigationbar"> <table><tr> <td >Qt 5.12</td><td ><a href="qtwidgets-index.html">Qt Widgets</a></td><td ><a href="qtwidgets-module.html">C++ Classes</a></td><td >QDesktopWidget</td></tr></table><table class="buildversion"><tr> <td id="buildversion" width="100%" align="right"><a href="qtwidgets-index.html">Qt 5.12.6 Reference Documentation</a></td> </tr></table> </div> </div> <div class="content"> <div class="line"> <div class="content mainContent"> <div class="sidebar"><div class="sidebar-content" id="sidebar-content"></div></div> <h1 class="title">Obsolete Members for QDesktopWidget</h1> <p><b>The following members of class <a href="qdesktopwidget.html">QDesktopWidget</a> are obsolete.</b> They are provided to keep old source code working. We strongly advise against using them in new code.</p> <h2>Properties</h2> <ul> <li class="fn"><code>(obsolete) </code><b><a href="qdesktopwidget-obsolete.html#primaryScreen-prop">primaryScreen</a></b> : const int</li> <li class="fn"><code>(obsolete) </code><b><a href="qdesktopwidget-obsolete.html#screenCount-prop">screenCount</a></b> : const int</li> <li class="fn"><code>(obsolete) </code><b><a href="qdesktopwidget-obsolete.html#virtualDesktop-prop">virtualDesktop</a></b> : const bool</li> <li class="fn"><code>(obsolete) </code><b><a href="qwidget-obsolete.html#windowIconText-prop">windowIconText</a></b> : QString</li> </ul> <h2>Public Functions</h2> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>const QRect </td><td class="memItemRight bottomAlign"><b><a href="qdesktopwidget-obsolete.html#availableGeometry-1">availableGeometry</a></b>(int <i>screen</i> = -1) const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>const QRect </td><td class="memItemRight bottomAlign"><b><a href="qdesktopwidget-obsolete.html#availableGeometry-2">availableGeometry</a></b>(const QPoint &<i>p</i>) const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code></td><td class="memItemRight bottomAlign"><b><a href="../qtcore/qobject-obsolete.html#dumpObjectInfo-1">dumpObjectInfo</a></b>()</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code></td><td class="memItemRight bottomAlign"><b><a href="../qtcore/qobject-obsolete.html#dumpObjectTree-1">dumpObjectTree</a></b>()</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget-obsolete.html#isEnabledToTLW">isEnabledToTLW</a></b>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>bool </td><td class="memItemRight bottomAlign"><b><a href="qwidget-obsolete.html#isTopLevel">isTopLevel</a></b>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>int </td><td class="memItemRight bottomAlign"><b><a href="qdesktopwidget-obsolete.html#numScreens">numScreens</a></b>() const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qdesktopwidget-obsolete.html#screen">screen</a></b>(int <i>screen</i> = -1)</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>const QRect </td><td class="memItemRight bottomAlign"><b><a href="qdesktopwidget-obsolete.html#screenGeometry-1">screenGeometry</a></b>(int <i>screen</i> = -1) const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>const QRect </td><td class="memItemRight bottomAlign"><b><a href="qdesktopwidget-obsolete.html#screenGeometry-2">screenGeometry</a></b>(const QPoint &<i>p</i>) const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>int </td><td class="memItemRight bottomAlign"><b><a href="qdesktopwidget-obsolete.html#screenNumber-1">screenNumber</a></b>(const QPoint &<i>point</i>) const</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>QWidget *</td><td class="memItemRight bottomAlign"><b><a href="qwidget-obsolete.html#topLevelWidget">topLevelWidget</a></b>() const</td></tr> </table></div> <h2>Signals</h2> <div class="table"><table class="alignedsummary"> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qdesktopwidget-obsolete.html#resized">resized</a></b>(int <i>screen</i>)</td></tr> <tr><td class="memItemLeft topAlign rightAlign"> <code>(obsolete) </code>void </td><td class="memItemRight bottomAlign"><b><a href="qdesktopwidget-obsolete.html#workAreaResized">workAreaResized</a></b>(int <i>screen</i>)</td></tr> </table></div> <h2>Member Function Documentation</h2> <!-- $$$availableGeometry$$$availableGeometryint --> <h3 class="fn" id="availableGeometry-1"><a name="availableGeometry-1"></a>const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span> QDesktopWidget::<span class="name">availableGeometry</span>(<span class="type">int</span> <i>screen</i> = -1) const</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>Returns the available geometry of the screen with index <i>screen</i>. What is available will be subrect of <a href="qdesktopwidget.html#screenGeometry">screenGeometry</a>() based on what the platform decides is available (for example excludes the dock and menu bar on macOS, or the task bar on Windows). The default screen is used if <i>screen</i> is -1.</p> <p>Use <a href="../qtgui/qguiapplication.html#screens">QGuiApplication::screens</a>() instead.</p> <p><b>See also </b><a href="qdesktopwidget.html#screenNumber">screenNumber</a>(), <a href="qdesktopwidget.html#screenGeometry">screenGeometry</a>(), and <a href="../qtgui/qscreen.html#availableGeometry-prop">QScreen::availableGeometry</a>().</p> <!-- @@@availableGeometry --> <!-- $$$availableGeometry$$$availableGeometryconstQPoint& --> <h3 class="fn" id="availableGeometry-2"><a name="availableGeometry-2"></a>const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span> QDesktopWidget::<span class="name">availableGeometry</span>(const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &<i>p</i>) const</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>This is an overloaded function.</p> <p>Returns the available geometry of the screen which contains <i>p</i>.</p> <p>Use <a href="../qtgui/qguiapplication.html#screenAt">QGuiApplication::screenAt</a>() instead.</p> <p><b>See also </b><a href="qdesktopwidget.html#screenGeometry">screenGeometry</a>().</p> <!-- @@@availableGeometry --> <!-- $$$numScreens[overload1]$$$numScreens --> <h3 class="fn" id="numScreens"><a name="numScreens"></a><span class="type">int</span> QDesktopWidget::<span class="name">numScreens</span>() const</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>Returns the number of available screens.</p> <p>Use <a href="../qtgui/qguiapplication.html#screens">QGuiApplication::screens</a>() instead.</p> <p><b>See also </b><a href="qdesktopwidget-obsolete.html#primaryScreen-prop">primaryScreen</a>.</p> <!-- @@@numScreens --> <!-- $$$primaryScreenChanged --> <h3 class="fn" id="primaryScreenChanged"><a name="primaryScreenChanged"></a><code>[signal] </code><span class="type">void</span> QDesktopWidget::<span class="name">primaryScreenChanged</span>()</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>This signal is emitted whenever the primary screen changes.</p> <p><b>Note: </b>This doesn't mean the <a href="qdesktopwidget-obsolete.html#primaryScreen-prop">QDesktopWidget::primaryScreen</a> index will necessarily be different, but now it will refer to the new primary screen.</p><p>Use <a href="../qtgui/qguiapplication.html#primaryScreen-prop">QGuiApplication::primaryScreenChanged</a>() instead.</p> <p>This function was introduced in Qt 5.6.</p> <p><b>Note:</b> Notifier signal for property <a href="qdesktopwidget-obsolete.html#primaryScreen-prop">primaryScreen</a>. </p><p><b>See also </b><a href="qdesktopwidget-obsolete.html#primaryScreen-prop">primaryScreen</a> and <a href="qdesktopwidget.html#screenGeometry">screenGeometry</a>().</p> <!-- @@@primaryScreenChanged --> <!-- $$$resized[overload1]$$$resizedint --> <h3 class="fn" id="resized"><a name="resized"></a><code>[signal] </code><span class="type">void</span> QDesktopWidget::<span class="name">resized</span>(<span class="type">int</span> <i>screen</i>)</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>This signal is emitted when the size of <i>screen</i> changes.</p> <p>Use <a href="../qtgui/qscreen.html#geometryChanged">QScreen::geometryChanged</a>() instead.</p> <!-- @@@resized --> <!-- $$$screen[overload1]$$$screenint --> <h3 class="fn" id="screen"><a name="screen"></a><span class="type"><a href="qwidget.html#QWidget">QWidget</a></span> *QDesktopWidget::<span class="name">screen</span>(<span class="type">int</span> <i>screen</i> = -1)</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>Returns a widget that represents the screen with index <i>screen</i> (a value of -1 means the default screen).</p> <p>If the system uses a virtual desktop, the returned widget will have the geometry of the entire virtual desktop; i.e., bounding every <i>screen</i>.</p> <p>Use <a href="../qtgui/qscreen.html">QScreen</a> instead.</p> <p><b>See also </b><a href="qdesktopwidget-obsolete.html#primaryScreen-prop">primaryScreen</a>, <a href="qdesktopwidget-obsolete.html#screenCount-prop">screenCount</a>, and <a href="qdesktopwidget-obsolete.html#virtualDesktop-prop">virtualDesktop</a>.</p> <!-- @@@screen --> <!-- $$$screenCountChanged --> <h3 class="fn" id="screenCountChanged"><a name="screenCountChanged"></a><code>[signal] </code><span class="type">void</span> QDesktopWidget::<span class="name">screenCountChanged</span>(<span class="type">int</span> <i>newCount</i>)</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>This signal is emitted when the number of screens changes to <i>newCount</i>.</p> <p>Use <a href="../qtgui/qguiapplication.html#screenAdded">QGuiApplication::screenAdded</a> and <a href="../qtgui/qguiapplication.html#screenRemoved">QGuiApplication::screenRemoved</a>() instead.</p> <p>This function was introduced in Qt 4.6.</p> <p><b>Note:</b> Notifier signal for property <a href="qdesktopwidget-obsolete.html#screenCount-prop">screenCount</a>. </p><p><b>See also </b><a href="qdesktopwidget-obsolete.html#screenCount-prop">screenCount</a>.</p> <!-- @@@screenCountChanged --> <!-- $$$screenGeometry$$$screenGeometryint --> <h3 class="fn" id="screenGeometry-1"><a name="screenGeometry-1"></a>const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span> QDesktopWidget::<span class="name">screenGeometry</span>(<span class="type">int</span> <i>screen</i> = -1) const</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>Returns the geometry of the screen with index <i>screen</i>. The default screen is used if <i>screen</i> is -1.</p> <p>Use <a href="../qtgui/qguiapplication.html#screens">QGuiApplication::screens</a>() instead.</p> <p><b>See also </b><a href="qdesktopwidget.html#screenNumber">screenNumber</a>().</p> <!-- @@@screenGeometry --> <!-- $$$screenGeometry$$$screenGeometryconstQPoint& --> <h3 class="fn" id="screenGeometry-2"><a name="screenGeometry-2"></a>const <span class="type"><a href="../qtcore/qrect.html">QRect</a></span> QDesktopWidget::<span class="name">screenGeometry</span>(const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &<i>p</i>) const</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>This is an overloaded function.</p> <p>Returns the geometry of the screen which contains <i>p</i>.</p> <p>Use <a href="../qtgui/qguiapplication.html#screenAt">QGuiApplication::screenAt</a>() instead.</p> <!-- @@@screenGeometry --> <!-- $$$screenNumber$$$screenNumberconstQPoint& --> <h3 class="fn" id="screenNumber-1"><a name="screenNumber-1"></a><span class="type">int</span> QDesktopWidget::<span class="name">screenNumber</span>(const <span class="type"><a href="../qtcore/qpoint.html">QPoint</a></span> &<i>point</i>) const</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>This is an overloaded function.</p> <p>Returns the index of the screen that contains the <i>point</i>, or the screen which is the shortest distance from the <i>point</i>.</p> <p>Use <a href="../qtgui/qguiapplication.html#screenAt">QGuiApplication::screenAt</a>() instead.</p> <p><b>See also </b><a href="qdesktopwidget-obsolete.html#primaryScreen-prop">primaryScreen</a>.</p> <!-- @@@screenNumber --> <!-- $$$workAreaResized[overload1]$$$workAreaResizedint --> <h3 class="fn" id="workAreaResized"><a name="workAreaResized"></a><code>[signal] </code><span class="type">void</span> QDesktopWidget::<span class="name">workAreaResized</span>(<span class="type">int</span> <i>screen</i>)</h3> <p>This function is obsolete. It is provided to keep old source code working. We strongly advise against using it in new code.</p> <p>This signal is emitted when the work area available on <i>screen</i> changes.</p> <p>Use <a href="../qtgui/qscreen.html#availableGeometryChanged">QScreen::availableGeometryChanged</a>() instead.</p> <!-- @@@workAreaResized --> </div> </div> </div> </div> </div> <div class="footer"> <p> <acronym title="Copyright">©</acronym> 2019 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners.<br/> 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.<br/> 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. </p> </div> </body> </html>