vlr-owner-add
(vlr-owner-add objReactor object)
This function adds the object to the specified
objReactor ObjectReactor.
Arguments
|
objReactor
(object object VLR-Object-Reactor)
the reactor to add the specified object to
object (VLA-Object) specifies the object to be added to the
reactor
|
Return
|
object is returned
|
Example
|
(setq rx (vlr-object-reactor
nil nil '((:vlr-modified . cb))))
#<VLR-Object-Reactor>
(setq obj (vlax-ename->vla-object
(entlast))) #<VLA-OBJECT IAcadLine
00000000427C86C0>
(vlr-owner-add rx obj) #<VLA-OBJECT
IAcadLine 00000000427C86C0>
now the last added entity is also monitored by
"rx" object reactor
|
Remarks
|
Note 1 :
if many drawing objects (especially when of
same type, say entities) are to be monitored, it is more efficient
to use 1 reactor, and add all objects to be monitored to that
single object reactor instance;
using "1 reactor per 1 object" also works, but
causes significant overhead;
Note 2 :
do never assume a particular sequence of the
monitored objects - that sequence is based on internal sorting and
other handling
Note 3 :
as object reactor events are the most often
fired events, the implementation of the callback handler should be
as lightweight as possible, to prevent significant performance
impact
see also (vlr-owner-remove) and (vlr-owners) functions
|