diff -r 5b6f26637ad3 -r f4a778e096c2 phonebookui/Phonebook2/remotecontactlookup/contactactionservice/inc/TFscAddressSelectParams.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/phonebookui/Phonebook2/remotecontactlookup/contactactionservice/inc/TFscAddressSelectParams.h Wed Sep 01 12:29:52 2010 +0100 @@ -0,0 +1,133 @@ +/* +* Copyright (c) 2008 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: Address selection parameters. + * +*/ + + +#ifndef TFSCADDRESSSELECTPARAMS_H +#define TFSCADDRESSSELECTPARAMS_H + +// INCLUDES +#include +#include +#include +#include + +// FORWARD DECLARATIONS +class MVPbkStoreContact; +class MVPbkStoreContactField; +class MPbk2ContactNameFormatter; +class CVPbkContactManager; +class CFscFieldPropertyArray; + +// CLASS DECLARATION + +/** + * Address selection parameters. + * Responsible for carrying the parameters to the address select class. + */ +class TFscAddressSelectParams + { +public: + // Construction + + /** + * Constructor. + * + * @param aContact Contact from where to select + * an address. + * @param aContactManager Virtual Phonebook contact manager. + * @param aNameFormatter Name formatter. + * @param aFieldPropertyArray Phonebook 2 field property array. + * @param aReader Resource reader pointed to + * FSC_ADDRESS_SELECT structure. + * @param aTitleResId Resource id for title text. + * Default = 0. If default, the memory + * entry name is used as a title. + */ + TFscAddressSelectParams(MVPbkStoreContact& aContact, + const CVPbkContactManager& aContactManager, + MPbk2ContactNameFormatter& aNameFormatter, + const CFscFieldPropertyArray& aFieldPropertyArray, + TResourceReader& aReader, TInt aTitleResId = 0); + +public: + // Interface + + /** + * Sets the focused field of the contact. If focused field + * is a non-empty address field it is returned directly by + * ExecuteLD. Defaults to NULL. + * + * @param aFocusedField The focused field to set. + */ + void SetFocusedField(const MVPbkStoreContactField* aFocusedField); + + /** + * Sets the default to be used in address select. The + * defaults in the array should be in priority order. + * If the priorities array is not set, no defaults are used. + * Focused field overrides default address if both are + * available. + * + * @param aDefaultPriorities An array of default properties in + * priority order. + */ + void SetDefaultPriorities( + const RVPbkContactFieldDefaultPriorities& aDefaultPriorities); + + /** + * Set to ETrue to use default address of the contact directly. + * Focused field overrides default address if both are + * available. Default value for this parameter is EFalse. + * + * @param aUseDefaultDirectly Defines should the default address + * be used directly. + */ + void SetUseDefaultDirectly( TBool aUseDefaultDirectly ); + +public: + // Data + /// Ref: Contact where to select an address from + MVPbkStoreContact& iContact; + /// Ref: Virtual Phonebook contact manager + const CVPbkContactManager& iContactManager; + /// Ref: Contact name formatter. + MPbk2ContactNameFormatter& iNameFormatter; + /// Ref: Phonebook 2 field property array. + const CFscFieldPropertyArray& iFieldPropertyArray; + /// Ref: Resource reader. + TResourceReader& iResReader; + /// Own: Title resource id + TInt iTitleResId; + /// Ref: Focused field of the contact. + const MVPbkStoreContactField* iFocusedField; + /// Ref: Prioritized array of defaults to use. + const RVPbkContactFieldDefaultPriorities* iDefaultPriorities; + /// Own: Indicates should the default address be used directly + TBool iUseDefaultDirectly; + /// Own: Indicates whether to include contact name in custom prompt. + /// Custom prompt refers to iTitleResId. + TBool iIncludeContactNameInPrompt; + /// Own: Indicates are the warnings suppressed + TBool iSuppressWarnings; + +private: + // Friends + friend class CFscAddressSelect; + }; + +#endif // TFSCADDRESSSELECTPARAMS_H +// End of File