HTMLXpress Object

Description

The HTMLXpress control is embedded in all Web pages using the <OBJECT> tag. The most important parameters of the <OBJECT> tag are CLASSID and CODEBASE.

The CLASSID parameter of the <OBJECT> tag is string that specifies the class identifier for the object. It is not changed when a new version of the control is released.

Pay attention that the CLASSID parameters for the demo and the full version are different. The CLASSID parameter for the demo is CLSID:BFE1F4EA-0B7F-4AA5-8FD8-FBAB6AA5C3D5 and the CLASSID parameter for the full version is CLSID:86A63E0C-CCF7-11D4-90CE-00C02627FC4F. They must match exactly the CLASSID-s shown in the examples for respective version of the HTMLXpress control.

The CODEBASE parameter of the <OBJECT> tag specifies the location (.CAB file) from which the control will be downloaded.

In the following examples MySite is used for domain name of the site, on which the HTMLXpress is used. The ActiveXPath is used for relative WEB path where the CAB file is placed. (I.e. In URL http://www.mysite.com/objects/client/HTMLXpress.CAB - "www.mysite.com" is for MySite and "objects/client" is for ActiveXPath).

The #version sub-parameter of the CODEBASE parameter must show the version number of the newest OCX file (contained in the CAB file) in order to download and update the client's OCX file to match the current version, which occurs when a page containing <OBJECT> tag of the control is being accessed. Increasing the #version value will force a download of the control on client computer.

Demo Version Usage

The example below illustrates usage of the <OBJECT> tag with HTMLXpressDemo control.

<OBJECT ID=HTMLXpressDemo NAME=HTMLXpressDemo 
STYLE="WIDTH: 620px; HEIGHT: 445px" 
CLASSID="CLSID:BFE1F4EA-0B7F-4AA5-8FD8-FBAB6AA5C3D5"  
CODEBASE="http://MySite/ActiveXPath/HTMLXPressDemo.CAB#version=1,1,0,4" >
 <PARAM NAME= ="_ExtentX" VALUE="16404">
 <PARAM NAME ="_ExtentY" VALUE="11906">
 .....
</OBJECT>

The HTMLXpressDemo.cab contains two files in that sample - HTMLXpressDemo.ocx and HTMLXpressDemo.inf.

Full licensed Version Usage

To use a licensed full version of HTMLXpress control to edit an HTML page, you have to use the license package file ( HTMLXpress.lpk). The LPK file contains run-time license so all HTMLXpress control functions are available. This file is included in the full installation package of HTMLXpress control. If you have purchased HTMLXpress, you have to insert an <OBJECT> tag defining the License Manager object in front of any other <OBJECT> tags. The usage of the licensed full version of HTMLXpress is shown below.

In the following example the LPKPath is used for relative path (URL), where the LPK file is placed. (I.e. In URL /objects/client/HTMLXpress.LPK - "objects/client" is for LPKPath). This path may be a relative path but must not refer to a UNC share or a URL on another domain.

NOTE: The HTMLXpress.LPK file can be placed in the same folder where the HTMLXpress.CAB file is placed for your convenience.

<OBJECT CLASSID = "CLSID:5220cb21-c88d-11cf-b347-00aa00a28331">
 <PARAM NAME="LPKPath" VALUE="/LPKPath/HTMLXpress.LPK">
</OBJECT>

<OBJECT ID=HTMLXpress NAME=HTMLXpress STYLE="WIDTH: 620px; HEIGHT: 445px" 
CLASSID="CLSID:86A63E0C-CCF7-11D4-90CE-00C02627FC4F"  
CODEBASE="http://MySite/ActiveXPath/HTMLXpress.CAB#version=1,1,0,4" >
<PARAM NAME="_ExtentX" VALUE="16404">
<PARAM NAME="_ExtentY" VALUE="11906">
.....
</OBJECT>

NOTE:

The <OBJECT> tag for your licensed HTMLXpress control has to be under the License Manager <OBJECT> tag.

Properties

Methods

Events