LispWorks COM/Automation User Guide and Reference Manual > 4 Automation Reference Entries

NextPrevUpTopContentsIndex

call-dispatch-get-property

Macro
Summary

Calls an Automation property getter method from a particular interface.

Package

com

Signature

call-dispatch-get-property spec arg * => values

spec ::= ( dispinterface-ptr dispinterface-name method-name )

Arguments

spec

The interface pointer and a specification of the method to be called.

dispinterface-ptr

A form which is evaluated to yield a COM i-dispatch interface pointer.

dispinterface-name

A symbol which names the Automation interface. It is not evaluated.

method-name

A symbol which names the property getter method. It is not evaluated.

arg

Arguments to the method (see Data conversion when calling Automation methods for details).

Values

values

Values from the method (see Data conversion when calling Automation methods for details).

Description

The call-dispatch-get-property macro is used to invoke an Automation property getter method from Lisp. The dispinterface-ptr should be a COM interface pointer for the i-dispatch interface. The appropriate Automation property getter method, chosen using dispinterface-name and method-name , is invoked after evaluating each arg . The arg s must be values that are suitable for the method and of types compatible with Automation. The values returned are as specified by the method signature. In general, property getter methods take no arguments and return the value of the property, but see Data conversion when calling Automation methods for more details.

There is also setf expander for call-dispatch-get-property , which can be used as an alternative to the call-dispatch-put-property macro.

Example

For example, in order to get and set the Width property of a MyDocument interface pointer

(call-dispatch-get-property
   (doc my-document width))
(setf (call-dispatch-get-property
         (doc my-document width))
      10)
See also

call-dispatch-put-property
call-dispatch-method


LispWorks COM/Automation User Guide and Reference Manual - 22 Dec 2009

NextPrevUpTopContentsIndex