Setting up the OLE control
Contents
When you create an OLE control and insert an object, PowerBuilder
activates the server application to allow you to modify the object.
After you deactivate it (by clicking outside the object’s borders in the
Layout view), you can use the control’s property sheets to set up the
control.
To specify the control’s appearance and behavior:
-
Double-click the control, or select Properties from the
control’s pop-up menu. -
In the Properties view, give the control a name that is
relevant to your application.You will use this name in scripts. The default name is
ole_ followed by a number. -
Specify a value for Display Name for use by the OLE server.
The OLE server can use this name in window title bars. -
Specify the control’s appearance and behavior by choosing
appropriate settings in the Properties view.In addition to the standard Visible, Enabled, Focus Rectangle,
and Border properties, which are available for most controls, there
are several options that control the object’s interaction with the
server:Option
Meaning
Activation
How the user activates the
control.Options are:
-
Double Click — When the user double-clicks the
control, the server application is activated. -
Get Focus — When the user clicks or tabs to the
control, the server is activated. If you also write a
script for the GetFocus event, do not call
MessageBox or any function that results in a change in
focus. -
Manual — The control can be activated only
programmatically with the Activate function.
The control can always be activated
programmatically, regardless of the Activation
setting.Display Type
What the control displays.
Options
are:-
Contents — Display a representation of the
object, reduced to fit within the control. -
Icon — Display the icon associated with the
data. This is usually an icon provided by the server
application. -
ActiveX document — Display as an ActiveX
document. ActiveX documents fill the space of the
container and have access to all the features of the
server application.
Contents
What the user can insert in the control at
runtime.Options are:
-
Any — The user can insert either a linked or
embedded object. -
Embedded — The user can insert an embedded
object. -
Linked — The user can insert a linked
object.
Setting Contents changes the value of
the ContentsAllowed property.Link Update
When the object in the control is linked, the
method for updating link information.Options
are:-
Automatic — If the link is broken and
PowerBuilder cannot find the linked file, it displays
a dialog box in which the user can specify the
file. -
Manual — If the link is broken, the object
cannot be activated. You can re-establish the link in
a script using the LinkTo or UpdateLinksDialog
function.
Setting Link Update changes the value
of the LinkUpdateOptions property.Size Mode
How the object is displayed in the
container.Options are:
-
Clip — The object’s image displays full size.
If it is larger than the OLE control, it is clipped by
the control’s borders. -
Stretch — The object’s image is resized to fit
into and fill the OLE control (default).
-