All Manuals > CAPI Reference Manual > 1 CAPI Reference Entries

NextPrevUpTopContentsIndex

execute-with-interface-if-alive

Function
Summary

Executes a function in the event process of a given interface if it is alive.

Package

capi

Signature

execute-with-interface-if-alive interface function &rest args => nil

Description

The function execute-with-interface-if-alive applies the function function to the arguments args in the process of the interface interface , if the interface is "alive". An interface is alive if it has a representation on the screen.

If interface is not alive, function is not applied. This is in contrast to execute-with-interface, which in this case applies the function in the current process.

execute-with-interface-if-alive is useful for automatic updating of interfaces that may be destroyed by the user, where the update is redundant if the interface is not alive.

Notes

All accesses (reads as well as writes) on a CAPI interface and its sub-elements should be performed in the interface process. Using execute-with-interface-if-alive is one way of ensuring this.

See also

apply-in-pane-process-if-alive
execute-with-interface


CAPI Reference Manual - 15 Dec 2011

NextPrevUpTopContentsIndex