Authors
- Generated by root
-
- Declared in:
- Conversation.h
- Conforms to:
- MessageHandler
The Conversation class is an encapsulation of an abstract
conversation. This is a dialogue between two
parties; the local user and some other person. The
remote person is not a client, but some abstraction of
a person which may span multiple identities. The same
abstraction can be used for group chats, where
the remote 'person' will be the chat room, and each
identity will be a user within that room.
Instance Variables
Method summary
+ (id)
conversationForPerson: (
JabberPerson*)corespondent;
Create a new conversation with the specified person
associated with the default account.
+ (id)
conversationWithPerson: (
JabberPerson*)corespondent
forAccount: (
XMPPAccount*)_account;
Create a new conversation with the specified person,
associated with a given account. If a
conversation with the specified person already
exists, a copy will be returned.
+ (void)
releaseAllConversations;
Release all conversations. The class maintains a
reference to all created conversations. This is
used to clean-up all references. After calling this
method, existing conversations should not be used;
requesting a conversation may cause two
conversations with the same person to exist,
which could confuse the user.
+ (void)
setViewClass: (Class)aClass;
Sets the class of the object used to create a view for
each conversation. This should probably be moved out
into the application code and removed from here.
- (id
ConversationDelegate>) delegate;
Returns the delegate.
- (NSString*)
name;
Returns the name of the remote user.
- (
JID*)
remoteJID;
Returns the currently active JID of the remote
party. This may change for a variety of reasons.
- (void)
sendPlainText: (NSString*)_message;
Send a string as a message to the remote party.
- (void)
setDelegate: (id
ConversationDelegate>)_delegate;
Sets the delegate.
- (void)
setJID: (
JID*)jid;
Overrides the automatic JID selection, and forces
messages to be sent to that JID.
Instance Variables for Conversation Class
@protected XMPPConnection* connection;
Description forthcoming.
@protected id delegate;
Description forthcoming.
@protected NSString* name;
Description forthcoming.
@protected JID* remoteJID;
Description forthcoming.
@protected JabberPerson* remotePerson;
Description forthcoming.
- Declared in:
- Conversation.h
- Conforms to:
- XMPPPresenceDisplay
The ConversationDelegate formal protocol should be
implemented by any user interface representing a
conversation. Events in the associated
conversation class will cause messages defined
by this interface to be sent.
Method summary
- (void)
activate: (id)_sender;
Used to tell the UI that an event has occurred that
should cause it to become visible (or some analogue
of visible). (Deprecated?)
- (void)
conversation: (id)aConversation;
Sets the conversation with which this delegate is
associated.
- (void)
displayMessage: (
Message*)_message
incoming: (BOOL)_in;
Instructs the delegate to display a new message.
The incoming parameter is used to indicate the
direction of the message. Messages originating
with the local user will have this set to
NO
, while those from outside will have
it set to YES
.
- (BOOL)
newRemoteJID: (
JID*)jid;
Used to indicate that the active client on the remote
end has changed. This happens, for example, when the
remote user switches clients. This may indicate a
new resource, or an entirely new JID (for example
switching from a Jabber client to a legacy client
being used over a gateway).