All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

NextPrevUpTopContentsIndex

record-dependent-object

unrecord-dependent-object

Functions
Summary

Register or unregister an object for destruction when a pinboard-layout is destroyed.

Package

capi

Signature

record-dependent-object pinboard-layout object

unrecord-dependent-object pinboard-layout object

Arguments

pinboard-layout

A pinboard-layout.

object

A Lisp object.

Description

The functions record-dependent-object and unrecord-dependent-object are part of a mechanism for destroying objects when a pinboard-layout is destroyed.

record-dependent-object records the object object , which means that when pinboard-layout is destroyed, destroy-dependent-object is applied to object .

unrecord-dependent-object removes object from the dependents, comparing objects by cl:equal.

It is possible to record the same object more than once. unrecord-dependent-object removes one occurrence of object at most. If there is no object, it does nothing.

Notes

These functions are not designed to deal with many calls to record-dependent-object and unrecord-dependent-object. If you need to deal with many objects, you can either use the destroy-callback of pinboard-layout (inherited from output-pane), or add a single object of your object type (class or structure) and define a destroy-dependent-object method for it that will deal with the many objects in an optimal way.

See also

destroy-dependent-object
pinboard-layout


CAPI User Guide and Reference Manual (Unix version) - 25 Feb 2015

NextPrevUpTopContentsIndex