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-EF7FF39E-929F-4767-B475-5D582D37BB32" xml:lang="en"><title>Window

    13 server events</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>Window server events are an important part of the application framework.

    15 They allow applications to receive information regarding key presses, pointer

    16 activities, application switches, and focus transitions. </p>

    17 <p>Every application has at least a <xref href="GUID-FD2CDEB8-0784-4BE5-A775-170F57D71BBC.dita">UI

    18 controller</xref>, which is the root for all other controls owned by the application.

    19 When an event occurs under the window server, the window server passes the

    20 event to the UI controller and possible other controls, depending on the event

    21 and the architecture of your application.</p>

    22 <p>For more information on the window server, see <xref href="jar:GUID-35228542-8C95-4849-A73F-2B4F082F0C44.jar!/sdk/doc_source/guide/Graphics-subsystem-guide/WindowServerClientSide/WindowServerGuide1/WindowServerIntroduction.guide.html#WindowServerGuide1%2eintro" format="application/java-archive">Introduction to the window server</xref>.</p>

    23 <p>The following window server events have a special function:</p>

    24 <ul>

    25 <li><p><xref href="GUID-E402616A-7ED8-45AC-B836-99C3A3760B33.dita">Key events</xref></p>

    26 </li>

    27 <li><p><xref href="GUID-DD15F24B-0786-4531-A6C5-A5E70EBE2732.dita">Layout

    28 change events</xref></p>

    29 </li>

    30 <li><p><xref href="GUID-3B441CDC-AB7A-4D8D-A595-57C21E1D426C.dita">Foreground

    31 events</xref></p>

    32 </li>

    33 <li><p><xref href="GUID-4D2AA522-82AB-4D1E-9F1E-5C6A35DEF195.dita">Pointer

    34 events</xref></p>

    35 </li>

    36 <li><p><xref href="GUID-868C1A38-3CD0-4082-8106-DC3EE1F815D8.dita">System

    37 events</xref></p>

    38 </li>

    39 <li><p><xref href="GUID-95DD1440-01C9-4997-8DD4-FFD33D7DEAFF.dita">Application-specific

    40 events</xref></p>

    41 </li>

    42 <li><p><xref href="GUID-3729C075-4958-4874-9DD7-02A68D17E043.dita">Other

    43 window server events</xref></p>

    44 </li>

    45 </ul>

    46 <p>The framework provides different functions to handle each type of event

    47 separately. You must implement these functions for the events to be handled

    48 by your application.</p>

    49 <p> All the window server event types are defined in the <parmname>w32std.h</parmname> header,

    50 and are as follows:</p>

    51 <codeblock id="GUID-2F04E088-73B0-4006-903D-4651223E0434" xml:space="preserve">enum TEventCode 

    52     { 

    53     EEventNull, 

    54     EEventKey, 

    55     EEventKeyUp, 

    56     EEventKeyDown, 

    57     EEventModifiersChanged, 

    58     EEventPointer, 

    59     EEventPointerEnter, 

    60     EEventPointerExit, 

    61     EEventPointerBufferReady, 

    62     EEventDragDrop, 

    63     EEventFocusLost, 

    64     EEventFocusGained, 

    65     EEventSwitchOn, 

    66     EEventWindowGroupsChanged, 

    67     EEventErrorMessage, 

    68     EEventMessageReady, 

    69     EEventMarkInvalid, 

    70     EEventSwitchOff, 

    71     EEventKeySwitchOff, 

    72     EEventScreenDeviceChanged, 

    73     EEventFocusGroupChanged, 

    74     EEventCaseOpened, 

    75     EEventCaseClosed, 

    76     EEventWindowGroupListChanged, 

    77     EEventWindowVisibilityChanged, 

    78     EEventKeyRepeat=100, 

    79     EEventDirectScreenAccessBegin = 200, 

    80     EEventDirectScreenAccessEnd, 

    81     EEventHeartbeatTimerStateChange, 

    82     EEventUser = 1000, 

    83     }; 

    84 

    85 </codeblock>

    86 </conbody></concept>