The Edit OLE Container Dialog

The Edit OLE Container dialog can be displayed by

double clicking anywhere within an OLE/ActiveX form field object

selecting the OLE/ActiveX field and clicking on the "attribute edit" icon in the tool bar.

This dialog presents the current attributes of the OLE/ActiveX field. The dialog consists of three sections: Identification, Appearance, and Properties.

Identification Section

This section displays naming and other identifying information for the OLE/ActiveX form field object.

Field Name	This field contains the name of the OLE/ActiveX field. The Screen Painter automatically generates a unique name for it. This name can be maintained or changed, as long as the new name conforms to the Zim Object Naming Rules.
Form Name	This field contains the name of the form in which the OLE/ActiveX field was created. The field can be viewed by selecting it and scrolling left and right, but its value cannot be changed.
Directory	This field contains the name of the Zim directory that owns the form in which the OLE/ActiveX field was created. The field can be viewed by selecting it and scrolling left and right, but its value cannot be changed.
Field Number	This field contains an automatically generated identifying number for the OLE/ActiveX field. The value in this field can be used to identify the OLE/ActiveX field if it triggers a callback event. Refer to Form Fields and Callback Events for more detailed information about associating form fields with callback events. The value in this field can be changed and need not be unique.
Field Tag	This field contains an identifying text string for the OLE/ActiveX field. The value in this field can be used to identify the OLE/ActiveX field if it triggers a callback event. Refer to Form Fields and Callback Events for more detailed information about associating form fields with callback events. The value in this field can be changed and need not be unique. If left blank (the default), the value contained in Field Name is used for Field Tag.
Help Message	This field contains the text to display in a field of type "message" (if one exists in the form) when the OLE/ActiveX field receives the input focus. The message, which appears at the bottom left of this dialog is itself a "message" field, and the help message associated with each field in the dialog, is automatically displayed there when the field receives the input focus. If you intend to have a "message" field in your forms, then enter an appropriate help message text in this Help Message field.

Appearance Section

This section presents the display or appearance attributes of the OLE/ActiveX form field object. The Object Reference subsection permits the OLE/ActiveX object to be chosen.

Visible	This field determines if the OLE/ActiveX field is visible by default. The visibility attribute of all form fields other than labels and graphics can be dynamically modified under Zim program control.
Pointer Style	This field is used to select the pointer (or cursor) style to use when the pointer is over or in the OLE/ActiveX field if it is available. By default, the value is "default" which, for an OLE/ActiveX field, is the "Arrow" pointer style.
Select OLE Type	This field is used to select an OLE object or an ActiveX object.
Auto Size	This field is used to select from four different automatic image-sizing options. These are "Clip", "Stretch", "Default" and "Proportional". Refer to OLE Container Auto Size Options for more detailed information about the different automatic object sizing options.
Select Component / Select File To Link Button	Depending on the OLE Type that is currently selected, this push button invokes the Insert Component common dialog or the Select File To Link common dialog, and places the selected component or filename into the Object Name field.
Object Name	This field contains an ActiveX ProgId (unique component identifier) if the OLE Type is set to ActiveX and contains the name of the linked OLE Object otherwise.

Properties Section

This section presents the behavioral attributes of the OLE/ActiveX field.

Availability	This field determines the "availability" attribute of the OLE/ActiveX field. The values are "Available", "Unavailable", "Guarded" and "Protected".
Tab Stop	This field determines if the OLE/ActiveX field is included in the tab order. If cleared, the end-user cannot access this field by using the tab keys. The OLE/ActiveX field is still directly accessible by accelerator keys and the mouse.
Tab Index	This field contains a number that represents the relative position of the field in the tab sequence order. A value of zero (0) means use the tab sequence order as defined by the relative position of the field in the structure chart.

Dialog Push Buttons

OK	This push button performs any required data validation, commits any changes that were made in this dialog, and returns to the Screen Painter's layout mode.
Cancel	This push button discards any changes that were made in this dialog and returns to the Screen Painter's layout mode.
Help	This push button invokes the Zim Help facility, initially displaying the section entitled Edit OLE Container dialog (this section).
Options	This push button displays the OLE Container Options dialog that enables additional attributes of the OLE/ActiveX to be viewed and/or modified.