Sophie

Sophie

distrib > Mandriva > 2010.0 > i586 > media > contrib-release > by-pkgid > a6711891ce757817bba854bf3f25205a > files > 1974

qtjambi-doc-4.3.3-3mdv2008.1.i586.rpm

<class name="QDesktopWidget" doc="/**
&lt;p&gt;The &lt;a href=&quot;QDesktopWidget.html#QDesktopWidget()&quot;&gt;&lt;tt&gt;QDesktopWidget&lt;/tt&gt;&lt;/a&gt; class provides access to screen information on multi-head systems.&lt;/p&gt;
&lt;p&gt;Systems with more than one graphics card and monitor can manage the physical screen space available either as multiple desktops, or as a large virtual desktop, which usually has the size of the bounding rectangle of all the screens (see &lt;a href=&quot;QDesktopWidget.html#isVirtualDesktop()&quot;&gt;&lt;tt&gt;isVirtualDesktop&lt;/tt&gt;&lt;/a&gt;). For an application, one of the available screens is the primary screen, i.e&amp;#x2e; the screen where the main widget resides (see &lt;a href=&quot;QDesktopWidget.html#primaryScreen()&quot;&gt;&lt;tt&gt;primaryScreen&lt;/tt&gt;&lt;/a&gt;). All windows opened in the context of the application should be constrained to the boundaries of the primary screen; for example, it would be inconvenient if a dialog box popped up on a different screen, or split over two screens.&lt;/p&gt;
&lt;p&gt;The &lt;a href=&quot;QDesktopWidget.html#QDesktopWidget()&quot;&gt;&lt;tt&gt;QDesktopWidget&lt;/tt&gt;&lt;/a&gt; provides information about the geometry of the available screens with &lt;a href=&quot;QDesktopWidget.html#screenGeometry(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;screenGeometry&lt;/tt&gt;&lt;/a&gt;. The number of screens available is returned by &lt;a href=&quot;QDesktopWidget.html#numScreens()&quot;&gt;&lt;tt&gt;numScreens&lt;/tt&gt;&lt;/a&gt;. The screen number that a particular point or widget is located in is returned by &lt;a href=&quot;QDesktopWidget.html#screenNumber(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;screenNumber&lt;/tt&gt;&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Widgets provided by Qt use this class, for example, to place tooltips, menus and dialog boxes according to the parent or application widget.&lt;/p&gt;
&lt;p&gt;Applications can use this class to save window positions, or to place child widgets on one screen.&lt;/p&gt;
&lt;p align=&quot;center&quot;&gt;&lt;img src=&quot;%2E%2E/images/qdesktopwidget.png&quot; alt=&quot;Managing Multiple Screens&quot; /&gt;&lt;/p&gt;&lt;p&gt;In the illustration above, Application One's primary screen is screen 0, and App Two's primary screen is screen 1.&lt;/p&gt;

@see &lt;a href=&quot;QApplication.html&quot;&gt;&lt;tt&gt;QApplication&lt;/tt&gt;&lt;/a&gt;
@see &lt;tt&gt;QX11Info::appRootWindow&lt;/tt&gt; */">
    <signal name="protected final void customContextMenuRequested(com.trolltech.qt.core.QPoint pos)" doc="/**
&lt;p&gt;This signal is emitted when the widget's &lt;a href=&quot;QWidget.html#contextMenuPolicy()&quot;&gt;&lt;tt&gt;contextMenuPolicy&lt;/tt&gt;&lt;/a&gt; is Qt::CustomContextMenu, and the user has requested a context menu on the widget. The position &lt;tt&gt;pos&lt;/tt&gt; is the position of the context menu event that the widget receives. Normally this is in widget coordinates. The exception to this rule is &lt;a href=&quot;QAbstractScrollArea.html&quot;&gt;&lt;tt&gt;QAbstractScrollArea&lt;/tt&gt;&lt;/a&gt; and its subclasses that map the context menu event to coordinates of the viewport()&lt;/tt&gt; .&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(com.trolltech.qt.core.QPoint pos)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;See Also:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;a href=&quot;QWidget.html#mapToGlobal(com.trolltech.qt.core.QPoint)&quot;&gt;&lt;tt&gt;mapToGlobal&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QMenu.html&quot;&gt;&lt;tt&gt;QMenu&lt;/tt&gt;&lt;/a&gt;, &lt;a href=&quot;QWidget.html#contextMenuPolicy()&quot;&gt;&lt;tt&gt;contextMenuPolicy&lt;/tt&gt;&lt;/a&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void resized(int arg__1)" doc="/**
&lt;p&gt;This signal is emitted when the size of &lt;tt&gt;arg__1&lt;/tt&gt; changes.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(int arg__1)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <signal name="protected final void workAreaResized(int arg__1)" doc="/**
&lt;p&gt;This signal is emitted when the work area available on &lt;tt&gt;arg__1&lt;/tt&gt; changes.&lt;/p&gt;
&lt;dl&gt;
&lt;dt&gt;&lt;b&gt;Compatible Slot Signatures:&lt;/b&gt;&lt;/dt&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot(int arg__1)&lt;/tt&gt;&lt;/dd&gt;
&lt;dd&gt;&lt;tt&gt;void mySlot()&lt;/tt&gt;&lt;/dd&gt;
&lt;/dl&gt;
 */"/>
    <method name="public QDesktopWidget()" doc="/**
&lt;p&gt;Creates the desktop widget.&lt;/p&gt;
&lt;p&gt;If the system supports a virtual desktop, this widget will have the size of the virtual desktop; otherwise this widget will have the size of the primary screen.&lt;/p&gt;
&lt;p&gt;Instead of using &lt;a href=&quot;QDesktopWidget.html#QDesktopWidget()&quot;&gt;&lt;tt&gt;QDesktopWidget&lt;/tt&gt;&lt;/a&gt; directly, use QApplication::desktop().&lt;/p&gt;
 */"/>
    <method name="public final com.trolltech.qt.core.QRect availableGeometry(com.trolltech.qt.gui.QWidget widget)" doc="/**
&lt;p&gt;Returns the available geometry of the screen which contains &lt;tt&gt;widget&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QDesktopWidget.html#screenGeometry(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;screenGeometry&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.core.QRect availableGeometry(com.trolltech.qt.core.QPoint point)" doc="/**
&lt;p&gt;Returns the available geometry of the screen which contains &lt;tt&gt;point&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QDesktopWidget.html#screenGeometry(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;screenGeometry&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.core.QRect availableGeometry(int screen)" doc="/**
&lt;p&gt;Returns the available geometry of the screen with index &lt;tt&gt;screen&lt;/tt&gt;. What is available will be subrect of &lt;a href=&quot;QDesktopWidget.html#screenGeometry(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;screenGeometry&lt;/tt&gt;&lt;/a&gt; based on what the platform decides is available (for example excludes the dock and menu bar on Mac OS X, or the task bar on Windows).&lt;/p&gt;

@see &lt;a href=&quot;QDesktopWidget.html#screenNumber(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;screenNumber&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QDesktopWidget.html#screenGeometry(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;screenGeometry&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.core.QRect availableGeometry()" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QDesktopWidget.html#availableGeometry(int)&quot;&gt;&lt;tt&gt;availableGeometry&lt;/tt&gt;&lt;/a&gt;(-1). */"/>
    <method name="public final boolean isVirtualDesktop()" doc="/**
&lt;p&gt;Returns true if the system manages the available screens in a virtual desktop; otherwise returns false.&lt;/p&gt;
&lt;p&gt;For virtual desktops, &lt;a href=&quot;QDesktopWidget.html#screen(int)&quot;&gt;&lt;tt&gt;screen&lt;/tt&gt;&lt;/a&gt; will always return the same widget. The size of the virtual desktop is the size of this desktop widget.&lt;/p&gt;
 */"/>
    <method name="public final int numScreens()" doc="/**
&lt;p&gt;Returns the number of available screens.&lt;/p&gt;

@see &lt;a href=&quot;QDesktopWidget.html#primaryScreen()&quot;&gt;&lt;tt&gt;primaryScreen&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final int primaryScreen()" doc="/**
&lt;p&gt;Returns the index of the primary screen.&lt;/p&gt;

@see &lt;a href=&quot;QDesktopWidget.html#numScreens()&quot;&gt;&lt;tt&gt;numScreens&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.gui.QWidget screen(int screen)" doc="/**
&lt;p&gt;Returns a widget that represents the screen with index &lt;tt&gt;screen&lt;/tt&gt;.&lt;/p&gt;
&lt;p&gt;If the system uses a virtual desktop, the returned widget will have the geometry of the entire virtual desktop; i.e&amp;#x2e;, bounding every &lt;tt&gt;screen&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QDesktopWidget.html#primaryScreen()&quot;&gt;&lt;tt&gt;primaryScreen&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QDesktopWidget.html#numScreens()&quot;&gt;&lt;tt&gt;numScreens&lt;/tt&gt;&lt;/a&gt;
@see &lt;a href=&quot;QDesktopWidget.html#isVirtualDesktop()&quot;&gt;&lt;tt&gt;isVirtualDesktop&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.gui.QWidget screen()" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QDesktopWidget.html#screen(int)&quot;&gt;screen&lt;/tt&gt;&lt;/a&gt;(-1). */"/>
    <method name="public final com.trolltech.qt.core.QRect screenGeometry(int screen)" doc="/**
&lt;p&gt;Returns the geometry of the screen with index &lt;tt&gt;screen&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QDesktopWidget.html#screenNumber(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;screenNumber&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final com.trolltech.qt.core.QRect screenGeometry()" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QDesktopWidget.html#screenGeometry(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;screenGeometry&lt;/tt&gt;&lt;/a&gt;(-1). */"/>
    <method name="public final com.trolltech.qt.core.QRect screenGeometry(com.trolltech.qt.core.QPoint point)" doc="/**
&lt;p&gt;Returns the geometry of the screen which contains &lt;tt&gt;point&lt;/tt&gt;.&lt;/p&gt;
 */"/>
    <method name="public final com.trolltech.qt.core.QRect screenGeometry(com.trolltech.qt.gui.QWidget widget)" doc="/**
&lt;p&gt;Returns the geometry of the screen which contains &lt;tt&gt;widget&lt;/tt&gt;.&lt;/p&gt;
 */"/>
    <method name="public final int screenNumber(com.trolltech.qt.core.QPoint arg__1)" doc="/**
&lt;p&gt;Returns the index of the screen that contains the &lt;tt&gt;arg__1&lt;/tt&gt;, or the screen which is the shortest distance from the &lt;tt&gt;arg__1&lt;/tt&gt;.&lt;/p&gt;

@see &lt;a href=&quot;QDesktopWidget.html#primaryScreen()&quot;&gt;&lt;tt&gt;primaryScreen&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final int screenNumber(com.trolltech.qt.gui.QWidget widget)" doc="/**
&lt;p&gt;Returns the index of the screen that contains the largest part of &lt;tt&gt;widget&lt;/tt&gt;, or -1 if the widget not on a screen.&lt;/p&gt;

@see &lt;a href=&quot;QDesktopWidget.html#primaryScreen()&quot;&gt;&lt;tt&gt;primaryScreen&lt;/tt&gt;&lt;/a&gt; */"/>
    <method name="public final int screenNumber()" doc="/**
&lt;p&gt;Equivalent to &lt;a href=&quot;QDesktopWidget.html#screenNumber(com.trolltech.qt.gui.QWidget)&quot;&gt;&lt;tt&gt;screenNumber&lt;/tt&gt;&lt;/a&gt;(0). */"/>
    <method name="protected void resizeEvent(com.trolltech.qt.gui.QResizeEvent e)" doc="/**
&lt;p&gt;This function is reimplemented for internal reasons.&lt;/p&gt;
 */"/>
</class>