AknCheckBoxSettingPage.h

00001 /*
00002 * ============================================================================
00003 *  Name     : AknCheckBoxSettingPage.h
00004 *  Part of  : Avkon
00005 *
00006 *  Description:
00007 *  Check box list support for setting page in editable state
00008 *
00009 *  Version:
00010 *
00011 *  Copyright © 2002 Nokia Corporation.
00012 *  This material, including documentation and any related 
00013 *  computer programs, is protected by copyright controlled by 
00014 *  Nokia Corporation. All rights are reserved. Copying, 
00015 *  including reproducing, storing,  adapting or translating, any 
00016 *  or all of this material requires the prior written consent of 
00017 *  Nokia Corporation. This material also contains confidential 
00018 *  information which may not be disclosed to others without the 
00019 *  prior written consent of Nokia Corporation.
00020 */
00022 #ifndef __AKNCHECKBOXSETTINGPAGE_H__
00023 #define __AKNCHECKBOXSETTINGPAGE_H__ 
00024 
00026 #include <aknlistboxsettingpage.h>
00028 // forward declare
00029 class CAknCheckBoxSettingPageExtension;
00037 class CSelectableItem : public CBase
00038 {
00039 public :
00045         IMPORT_C CSelectableItem( TDesC& aItemText, TBool aSelected  );
00049         virtual ~CSelectableItem();
00055         IMPORT_C void ConstructL();
00062         IMPORT_C void SetSelectionStatus( TBool aSelected );
00068         IMPORT_C TBool SelectionStatus();
00074         IMPORT_C TPtrC ItemText();
00076 private:
00077         TDesC& iDesC;   // Holds the reference to the descriptor prior to construction
00078         HBufC* iItem;   // This is on the heap and is used post constuction
00079         TBool iSelected;
00080 };
00087 class CSelectionItemList : public CArrayPtrFlat<CSelectableItem>, public MDesCArray
00088         {
00089 public:
00093         IMPORT_C CSelectionItemList( TInt Granularity );
00094 // from MDesCArray
00101         IMPORT_C TInt MdcaCount() const;
00107         IMPORT_C TPtrC MdcaPoint(TInt aIndex) const;
00108         };
00118 class CAknCheckBoxSettingPage : public CAknListBoxSettingPage
00119 {
00120 public:
00121         IMPORT_C CAknCheckBoxSettingPage(TInt aResourceID, CSelectionItemList* aItemArray );
00149         IMPORT_C CAknCheckBoxSettingPage(       const TDesC* aSettingTitleText, 
00150                                                                 TInt aSettingNumber, 
00151                                                                 TInt aControlType,
00152                                                                 TInt aEditorResourceId, 
00153                                                                 TInt aSettingPageResourceId,
CSelectionItemList* aItemArray );
00161         IMPORT_C virtual void ConstructL();
00169         IMPORT_C CAknSetStyleListBox* ListBoxControl() const;
00176         IMPORT_C void SetSelectionItemArrayL( CSelectionItemList* aItemArray );
00178 // From MEikListBoxObserver
00185         IMPORT_C virtual void HandleListBoxEventL(CEikListBox* aListBox,
MEikListBoxObserver::TListBoxEvent aEventType);
00192     IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);
00194     IMPORT_C void HandleResourceChange(TInt aType);
00196 protected:
00200         IMPORT_C virtual ~CAknCheckBoxSettingPage();
00206         IMPORT_C virtual void UpdateSettingL();
00212         IMPORT_C void DynamicInitL();
00214         // From MEikCommandObserver
00215         IMPORT_C virtual void ProcessCommandL(TInt aCommandId);
00216         /*
00217         * This method is called upon Select command id.  It should change the setting but not exit in
00218         * this case.
00219         */
00220         IMPORT_C virtual void SelectCurrentItemL();
00222 //
00223 // CoeControl Framework and reserved methods
00224 //
00225 protected:
00234         IMPORT_C virtual void WriteInternalStateL(RWriteStream& aWriteStream) const;
00235 private:
00239     IMPORT_C void* ExtensionInterface( TUid aInterface );
00241 private:
00245         IMPORT_C virtual void Reserved_2();
00250 private: 
00251         IMPORT_C virtual void CAknSettingPage_Reserved_1();
00252         IMPORT_C virtual void CAknSettingPage_Reserved_2();
00254 private:
00259         IMPORT_C virtual void CAknListBoxSettingPage_Reserved_1();
00261 private:
00262         void UpdateAllSelections();
00263         void SetAllSelectionsL();
00264         void ToggleSelectionL();
00270         void GenerateInternalArrayAndGiveToListBoxL();
00272         void CreateCheckBoxBitmapsL();
00274         CDesCArrayFlat* iInternalItemArray;     
00276         // the following are not owned
CSelectionItemList* iItemArray; 
00279     CAknCheckBoxSettingPageExtension* iExtension; // owned
00280 };
00282 #endif