--- a/epoc32/include/mw/aknipfed.h Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/mw/aknipfed.h Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,172 @@
-aknipfed.h
+/*
+* Copyright (c) 2002-2006 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: The CAknIpFieldEditor class implements an editor for an
+* IP address.
+*
+*/
+
+
+#if !defined(__AKNIPFED_H_)
+#define __AKNIPFED_H_
+
+// INCLUDES
+#include <eikmfne.h>
+
+// FORWARD DECLERATIONS
+class TInetAddr;
+
+//CLASS DECLERATION
+/**
+ * The @c CAknIpFieldEditor class implements an editor for an IP address.
+ * Based on Crystal @c CCknIpFieldEditor.
+ *
+ * @since Series 60 0.9
+ */
+class CAknIpFieldEditor : public CEikMfne
+ {
+public: // public constructors
+
+ /**
+ * C++ default constructor.
+ */
+ IMPORT_C CAknIpFieldEditor();
+
+ /**
+ * Two phased constructor.
+ * @param aMinimumAddress Reference to a @c TInetAddr struct. Defines lower
+ * limits for IP editor fields.
+ * @param aMaximumAddress Reference to a @c TInetAddr struct. Defines upper
+ * limits for IP editor fields.
+ * @param aInitialAddress Reference to a @c TInetAddr struct. Defines the
+ * initial address of the IP editor.
+ * @param aFlags The number field's flags. Default is 0.
+ * @return Pointer to the fully constructed @c CAknIpFieldEditor object.
+ */
+ void ConstructL(TInetAddr& aMinimumAddress,
+ TInetAddr& aMaximumAddress,
+ TInetAddr& aInitialAddress,
+ const TInt aFlags=0);
+
+ /**
+ * Two phased constructor.
+ * Constructs a CAknIpFieldEditor object using given parameters.
+ * @param aMinimumAddress Reference to a @c TInetAddr struct. Defines lower
+ * limits for IP editor fields.
+ * @param aMaximumAddress Reference to a @c TInetAddr struct. Defines upper
+ * limits for IP editor fields.
+ * @param aInitialAddress Reference to a @c TInetAddr struct. Defines the
+ * initial address of the IP editor.
+ * @return Pointer to the fully constructed @c CAknIpFieldEditor object.
+ */
+ IMPORT_C static CAknIpFieldEditor* NewL(TInetAddr& aMinimumAddress,
+ TInetAddr& aMaximumAddress,
+ TInetAddr& aInitialAddress);
+
+ /**
+ * Two phased constructor.
+ * Requires a call for @c ConstructFromResourcesL() method to finish
+ * construction.
+ * @return Pointer to the constructed @c CAknIpFieldEditor object.
+ */
+ IMPORT_C static CAknIpFieldEditor* NewL();
+
+public: // Methods for getting and setting values
+
+
+ /**
+ * Sets the editor's value dynamically.
+ * @param aAddress Reference to a @c TInetAddr struct including the new
+ * address.
+ */
+ IMPORT_C void SetAddress(const TInetAddr& aAddress);
+
+ /**
+ * Gets the editor's value.
+ * @return TInetAddr struct including the address.
+ */
+ IMPORT_C TInetAddr Address() const;
+
+ /**
+ * Sets the minimum and maximum editor values.
+ * @param aMinimumAddress Reference to a @c TInetAddr struct defining the
+ * lower limits of the editor fields.
+ * @param aMaximumAddress Reference to a @c TInetAddr struct defining the
+ * upper limits of the editor fields.
+ */
+ IMPORT_C virtual void SetMinimumAndMaximum(
+ const TInetAddr& aMinimumAddress,
+ const TInetAddr& aMaximumAddress); // only values inside the initial minimum and maximum are permitted
+
+ /**
+ * Gets the minimum and maximum editor values.
+ * @param aMinimumAddress Reference to a @c TInetAddr struct in which the
+ * lower limits are wanted to be returned.
+ * @param aMaximumAddress Reference to a @c TInetAddr struct in which the
+ * upper limits are wanted to be returned.
+ */
+ IMPORT_C virtual void GetMinimumAndMaximum(
+ TInetAddr& aMinimumAddress,
+ TInetAddr& aMaximumAddress) const;
+
+ /**
+ * Gets an IP address from resources.
+ * @param aResourceReader Reference to a resource reader associated to the
+ * @c IP_FIELD resource.
+ * @return TInetAddr struct including the address.
+ */
+ IMPORT_C TInetAddr ReadIPAddress(TResourceReader& aResourceReader);
+
+public: // from CCoeControl
+
+ /**
+ * From @c CCoeControl. Constructs controls from a resource file.
+ * Essential for Dialog/Form construction.
+ * @param aResourceReader The resource reader with which to access
+ * @c IP_FIELD_EDITOR
+ * resource.
+ */
+ IMPORT_C void ConstructFromResourceL(TResourceReader& aResourceReader);
+
+ /**
+ * From @c CCoeControl. Handles key events.
+ * Called by framework when a key event occurs.
+ * @param aKeyEvent The key event that occured.
+ * @param aType The type of key event that occured.
+ * @return @c EKeyWasConsumed if the event was processed,
+ * @c EKeyWasNotConsumed if the event was not processed
+ */
+ IMPORT_C TKeyResponse OfferKeyEventL(const TKeyEvent& aKeyEvent,
+ TEventCode aType);
+ IMPORT_C void HandlePointerEventL(const TPointerEvent& aPointerEvent);
+private:
+ /**
+ * From CAknControl
+ */
+ IMPORT_C void* ExtensionInterface( TUid aInterface );
+private:
+ void SplitAddressIntoFields(
+ const TInetAddr& aAddress,
+ TUint8 &aFieldA,
+ TUint8 &aFieldB,
+ TUint8 &aFieldC,
+ TUint8 &aFieldD) const;
+ IMPORT_C virtual void CEikMfne_Reserved();
+
+private:
+ TInt iSpare;
+ TInt iSpare2;
+ };
+
+
+#endif