QWSWindow Class

The QWSWindow class encapsulates a top-level window in Qt for Embedded Linux. 更多...

頭: #include <QWSWindow>

公共類型

enum State { NoState, Hidden, Showing, Visible, ..., Destroyed }

公共函數

const QString & caption () const
QWSClient * client () const
QRegion dirtyOnScreen () const
bool isFullyObscured () const
bool isOpaque () const
bool isVisible () const
const QString & name () const
uint opacity () const
const QRegion & requestedRegion () const
狀態 state () const
int winId () const
Qt::WindowFlags windowFlags () const

詳細描述

The QWSWindow class encapsulates a top-level window in Qt for Embedded Linux.

When you run a Qt for Embedded Linux application, it either runs as a server or connects to an existing server. As applications add and remove windows, the server process maintains information about each window. In Qt for Embedded Linux , top-level windows are encapsulated as QWSWindow objects. Note that you should never construct the QWSWindow class yourself; the current top-level windows can be retrieved using the QWSServer::clientWindows () 函數。

With a window at hand, you can retrieve its caption, name, opacity and ID using the caption (), name (), opacity () 和 winId () functions, respectively. Use the client () function to retrieve a pointer to the client that owns the window.

使用 isVisible () function to find out if the window is visible. You can find out if the window is completely obscured by another window or by the bounds of the screen, using the isFullyObscured () 函數。 isOpaque () function returns true if the window has an alpha channel equal to 255. Finally, the requestedRegion () function returns the region of the display the window wants to draw on.

另請參閱 QWSServer , QWSClient ,和 Qt for Embedded Linux 體係結構 .

成員類型文檔編製

enum QWSWindow:: State

This enum describes the state of a window. Most of the transitional states are set just before a call to QScreen::exposeRegion () and reset immediately afterwards.

常量 描述
QWSWindow::NoState 0 Initial state before the window is properly initialized.
QWSWindow::Hidden 1 The window is not visible.
QWSWindow::Showing 2 The window is being shown.
QWSWindow::Visible 3 The window is visible, and not in a transition.
QWSWindow::Hiding 4 The window is being hidden.
QWSWindow::Raising 5 The windoe is being raised.
QWSWindow::Lowering 6 The window is being raised.
QWSWindow::Moving 7 The window is being moved.
QWSWindow::ChangingGeometry 8 The window's geometry is being changed.
QWSWindow::Destroyed 9 The window is destroyed.

另請參閱 state () 和 QScreen::exposeRegion ().

成員函數文檔編製

const QString & QWSWindow:: caption () const

Returns the window's caption.

另請參閱 name () 和 winId ().

QWSClient * QWSWindow:: client () const

Returns a reference to the QWSClient object that owns this window.

另請參閱 requestedRegion ().

QRegion QWSWindow:: dirtyOnScreen () const

Returns the region that has been repainted since the previous QScreen::exposeRegion (), and needs to be copied to the screen.

該函數在 Qt 4.3 引入。

bool QWSWindow:: isFullyObscured () const

Returns true if the window is completely obsured by another window or by the bounds of the screen; otherwise returns false.

另請參閱 isVisible ().

bool QWSWindow:: isOpaque () const

Returns true if the window is opaque, i.e., if its alpha channel equals 255; otherwise returns false.

另請參閱 opacity ().

bool QWSWindow:: isVisible () const

Returns true if the window is visible; otherwise returns false.

另請參閱 isFullyObscured ().

const QString & QWSWindow:: name () const

Returns the window's name, which is taken from the objectName() at the time of show() .

另請參閱 caption () 和 winId ().

uint QWSWindow:: opacity () const

Returns the window's alpha channel value.

另請參閱 isOpaque ().

const QRegion & QWSWindow:: requestedRegion () const

Returns the region that the window has requested to draw onto, including any window decorations.

另請參閱 client ().

State QWSWindow:: state () const

Returns the current state of the window.

該函數在 Qt 4.3 引入。

int QWSWindow:: winId () const

Returns the window's ID.

另請參閱 name () 和 caption ().

Qt::WindowFlags QWSWindow:: windowFlags () const

Returns the window flags of the window. This value is only available after the first paint event.

該函數在 Qt 4.3 引入。