You can add an EXTRA! session to any Web page by calling the EXTRA! X-treme ActiveX control. This control is called by the
launch method, and uses several properties, described below.
|launch||BOOL launch()||Creates and opens the EXTRA! session specified in the
|launchfile||String||Required. The filename of session to open.
This can be any of the following formats:
|userid||String||Optional. A user ID that can access this session configuration.|
|password||String||Optional, write-only. A valid password for this session configuration.|
|mcsurl||String||Optional. The URL for the MCS server to check for the session configuration file. For example,
The default setting for this property is
|session||IDispatch||Read-only. This property returns a pointer to the session object. This allows programmatic access to the session object and all of its sub-objects.
A full description of the properties and methods of the session object and all of its sub-objects is available in the Help installed with the EXTRA! X-treme client application here:
|onclose||String||Optional. Determines what happens to the session when the Web page containing the ActiveX control closes (such as when moving to a different Web page, or closing the browser). The behavior resulting from this property depends upon whether the control is embedded or not. See the table below for details.|
Unless an embedded session is using the
detached value for the
onclose property, when the session window closes, the session disconnects.
||if embedded||if not embedded|
|close||The session window will close when the Web page containing the ActiveX control closes.||The session window will close when the associated browser closes. The associated browser is the one that opened the Web page containing the ActiveX control.|
|detach||The session window opens as a standalone EXTRA! window, and loses any association with the browser that initially opened it.||The session window doesn't make an association with the browser that opened it, and so remains independent whether the browser is closed or not.
This is the default setting for a non-embedded session.
|cached||The session window will close when the Web page containing the ActiveX control closes; however, the session remains connected. The session's state is cached by the browser, allowing the user to visit other Web pages, and then return to the Web page that calls the session, without losing her place in the host application. If the user closes the browser, the session is disconnected and the state is lost.
This is the default setting for an embedded session.
|Do not use this property if the session is not embedded.|
|Adding Sessions to a Portal, Overview|
|Adding a Session to any Web Page|
|Launcher Control Code Sample|
|Adding a Session to a Presentation|