1 /*

     2 * Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Declaration of class CAccessPointTextSettingPage.

    15 *

    16 */

    17 

    18 

    19 #ifndef ACCESSPOINT_TEXT_SETTING_PAGE_H

    20 #define ACCESSPOINT_TEXT_SETTING_PAGE_H

    21 

    22 // INCLUDE FILES

    23 #include <akntextsettingpage.h>

    24 

    25 

    26 // FORWARD DECLARATION

    27 class CApSelectorListboxModel;

    28 

    29 

    30 // CLASS DECLARATION

    31 

    32 /**

    33 * Model for the access point listbox. It is an array of CApSelectorItem

    34 * pointers; items are owned.

    35 */

    36 NONSHARABLE_CLASS( CAccessPointTextSettingPage ) : public CAknTextSettingPage

    37     {

    38 public:

    39     /**

    40     * Simple constructor depending only on a single resource Id. 

    41     * Editor resource is given via the link in the setting page resource.

    42     *

    43     * @param aResourceID Setting Page to use (if present)

    44     * @param aText Reference to text for editing

    45     * @param aTextSettingPageFlags option flags for miscellaneous things

    46     * @param aIsLatin Giving whether the editor should be Latin only

    47     */

    48     CAccessPointTextSettingPage( TInt aResourceID, TDes& aText,

    49                                  TInt aTextSettingPageFlags = 0,

    50                                  TBool aIsLatin = EFalse );

    51     /**

    52     * Constructor that allows separate setting page and editor resources

    53     *

    54     * This constructor allows the use of setting page using only the editor 

    55     * resource. Other combinations are also possible

    56     *

    57     * In all cases the number (if supplied i.e. <> 0 ) is used.

    58     *

    59     *   Editor    Setting Page 

    60     *  Resource    Resource

    61     *   present     present     Both are used (but text & number overridden)

    62     *    = 0        present     Editor resource is used via SP resource 

    63     *                           (Effectively like the other constructor)

    64     *   present      = 0        Default Avkon SP resource if used 

    65     *                           + this editor resource

    66     *    = 0         = 0        uses default resource for both SP and editor.

    67     *                           This is OK if:

    68     *   i) control type is present,

    69     *   ii) a default resource exists 

    70     *       ( OK for text, integer, date, time, duration )

    71     *

    72     * Note: THe first argument is a TDesC* (rather than TDesC&) because 

    73     * the other constructor cannot initialize such a member without allocation

    74     * or having an internal dummy buffer.

    75     * Note that this buffer must be owned by the client until 

    76     * ExecuteLD has been called.

    77     *

    78     * Rules for text and numbers: The rules are the same for both:  (non-zero

    79     * length) text or number other than EAknSettingPageNoOrdinalDisplayed if 

    80     * given in this constructor will not override resource (unless that is 

    81     * zero length or EAknSettingPageNoOrdinalDisplayed). Note, however, 

    82     * that text or number given via the specific API for setting them, 

    83     * WILL override resource.

    84     * It is assumed that number from resource is very rare. Special text 

    85     * is somewhat more likely.

    86     *

    87     * @param aSettingTitleText      Text at top of setting pane; 

    88     *                               OWNED EXTERNALLY

    89     * @param aSettingNumber         Number at top left (if present)

    90     * @param aControlType           Determines the type constructed 

    91     *                               and how its resource is read

    92     * @param aEditorResourceId      Editor resource to use in the setting page

    93     *                               (if present)

    94     * @param aSettingPageResourceId Setting Page to use (if present)

    95     * @param aText                  Reference to text for editing

    96     * @param aTextSettingPageFlags  option flags for miscellaneous things

    97     * @param aIsLatin               Gives whether the editor should accept 

    98     *                               only Latin input 

    99     */

   100     CAccessPointTextSettingPage( const TDesC* aSettingTitleText,

   101                                  TInt aSettingNumber,

   102                                  TInt aControlType,

   103                                  TInt aEditorResourceId,

   104                                  TInt aSettingPageResourceId,

   105                                  TDes& aText,

   106                                  TInt aTextSettingPageFlags = 0,

   107                                  TBool aIsLatin = EFalse );

   108 

   109 

   110 

   111     /**

   112     * 2nd stage construction for this specific type.  Call BaseConstructL in

   113     * CAknSettingPage, where the object is constructed from resource.

   114     *

   115     */

   116     virtual void ConstructL();

   117 

   118     TBool iIsLatin;

   119     };

   120 

   121 

   122 #endif

   123 

   124 // End of file