OnEvent_ContactStatusChange

The OnEvent_ContactStatusChange event is fired when a contact changes his Messenger status.

Syntax

OnEvent_ContactStatusChange(
    [string] Email,
    [enum] NewStatus
);

Parameters

Email

[string] Sign-in email of the contact changing its status.

NewStatus

[enum] New status of the contact, represented by a number taken from the following enumeration:

STATUS_ONLINE (3) STATUS_BUSY (4) STATUS_BRB (5) STATUS_IDLE (6) STATUS_AWAY (7) STATUS_INCALL (8) STATUS_OUTLUNCH (9)

Online Busy Be Right Back Idle Away In a Call Out to Lunch

Return Value

No value has to be returned by this event.

Remarks

This event is fired before the change gets recorded by Messenger Plus!. This means that the previous status of the contact can be obtained in the event handler with Contact::Status.

Messenger Plus! 4.23 and earlier: enumeration names are not available, numbers must be used instead.

Event Information

See Also

Messenger Events.