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



©  Bricsys NV. All rights reserved.