• Skip to content
  • Skip to link menu
KDE 4.2 API Reference
  • KDE API Reference
  • API Reference
  • Sitemap
  • Contact Us
 

libkdegames

KChat Class Reference

#include <KChat>

Inheritance diagram for KChat:

Inheritance graph
[legend]

List of all members.


Detailed Description

A chat widget for non-KGame games.

Docu is TODO

Author:
Andreas Beckermann <b_mann@gmx.de>

Definition at line 36 of file kchat.h.


Signals

void signalSendMessage (int id, const QString &msg)

Public Member Functions

int addPlayer (const QString &nick)
bool autoAddMessages () const
int fromId () const
virtual QString fromName () const
 KChat (QWidget *parent, bool twoPlayerGame=false)
QString player (int id) const
void removePlayer (int id)
void removePlayer (const QString &nick)
void setAutoAddMessages (bool add)
void setFromNickname (const QString &name)
virtual ~KChat ()

Protected Member Functions

virtual void returnPressed (const QString &)
int uniqueId ()

Constructor & Destructor Documentation

KChat::KChat ( QWidget *  parent,
bool  twoPlayerGame = false 
) [explicit]

Parameters:
parent The parent widget for this widget.

Parameters:
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.

Definition at line 44 of file kchat.cpp.

KChat::~KChat (  )  [virtual]

Definition at line 53 of file kchat.cpp.


Member Function Documentation

int KChat::addPlayer ( const QString &  nick  ) 

Adds a player nickname.

Returns:
The unique ID of the player

Definition at line 100 of file kchat.cpp.

bool KChat::autoAddMessages (  )  const

Returns:
true if the messages which will be sent from here will be added automatically using KChatBase::addMessage.

See also setAutoAddMessages

Definition at line 73 of file kchat.cpp.

int KChat::fromId (  )  const

Returns:
The ID that belongs to the local player.

See also:
setFromNickname

Definition at line 77 of file kchat.cpp.

QString KChat::fromName (  )  const [virtual]

Equivalent to player(fromId()).

Returns:
The name that will be shown for messages from this widget. That is the string from setFromNickname

Implements KChatBase.

Definition at line 69 of file kchat.cpp.

QString KChat::player ( int  id  )  const

Returns:
The nickname of the player which belongs to this id

Definition at line 79 of file kchat.cpp.

void KChat::removePlayer ( int  id  ) 

Removes the player with this id, as returned by addPlayer.

Parameters:
id The id of the player to be removed

Definition at line 107 of file kchat.cpp.

void KChat::removePlayer ( 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)

Parameters:
nick The nickname of the removed players

Definition at line 112 of file kchat.cpp.

void KChat::returnPressed ( const QString &  text  )  [protected, virtual]

This emits signalSendMessage and, if autoAddMessages is true, calls KChatBase::addMessage.

Implements KChatBase.

Definition at line 82 of file kchat.cpp.

void KChat::setAutoAddMessages ( bool  add  ) 

Usually the messages which will be sent from here (see 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 KChatBase::addMessage yourself

Parameters:
add If true (default) messages sent from here will be added automatically. Otherwise you will have to add them yourself

Definition at line 71 of file kchat.cpp.

void KChat::setFromNickname ( const QString &  name  ) 

This sets the name that will be shown on all chat widgets if this widget sends a message.

See signalSendMessage

Parameters:
name The name of the player owning this widget

Definition at line 67 of file kchat.cpp.

void KChat::signalSendMessage ( int  id,
const QString &  msg 
) [signal]

This signal is emitted when the player wants to send a message.

The message is added automatically using KChatBase::addMessage if autoAddMessages is enabled.

Parameters:
id The id of the player who sends the message - see setFromNickname and player
msg The message itself

int KChat::uniqueId (  )  [protected]

The Id of the next player.

Incremented after every call.

Definition at line 75 of file kchat.cpp.


The documentation for this class was generated from the following files:
  • kchat.h
  • kchat.cpp

libkdegames

Skip menu "libkdegames"
  • Main Page
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

API Reference

Skip menu "API Reference"
  • kblackbox
  • kgoldrunner
  • kmahjongg
  • ksquares
  • libkdegames
  •   highscore
  •   kgame
  •   kggzgames
  •   kggzmod
  •   kggznet
  • libkmahjongg
Generated for API Reference by doxygen 1.5.4
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal