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