epoc32/include/mw/aknqueryvaluephone.h
branchSymbian2
changeset 2 2fe1408b6811
parent 1 666f914201fb
child 4 837f303aceeb
--- a/epoc32/include/mw/aknqueryvaluephone.h	Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/mw/aknqueryvaluephone.h	Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,209 @@
-aknqueryvaluephone.h
+/*
+* 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 the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+* which accompanies this distribution, and is available
+* at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description: 
+*
+*/
+
+// AknQueryValuePhone.h
+//
+// Copyright (c) 2001 Symbian Ltd.  All rights reserved.
+//
+
+#if !defined(__AKNQUERYVALUEPHONE_H__)
+#define __AKNQUERYVALUEPHONE_H__
+
+#include <bamdesca.h>
+#include <eikdialg.h>
+#include "AknQueryValue.h"
+
+class CAknQueryValuePhoneArray;
+
+/**
+ * Encapsulates a string. Provides an interface to create a dialog
+ * containing a phone number query control, which will edit the value. Optionally 
+ * allows the value to be changed by selecting from a list of values. 
+ *
+ */
+NONSHARABLE_CLASS(CAknQueryValuePhone) : public CAknQueryValue
+    {
+public:
+    /**
+     * First stage of two stage construction.
+     *
+    */
+	IMPORT_C static CAknQueryValuePhone* NewL();
+	
+	/**
+     * First stage of two stage construction.
+     *
+    */
+	IMPORT_C static CAknQueryValuePhone* NewLC();
+	
+    IMPORT_C virtual ~CAknQueryValuePhone();
+	
+	/**
+     * Set the array.
+     * 
+     * @param aArray pointer to array, ownership is not passed
+    */
+	IMPORT_C void SetArrayL(const CAknQueryValuePhoneArray* aArray);
+	
+	/**
+     * Set the string used for the query caption to be a string other than the default.
+     *
+     * @param aResourceId		resource id of string to use for caption.
+     *
+    */
+	IMPORT_C void SetQueryCaption(TInt aResourceId);
+	
+    /**
+     * Return the current value, which may have been set by the user
+     *
+     * @return The current value, ownership is not passed
+     *
+    */	
+	IMPORT_C HBufC* Value() const;
+	
+public: // from MAknQueryValue
+    IMPORT_C virtual const MDesCArray* MdcArray() const;
+    IMPORT_C virtual HBufC* CurrentValueTextLC();
+    IMPORT_C virtual TInt CurrentValueIndex() const;
+    IMPORT_C virtual void SetCurrentValueIndex(const TInt aIndex);
+    IMPORT_C virtual TBool CreateEditorL();
+    
+protected:
+	CAknQueryValuePhone();
+	
+    /**
+     * Two stage construction
+     *
+    */	
+	void ConstructL();
+	
+	/**
+     * Search for the current value in the list, and set the curent index 
+     * to be the found index. If not found, set current index to 1 after the size of the array.
+     *
+    */
+	void CalculateCurrentIndex();
+	
+	virtual void AppendValueIfNewL();
+	
+private: // from MAknQueryValue
+	IMPORT_C void Reserved_MAknQueryValue();
+	
+private:
+	// the following are member variables
+	TInt iQueryCaptionId;
+	HBufC* iText;
+	TInt iCurrentIndex;
+	// the following are not owned
+	const CAknQueryValuePhoneArray* iArray;
+    };
+
+
+/**
+ * Wraps a descriptor array.
+ *
+ */
+NONSHARABLE_CLASS(CAknQueryValuePhoneArray) : public CBase, public MDesCArray
+	{
+public:
+    /**
+     * Typedef for array
+     *
+    */
+	typedef CDesCArray TextArray;
+	
+	enum {KSafeSizeOfDescriptorForPhoneFormat = 64};
+	
+public:
+    /**
+     * Two-phased constructor.
+     *
+    */
+	IMPORT_C static CAknQueryValuePhoneArray* NewL();
+	
+	/**
+     * Two-phased constructor.
+     *
+    */
+	IMPORT_C static CAknQueryValuePhoneArray* NewLC();
+	
+	IMPORT_C ~CAknQueryValuePhoneArray();
+	
+	/**
+     * Set the array of values. 
+     * Note that client can use any implementation of array class, but must pass in a 
+     * TArray generated from it (by calling the Array() method on the array class)
+     *
+     * @param aArray  array of values, ownership is passed
+    */
+	IMPORT_C void SetArray(TextArray& aArray);
+	
+	/**
+     * Get the array of values as a TArray. 
+     * Note that client can use any implementation of array class, but the array is 
+     * treated as a TArray.
+     *
+     * @return array of values, ownership is not passed
+    */
+	IMPORT_C TextArray* Array() const;
+
+/**
+ * Return the size of a maximal time string formated using the format string 
+ * that was supplied during construction of this instance.
+ * Two versions to eliminate compiler warnings.
+ *
+ * @return length of formatted string.
+ */	
+#ifdef __WINS__
+	IMPORT_C const TInt FormattedStringSize() const;
+#else
+	IMPORT_C TInt FormattedStringSize() const;
+#endif // __WINS__
+
+public:
+	// from MDesCArray
+	/**
+     * @return count of contained array
+     *
+    */
+    IMPORT_C virtual TInt MdcaCount() const;
+    
+    /**
+     * Returns array element, pass through to contained descriptor array
+     *
+     * @param aIndex   index of element to return
+     * @return descriptor representing array element, ownership is not passed
+    */
+    IMPORT_C virtual TPtrC MdcaPoint(TInt aIndex) const;
+    
+protected:
+	CAknQueryValuePhoneArray();
+	
+    /**
+     * 2nd stage construction.
+     *
+    */
+	void ConstructL();
+	
+private:
+	// the following members are not owned
+	TextArray* iArray;
+	TInt iFormattedStringSize;
+	};
+
+#endif // __AKNQUERYVALUEPHONE_H__
+