1.1 --- a/epoc32/include/mw/apaid.h Wed Mar 31 12:27:01 2010 +0100
1.2 +++ b/epoc32/include/mw/apaid.h Wed Mar 31 12:33:34 2010 +0100
1.3 @@ -1,9 +1,9 @@
1.4 // Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
1.5 // All rights reserved.
1.6 // This component and the accompanying materials are made available
1.7 -// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
1.8 +// under the terms of "Eclipse Public License v1.0"
1.9 // which accompanies this distribution, and is available
1.10 -// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
1.11 +// at the URL "http://www.eclipse.org/legal/epl-v10.html".
1.12 //
1.13 // Initial Contributors:
1.14 // Nokia Corporation - initial contribution.
1.15 @@ -11,34 +11,21 @@
1.16 // Contributors:
1.17 //
1.18 // Description:
1.19 +// apaid.h
1.20 //
1.21
1.22 #ifndef __APAID_H__
1.23 #define __APAID_H__
1.24
1.25 -#if !defined(__E32BASE_H__)
1.26 #include <e32base.h>
1.27 -#endif
1.28 -#if !defined(__APADEF_H__)
1.29 #include <apadef.h>
1.30 -#endif
1.31 +#include <apmstd.h> // class TDataTypeWithPriority
1.32
1.33 -#include "apmstd.h"
1.34 -
1.35 -
1.36 -// classes defined:
1.37 -class TApaAppIdentifier;
1.38 -class TApaAppEntry;
1.39 -class CApaAppFinder;
1.40 -//
1.41 -// classes referenced:
1.42 +// classes referenced
1.43 class RReadStream;
1.44 class RWriteStream;
1.45 class RFs;
1.46 -//
1.47
1.48 -
1.49 -class TApaAppIdentifier
1.50 /** The identity of an application.
1.51
1.52 An object of this type contains two pieces of information:
1.53 @@ -56,52 +43,23 @@
1.54 @see CApaProcess::WriteRootStreamL()
1.55 @see CApaProcess::ReadAppIdentifierL()
1.56 @see CApaProcess::WriteAppIdentifierL() */
1.57 +class TApaAppIdentifier
1.58 {
1.59 public:
1.60 IMPORT_C TApaAppIdentifier();
1.61 IMPORT_C TApaAppIdentifier(TUid aAppUidType,const TFileName& aDllName);
1.62 IMPORT_C void ExternalizeL(RWriteStream& aStream)const;
1.63 IMPORT_C void InternalizeL(RReadStream& aStream);
1.64 -
1.65 public:
1.66 /** The application-specific UID. */
1.67 TUid iAppUid;
1.68 /** The full path name of the application DLL. */
1.69 TFileName iFullName;
1.70 -
1.71 private:
1.72 TInt iTApaAppIdentifier_Reserved1;
1.73 };
1.74
1.75
1.76 -class TApaAppEntry
1.77 -/** An application entry.
1.78 -
1.79 -An object of this type contains two pieces of information:
1.80 -
1.81 -the full path name of the application DLL
1.82 -
1.83 -the UID type (or compound identifier) of the application DLL.
1.84 -
1.85 -@publishedAll
1.86 -@released */
1.87 - {
1.88 -public:
1.89 - IMPORT_C TApaAppEntry();
1.90 - IMPORT_C TApaAppEntry(const TUidType& aAppUidType,const TFileName& aDllName);
1.91 - IMPORT_C void ExternalizeL(RWriteStream& aStream)const;
1.92 - IMPORT_C void InternalizeL(RReadStream& aStream);
1.93 -public:
1.94 - /** The UID type (or compound identifier) of the application DLL. */
1.95 - TUidType iUidType;
1.96 - /** The full path name of the application DLL. */
1.97 - TFileName iFullName;
1.98 -private:
1.99 - TInt iTApaAppEntry_Reserved1;
1.100 - };
1.101 -
1.102 -
1.103 -class TApaAppInfo
1.104 /** Application information.
1.105
1.106 An object of this type contains four pieces of information:
1.107 @@ -116,6 +74,7 @@
1.108
1.109 @publishedAll
1.110 @released */
1.111 +class TApaAppInfo
1.112 {
1.113 public:
1.114 IMPORT_C TApaAppInfo();
1.115 @@ -132,13 +91,11 @@
1.116 TApaAppCaption iCaption;
1.117 /** The short caption for the application. */
1.118 TApaAppCaption iShortCaption;
1.119 -
1.120 private:
1.121 TInt iTApaAppInfo_Reserved1;
1.122 };
1.123
1.124
1.125 -class TApaAppViewInfo
1.126 /** Contains the basic information about an application view.
1.127
1.128 An object of this type contains two pieces of information:
1.129 @@ -153,6 +110,7 @@
1.130 @released
1.131 @see CApaAppViewArray
1.132 @see TUid */
1.133 +class TApaAppViewInfo
1.134 {
1.135 public:
1.136 IMPORT_C TApaAppViewInfo();
1.137 @@ -181,21 +139,17 @@
1.138 typedef CArrayFixFlat<TApaAppViewInfo> CApaAppViewArray;
1.139
1.140
1.141 -class TApaAppCapability
1.142 -// expandable class - add new members to the end, add them to the end of int/ext also, and increment the version no.
1.143 -// default value for all data members must be 0
1.144 /** Application capabilities.
1.145
1.146 @publishedAll
1.147 @released */
1.148 +class TApaAppCapability
1.149 {
1.150 public:
1.151 IMPORT_C static void CopyCapability(TDes8& aDest,const TDesC8& aSource);
1.152 IMPORT_C void InternalizeL(RReadStream& aStream);
1.153 - IMPORT_C void Internalize7_0L(RReadStream& aStream); // deprecated
1.154 IMPORT_C void ExternalizeL(RWriteStream& aStream) const;
1.155 private:
1.156 - IMPORT_C void Externalize7_0L(RWriteStream& aStream) const; // deprecated
1.157 void DoInternalizeL(RReadStream& aStream, TBool& aLaunchInBackground, TApaAppGroupName& aGroupName);
1.158 public:
1.159 //
1.160 @@ -214,7 +168,9 @@
1.161 /** Defines an application's attributes as a set of bit flags. */
1.162 enum TCapabilityAttribute
1.163 {
1.164 - /** If set, the application was built as a DLL, otherwise it was built as an EXE. */
1.165 + /** This functionality is deprecated from v9.5 onwards.
1.166 + @deprecated
1.167 + */
1.168 EBuiltAsDll = 0x00000001,
1.169 /** If set, the application provides control panel functionality. */
1.170 EControlPanelItem = 0x00000002,
1.171 @@ -239,6 +195,8 @@
1.172 /** Indicates the application attributes. One or more values from TCapabilityAttribute may be specified. */
1.173 TUint iAttributes;
1.174 private:
1.175 + // expandable class - add new members to the end, add them to the end of int/ext also, and increment the version no.
1.176 + // default value for all data members must be 0
1.177 enum { EVersion=4 };
1.178 private:
1.179 TInt iTApaAppCapability_Reserved1;
1.180 @@ -268,27 +226,7 @@
1.181 TInt iTApaEmbeddabilityFilter_Reserved1;
1.182 };
1.183
1.184 -
1.185 -class CApaAppFinder : public CBase
1.186 -/**
1.187 -@publishedPartner
1.188 -@deprecated
1.189 -*/
1.190 - {
1.191 -public:
1.192 - virtual void FindAllAppsL()=0; // sets up a scan for all apps
1.193 - virtual TBool NextL(TApaAppEntry& aEntry)=0; // increments a scan for all apps
1.194 - virtual TFileName FindAppL(const TDesC& aFileName,TUid aFileUid)=0; // searches for a particular app - should support wildcards in aFileName
1.195 - //
1.196 - virtual TFileName DefaultAppInfoFileName()const=0; // should return the full name, path and drive of the default icon file
1.197 -protected:
1.198 - IMPORT_C CApaAppFinder();
1.199 -
1.200 -private:
1.201 - IMPORT_C virtual void CApaAppFinder_Reserved1();
1.202 - IMPORT_C virtual void CApaAppFinder_Reserved2();
1.203 - };
1.204 -
1.205 +#ifndef SYMBIAN_ENABLE_SPLIT_HEADERS
1.206 /**
1.207 The uid for the Open service.
1.208
1.209 @@ -311,13 +249,12 @@
1.210 class TApaAppServiceInfo
1.211 {
1.212 public:
1.213 - TApaAppServiceInfo();
1.214 - TApaAppServiceInfo(TUid aUid, CArrayFixFlat<TDataTypeWithPriority>* aDataTypes,
1.215 - HBufC8* aOpaqueData);
1.216 - void ExternalizeL(RWriteStream& aStream) const;
1.217 - void InternalizeL(RReadStream& aStream);
1.218 - void Release();
1.219 - CArrayFixFlat<TDataTypeWithPriority>& DataTypes();
1.220 + IMPORT_C TApaAppServiceInfo();
1.221 + IMPORT_C TApaAppServiceInfo(TUid aUid, CArrayFixFlat<TDataTypeWithPriority>* aDataTypes, HBufC8* aOpaqueData);
1.222 + IMPORT_C void ExternalizeL(RWriteStream& aStream) const;
1.223 + IMPORT_C void InternalizeL(RReadStream& aStream);
1.224 + IMPORT_C void Release();
1.225 + IMPORT_C CArrayFixFlat<TDataTypeWithPriority>& DataTypes();
1.226 IMPORT_C TUid Uid() const;
1.227 IMPORT_C const CArrayFixFlat<TDataTypeWithPriority>& DataTypes() const;
1.228 IMPORT_C const TDesC8& OpaqueData() const;
1.229 @@ -339,20 +276,20 @@
1.230 class CApaAppServiceInfoArray : public CBase
1.231 {
1.232 protected:
1.233 - CApaAppServiceInfoArray();
1.234 + IMPORT_C CApaAppServiceInfoArray();
1.235 public:
1.236 /** Provides access to the encapsulated array of
1.237 TApaAppServiceInfo objects.
1.238
1.239 @return A generic array of TApaAppServiceInfo objects. */
1.240 virtual TArray<TApaAppServiceInfo> Array()=0;
1.241 -
1.242 private:
1.243 IMPORT_C virtual void CApaAppServiceInfoArray_Reserved1();
1.244 IMPORT_C virtual void CApaAppServiceInfoArray_Reserved2();
1.245 -
1.246 private:
1.247 TInt iCApaAppServiceInfoArray_Reserved1;
1.248 };
1.249
1.250 +#endif //SYMBIAN_ENABLE_SPLIT_HEADERS
1.251 +
1.252 #endif