capi-object-property

capi-object-property Accessor

Summary

Accesses properties in the property list of a capi-object.

Package

capi

Signature

capi-object-property object property => value

setf (capi-object-property object property) value => value

Arguments

`object`⇩	A capi-object.
`property`⇩	A Lisp object.
`value`⇩	A Lisp object.

Values

value⇩

A Lisp object.

Description

The accessor capi-object-property gets and sets the property named property in the property list of object. value can be any Lisp object.

All CAPI objects contain a property list, similar to the plist of a symbol. The recommended ways of accessing properties are capi-object-property and (setf capi-object-property). To remove a property, use the function remove-capi-object-property.

Examples

In this example a list panel is created, and a test property is set and examined using capi-object-property.

(setq pane (make-instance 'capi:list-panel
                          :items '(1 2 3)))
 
(capi:capi-object-property pane 'test-property)
 
(setf (capi:capi-object-property pane 'test-property)
      "Test")
(capi:capi-object-property pane 'test-property)
 
(capi:remove-capi-object-property pane 'test-property)
(capi:capi-object-property pane 'test-property)