You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdegames/libkdegames/kchat.h

148 lines
4.1 KiB

/*
This file is part of the KDE games library
Copyright (C) 2001 Andreas Beckermann (b_mann@gmx.de)
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License version 2 as published by the Free Software Foundation.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public License
along with this library; see the file COPYING.LIB. If not, write to
the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
Boston, MA 02110-1301, USA.
*/
#ifndef __KCHAT_H__
#define __KCHAT_H__
#include <qstring.h>
#include "kchatbase.h"
#include <kdemacros.h>
class KChatPrivate;
/**
* @short A chat widget for non-KGame games
*
* Docu is TODO
*
* @author Andreas Beckermann <b_mann@gmx.de>
**/
class KDE_EXPORT KChat : public KChatBase
{
Q_OBJECT
public:
/**
* @param parent The parent widget for this widget.
* @param twoPlayerGame If true the combo box where the player can
* choose to send to a single player or to all players will not be added
* as you will hardly need it in 2-player games.
**/
KChat(QWidget* parent, bool twoPlayerGame = false);
virtual ~KChat();
/**
* Equivalent to player(fromId())
* @return The name that will be shown for messages from this widget.
* That is the string from @ref setFromNickname
**/
virtual const QString& fromName() const;
/**
* This sets the name that will be shown on all chat widgets if this
* widget sends a message. See signalSendMessage
* @param name The name of the player owning this widget
**/
void setFromNickname(const QString& name);
// TODO:
// void setPlayerList(QIntDict<QString>);// use this for non-KGame use
/**
* Adds a player nickname.
* @return The unique ID of the player
**/
int addPlayer(const QString& nick);
/**
* Removes all players with this nickname. Better don't use this as it
* will remove *all* players with this nickname. Save the id instead and
* call removePlayer(id)
* @param nick The nickname of the removed players
**/
void removePlayer(const QString& nick);
/**
* Removes the player with this id, as returned by @ref addPlayer
* @param id The id of the player to be removed
**/
void removePlayer(int id);
/**
* @return true if the messages which will be sent from here will be
* added automatically using @ref KChatBase::addMessage. See also @ref
* setAutoAddMessages
**/
bool autoAddMessages() const;
/**
* Usually the messages which will be sent from here (see @ref
* signalSendMessage) are added autmatically to this widget. But under
* some circumstances that would be very unhandy. So you can deactivate
* this behaviour here and call @ref KChatBase::addMessage yourself
* @param add If true (default) messages sent from here will be added
* automatically. Otherwise you will have to add them yourself
**/
void setAutoAddMessages(bool add);
/**
* @return The nickname of the player which belongs to this id
**/
const QString& player(int id) const;
/**
* @return The ID that belongs to the local player.
* @see setFromNickname
**/
int fromId() const;
signals:
/**
* This signal is emitted when the player wants to send a message.
*
* The message is added automatically using @ref KChatBase::addMessage if @ref
* autoAddMessages is enabled.
* @param id The id of the player who sends the message - see
* setFromNickname and player
* @param msg The message itself
**/
void signalSendMessage(int id, const QString& msg);
protected:
/**
* This emits @ref signalSendMessage and, if @ref autoAddMessages is
* true, calls @ref KChatBase::addMessage
**/
virtual void returnPressed(const QString&);
/**
* The Id of the next player. Incremented after every call.
**/
int uniqueId();
private:
void init();
KChatPrivate* d;
};
#endif