|
Home · All Classes · Main Classes · Grouped Classes · Modules · Functions | |
The QWSServer class provides server-specific functionality in Qtopia Core. More...
#include <QWSServer>
Inherits QObject.
The QWSServer class provides server-specific functionality in Qtopia Core.
When you run a Qtopia Core application, it either runs as a server or connects to an existing server. If it runs as a server, the QWSServer class provides additional functionality to handle the clients as well as the mouse, keyboard, display and input methods.
Note that this class is instantiated by QApplication for Qtopia Core server processes; you should never construct this class yourself. Access to the QWSServer instance can be obtained using the global qwsServer pointer.
In Qtopia Core, the top-level windows are encasulated as QWSWindow objects. The collection of windows changes as applications add and remove widgets, and each window can tell which client that owns it through its QWSWindow::client() function. Use the clientWindows() function to retrieve a list of the current top-level windows. Given a particular position on the display, the window containing it can be retrieved using the windowAt() function.
QWSServer also provides the windowEvent() signal which is emitted whenever something happens to a top level window; the WindowEvent enum describes the various types of events that the signal recognizes. In addition, the server class provides the markedText() signal which is emitted whenever some text has been selected in any of the windows, passing the selection as parameter.
See the QWSWindow and QWSClient class documentation for more details.
The QCopChannel class and the QCOP communication protocol enable transfer of messages between clients. QWSServer provides the newChannel() and removedChannel() signals that is emitted whenever a new QCopChannel object is created or destroyed. See the QCopChannel class documentation for details on client communication.
To open the mouse devices specified by the QWS_MOUSE_PROTO environment variable, use the openMouse() function. Alternatively, the static setDefaultMouse() function provides means of specifying the default mouse driver to use if the QWS_MOUSE_PROTO variable is not defined. Note that the default is otherwise platform dependent. The primary mouse handler can be retrieved using the static mouseHandler() function. Use the closeMouse() function to delete the mouse handlers.
Likewise, open the keyboard devices specified by the QWS_KEYBOARD environment variable by using the openKeyboard() function. Alternatively, the static setDefaultKeyboard() function provides means of specifying the default keyboard driver to use if the QWS_KEYBOARD variable is not defined. Note again tha the default is otherwise platform dependent. The primary keyboard handler can be retrieved using the static keyboardHandler() function. Use the closeKeyboard() function to delete the keyboard handlers.
In addition, the QWSServer class can control the flow of mouse input using the suspendMouse() and resumeMouse() functions (see QWSMouseHandler for more details), and handle key events from both physical and virtual keyboards using the processKeyEvent() and sendKeyEvent() functions, respectively. Use the addKeyboardFilter() function to filter the key events from physical keyboard drivers, the most recently added filter can be removed and deleted using the removeKeyboardFilter() function. See Character Input and QWSKeyboardHandler for more information.
Finally, the keyMap() function returns the keyboard mapping table used to convert keyboard scancodes to Qt keycodes and Unicode values.
To set the brush used as the background in the absence of obscuring windows, QWSServer provides the static setBackground() function. The backgroundBrush() function returns the currently set brush.
Use the refresh() function to refresh the entire display, or alternatively a specified region of it. The enablePainting() function can be used to control the privileges for painting on the display. QWSServer also provide the setMaxWindowRect() function restricting the area of the screen which Qtopia Core applications will consider to be the maximum area to use for windows.
The setScreenSaver() function provides the option of installing a custom screensaver derived from the QWSScreenSaver class. Once installed, the screensaver can be activated using the screenSaverActivate() function, and the screenSaverActive() function returns its current status. The screensaver's timeout intervals can be specified using the setScreenSaverInterval() and setScreenSaverIntervals() functions.
Use the isCursorVisible() function to determine if the cursor is visible on the display, use the setCursorVisible() function to alter its visibility.
Custom input methods derived from the QWSInputMethod class, can be installed using the setCurrentInputMethod(). Use the sendIMEvent() and sendIMQuery() functions to send input method events and queries. Finally, QWSServer provides the IMMouse enum describing the various mouse events recognized by the QWSInputMethod::mouseHandler() function. The latter funciton allows subclasses of QWSInputMethod to handle mouse events within the preedit text.
See also QWSClient, Qtopia Core, and Running Applications.
This enum describes the various types of mouse events recognized by the QWSInputMethod::mouseHandler() function which allows subclasses of QWSInputMethod to handle mouse events within the preedit text.
| Constant | Value | Description |
|---|---|---|
| QWSServer::MousePress | 0 | An event generated by pressing a mouse button. |
| QWSServer::MouseRelease | 1 | An event generated by relasing a mouse button. |
| QWSServer::MouseMove | 2 | An event generated by moving the mouse cursor. |
| QWSServer::MouseOutside | 3 | This value is only reserved, i.e. it is not used in current implementations. |
See also QWSInputMethod::mouseHandler().
This enum specifies the various events that can occur in a top-level window.
| Constant | Value | Description |
|---|---|---|
| QWSServer::Create | 0x0001 | A new window has been created (by the QWidget constructor). |
| QWSServer::Destroy | 0x0002 | The window has been closed and deleted (by the QWidget destructor). |
| QWSServer::Hide | 0x0004 | The window has been hidden using the QWidget::hide() function. |
| QWSServer::Show | 0x0008 | The window has been shown using the QWidget::show() function or similar. |
| QWSServer::Raise | 0x0010 | The window has been raised to the top of the desktop. |
| QWSServer::Lower | 0x0020 | The window has been lowered. |
| QWSServer::Geometry | 0x0040 | The window has changed size or position. |
| QWSServer::Active | 0x0080 | The window has become the active window (i.e. it has keyboard focus). |
| QWSServer::Name | 0x0100 | The window has been named. |
See also windowEvent().
Makes the given filter the one invoked for all key events generated by physical keyboard drivers (i.e. events sent using the processKeyEvent() function).
Note that the filter is not invoked for keys generated by virtual keyboard drivers (i.e. events sent using the sendKeyEvent() function).
See also removeKeyboardFilter().
Returns the brush used as background in the absence of obscuring windows.
See also setBackground().
Returns the list of current top-level windows.
Note that the collection of top-level windows changes as applications add and remove widgets so it should not be stored for future use. The windows are sorted in stacking order from top-most to bottom-most.
See also windowAt() and QWSClient.
Closes all the keyboard devices (specified by the QWS_KEYBOARD environment variable) by deleting the associated keyboard handlers.
See also openKeyboard() and keyboardHandler().
Closes all pointer devices (specified by the QWS_MOUSE_PROTO environment variable) by deleting the associated mouse handlers.
See also openMouse() and mouseHandler().
If enable is true, painting on the display is enabled; otherwise painting is disabled.
See also QDirectPainter and QScreen.
Returns true if the cursor is visible; otherwise returns false.
See also setCursorVisible().
Returns the keyboard mapping table used to convert keyboard scancodes to Qt keycodes and Unicode values.
See also KeyMap.
Returns the primary keyboard handler.
See also setKeyboardHandler() and openKeyboard().
This signal is emitted whenever some text is selected in any of the running applications, passing the selected text in the selection parameter.
Returns the primary mouse handler.
See also setMouseHandler(), closeMouse(), and openMouse().
This signal is emitted whenever a new QCopChannel object is created, passing the channel's name in the channel parameter.
See also removedChannel().
Opens the keyboard devices specified by the QWS_KEYBOARD environment variable.
See also closeKeyboard() and keyboardHandler().
Opens the mouse devices specified by the QWS_MOUSE_PROTO environment variable.
See also closeMouse() and mouseHandler().
Processes the key event characterized by the given parameters:
| Parameter | Description |
|---|---|
| unicode | The unicode value of the key to send |
| keycode | The Qt keycode value as defined by the Qt::Key enum. |
| modifiers | An OR combination of Qt::KeyboardModifier values, indicating whether Shift/Alt/Ctrl keys are pressed. |
| isPress | True if this is a key down event; otherwise false. |
| autoRepeat | True if this event is caused by auto repeat (i.e. the user has held the key down and this is the second or subsequent key event being sent); otherwise false. |
Typically, this function is called internally by keyboard drivers.
See also sendKeyEvent(), addKeyboardFilter(), and Character Input.
Refreshes the entire display.
This is an overloaded member function, provided for convenience.
Refreshes the given region of the display.
Removes and deletes the most recently added filter.
Note that the programmer is responsible for matching each addition of a keyboard filter with a corresponding removal.
See also addKeyboardFilter().
This signal is emitted immediately after the QCopChannel object specified by channel, is destroyed.
Note that a channel is not destroyed until all its listeners have been unregistered.
See also newChannel().
Resumes mouse handling by reactivating each registered mouse handler.
See also suspendMouse(), QWSMouseHandler::resume(), and QWS_MOUSE_PROTO.
Activates the screensaver immediately if the activate is true; otherwise it is deactivated.
See also screenSaverActive().
Returns true if the screensaver is active (i.e. the screen is blanked); otherwise returns false.
See also screenSaverActivate().
Sends the given input method event.
If there is a window currently in compose mode (i.e. actively composing the preedit string ), the event is sent to that window. Otherwise, the event is sent to the current focus window.
See also sendIMQuery() and QWSInputMethod::sendEvent().
Sends an input method query for the specified property.
To receive responses to input method queries the virtual QWSInputMethod::queryResponse() function must be reimplemented in a QWSInputMethod subclass.
See also sendIMEvent() and QWSInputMethod::sendQuery().
Sends a key event. Use this function to send key events generated by "virtual keyboards".
| Parameter | Description |
|---|---|
| unicode | The unicode value of the key to send |
| keycode | The Qt keycode value as defined by the Qt::Key enum. |
| modifiers | An OR combination of Qt::KeyboardModifier values, indicating whether Shift/Alt/Ctrl keys are pressed. |
| isPress | True if this is a key down event; otherwise false. |
| autoRepeat | True if this event is caused by auto repeat (i.e. the user has held the key down and this is the second or subsequent key event being sent); otherwise false. |
See also processKeyEvent() and Character Input.
Sets the brush used as background in the absence of obscuring windows, to be the given brush.
See also backgroundBrush().
Sets the current input method to be the given method.
See also sendIMQuery(), sendIMEvent(), and QWSInputMethod.
Makes the cursor visible if visible is true: otherwise the cursor is made invisible.
See also isCursorVisible().
Sets the keyboard driver that is used if the QWS_KEYBOARD environment variable is not defined, to be the given keyboardDriver. The default is platform-dependent.
See also Character Input.
Sets the mouse driver that is used if the QWS_MOUSE_PROTO environment variable is not defined, to be the given mouseDriver. The default is platform-dependent.
See also Pointer Handling.
Sets the primary keyboard handler to be the given handler.
Note that it is recommended to use the plugin mechanism instead, deriving from the QKbdDriverPlugin and QKbdDriverFactory classes.
See also keyboardHandler().
Sets the area of the screen which Qtopia Core applications will consider to be the maximum area to use for windows, to the area specified by the given rectangle.
See also QWidget::showMaximized().
Sets the primary mouse handler to be the given handler.
Note that it is recommended to use the plugin mechanism instead, deriving from the QMouseDriverPlugin and QMouseDriverFactory classes.
See also mouseHandler().
Deletes the current screensaver and installs the given screenSaver instead.
See also screenSaverActivate().
Sets the timeout interval for the screensaver to be the specified milliseconds. To turn off the screensaver, set the timout interval to 0.
See also setScreenSaverIntervals().
Sets a list of timeout intervals (specified in millisecond) for the screensaver. An interval of 0 milliseconds turns off the screensaver.
Note that the array must be 0-terminated.
See also setScreenSaverInterval().
Suspends mouse handling by suspending each registered mouse handler.
See also resumeMouse(), QWSMouseHandler::suspend(), and QWS_MOUSE_PROTO.
Returns the window containing the given position, returns 0 if there is no window under the specified point.
See also clientWindows().
This signal is emitted whenever something happens to a top-level window (e.g. it's created or destroyed).
The window to which the event has occurred and the event's type are passed in the window and eventType parameters, respectively.
| Copyright © 2006 Trolltech | Trademarks | Qt 4.1.3 |