diff -r aa99f2208aad -r b8d18c84f71c localisation/apparchitecture/inc/APGICNFL.H --- a/localisation/apparchitecture/inc/APGICNFL.H Wed Jul 28 16:03:37 2010 +0100 +++ b/localisation/apparchitecture/inc/APGICNFL.H Tue Aug 03 10:20:34 2010 +0100 @@ -1,7 +1,7 @@ // Copyright (c) 1997-2009 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" +// under the terms of "Eclipse Public License v1.0" // which accompanies this distribution, and is available // at the URL "http://www.eclipse.org/legal/epl-v10.html". // @@ -11,6 +11,7 @@ // Contributors: // // Description: +// apgicnfl.h // #ifndef __APGICNFL_H__ @@ -27,7 +28,6 @@ class RReadStream; class RWriteStream; -class CApaMaskedBitmap : public CFbsBitmap /** An application icon. This is a bitmap and a mask, managed by the Font and Bitmap server. @@ -38,6 +38,7 @@ @publishedAll @released @see RApaLsSession::GetAppIcon() */ +class CApaMaskedBitmap : public CFbsBitmap { public: IMPORT_C static CApaMaskedBitmap* NewLC(); @@ -57,6 +58,7 @@ CFbsBitmap* iMask; }; +#ifndef SYMBIAN_ENABLE_SPLIT_HEADERS /** @internalComponent */ @@ -218,344 +220,7 @@ HBufC* iGroupName; }; -#if defined(UI_FRAMEWORKS_V1_REMNANT_FOR_JAVA_MIDLET_INSTALLER) - -class CApaAppInfoFileWriter; - -/** -@internalAll -*/ -const TUid KUidInterimFormatFileForJavaMIDletInstaller={0x10208182}; +#endif //SYMBIAN_ENABLE_SPLIT_HEADERS -/** -@internalAll -*/ -class ForJavaMIDletInstaller - { -public: - IMPORT_C static void CheckInterimFormatFileNotCorruptL(RFile& aInterimFormatFile); - IMPORT_C static void GetJavaMIDletInfoL(RFs& aFs, const TDesC& aFileName,TUint32& aJavaMIDletInfo_AmsAuthId,TUint32& aJavaMIDletInfo_MIDlet); - IMPORT_C static CApaAppInfoFileWriter* NewInterimFormatFileWriterLC(RFs& aFs,const TDesC& aFileName,TUid aApplicationUid,TUint32 aJavaMIDletInfo_AmsAuthId,TInt aJavaMIDletInfo_MIDlet); - }; - -#endif // UI_FRAMEWORKS_V1_REMNANT_FOR_JAVA_MIDLET_INSTALLER - -#if (((defined(SYMBIAN_SUPPORT_UI_FRAMEWORKS_V1) || !defined(SYMBIAN_HIDE_UI_FRAMEWORKS_V1)) && !defined(SYMBIAN_REMOVE_UI_FRAMEWORKS_V1)) || defined(UI_FRAMEWORKS_V1_REMNANT_FOR_JAVA_MIDLET_INSTALLER)) - -#if !defined(IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER) -// we're compiling a source file that doesn't define IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER, so give it it's default "value" of "IMPORT_C" -#define IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER IMPORT_C -#endif - -/** -@publishedAll -@deprecated -*/ -#ifdef _UNICODE -#define KUidAppInfoFile KUidAppInfoFile16 -#else -#define KUidAppInfoFile KUidAppInfoFile8 #endif -/** -@publishedAll -@deprecated -*/ -const TUid KUidAppInfoFile8={268435562}; - -/** -@publishedAll -@deprecated -*/ -const TUid KUidAppInfoFile16={0x10003A38}; - -/** -@internalComponent -*/ -const TUid KUidAppInfoFileVersion2={0x101fb032}; - -/** -@internalComponent -*/ -enum TAifVersion -// The order here is important, only ever APPEND to the list - { - EAifVersionOriginal, - EAifVersionAddsDataType, - EAifVersionAddsViewData, - EAifVersionAddsFileOwnershipInfo -#if defined(UI_FRAMEWORKS_V1_REMNANT_FOR_JAVA_MIDLET_INSTALLER) - ,EAifVersionAddsJavaMIDletInfo -#endif - }; - -class CApaAIFCaption : public CBase -// -// Represents a caption in an AIF during reading and writing of the file. -/** -@internalComponent -*/ - { -public: - ~CApaAIFCaption(); - CApaAIFCaption(); - void ConstructL(TLanguage aLanguage,const TDesC& aCaption); - static CApaAIFCaption* NewLC(TLanguage aLanguage,const TDesC& aCaption); - void InternalizeL(RReadStream& aStream); - void ExternalizeL(RWriteStream& aStream) const; - TLanguage Language() const; - TApaAppCaption Caption() const; -public: - HBufC* iCaption; - TLanguage iLanguage; - }; - -class CApaAIFViewData : public CBase -// -// Represents the data associated with an application view described in an AIF -// during reading and writing of the file. -// implementation class -/** -@internalComponent -*/ - { -public: - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER TApaAppCaption CaptionL(TLanguage aLanguage) const; - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER CApaMaskedBitmap* IconByIndexL(TInt aIndex) const; - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER TInt NumberOfIcons() const; - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER TUid ViewUid() const; - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER TInt ScreenMode() const; -public: - ~CApaAIFViewData(); - static CApaAIFViewData* NewLC(); - static CApaAIFViewData* NewLC(const CApaAIFViewData& aSourceData); - void InternalizeL(RReadStream& aStream); - void ExternalizeL(RWriteStream& aStream) const; - void SetScreenMode(TInt aScreenMode); - void AddCaptionL(TLanguage aLanguage,const TDesC& aCaption); - void AddIconL(CApaMaskedBitmap& aIcon); - void AddIconIndexL(TInt aIndex); - void SetViewUid(TUid aUid); - void LoadIconsL(const TDesC& aFileName, TUint aMbmOffset); -private: - CApaAIFViewData(); - void ConstructL(); - void ConstructL(const CApaAIFViewData& aSourceData); -private: - TInt iScreenMode; - CArrayPtr* iIconArray; - CArrayPtr* iCaptionArray; - TUid iViewUid; - CArrayFixFlat* iIconIndexArray; // used for AIF version 2 format - }; - -class CApaAppInfoFile : public CBase -/** -@internalComponent -*/ - { -#if defined(UI_FRAMEWORKS_V1_REMNANT_FOR_JAVA_MIDLET_INSTALLER) - friend class ForJavaMIDletInstaller; -#endif -public: - ~CApaAppInfoFile(); - // -protected: - CApaAppInfoFile(RFs& aFs); - void ConstructL(); -protected: - - class TCaptionHeader - { - public: - void InternalizeL(RReadStream& aStream); // internalizes the header info only - void ExternalizeL(RWriteStream& aStream) const; // externalizes the header info only - public: - TSwizzle iCaption; - TLanguage iLanguage; - }; - class TIconHeader - { - public: - void InternalizeL(RReadStream& aStream); // internalizes the header info only - void ExternalizeL(RWriteStream& aStream) const; // externalizes the header info only - public: - TSwizzle iIcon; // Used for old AIF format Internalize - TInt iIconSideInPixels; - TSwizzle iIconMain; // Used for new AIF format - TSwizzle iIconMask; // Used for new AIF format - }; - class TDataTypeHeader - { - public: - // header info only - void InternalizeL(RReadStream& aStream); // internalizes the header info only - void ExternalizeL(RWriteStream& aStream) const; // externalizes the header info only - public: - TSwizzle iDataType; - TDataTypePriority iPriority; - }; - class TViewDataHeader - { - public: - void InternalizeL(RReadStream& aStream); // internalizes the header info only - void ExternalizeL(RWriteStream& aStream) const; // externalizes the header info only - public: - TSwizzle iViewData; - }; - class TFileOwnershipInfoHeader - { - public: - void InternalizeL(RReadStream& aStream); // internalizes the header info only - void ExternalizeL(RWriteStream& aStream) const; // externalizes the header info only - public: - TSwizzle iOwnedFileName; - }; -protected: - RFs& iFs; - CPersistentStore* iStore; - CArrayFix* iCaptionHeaderArray; - CArrayFix* iIconHeaderArray; - CArrayFix* iDataTypeHeaderArray; - CArrayFix* iViewDataHeaderArray; - CArrayFix* iFileOwnershipInfoHeaderArray; - TApaAppCapability iCapability; - }; - -class CApaAppInfoFileReader : public CApaAppInfoFile -/** Aif file reader. - -Aif files contain information about an application, including its icons and -captions. - -An application can get a reader for its own aif file by calling CEikApplication::OpenAppInfoFileLC(). - -@publishedAll -@deprecated */ - { -#if defined(UI_FRAMEWORKS_V1_REMNANT_FOR_JAVA_MIDLET_INSTALLER) - friend class ForJavaMIDletInstaller; -#endif -public: - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER static CApaAppInfoFileReader* NewLC(RFs& aFs, const TDesC& aFileName,TUid aApplicationUid=KNullUid); - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER static CApaAppInfoFileReader* NewL(RFs& aFs, const TDesC& aFileName,TUid aApplicationUid=KNullUid); - // - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void Capability(TDes8& aInfo) const; - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER TApaAppCaption CaptionL(TLanguage aLanguage); - - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER CApaMaskedBitmap* CreateMaskedBitmapL(TInt aIconSideInPixels); // If there are no bitmaps in the file this method leaves with KErrNotFound - // Not available until ER6 - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER CApaMaskedBitmap* CreateMaskedBitmapByIndexLC(TInt aIndex); // If there are no bitmaps in the file this method leaves with KErrNotFound - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER TInt NumberOfBitmaps() const; - - // Not available till ER5 - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void DataTypesSupportedL(CArrayFix& aTypeList) const; - // - - // Not available till ER6.1 - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void GetViewsL(CArrayPtr& aViewList) const; - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void GetOwnedFilesL(CDesCArray& aOwnedFilesList) const; - // - - // utility function - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER static void StretchDrawL(CFbsBitmap* aSource,CFbsBitmap* aTarget,TSize aSizeInPixels); - // - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER ~CApaAppInfoFileReader(); -public: - static void GetAifFileNameL(const TDesC& aFullName,TDes& aAifName); -private: - CApaAppInfoFileReader(RFs& aFs); - void InternalizeL(RReadStream& aStream); - void ConstructL(const TDesC& aFileName,TUid aUid); - void LoadAifFileVersionTwoL(const TDesC& aFileName, TUid aMostDerivedUid); - void AddIconHeadersL(const TDesC& aFileName, TInt32 aFileOffset, TInt aNumIcons); -private: - HBufC* iDefaultCaption; - TUint8* iRomPointer; - TInt iMbmOffset; - HBufC* iAifFileName; -#if defined(UI_FRAMEWORKS_V1_REMNANT_FOR_JAVA_MIDLET_INSTALLER) - TUint32 iJavaMIDletInfo_AmsAuthId; - TInt iJavaMIDletInfo_MIDlet; -#endif - }; - -class CApaAppInfoFileWriter : public CApaAppInfoFile -/** -Aif file writer. - -This class writes application information, including icons and captions into the aif file. - -@publishedAll -@deprecated */ - { -#if defined(UI_FRAMEWORKS_V1_REMNANT_FOR_JAVA_MIDLET_INSTALLER) - friend class ForJavaMIDletInstaller; -#endif -public: - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER static CApaAppInfoFileWriter* NewLC(RFs& aFs, const TDesC& aFileName,TUid aApplicationUid); - // - IMPORT_C TInt SetCapability(const TDesC8& aInfo); - IMPORT_C void AddCaptionL(TLanguage aLanguage,const TDesC& aCaption); - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void AddIconL(const TDesC& aIconFileName); - IMPORT_C void AddIconL(CApaMaskedBitmap& aIcon); - - // Not available till ER5 - IMPORT_C void AddDataTypeL(const TDataTypeWithPriority& aTypePriority); - // - - // Not available till ER6.1 - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void AddViewL(TUid aViewUid); - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void AddViewL(TUid aViewUid,TInt aScreenMode); - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void AddViewCaptionL(TLanguage aLanguage,const TDesC& aCaption,TUid aViewUid); - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void AddViewIconL(CApaMaskedBitmap& aIcon,TUid aViewUid); - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void StoreViewL(TUid aViewId); - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER void AddOwnedFileL(const TDesC& aOwnedFileName); - // - - IMPORT_C void StoreL(); - // - IMPORT_C ~CApaAppInfoFileWriter(); -private: - CApaAppInfoFileWriter(RFs& aFs); - void ExternalizeL(RWriteStream& aStream) const; - void ConstructL(const TDesC& aFileName,TUid aUid -#if defined(UI_FRAMEWORKS_V1_REMNANT_FOR_JAVA_MIDLET_INSTALLER) - ,TUid aMiddleUid=KUidAppInfoFile,TUint32 aJavaMIDletInfo_AmsAuthId=0,TInt aJavaMIDletInfo_MIDlet=0 -#endif - ); -private: - CStoreMap* iMap; -#if defined(UI_FRAMEWORKS_V1_REMNANT_FOR_JAVA_MIDLET_INSTALLER) - TUint32 iJavaMIDletInfo_AmsAuthId; - TInt iJavaMIDletInfo_MIDlet; -#endif - }; - -class CApaAppCaptionFileReader : public CBase -/** -@internalComponent -*/ - { -public: - CApaAppCaptionFileReader(RFs& aFs,const TDesC& iAppFileName); - void GetCaptionsL(TApaAppCaption& aCaption,TApaAppCaption& aShortCaption); -private: - RFs& iFs; - TFileName iCaptionFileName; - }; - -class AppInfoFileUtils -// Internal utilities providing helper functions for non-ROM localisation -/** -@internalComponent -*/ - { -public: // For internal use only - IMPORT_C_NOT_NEEDED_FOR_JAVA_MIDLET_INSTALLER static void GetAifFileName(const RFs& aFs,TDes& aAifName); -public: - static void GetAifFileNameL(const RFs& aFs,const TDesC& aFullName,TDes& aAifName); - }; -#endif // #if (defined(SYMBIAN_SUPPORT_UI_FRAMEWORKS_V1) || !defined(SYMBIAN_HIDE_UI_FRAMEWORKS_V1)) && !defined(SYMBIAN_REMOVE_UI_FRAMEWORKS_V1) - -#endif