diff -r 666f914201fb -r 2fe1408b6811 epoc32/include/mw/aknqueryvalueduration.h --- a/epoc32/include/mw/aknqueryvalueduration.h Tue Nov 24 13:55:44 2009 +0000 +++ b/epoc32/include/mw/aknqueryvalueduration.h Tue Mar 16 16:12:26 2010 +0000 @@ -1,1 +1,229 @@ -aknqueryvalueduration.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: +* +*/ + +// AknQueryValueDuration.h +// +// Copyright (c) 2001 Symbian Ltd. All rights reserved. +// + +#if !defined(__AKNQUERYVALUEDURATION_H__) +#define __AKNQUERYVALUEDURATION_H__ + +#include +#include +#include "AknQueryValue.h" + +class CAknQueryValueDurationArray; + +/** + * Encapsulates a TTimeIntervalSeconds. Provides an interface to create a dialog + * containing a duration query control, which will edit the value. Optionally + * allows the value to be changed by selecting from a list of values. + * + */ +NONSHARABLE_CLASS(CAknQueryValueDuration) : public CAknQueryValue + { +public: + /** + * Two-phased constructor. + * + */ + IMPORT_C static CAknQueryValueDuration* NewL(); + + /** + * Two-phased constructor. + * + */ + IMPORT_C static CAknQueryValueDuration* NewLC(); + IMPORT_C virtual ~CAknQueryValueDuration(); + + /** + * Set the array. + * + * @param aArray pointer to array, ownership is not passed + */ + IMPORT_C void SetArrayL(const CAknQueryValueDurationArray* 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 + * + */ + IMPORT_C TTimeIntervalSeconds 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: + CAknQueryValueDuration(); + + /** + * 2nd 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; + TTimeIntervalSeconds iDuration; + TInt iCurrentIndex; + // the following are not owned + const CAknQueryValueDurationArray* iArray; + }; + + +/** + * Wraps an array of numeric values, adapts it into a descriptor array. + * + */ +NONSHARABLE_CLASS(CAknQueryValueDurationArray) : public CBase, public MDesCArray + { +public: + /** + * Typedef for array containing TTimeIntervalSeconds items + * + */ + typedef CArrayFix DurationArray; + + enum {KSafeSizeOfDescriptorForDurationFormat = 32}; + +public: + /** + * Two-phased constructor.. + * + * @param aResourceId Recource id of a TBUF containing a duration format string. Client + * can use R_AVKON_TBUF_POPUP_FIELD_DEFAULT_DURATION_FORMAT + * if desired, or provide its own resource. (must be at least "%d%d%d") + */ + IMPORT_C static CAknQueryValueDurationArray* NewL(TInt aResourceId); + + /** + * See NewL + * + */ + IMPORT_C static CAknQueryValueDurationArray* NewLC(TInt aResourceId); + + IMPORT_C ~CAknQueryValueDurationArray(); + + /** + * 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 not passed + */ + IMPORT_C void SetArray(DurationArray& 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 DurationArray* Array() const; + + /** + * Return the TTime format string that is used to generate MDesCArray values + * + * @return format string + */ + IMPORT_C const HBufC* FormatString() 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__ + + /** + * Format a descriptor with the textual version of a duration, formated according to the format string. + * Number of hours is not bounded. + * + * @param aText descriptor to be filled, must be of sufficient size + * @param aDuration the interval to be formatted + * + */ + IMPORT_C void FormatDuration(TPtr& aText, TTimeIntervalSeconds aDuration) const; + +public: + // from MDesCArray + /** + * @return count of contained array + * + */ + IMPORT_C virtual TInt MdcaCount() const; + + /** + * Returns array element, converting value to text. + *

WARNING: the returned pointer is only valid until the next time this + * method is invoked. + * + * @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: + CAknQueryValueDurationArray(); + + /** + * 2nd stage construction. + * + */ + void ConstructL(TInt aResourceId); + +private: + // the following members are owned + HBufC* iLastGeneratedTextValue; + HBufC* iFormatString; + // the following members are not owned + DurationArray* iArray; + TInt iFormattedStringSize; + }; + + +#endif // __AKNQUERYVALUEDURATION_H__ +