dependencies/AknStatuspaneUtils.h
author MattD <mattd@symbian.org>
Thu, 01 Apr 2010 14:50:19 +0100
changeset 48 0d4ac38889fc
parent 34 1494d39c2fee
permissions -rw-r--r--
Merged in kashif's, fdim's and my removal of abld.bat and .cproject files onto the fixed up version of Christian's head.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
34
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
     1
/*
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
     2
* Copyright (c) 2004-2007 Nokia Corporation and/or its subsidiary(-ies).
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
     3
* All rights reserved.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
     4
* This component and the accompanying materials are made available
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
     6
* which accompanies this distribution, and is available
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
     8
*
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
     9
* Initial Contributors:
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    11
*
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    12
* Contributors:
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    13
*
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    14
* Description:  Statuspane related utilities.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    15
*
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    16
*/
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    17
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    18
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    19
#ifndef __AKNSTATUSPANEUTILS_H__
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    20
#define __AKNSTATUSPANEUTILS_H__
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    21
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    22
#include <e32base.h>
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    23
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    24
/**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    25
 * This class contains statuspane related utility methods.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    26
 */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    27
class AknStatuspaneUtils
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    28
    {
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    29
public:
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    30
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    31
   /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    32
    * This method checks if statuspane layout is currently a stacon layout.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    33
    * (stacon = combined status & control pane, side softkeys).
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    34
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    35
    * @return ETrue if one of stacon layouts is active, otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    36
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    37
    */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    38
    IMPORT_C static TBool StaconPaneActive();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    39
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    40
   /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    41
    * This method checks if statuspane layout is currently a stacon layout 
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    42
    * which has softkeylabels at the left side of the screen.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    43
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    44
    * @return ETrue if one of stacon layout with left softkeys is active, 
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    45
    *         otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    46
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    47
    */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    48
    IMPORT_C static TBool StaconSoftKeysLeft();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    49
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    50
   /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    51
    * This method checks if statuspane layout is currently a stacon layout 
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    52
    * which has softkeylabels at the right side of the screen.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    53
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    54
    * @return ETrue if one of stacon layout with right softkeys is active, 
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    55
    *         otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    56
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    57
    */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    58
    IMPORT_C static TBool StaconSoftKeysRight();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    59
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    60
   /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    61
    * This method checks if any of "idle" statuspane layouts is
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    62
    * active. Also video telephony statuspane is considered as
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    63
    * idle layout.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    64
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    65
    * @return ETrue if one of "idle" layouts is active, otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    66
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    67
    */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    68
    IMPORT_C static TBool IdleLayoutActive();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    69
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    70
   /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    71
    * This method checks if any of flat statuspane layouts is
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    72
    * active. 
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    73
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    74
    * @return ETrue if one of flat layouts is active, otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    75
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    76
    */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    77
    IMPORT_C static TBool FlatLayoutActive();    
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    78
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    79
   /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    80
    * This method checks if any of "usual" statuspane layouts is
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    81
    * active. 
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    82
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    83
    * @return ETrue if one of "usual" layouts is active, otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    84
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    85
    */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    86
    IMPORT_C static TBool UsualLayoutActive();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    87
    
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    88
   /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    89
    * This method checks if any of small statuspane layouts is
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    90
    * active. 
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    91
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    92
    * @return ETrue if one of small layouts is active, otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    93
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    94
    */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    95
    IMPORT_C static TBool SmallLayoutActive();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    96
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    97
    /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    98
     * This method checks if the active statuspane layout is compatible with
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
    99
     * the touch pane.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   100
     *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   101
     * @return ETrue if the active layout is compatible with touch pane,
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   102
     *      otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   103
     */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   104
     IMPORT_C static TBool TouchPaneCompatibleLayoutActive();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   105
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   106
   /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   107
    * This method checks if any of extended status pane portrait mode layouts is
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   108
    * active. 
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   109
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   110
    * @return ETrue if any extended portrait layout is active, otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   111
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   112
    */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   113
    IMPORT_C static TBool ExtendedLayoutActive();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   114
    
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   115
    /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   116
     * This method checks if an nHD status pane layout is active.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   117
     *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   118
     * @return  @c ETrue if an nHD status pane layout is active,
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   119
     *          otherwise @c EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   120
     */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   121
    static TBool HDLayoutActive();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   122
    
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   123
   /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   124
    * This method checks if statuspane layout is currently any of extended stacon layouts.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   125
    * (stacon = combined status & control pane, side softkeys).
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   126
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   127
    * @return ETrue if one of extended stacon layouts is active, otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   128
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   129
    */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   130
    IMPORT_C static TBool ExtendedStaconPaneActive();    
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   131
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   132
   /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   133
    * This method checks if statuspane layout is currently any of extended flat layouts.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   134
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   135
    * @return ETrue if one of extended flat layouts is active, otherwise EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   136
    *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   137
    */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   138
    IMPORT_C static TBool ExtendedFlatLayoutActive();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   139
    
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   140
    /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   141
     * This method can be used the check the status pane layout resource ID
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   142
     * of the current application. If the application has no status pane the
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   143
     * resource ID is checked from AknCapServer.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   144
     *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   145
     * @return The layout resource ID of the status pane.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   146
     * @see @c R_AVKON_STATUS_PANE in avkon.rss
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   147
     *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   148
     */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   149
    IMPORT_C static TInt CurrentStatusPaneLayoutResId();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   150
    
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   151
     /**
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   152
     * This method checks if the status pane belongs to active idle.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   153
     *
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   154
     * @return  @c ETrue if the status pane belongs to active idle,
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   155
     *          otherwise @c EFalse.
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   156
     */
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   157
    static TBool IsActiveIdle();
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   158
    };
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   159
1494d39c2fee added few more dependencies
kashif.sayed
parents:
diff changeset
   160
#endif //  __AKNSTATUSPANEUTILS_H__