Symbian3/SDK/Source/GUID-7AE4913D-18CE-5F17-A6B1-6E3F6975A178.dita
author Graeme Price <GRAEME.PRICE@NOKIA.COM>
Fri, 15 Oct 2010 14:32:18 +0100
changeset 15 307f4279f433
parent 0 89d6a7a84779
permissions -rw-r--r--
Initial contribution of the Adaptation Documentation.

<?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 xml:lang="en" id="GUID-7AE4913D-18CE-5F17-A6B1-6E3F6975A178"><title>Window Group Priority</title><shortdesc>In addition to having an ordinal position, all windows have a priority, which is 0 by default. A window's priority can be changed in order to allow it to override the normal z-order determined by ordinal position. Although this can be done for any type of window, in practice it is generally only window groups that have their priorities changed, and this is normally carried out by special applications such as the shell. </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 ordinal position of a window only applies within the set of windows that have the same priority as that window. If a window group is given a priority higher than other window groups, it is positioned in front of all windows of lower priority, regardless of their ordinal positions. If a window group is given a priority of 1, for example, and all other window groups have a priority of 0, it is moved to the <keyword>foreground</keyword> and all other window are prevented from overlapping it or from getting the keyboard focus (unless it has disabled receipt of keyboard focus). </p> <p>Similarly, if a window group is given a priority of –1, and all other window groups have a priority of 0, it does not get keyboard focus or move to the front of any other window group, whatever its ordinal position is set to. Such a setting might, for example, be used for a background "wallpaper" application. </p> <section><title>Full ordinal position</title> <p>The <keyword>full ordinal position</keyword> of a window group is its ordinal position, taking into account window groups of other priorities. For example, if window group A has priority 0 and ordinal position 0, but window group B has a priority of 1, then window group A’s <i>full</i> ordinal position is 1, not 0. </p> <p>Full ordinal position is usually only meaningful for window groups, although it also exists for other windows. Other windows are typically not given different priorities. Consequently their ordinal positions and full ordinal positions are usually the same. </p> </section> </conbody><related-links><link href="GUID-99AE1D62-571A-5A63-B472-C0FBC0861F52.dita"><linktext>Window Types</linktext> </link> </related-links></concept>