invoke (External Interfaces/API)

Invoke a method on an object's interface and retrieve the return value of the method, if any, or display a list of methods.

Syntax

v = invoke (a [, 'methodname' [, arg1, arg2, ...]])

Arguments
a
An activex object previously returned from actxcontrol, actxserver, get, or invoke.

methodname
A string that is the name of the method to be invoked.

arg1, ..., argn
Arguments, if any, required by the method being invoked.

Returns

The value returned by the method or a list of methods (if you use the form invoke(a).) The data type of the value is dependent upon the specific method being invoked and is determined by the specific control or server. If the method returns an interface (described in ActiveX documentation as an interface, or an Idispatch *), this method will return a new MATLAB activex object that represents the interface returned. See Converting Data for a description of how MATLAB converts ActiveX data types.

Description

Invoke a method on an object's interface and retrieve the return value of the method, if any. (Some methods have no return value.)

Example

Invoke a method:

f = figure ('pos', [100 200 200 200]);
% create the control to fill the figure
h = actxcontrol ('MWSAMP.MwsampCtrl.1', [0 0 200 200], f)
set (h, 'Radius', 100);
v = invoke (h, 'Redraw')

Display a list of methods:

invoke(h)
AboutBox = Void AboutBox ()
ShowPropertyPage = Void ShowPropertyPage ()

get load