Marvin OLE User's Guide

Introduction
Install and Uninstall
How to Use
Known Issues

Introduction

Marvin OLE is the ChemAxon solution for Microsoft's Object Linking and Embedding (OLE) technology. It is supported by Windows operating systems. Marvin OLE offers an easy way to embed Marvin Sketch drawings into other applications, like Microsoft Office Family products. Embedded Marvin Documents can be edited in-place with a fully functional Marvin Sketch.

Word Documents, Excel Sheets, and many more other files containing embedded Marvin Documents are easily distributable. Even people who do not have Marvin and JChem_NET_API installed can access the content as an image, however, to edit the Marvin Document itself, they must have a properly installed Marvin with OLE support.

Install and Uninstall

Installation

The OLE server is bundled in JChem_NET_API installer, when JChem_NET_API is installed it automatically register OLE server too. Administrator privileges are required for the installation since the installer writes the Windows registry. OLE server does not require present of Marvin Beans package. If it is not available it uses the .NET version of MarvinSketch (that is also part of the JChem_NET_API as the OLE server OLE server). If Marvin Beans package has been installed, OLE server prefers the Java based Marvin by editing OLE objects.

When you install Java based Marvin Beans package, the installer strores a reference in the Windows registry about the location of the MarvinSketch application. OLE server check this reference when try to look-up it.

The Marvin Beans installer also includes the JChem_NET_API.msi file and launch it automatically during the installation process. It means that you do not have to download or register any extra resources to setup OLE server since installer does it automatically.

If you do not use Marvin Beans installer but you need both Marvin and OLE server, you have to do the followings:

Download marvinbeans-VERSION.zip and JChem_NET_API-VERSION.msi
Unwrap the marvinbeans-VERSION.zip.
Launch the downloaded JChem_NET_API installer in administrator mode.
Run installole.bat in administrator mode with the following parameters from the lib folder of the Marvin Beans package to register the location of Marvin Beans package for the OLE server.
```
installole.bat /c "MARVINHOME\lib" MARVIN_VERSION
```
where MARVINHOME is the absolute path of target directory where Marvin has been installed to and MARVIN_VERSION is the version id of Marvin release. E.g.:
```
installole.bat /c "C:\Program Files\ChemAxon\MarvinBeans\lib" 5.3.4
```

If installation has been successful, you will find OLE Server resource in the C:\Program Files\ChemAxon\Shared\MarvinOLE folder.

Uninstallation

When you uninstall JChem_NET_API, OLE server is also unregistered and the C:\Program Files\ChemAxon\Shared folder is also deleted (where OLE server resources was stored).

In this case, Marvin OLE support will not be available for Marvin.

When you uninstall Marvin Beans package, JChem_NET_API uninstaller is also invoked unless other products still keep reference to it.

Of course, uninstallation also requests administration privileges.

Administrator privileges

Windows 2000/XP: Most users have got administrator privileges in default (unless the system administrator restricts it). If you have got full control on your machine (install anything freely), you have administrator rights. In this case, installer/uninstaller will run definitely with admin privileges.

Windows Vista: Vista security policy is more strict than earlier Windows versions. If a user has got administrator rights, it does not mean that he can run everything with these privileges. In default, all programs run without extra rights. To run a program with administrator privileges, you have to select Run As Administrator by launching (right-click on the icon of the application and choose Run As Administrator option). After selecting this option, Vista will ask for confirmation to run the application with high privileges, click Allow. The application will run in admin mode.

Although ChemAxon installer/uninstaller does not require admin rights, it detects the highest running level and tries to run in administrator mode automatically (if it is possible). If the installer has got the proper rights, it does registration/unregistration of OLE server in the background during the (un)installation process.

How to Use

Simply select your drawing, or any part of it and copy it to clipboard (Ctrl+c). The selection can be pasted into any OLE-capable application, like Microsoft Office Family (if OLE support is enabled).

This feature also works in a reversed way: select an embedded Marvin OLE document from your Excel Sheet or Word Document, copy to the clipboard (Ctrl+c), then use the paste function (Ctrl+v) at your MarvinSketch to retrieve the structure.

IF OLE copy does not work for you, please check the followings:

Make sure JChem_NET_API is installed on your machine. (If you open Add/Remove Programs section in Control Panel, you can check easily whether the required component is in the list.
Open the C:\Program Files\ChemAxon\Shared\MarvinOLE folder to check whether OLE server exe is there.
Check whether the OLE copy option is enabled in the Copy As dialog in the Edit menu of Marvin. If not, OLE server is not registered. Uninstalling and reinstalling JChem_NET_API can help in this case.

Customize Marvin OLE editing mode

When you would like to editing Marvin OLE object in an MS-Office document, MarvinSketch can be opened by a couple of ways depend on the configuration of the OLE server.

In default, editor displays by embedding into the MS-Office application when OLE object is edited. If you would like to see MarvinSketch in a standalone window by editing OLE object, you have to modify OLE server settings in the registry.

In the C:\Program Files\ChemAxon\Shared\Marvin OLE folder, you will find various reg file that can help you to modify registry:

StandaloneModeForAdministrators.reg: this registry file is defined for administrators to deploy Stand Alone Mode data editing company wide as default for all users. This setting cannot be applied by restricted users since targeting to change a global part of the registry database. This global setting can be overriden by each user individually with running the following scripts (StandaloneModeOn and StandaloneModeOff).
StandaloneModeOn.reg: this registry file is for restricted users to influence the global setting of default editing mode. If this script is run OLE is going to switch to Stand Alone Mode editing as default. In-place mode optionally is still available from context menu in every Office application if the user selects Edit on MarvinOLE document menu point.
StandaloneModeOff.reg: this registry file is to reset the default approach of data editing (as is after installation) when in-place mode is the default data editing mode in the container applications.

Just install the desired regfile to modify the edit settings of OLE server.

Installation of a regfile

Navigate into the directory in file Explorer where the desired regfile is located and take a right mouse-click on the file.
Select Open With... option from the popup menu. If regedit.exe is available in the list, select it. If not, commit the Browse button in the Open With dialog and find regedit.exe to select it. In default, it is located in the C:\Windows folder.
After selecting regedit.exe, submit the Open With dialog to run desired regfile with regedit.exe.

Known Issues

Word Pad pops up a dialog indicating that Marvin OLE Server is not responding while inserting a new Marvin Document, or editing an exisiting one with MarvinSketch. This causes no harm or data loss, it is an invalid error message fired by Word Pad. After you complete the drawing process, and close MarvinSketch, press 'Retry' to close the dialog.

Open Office: Although Open Office is not supported, this OLE solution works partially on that platform. The following issues are known: copy from Open Office into Marvin does not work; the image of the embedded structure is not refreshed after editing without saving the whole office document.