Each
OLE object (except OLE controls) has a default action that it performs
when you double-click on it. For many objects, the default action
is
Edit (invoking a visual editing session
for OLE 2.0 or an open editing session for linked objects and all
OLE 1.0 objects). However, there are some objects for which the
Edit action is secondary (for example, a Media Clip
object, where
Play is the primary action).
Also, many objects have more than one action that they can perform,
so they understand more than one OLE verb. (Double-clicking on an
OLE object in BUILD: DISPLAY mode does not perform the default action,
but double-clicking on the object in TESTAF mode does.)
To access the menu of
OLE verbs for an OLE object in BUILD mode, click on the object with
the right
mouse button. The name of the OLE object is located at the bottom
of the pop-up menu. In the cascading menu, there is a list of valid
OLE verbs for the object. Select a verb from this menu to perform
that action. The default verb appears first in the list of verbs.
For example, a Microsoft
Excel object understands
Edit (for visual
editing) and
Open (for open editing). A Media
Clip object understands
Play and
Edit.
You can also access
the list of valid verbs by clicking on the
Associated
Verbs item in the Object Attributes dialog box for the
object. This list just contains the names of the verbs; you cannot
initiate the verbs from here. Again, the verb at the top of the list
is the default verb.
Using SCL, you can invoke
any verb that a particular OLE object understands by using the _EXECUTE_
method with the verb as an argument. For example, this code would
invoke the verb
Play on the OLE object
mediaobj:
call notify('mediaobj', '_EXECUTE_', 'Play');You can specify multiple
verbs in a single call to _EXECUTE_. For more information about the
_EXECUTE_ method, see
_EXECUTE_.