Version 6.3.8 for Windows
 —  Editors  —

Selecting an OLE Server or Document

If you select an OLE server or document, the three options "OLE server", "OLE object" and "Existing OLE object" imply a number of restrictions when using Natural and when using the server application.

This document covers the following topics:


Differences Between OLE Server, New OLE Object and Existing OLE Object

Before you select an entry, decide if this is what you need.

Type Characteristics
OLE Server Creates an OLE object in its native form. Either server with no content ("Create New") or server with existing file as content ("Create from File").
New OLE Object Creates a new OLE embedded object to be stored within the Natural environment (default file extension ".neo"). Only "Create New" allowed.
Existing OLE Object Creates an existing OLE embedded object that has been stored within the Natural environment (default file extension ".neo"). Only "Create from File" allowed.

Top of page

OLE Server

If you have selected the "OLE server" entry

  1. Select the "..." button to the right of the drop-down combo box.

    The "Select OLE Server or Document" dialog box appears. Here you have two options:

  2. Either select "Create New".

    Or select "Create from File".

    If you have selected "Create New", proceed with 3a.

    If you have selected "Create from File", proceed with 3b.

  3. 3a. - From the "Object Type" list box, select an application, for example "Microsoft Word 6.0 Document".

    3b. - In the file text box, enter the path of the file you want to select.

    Or, if you are not sure where the file is, choose the "Browse" button to search in your environment.

  4. Select the "Display as Icon" check box or not. This lets you decide whether you want to display your application or file as an application icon inside the OLE container control or whether you want your application or file to appear as a text string called <<applicationname>> or <<pathname>>. Both act as a placeholder for the server application.

    If you choose to display the application or file as an icon, you can customize the icon by selecting the "Change Icon..." button.

  5. To save your settings and quit the dialog box, select OK.

    Or select "Cancel" to quit without saving.

Start of instruction setTo edit an OLE object inside an OLE container control at runtime

Prerequisite: you have selected "OLE server".

  1. Select and hold down the right mouse button inside the OLE container control's rectangle.

    The pop-up menu specific to your server application appears, saying for example:

    Edit object-typeObject; or

    object-type Object with the submenus "Edit" and "Open".

    "Open" activates the server application in a separate window and enables you to edit and save the object. You can then quit the server application and return to Natural. "Edit" lets you activate the server application inside your Natural dialog.

  2. Make your selection in the pop-up menu.

  3. Edit (and save) your object using the menu entries provided by the OLE server application.

Start of instruction setTo quit the OLE server application at runtime

If you have chosen "Edit":

Start of instruction setTo quit the OLE server application at runtime

If you have chosen "Open":

Start of instruction setNew OLE Object

If you have selected the "New OLE object" entry, do the following:

  1. Select the "..." button to the right of the drop-down combo box.

    The "Select OLE Server or Document" dialog box appears. Important: Here you may only select "Create New", even though the other option is not disabled.

  2. Select "Create New".

  3. From the "Object Type" list box, select an application, for example "Microsoft Word 6.0 Document".

  4. Select the "Display as Icon" check box or not. This lets you decide whether you want to display your object as an application icon inside the OLE container control or whether you want your object to appear as a text string called <<applicationname>>.

    If you choose to display the application or file as an icon, you can customize the icon by selecting the "Change Icon..." button.

  5. To save your settings and quit the dialog box, select OK.

    Or select "Cancel" to quit without saving.

    You have returned to the attributes window. Note that your server's name now appears in the "Name" text box, prepended by an "@". This is the current value of the SERVER-PROGID attribute. The OK button is disabled. Instead, the "OK & Start Server" button is enabled.

  6. Ensure you have made all choices in the attributes window.

  7. Choose "OK & Start Server".

    Your attributes window settings are saved and the server application is started.

  8. Create your OLE object.

  9. Quit the server application. The server application usually provides the menu entries "File", then "Close and Return to container-application-name".

    A file list box called "Save As" appears.

  10. Save the file as a Natural embedded object with the default file extension ".neo".

Start of instruction setIf your end user has edited your new OLE object at runtime

  1. To edit it in-place, the server application provides additional entries to the Natural application's menu bar.

  2. To quit the server application, the server application usually provides the menu entries "File", then "Close and Return to container-application-name".

    Note:
    Depending on the server application, you might have to set the focus back to Natural as the server applications usually remain active.

    A file list box called "Save As" appears.

  3. The end user must save the file as a Natural embedded object with the default file extension ".neo".

Start of instruction setExisting OLE Object

If you have selected the "Existing OLE object" entry:

  1. Select the "..." button to the right of the drop-down combo box.

    The "Select existing Natural Embedded Object" dialog box appears. It displays all Natural embedded objects with the default file extension ".neo" in the default directory.

  2. Select a file.

    Both the OK and the "OK & Start Server" buttons are enabled. You now have two options:

  3. Choose "OK & Start Server".

    Or choose OK.

    Your attributes window settings are saved and the server application is started.

  4. Modify your OLE object (if you have chosen "OK & Start Server" and the object is read-write).

    Or look at your OLE object (if you have chosen OK and the object is read-only).

  5. Quit the server application. The server application usually provides the menu entries "File", then "Close and Return to container-application-name".

    A file list box called "Save As" appears.

  6. If you confirm the default, the file is automatically saved as a Natural embedded object with the default file extension ".neo".

Top of page