vlr-xref-reactor

(vlr-xref-reactor customData callbackList)

This function creates and attaches a Xref operation reactor to the current drawing, for the command events specified by callbackList.

Arguments

customData (any valid Lisp data) custom data to be associated with the reactor object, can be NIL
callbackList (list) list of DottedPair entries, each DottedPair has the form
(event . callback)

event : one of these symbolic constants

	:VLR-beginAttach	an xref drawing is about to be attached
	:VLR-otherAttach	an xref database is being added to this database
	:VLR-endAttach	the xref attach operation has been finished
	:VLR-abortAttach	the xref attach operation has been aborted
	:VLR-redirected	an ObjectId inside the xref database has been modified to reference the associated object in host drawing
	:VLR-comandeered	an ObjectId inside the xref database has been appended to a SymbolTable in the host drawing
	:VLR-beginRestore	an existing xref is about to be restored (resolved)
	:VLR-endRestore	an existing xref has been restored (resolved)
	:VLR-abortRestore	restore/resolve operation of an existing xref has been aborted
	:VLR-xrefSubcommandAttachItem	the XRef sub-command "Attach" has been started
	:VLR-xrefSubcommandOverlayItem	the XRef sub-command "Overlay" has been started
	:VLR-xrefSubcommandBindItem	the XRef sub-command "Bind" has been started
	:VLR-xrefSubcommandDetachItem	the XRef sub-command "Detach" has been started
	:VLR-xrefSubcommandPathItem	the XRef sub-command "Path" has been started
	:VLR-xrefSubcommandReloadItem	the XRef sub-command "Reload" has been started
	:VLR-xrefSubcommandUnloadItem	the XRef sub-command "Unload" has been started

callback : the client Lisp side callback function, using 2 arguments :
(defun MyCB ( reactor args / ...) ...)

reactor : the xref reactor object - #<VLR-Xref-Reactor>
args : (list) contains 1 or more arguments depending on the particular event :

	:VLR-beginAttach	3 arguments : 1st argument : target database (VLA-Object) 2nd argument : (string) file name of the xref dwg 3rd argument : source database (VLA-Object), of the xref dwg database
	:VLR-otherAttach	2 arguments : 1st argument : target database (VLA-Object) 2nd argument : source database (VLA-Object), of the xref dwg database
	:VLR-endAttach	1 argument :target database (VLA-Object)
	:VLR-abortAttach	1 argument : source database (VLA-Object), of the xref dwg database
	:VLR-redirected	2 arguments : 1st argument : (integer) the ObjectId inside target/host database 2nd argument : (integer) the ObjectId inside source database
	:VLR-comandeered	3 arguments : 1st argument : target database (VLA-Object) 2nd argument : (integer) the ObjectId inside source database 3rd argument : source database (VLA-Object), of the xref dwg database
	:VLR-beginRestore	3 arguments : 1st argument : target database (VLA-Object) 2nd argument : (string) the name of the xref BlockTableRecord 3rd argument : source database (VLA-Object), of the xref dwg database
	:VLR-endRestore :VLR-abortRestore	1 argument :target database (VLA-Object)
	:VLR-xrefSubcommandAttachItem :VLR-xrefSubcommandOverlayItem	2 arguments : 1st argument : (integer) specifies the "Attach/Bind/Detach operation mode" (see below) 2nd argument : (string) the file name being affected, or NIL, if not appropriate
	:VLR-xrefSubcommandBindItem	2 arguments : 1st argument : (integer) specifies the "Attach/Bind/Detach operation mode" (see below) 2nd argument : (integer) ObjectId of the xref being bound, or 0, if not appropriate
	:VLR-xrefSubcommandDetachItem	2 arguments : 1st argument : (integer) specifies the "Attach/Bind/Detach operation mode" (see below) 2nd argument : (integer) ObjectId of the xref being detached, or 0, if not appropriate
	:VLR-xrefSubcommandPathItem	3 arguments : 1st argument : (integer) specifies the "Attach/Bind/Detach operation mode" (see below) 2nd argument : (integer) ObjectId of the xref being changed, or 0, if not appropriate 3rd argument : (string) new path name of the xref
	:VLR-xrefSubcommandReloadItem :VLR-xrefSubcommandUnloadItem	2 arguments : 1st argument : (integer) specifies the "Attach/Bind/Detach operation mode" (see below) 2nd argument : (integer) ObjectId of the xref being affected, or 0, if not appropriate

Return

the reactor object #<VLR-Xref-Reactor> or NIL

Example

Remarks

"Attach/Bind/Detach operation mode" values :

	0	BIND operation started
	2	xref is about to be bound
	3	xref has been successfully bound
	4	BIND operation finished
	5	BIND operation is about to fail or abort
	6	BIND operation has failed or was aborted
	7	XBind operation for an xref-dependent block
	8	other object types affected : layers, linetypes, text and dimension styles, and similar