|
sl@0
|
1 |
// Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
|
|
sl@0
|
2 |
// All rights reserved.
|
|
sl@0
|
3 |
// This component and the accompanying materials are made available
|
|
sl@0
|
4 |
// under the terms of "Eclipse Public License v1.0"
|
|
sl@0
|
5 |
// which accompanies this distribution, and is available
|
|
sl@0
|
6 |
// at the URL "http://www.eclipse.org/legal/epl-v10.html".
|
|
sl@0
|
7 |
//
|
|
sl@0
|
8 |
// Initial Contributors:
|
|
sl@0
|
9 |
// Nokia Corporation - initial contribution.
|
|
sl@0
|
10 |
//
|
|
sl@0
|
11 |
// Contributors:
|
|
sl@0
|
12 |
//
|
|
sl@0
|
13 |
// Description:
|
|
sl@0
|
14 |
// Interface for Render Stage Display Policy
|
|
sl@0
|
15 |
//
|
|
sl@0
|
16 |
//
|
|
sl@0
|
17 |
|
|
sl@0
|
18 |
#ifndef WSDISPLAYPOLICY_H_
|
|
sl@0
|
19 |
#define WSDISPLAYPOLICY_H_
|
|
sl@0
|
20 |
|
|
sl@0
|
21 |
/**
|
|
sl@0
|
22 |
@file
|
|
sl@0
|
23 |
@publishedpartner
|
|
sl@0
|
24 |
@released
|
|
sl@0
|
25 |
*/
|
|
sl@0
|
26 |
|
|
sl@0
|
27 |
#include <graphics/displayconfiguration.h>
|
|
sl@0
|
28 |
#include <graphics/wsgraphicdrawerinterface.h>
|
|
sl@0
|
29 |
|
|
sl@0
|
30 |
class MWsDisplayPolicy: public MWsObjectProvider
|
|
sl@0
|
31 |
{
|
|
sl@0
|
32 |
public:
|
|
sl@0
|
33 |
enum
|
|
sl@0
|
34 |
{
|
|
sl@0
|
35 |
KUidWsDisplayPolicy = 0x102869FA,
|
|
sl@0
|
36 |
ETypeId= KUidWsDisplayPolicy,
|
|
sl@0
|
37 |
EWsObjectInterfaceId= KUidWsDisplayPolicy
|
|
sl@0
|
38 |
};
|
|
sl@0
|
39 |
|
|
sl@0
|
40 |
enum TDisplayStatus
|
|
sl@0
|
41 |
{
|
|
sl@0
|
42 |
EDetach = 0,
|
|
sl@0
|
43 |
EAttach,
|
|
sl@0
|
44 |
EConnecting,
|
|
sl@0
|
45 |
};
|
|
sl@0
|
46 |
public:
|
|
sl@0
|
47 |
/**
|
|
sl@0
|
48 |
* Notification from the Window Server that the application size mode list has been updated.
|
|
sl@0
|
49 |
*/
|
|
sl@0
|
50 |
virtual void NewAppModesAvailable()=0;
|
|
sl@0
|
51 |
/**
|
|
sl@0
|
52 |
* Determine the display configuration and application rendering extent to use for a given screen size mode.
|
|
sl@0
|
53 |
*
|
|
sl@0
|
54 |
* The Window Server uses this function when a request to change to a new screen size mode or new display
|
|
sl@0
|
55 |
* configuration is made by a client. The display configuration passed in may be partially filled, and the
|
|
sl@0
|
56 |
* combination of the defined entries in it and the requested screen size mode values shall be used to define
|
|
sl@0
|
57 |
* the rest of the configuration and new application extent to be used.
|
|
sl@0
|
58 |
*
|
|
sl@0
|
59 |
* Only undefined entries in the configuration may be set by this function. Entries already defined must retain
|
|
sl@0
|
60 |
* the same values. If the combination of defined entries and size mode values is not acceptable to the implementer,
|
|
sl@0
|
61 |
* the function shall return KErrArgument.
|
|
sl@0
|
62 |
*
|
|
sl@0
|
63 |
* If the function returns KErrNone, the Window Server shall set the returned display configuration, notify render
|
|
sl@0
|
64 |
* stages of the new application extent and change to use the screen size mode. If either this function returns
|
|
sl@0
|
65 |
* EFalse or the call to set the display configuration fails for any reason (such as KErrNoMemory, for example),
|
|
sl@0
|
66 |
* then no further changes are made.
|
|
sl@0
|
67 |
*
|
|
sl@0
|
68 |
* @see MWsScreenConfigList
|
|
sl@0
|
69 |
* @see MWsDisplayMapping
|
|
sl@0
|
70 |
*
|
|
sl@0
|
71 |
* @param aScreenSizeMode The requested screen size mode. If static, the size in pixels, size in twips, and
|
|
sl@0
|
72 |
* the rotation must be respected. If dynamic, only the rotation must be respected.
|
|
sl@0
|
73 |
* @param aConfig The requested display configuration on input, the required configuration on return. Only
|
|
sl@0
|
74 |
* undefined entries may be set.
|
|
sl@0
|
75 |
* @param aExtent The screen size mode offset and size on input, the required application offset and size on return.
|
|
sl@0
|
76 |
* If the screen driver buffer is used as the UI surface, this must be left unchanged.
|
|
sl@0
|
77 |
* @return KErrNone if no error, otherwise a system wide error code
|
|
sl@0
|
78 |
*/
|
|
sl@0
|
79 |
virtual TInt GetSizeModeConfiguration(TInt aScreenSizeMode, TDisplayConfiguration& aConfig, TRect& aSizeModePosition) const =0;
|
|
sl@0
|
80 |
virtual TInt SuitableAppMode(TDisplayStatus aSituation)=0;
|
|
sl@0
|
81 |
/**
|
|
sl@0
|
82 |
* Sets the application mode resumed to after a display is connected again after a disconnect.
|
|
sl@0
|
83 |
*
|
|
sl@0
|
84 |
* @param aMode The application mode.
|
|
sl@0
|
85 |
*/
|
|
sl@0
|
86 |
virtual void SetLastAppMode(TInt aMode)=0;
|
|
sl@0
|
87 |
};
|
|
sl@0
|
88 |
|
|
sl@0
|
89 |
#endif /*WSDISPLAYPOLICY_H_*/
|