Echelon LNS Plug-in User Manual

Page 48

Advertising
background image

Name Type

Description

Prelaunch Long

The

optional

Prelaunch property allows a director

to launch the plug-in in the background, typically
when the director is started. Not all directors
support the use of pre-launch, and if not this
property is ignored, and the plug-in would never be
pre-launched by that director. When the plug-in is
pre-launched, the plug in should remain running in
the background until a command to that plug-in is
sent from the director, at which point the plug-in
should become visible and behave normally. This
allows plug-ins with a long launch time to be called
quickly once the director is running.

A plug-in implementing the Prelaunch property
must also define the Prelaunch value in the
Windows registry. The Windows registry key is
described in Implementing the Plug-in Object Class
in Chapter 2.

If you are using the LNS Plug-in Framework, you
can also use the Prelaunch field of the PluginInfo
static property of the plugin’s object class to have
the registry value set for you.

A plug-in supporting pre-launch operation should
not display any messages or become visible while
going through the pre-launch sequence. A director
can tell a plug-in to pre-launch by setting the
Prelaunch property to 1.

RemoteFlag

Boolean

Optionally set by the director to indicate if the
plug-in is running on the same computer as the LNS
Object Server (RemoteFlag is False) or on a
different computer (RemoteFlag is True). In the
remote case, the director will set this property before
setting the NetworkName property. If RemoteFlag
is True, the RemoteTransport property should also
be set.

RemoteTransport Read-write

Long

The enumeration specifies the remote client type. It
should only be set if the RemoteFlag property is
True.

For LNS full clients, set this property to 1.

For LNS lightweight clients, set this property to 2.

Top

Long

The y location, in pixels, of the upper left corner of
the plug-in’s main window. 0 is at the topmost of
the user’s display.

Advertising