ContactStatusChange Event
    
 

Description

Fires when contact's status changes.


Syntax

Private Sub object_ContactStatusChange(Contact, ChatRoom, NewStatus, OldStatus)



The ContactStatusChange Event syntax has these parts:

Part Description
object A wodXMPP object.
Contact A XMPPContact object. Provides you with reference to XMPPContact object.
ChatRoom A XMPPChatRoom object. Provides you with reference to chat room where contact belongs.
NewStatus A StatusEnum enumeration, as described in settings. Provides you with current Status information.
OldStatus A StatusEnum enumeration, as described in settings. Provides you with previous Status information.

Settings

The settings for OldStatus are:

Constant Value Description
 Offline 0 Offline.
 Online 1 Online.
 Away 2 Away.
 Chat 3 Free for chat.
 DoNotDisturb 4 Do not disturb.
 ExtendedAway 5 Extended away.
 Invisible 6 Invisible.
 Requested 7 Asking for subscription.
 Unsubscribed 8 Contact not subscribed.

Remarks

Fired each time when your contact changes his online status. When this happens, the event will provide you with two parameters, Contact - which provides you with the reference to XMPPContact object of the contact that changed his status, and OldStatus which provides you with information what your contact's previous status was.

If this contact is only from some chat room, ChatRoom argument will hold reference to the chat room.

When your contact is connected more than once using different resources, Resource property will contain all of them, but first one listed there is one that caused this event to fire.