OnEvent_EnterPersonalizedStatus

The OnEvent_EnterPersonalizedStatus event is fired when the current user changes its status to a Messenger Plus! personalized status. Personalized statuses are a combination of various Messenger properties changed simultaneously to create the appearance of a more complex status based on a name tag, a personal message and an automatic responder message.

Syntax

OnEvent_EnterPersonalizedStatus(
    [enum] NewStatus,
    [string] NameTag,
    [string] PersonalMessage,
    [string] AutoMessage
);

Parameters

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

NameTag

[string] A name tag is a string attached to the current name of the current user. It is enclosed in brackets and displayed differently in the contact list to simulate a status' name. If no name tag is associated with the personalized status, this parameter is an empty string.

PersonalMessage

[string] New personal message to be set for the current user. The old personal message is saved and restored when the personalized status is removed. If no personal message is associated with the personalized status, this parameter is an empty string.

AutoMessage

[string] Message that is sent automatically to contacts messaging the current user while in personalized status mode. If no automatic responder message is associated with the personalized status, this parameter is an empty string.

Return Value

No value has to be returned by this event.

Remarks

At least one of NameTag, PersonalMessage and AutoMessage is set when personalized status mode is entered.

Messenger events for status change, name change and personal message change are also generated if necessary.

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

Event Information

See Also

Messenger Plus! Events, OnEvent_LeavePersonalizedStatus.