|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-D68E0A64-0E8A-5C52-9C5B-93BA3B80C200" xml:lang="en"><title>Window |
|
13 Groups and Applications</title><shortdesc>A window group is the basic unit of an application.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p> <b>Variant</b>: Both (ScreenPlay and non-ScreenPlay). <b>Target audience</b>: |
|
15 Application developers. </p> |
|
16 <p> The main functions of a window group are: </p> |
|
17 <ul> |
|
18 <li id="GUID-7FCE3494-29FA-55D0-B798-825A86230A41"><p>To receive keyboard |
|
19 focus—unless captured, all key events are sent to the window group that has |
|
20 keyboard focus. </p> </li> |
|
21 <li id="GUID-F6CAE40A-72FE-5DC7-8104-173D3AE41BBC"><p>The application that |
|
22 has keyboard focus is known as the "foreground application". The Window Server |
|
23 gives the foreground application’s thread extra priority, so that it is responsive |
|
24 to the user, even if a background application is performing a long-running |
|
25 task. </p> </li> |
|
26 <li id="GUID-92F3DF82-02D1-579A-855E-3E9F540B75AF"><p>To control settings |
|
27 for priority keys and key capture. </p> </li> |
|
28 <li id="GUID-2760EF21-9193-5F48-9DE0-748BAD2EA9DB"><p>To have an associated |
|
29 name that can be interrogated by other Window Server clients and used to determine |
|
30 which applications are running. </p> </li> |
|
31 <li id="GUID-8CDFDECF-0B23-5BE4-964E-4ABE29F625F2"><p>To have a text cursor. |
|
32 The text cursor is displayed only for the application with keyboard focus. </p> </li> |
|
33 <li id="GUID-C184C67F-193B-5498-9537-632B52D53A7A"><p>To form a group for |
|
34 all other windows owned by an application. </p> </li> |
|
35 </ul> |
|
36 <p>A typical application has a single window group, and all its other windows |
|
37 are descendants of that window group. A system shell application may use the <codeph>RWsSession</codeph> interface |
|
38 to interrogate all window groups owned by all client applications, and therefore |
|
39 may display a task list. All applications should use the same policy for the |
|
40 format of the window group name. This policy is the responsibility of the |
|
41 GUI, not the Window Server itself. </p> |
|
42 <p>An <codeph>RWindowGroup</codeph> is a pseudo-window that can never be seen |
|
43 on screen, but which has an <keyword>ordinal position</keyword> and participates |
|
44 in parent/child and sibling relationships as all other windows. </p> |
|
45 </conbody><related-links> |
|
46 <link href="GUID-99AE1D62-571A-5A63-B472-C0FBC0861F52.dita"><linktext>Window Types</linktext> |
|
47 </link> |
|
48 </related-links></concept> |