73 lines
2.2 KiB
C++
73 lines
2.2 KiB
C++
/*
|
|
Copyright (c) 2006-2009 by Jakob Schroeter <js@camaya.net>
|
|
This file is part of the gloox library. http://camaya.net/gloox
|
|
|
|
This software is distributed under a license. The full license
|
|
agreement can be found in the file LICENSE in this distribution.
|
|
This software may not be copied, modified, sold or distributed
|
|
other than expressed in the named license agreement.
|
|
|
|
This software is distributed without any warranty.
|
|
*/
|
|
|
|
|
|
|
|
#ifndef MUCINVITATIONHANDLER_H__
|
|
#define MUCINVITATIONHANDLER_H__
|
|
|
|
#include "clientbase.h"
|
|
#include "macros.h"
|
|
#include "jid.h"
|
|
#include "mucroom.h"
|
|
|
|
#include <string>
|
|
|
|
namespace gloox
|
|
{
|
|
|
|
/**
|
|
* @brief A handler that can be used to receive invitations to MUC rooms.
|
|
*
|
|
* Register a derived class with ClientBase::registerMUCInvitationHandler().
|
|
*
|
|
* @author Jakob Schroeter <js@camaya.net>
|
|
* @since 0.9
|
|
*/
|
|
class GLOOX_API MUCInvitationHandler
|
|
{
|
|
public:
|
|
/**
|
|
* Constructor. Prepares the given ClientBase for receiving MUC invitations..
|
|
* @param parent A ClientBase instance to prepare.
|
|
*/
|
|
MUCInvitationHandler( ClientBase* parent )
|
|
{
|
|
if( parent )
|
|
parent->registerStanzaExtension( new MUCRoom::MUCUser() );
|
|
}
|
|
|
|
/**
|
|
* Virtual Destructor.
|
|
*/
|
|
virtual ~MUCInvitationHandler() {}
|
|
|
|
/**
|
|
* This function is called for incoming invitations to MUC rooms.
|
|
* @param room The JID of the room you're being invited to.
|
|
* @param from The JID of the inviter.
|
|
* @param reason A reason for the invitation.
|
|
* @param body The body of the message. May contain a MUC-service generated invitation message.
|
|
* @param password Optionally, a password for the room.
|
|
* @param cont Indicates whether or not the multi-user chat is a continuation of a private chat.
|
|
* @param thread An optional thread identifier in case this is a
|
|
* continued chat.
|
|
*/
|
|
virtual void handleMUCInvitation( const JID& room, const JID& from, const std::string& reason,
|
|
const std::string& body, const std::string& password,
|
|
bool cont, const std::string& thread ) = 0;
|
|
};
|
|
|
|
}
|
|
|
|
#endif // MUCINVITATIONHANDLER_H__
|