apengine/apsettingshandlerui/inc/AccessPointTextSettingPage.h
changeset 0 5a93021fdf25
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/apengine/apsettingshandlerui/inc/AccessPointTextSettingPage.h	Thu Dec 17 08:55:21 2009 +0200
@@ -0,0 +1,124 @@
+/*
+* Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies). 
+* All rights reserved.
+* This component and the accompanying materials are made available
+* 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".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:  Declaration of class CAccessPointTextSettingPage.
+*
+*/
+
+
+#ifndef ACCESSPOINT_TEXT_SETTING_PAGE_H
+#define ACCESSPOINT_TEXT_SETTING_PAGE_H
+
+// INCLUDE FILES
+#include <akntextsettingpage.h>
+
+
+// FORWARD DECLARATION
+class CApSelectorListboxModel;
+
+
+// CLASS DECLARATION
+
+/**
+* Model for the access point listbox. It is an array of CApSelectorItem
+* pointers; items are owned.
+*/
+NONSHARABLE_CLASS( CAccessPointTextSettingPage ) : public CAknTextSettingPage
+    {
+public:
+    /**
+    * Simple constructor depending only on a single resource Id. 
+    * Editor resource is given via the link in the setting page resource.
+    *
+    * @param aResourceID Setting Page to use (if present)
+    * @param aText Reference to text for editing
+    * @param aTextSettingPageFlags option flags for miscellaneous things
+    * @param aIsLatin Giving whether the editor should be Latin only
+    */
+    CAccessPointTextSettingPage( TInt aResourceID, TDes& aText,
+                                 TInt aTextSettingPageFlags = 0,
+                                 TBool aIsLatin = EFalse );
+    /**
+    * Constructor that allows separate setting page and editor resources
+    *
+    * This constructor allows the use of setting page using only the editor 
+    * resource. Other combinations are also possible
+    *
+    * In all cases the number (if supplied i.e. <> 0 ) is used.
+    *
+    *   Editor    Setting Page 
+    *  Resource    Resource
+    *   present     present     Both are used (but text & number overridden)
+    *    = 0        present     Editor resource is used via SP resource 
+    *                           (Effectively like the other constructor)
+    *   present      = 0        Default Avkon SP resource if used 
+    *                           + this editor resource
+    *    = 0         = 0        uses default resource for both SP and editor.
+    *                           This is OK if:
+    *   i) control type is present,
+    *   ii) a default resource exists 
+    *       ( OK for text, integer, date, time, duration )
+    *
+    * Note: THe first argument is a TDesC* (rather than TDesC&) because 
+    * the other constructor cannot initialize such a member without allocation
+    * or having an internal dummy buffer.
+    * Note that this buffer must be owned by the client until 
+    * ExecuteLD has been called.
+    *
+    * Rules for text and numbers: The rules are the same for both:  (non-zero
+    * length) text or number other than EAknSettingPageNoOrdinalDisplayed if 
+    * given in this constructor will not override resource (unless that is 
+    * zero length or EAknSettingPageNoOrdinalDisplayed). Note, however, 
+    * that text or number given via the specific API for setting them, 
+    * WILL override resource.
+    * It is assumed that number from resource is very rare. Special text 
+    * is somewhat more likely.
+    *
+    * @param aSettingTitleText      Text at top of setting pane; 
+    *                               OWNED EXTERNALLY
+    * @param aSettingNumber         Number at top left (if present)
+    * @param aControlType           Determines the type constructed 
+    *                               and how its resource is read
+    * @param aEditorResourceId      Editor resource to use in the setting page
+    *                               (if present)
+    * @param aSettingPageResourceId Setting Page to use (if present)
+    * @param aText                  Reference to text for editing
+    * @param aTextSettingPageFlags  option flags for miscellaneous things
+    * @param aIsLatin               Gives whether the editor should accept 
+    *                               only Latin input 
+    */
+    CAccessPointTextSettingPage( const TDesC* aSettingTitleText,
+                                 TInt aSettingNumber,
+                                 TInt aControlType,
+                                 TInt aEditorResourceId,
+                                 TInt aSettingPageResourceId,
+                                 TDes& aText,
+                                 TInt aTextSettingPageFlags = 0,
+                                 TBool aIsLatin = EFalse );
+
+
+
+    /**
+    * 2nd stage construction for this specific type.  Call BaseConstructL in
+    * CAknSettingPage, where the object is constructed from resource.
+    *
+    */
+    virtual void ConstructL();
+
+    TBool iIsLatin;
+    };
+
+
+#endif
+
+// End of file