--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/wvuing/wvuieng/EngInc/MCAInvite.h Thu Dec 17 08:41:52 2009 +0200
@@ -0,0 +1,125 @@
+/*
+* 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 "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: invitation interface for UI
+*
+*/
+
+
+#ifndef MCAINVITE_H
+#define MCAINVITE_H
+
+// INCLUDES
+#include <e32std.h>
+
+// INCLUDES
+#include "CCAInvitationRequest.h"
+#include "MCAInvitation.h"
+
+// FORWARD DECLARATIONS
+class MCAInviteObserver;
+
+// CLASS DECLARATION
+
+/**
+* Invitation handling interface for UI.
+*
+*
+* @lib CAEngine.lib
+* @since 1.2
+*/
+class MCAInvite
+ {
+ public:
+
+ /**
+ * Sends an invitation for joining to a group.
+ * @param aInvitation specifies the invitation (texts etc.).
+ */
+ virtual void SendInvitationL(
+ const CCAInvitationRequest& aInvitation ) = 0;
+
+ /**
+ * This is the reply to an invitation.
+ * Note that invitation gets removed by this call, so do not try to use
+ * it after calling this!!!
+ * @param aInvitation is the invitation.
+ * @param aInviteAccepted specifies if the invite was accepted or not.
+ * @param aResponse is the response
+ * @param aScreenName is our own screenname
+ */
+ virtual void ReplyInvitationL( const MCAInvitation* aInvitation,
+ const TBool aInviteAccepted,
+ const TDesC& aResponse,
+ const TDesC& aScreenName ) = 0;
+
+ /**
+ * Adds an invite observer. Invitation events are guided to this
+ * observer.
+ * @param aObserver specifies the observer.
+ * @return KErrNone if successful, otherwise one of the system error codes
+ */
+ virtual TInt AddInviteObserver( MCAInviteObserver* aObserver ) = 0;
+
+ /**
+ * Removes an invite observer.
+ * @param aObserver specifies the observer.
+ */
+ virtual void RemoveInviteObserver( MCAInviteObserver* aObserver ) = 0;
+
+ /**
+ * Populates the list with currently unhandled invitations
+ * @since 2.1
+ */
+ virtual void PopulateInviteList( RPointerArray<MCAInvitation>& aList ) = 0;
+
+ /**
+ * Returns the number of unhandled invitations
+ * @since 2.1
+ * @return The number of received active
+ */
+ virtual TInt ActiveInvitations() = 0;
+
+ /**
+ * Removes the invitation
+ * @since 2.1
+ * @param aInvitation
+ */
+ virtual void RemoveInvitationL( MCAInvitation* aInvitation ) = 0;
+
+ /**
+ * Gets the pointer to buffer holding the reject reason
+ * This is stored in the engine side because the last written
+ * reason must be remembered
+ * @since 2.1
+ * @return The pointer to reject reason, which can be modified
+ */
+ virtual HBufC* RejectReasonPtr() = 0;
+
+ /**
+ * Amount of unread invite messages
+ * @return Amount of unread invite messages
+ */
+ virtual TInt UnreadInvitesCount() const = 0;
+
+ protected:
+
+ /**
+ * Deletion through this class is not wanted.
+ */
+ virtual ~MCAInvite() {};
+ };
+
+#endif // MCAINVITE_H
+
+// End of File