Customizer's Guide > Working with ActiveX Controls > Integrating Arbortext Editor with Web Pages > The arbortext-editor-embed Protocol
  
The arbortext-editor-embed Protocol
You use the arbortext-editor-embed protocol to launch a Arbortext Editor session in an ActiveX control embedded in a web browser. Running Arbortext Editor in an ActiveX control in the browser is only supported for Internet Explorer. However, note that the arbortext-editor-embed protocol is not supported when running Internet Explorer on Microsoft Windows Server 2003 or 2008 with the Internet Explorer Enhanced Security Configuration enabled. All other web browsers treat the arbortext-editor-embed protocol as if it was the arbortext-editor protocol.
When Arbortext Editor is run in an ActiveX control, the user interface has somewhat different functionality than the regular Arbortext Editor window. In particular, the ActiveX Arbortext Editor provides the menus through a Menu toolbar button:
Menu toolbar button
For other differences between the regular and Active X Arbortext Editor interfaces, refer to Running Arbortext Editor in an ActiveX control.
Following are some examples of HTML markup that load the Active X Arbortext Editor in a browser window:
Loading Arbortext Editor full screen in the same browser window:
<a href="arbortext-editor-embed:http%3A%2F%2Fdocserver%2Fwebdav%2Fsample.xml">
Open document
</a>
Loading Arbortext Editor full screen in a new browser window:
<a href="arbortext-editor-embed:http%3A%2F%2Fdocserver%2Fwebdav%2Fsample.xml" target="_blank">
Open document
</a>
Embedding Arbortext Editor in a browser window using the iframe tag:
<html>
<body>
<p>Use Arbortext Editor to edit the sample document:</p>
<iframe height="600" width="500" src="arbortext-editor-embed:http%3A%2F%2Fdocserver%2Fwebdav%2Fsample.xml"></iframe>
</body>
</html>
Using a frameset tag to load multiple Arbortext Editor frames:
<html>
<frameset rows="50%,50%">
<frame src="arbortext-editor-embed:http%3A%2F%2Fdocserver%2Fwebdav%2Fsample.xml">
<frameset cols="25%,75%">
<frame src="arbortext-editor-embed:http%3A%2F%2Fdocserver%2Fwebdav%2Fsample2.xml">
<frame src="arbortext-editor-embed:http%3A%2F%2Fdocserver%2Fwebdav%2Fsample3.xml">
</frameset>
</frameset>
</html>
Embedding Arbortext Editor in a browser window using the embed tag:
<html>
<body>
<p>Use Arbortext Editor to edit the sample document:</p>
<EMBED src="arbortext-editor-embed:http%3A%2F%2Fdocserver%2Fwebdav%2Fsample.xml#.arbtxted" height="200" width="400">
</body>
</html>
When using the embed tag, Internet Explorer displays a tool tip saying Press SPACEBAR or ENTER to activate and use this control. Before you can use Arbortext Editor, you must either click in the ActiveX control or press the SPACEBAR or ENTER keys.
* 
To get the ActiveX Arbortext Editor to work correctly using the embed tag, the href attribute had to have the special suffix .arbtxted added to it as follows:
arbortext-editor-embed:http%3A%2F%2Fdocserver%2Fwebdav%2Fsample.xml#.arbtxted
The .arbtxted suffix is required for Internet Explorer to load the ActiveX control using this tag.
In general, this suffix can be safely added to any link as the suffix is ignored during processing by Arbortext Editor. Adding the suffix ensures that Internet Explorer loads the Arbortext Editor ActiveX control correctly during Back, Forward, and Refresh operations.
Embedding Arbortext Editor in a browser window using the object tag:
<html>
<body>
<p>Use Arbortext Editor to edit the sample document:</p>
<OBJECT classid="clsid:3990811F-C23D-448E-B893-54549C334960" height="200" width="400">
<PARAM NAME="SRC" VALUE="arbortext-editor-embed:http%3A%2F%2Fdocserver%2Fwebdav%2Fsample.xml"/>
</OBJECT>
</body>
</html>
When using the object tag, Internet Explorer displays a tool tip saying Press SPACEBAR or ENTER to activate and use this control. Before you can use Arbortext Editor, you must either click in the ActiveX control or press the SPACEBAR or ENTER keys.
* 
To get the ActiveX Arbortext Editor to work correctly using the object tag, a GUID (globally unique identifier) must be specified in the HTML markup using the classid attribute as follows:
classid="clsid:3990811F-C23D-448E-B893-54549C334960"
This GUID uniquely identifies the ActiveX control enabling Internet Explorer to load it.
If Arbortext Editor is not installed on the system, or is not registered for some reason, Internet Explorer displays a The page cannot be displayed error page for most of the preceding methods for loading the ActiveX control in a browser. However, when using the embedd or object tags, Internet Explorer displays an empty frame in this case.