Messenger Plus! Live - Scripting Documentation

The OnEvent_Initialize event is fired when the script is starting.

Syntax

OnEvent_Initialize(
    [boolean] MessengerStart
);

Parameters

MessengerStart
[boolean] Specifies the reason for the event to occur. If this parameter is true, the event was generated during the startup of Messenger. If it is false, the event was generated after the script was imported, enabled, or restarted.

Return Value

No value has to be returned by this event.

Remarks

Scripts are loaded very early in the life of the Messenger process, before any Messenger window is created and before the user signs in the service. You can use the MessengerStart parameter to adapt the start-up routine of your script when Windows Live Messenger starts. Important: this parameter does not guarantee if a user is currently signed-in or not. Please use the Messenger::MyStatus property for that.

Scripts should keep their initialization to a strict minimum when MessengerStart is true. No window must be displayed at that time and no time consuming task must be launched. As the Messenger process can rapidly exit following this event in several circumstances, without displaying anything to the user, it is imperative that your script follows these guidelines. If a task must be started along with Messenger, it is recommended to create a timer to start it with a a couple of seconds of delay.

Event Information

Event Source Messenger Plus!
Availability Messenger Plus! Live 4.00

See Also

Messenger Plus! Events, OnEvent_Uninitialize, Messenger::MyStatus.