Function

Summary

Applies a function in the process associated with a pane.

Package

capi

Signature

apply-in-pane-process pane function &rest args => nil

Description

The function apply-in-pane-process applies function to args in the process that is associated with pane . This is required when function modifies pane or changes how it is displayed. If pane has not been displayed yet, then function is called immediately.

Notes

1. All accesses (reads as well as writes) on a pane should be performed in the pane's process. Within a callback on the pane's interface this happens automatically, but apply-in-pane-process is a useful utility in other circumstances.
2. apply-in-pane-process calls function on the current process if the pane's interface does not have a process.

Example

Editor commands must be called in the correct process:

(setq editor 

      (capi:contain

       (make-instance 'capi:editor-pane

                      :text "Once upon a time...")))

(capi:apply-in-pane-process 

 editor 'capi:call-editor editor "End Of Buffer")

(capi:apply-in-pane-process 

 editor 'capi:call-editor editor "Beginning Of Buffer")