--- a/ipcm_pub/connection_settings_api/inc/cmconnectionmethod.h Tue Aug 31 15:35:44 2010 +0300
+++ b/ipcm_pub/connection_settings_api/inc/cmconnectionmethod.h Wed Sep 01 12:23:51 2010 +0100
@@ -1,5 +1,5 @@
/*
-* Copyright (c) 2006-2010 Nokia Corporation and/or its subsidiary(-ies).
+* Copyright (c) 2006 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"
@@ -11,22 +11,20 @@
*
* Contributors:
*
-* Description:
-* Connection Method interface class.
+* Description: Connection Method interface class.
*
*/
-
#ifndef CMCONNECTIONMETHOD_H
#define CMCONNECTIONMETHOD_H
+// INCLUDES
#include <e32base.h>
#include <cmconnectionmethoddef.h>
-// Forward declarations
+// CLASS DECLARATION
+class CCmPluginBaseEng;
class RCmDestination;
-class CCmConnectionMethodWrapper;
-
/**
* RCmConnectionMethod is for getting/setting values of a connection method.
@@ -35,30 +33,39 @@
*/
NONSHARABLE_CLASS( RCmConnectionMethod )
{
+ //=====================================================================
+ // Constructors/Destructors
+ //
public:
+
/**
- * Default constructor.
+ * Default constructor.
*/
IMPORT_C RCmConnectionMethod();
- /**
- * Copy constructor.
- */
- IMPORT_C RCmConnectionMethod( const RCmConnectionMethod& aConnMethod );
/**
- * Destructor.
+ * Copy constructor.
+ */
+ IMPORT_C RCmConnectionMethod(const RCmConnectionMethod& aItem);
+
+
+ /**
+ * Destructor.
*/
IMPORT_C ~RCmConnectionMethod();
+ //=====================================================================
+ // API functions
public:
+
/**
* Close the session
*
* @since S60 3.2
*/
IMPORT_C void Close();
-
+
/**
* Gets the value for a TInt attribute.
*
@@ -86,7 +93,7 @@
* @return copy of the requested attribute. Ownership is passed.
*/
IMPORT_C HBufC* GetStringAttributeL( TUint32 aAttribute ) const;
-
+
/**
* Gets the value for a String8 attribute.
* HBuf ownership is passed to the caller
@@ -95,8 +102,8 @@
* @param aAttribute Identifies the attribute to be retrieved.
* @return copy of the requested attribute. Ownership is passed.
*/
- IMPORT_C HBufC8* GetString8AttributeL(
- const TUint32 aAttribute ) const;
+ IMPORT_C HBufC8* GetString8AttributeL(
+ const TUint32 aAttribute ) const;
/**
* Call this function only if this CM is an embedded destination!
@@ -106,42 +113,42 @@
*/
IMPORT_C RCmDestination DestinationL() const;
-
+
/**
- * checks if connection methods are the same
- *
+ * checks if connection methods are the same
+ *
* @since S60 3.2
* @param aConnMethod the connection method being compared
* @return ETrue if the destinations are the same
*/
IMPORT_C TBool operator==( RCmConnectionMethod& aConnMethod ) const;
-
+
/**
- * checks if connection methods are not the same
- *
+ * checks if connection methods are not the same
+ *
* @since S60 3.2
* @param aConnMethod the connection method being compared
* @return ETrue if the destinations are different
*/
IMPORT_C TBool operator!=( RCmConnectionMethod& aConnMethod ) const;
-
+
/**
- * assignment operator
- *
+ * assignment operator
+ *
* @since S60 3.2
* @return RCmConnectionMethod
*/
- IMPORT_C RCmConnectionMethod& operator=(
- const RCmConnectionMethod& aConnMethod );
+ IMPORT_C RCmConnectionMethod& operator=(const RCmConnectionMethod&
+ aConnMethod);
/**
- * Creates a copy of this connection method. UpdateL() has to be called
+ * Creates a copy of this connection method. UpdateL() has to be called
* to store new connection method in database. Ownership is passed.
*/
IMPORT_C RCmConnectionMethod CreateCopyL();
- /**
+ /**
* Sets the value for a TInt attribute.
* @param aAttribute Identifies the attribute to be set.
* @param aValue The value to be set.
@@ -163,9 +170,8 @@
* @param aValue The value to be set.
* @return None.
*/
- IMPORT_C void SetStringAttributeL(
- TUint32 aAttribute,
- const TDesC16& aValue );
+ IMPORT_C void SetStringAttributeL( TUint32 aAttribute,
+ const TDesC16& aValue );
/**
* Sets the value for a String8 attribute.
@@ -173,13 +179,12 @@
* @param aValue The value to be set.
* @return None.
*/
- IMPORT_C void SetString8AttributeL(
- TUint32 aAttribute,
- const TDesC8& aValue );
+ IMPORT_C void SetString8AttributeL( TUint32 aAttribute,
+ const TDesC8& aValue );
/**
- * Try to delete the connection method. If it is referenced from
- * any destination, then the references are removed and the
+ * Try to delete the connection method. If it is referenced from
+ * any destination, then the references are removed and the
* connection method is deleted.
* Do NOT call this function if you got this
* connection method from a destination. Call destination's
@@ -191,40 +196,22 @@
/**
* Update in the database.
* @return None.
- */
+ */
IMPORT_C void UpdateL();
- /**
- * Gets the icon identifier(name) of the connection method. It can
- * contain path information. HBufC* ownership is passed to the caller.
- * @return Returns pointer to a buffer which identifies the requested
- * icon.
- */
- IMPORT_C HBufC* GetIconL() const;
-
- /**
- * Sets the icon identifier(name) of the connection method. It can
- * contain path information.
- * @param aIcon Identifier of the connection method icon.
- */
- IMPORT_C void SetIconL( const TDesC& aIcon );
-
- /**
- * Reload the contents of the connection method from database.
- * Any current changes made to the connection method are lost.
- * @return None.
- */
- IMPORT_C void RefreshL();
-
-
private:
+
friend class RCmDestination;
friend class RCmManager;
-
+
private:
- CCmConnectionMethodWrapper* iCmConnectionMethodWrapper;
+
+ /**
+ * the implementation class
+ */
+ CCmPluginBaseEng* iImplementation;
};
-#endif // CMCONNECTIONMETHOD_H
-
-// End of file
+#include <cmconnectionmethod.inl>
+
+#endif // CMCONNECTIONMETHOD_H