第11章 使用反應(yīng)器清華CAD二次開發(fā) LISP

1、第第 11 章章 使用反應(yīng)器使用反應(yīng)器 11.1 反應(yīng)器反應(yīng)器 反應(yīng)器是一種反饋機(jī)制，它可以在發(fā)生某些特定事件時，反應(yīng)器是一種反饋機(jī)制，它可以在發(fā)生某些特定事件時，將所發(fā)生的事件通知給應(yīng)用程序，應(yīng)用程序?qū)鶕?jù)發(fā)生的具將所發(fā)生的事件通知給應(yīng)用程序，應(yīng)用程序?qū)鶕?jù)發(fā)生的具體事件做出相應(yīng)的決策。例如，在某個圖元上鏈接了一個反應(yīng)體事件做出相應(yīng)的決策。例如，在某個圖元上鏈接了一個反應(yīng)器，如果用戶移動這個圖元，應(yīng)用程序就會接到反應(yīng)器的通知，器，如果用戶移動這個圖元，應(yīng)用程序就會接到反應(yīng)器的通知，知道了該圖元被移動這個事件，如果需要，應(yīng)用程序可以用適知道了該圖元被移動這個事件，如果需要，應(yīng)用程序可以用適

2、當(dāng)?shù)膭幼鳎ㄈ缫苿优c該圖元相關(guān)的其它圖元，或顯示有關(guān)信息當(dāng)?shù)膭幼鳎ㄈ缫苿优c該圖元相關(guān)的其它圖元，或顯示有關(guān)信息等）響應(yīng)該通知。等）響應(yīng)該通知。1. 1. 反應(yīng)器的類型反應(yīng)器的類型 反應(yīng)器有多種類型，每種反應(yīng)器對應(yīng)一個或多個反應(yīng)器有多種類型，每種反應(yīng)器對應(yīng)一個或多個AutoCADAutoCAD事事件。反應(yīng)器可以分為以下幾個大類：件。反應(yīng)器可以分為以下幾個大類： l l 數(shù)據(jù)庫反應(yīng)器：當(dāng)圖形數(shù)據(jù)庫發(fā)生特定類型的事件時，該數(shù)據(jù)庫反應(yīng)器：當(dāng)圖形數(shù)據(jù)庫發(fā)生特定類型的事件時，該反應(yīng)器將通知應(yīng)用程序。反應(yīng)器將通知應(yīng)用程序。 l l文檔反應(yīng)器：當(dāng)前圖形文檔發(fā)生改變（如打開新的圖形文檔、文檔反應(yīng)器：當(dāng)前圖形文檔發(fā)

3、生改變（如打開新的圖形文檔、激活其它文檔窗口、改變文檔的鎖定狀態(tài)等）時，該反應(yīng)器將激活其它文檔窗口、改變文檔的鎖定狀態(tài)等）時，該反應(yīng)器將通知應(yīng)用程序。通知應(yīng)用程序。 l l編輯器反應(yīng)器：在調(diào)用編輯器反應(yīng)器：在調(diào)用AutoCADAutoCAD命令（如打開圖形、關(guān)閉圖命令（如打開圖形、關(guān)閉圖形、保存圖形、輸入輸出形、保存圖形、輸入輸出DXFDXF文件、改變系統(tǒng)變量的值等）時，文件、改變系統(tǒng)變量的值等）時，該反應(yīng)器將通知應(yīng)用程序。該反應(yīng)器將通知應(yīng)用程序。 l l 鏈接反應(yīng)器：當(dāng)加載和卸載鏈接反應(yīng)器：當(dāng)加載和卸載ARXARX應(yīng)用程序時，該反應(yīng)器將通應(yīng)用程序時，該反應(yīng)器將通知應(yīng)用程序。知應(yīng)用程序。 l

4、l對象反應(yīng)器：當(dāng)特定對象（對象反應(yīng)器：當(dāng)特定對象（AutoCADAutoCAD圖元）被修改、復(fù)制或圖元）被修改、復(fù)制或刪除時，該反應(yīng)器將通知應(yīng)用程序。刪除時，該反應(yīng)器將通知應(yīng)用程序。 調(diào)用函數(shù)調(diào)用函數(shù)vlr-typesvlr-types可返回反應(yīng)器類型的完整列表。表可返回反應(yīng)器類型的完整列表。表11-111-1列列出了出了AutoCADAutoCAD反應(yīng)器類型及其標(biāo)識符。反應(yīng)器類型及其標(biāo)識符。表表11-1AutoCAD11-1AutoCAD反應(yīng)器類型及其標(biāo)識符反應(yīng)器類型及其標(biāo)識符 反應(yīng)器類型的標(biāo)識符反應(yīng)器類型的標(biāo)識符 說明說明:VLR-AcDb-Reactor :VLR-AcDb-Reacto

5、r 數(shù)據(jù)庫反應(yīng)器數(shù)據(jù)庫反應(yīng)器:VLR- DocManager- Reactor :VLR- DocManager- Reactor 文檔管理反應(yīng)器文檔管理反應(yīng)器:VLR-Editor- Reactor :VLR-Editor- Reactor 通用編輯器反應(yīng)器通用編輯器反應(yīng)器:VLR-Linker- Reactor :VLR-Linker- Reactor 鏈接反應(yīng)器鏈接反應(yīng)器:VLR-Object- Reactor :VLR-Object- Reactor 對象反應(yīng)器對象反應(yīng)器 其中通用編輯器反應(yīng)器被進(jìn)一步細(xì)分為更加明確的幾種反應(yīng)器類型，其中通用編輯器反應(yīng)器被進(jìn)一步細(xì)分為更加明確的幾種反應(yīng)器

6、類型，見表見表11-211-2。表。表11-111-1中的通用編輯器反應(yīng)器類型只是為了向后兼容才保留的，中的通用編輯器反應(yīng)器類型只是為了向后兼容才保留的，表表11-211-2所示的各種編輯類型的反應(yīng)器不能被通用編輯器所示的各種編輯類型的反應(yīng)器不能被通用編輯器 :VLR-Editor-:VLR-Editor-ReactorReactor引用。引用。 表表11-2 11-2 編輯類型的各種反應(yīng)器及其標(biāo)識符編輯類型的各種反應(yīng)器及其標(biāo)識符 反應(yīng)器類型的標(biāo)識符反應(yīng)器類型的標(biāo)識符 說明說明:VLR-Command-Reactor :VLR-Command-Reactor 通報命令事件通報命令事件:VLR-

7、DeepClone-Reactor :VLR-DeepClone-Reactor 通報通報 deep clone deep clone 事件事件:VLR-DWG-Reactor :VLR-DWG-Reactor 通報打開或關(guān)閉圖形文件的事件通報打開或關(guān)閉圖形文件的事件:VLR-DXF-Reactor :VLR-DXF-Reactor 通報和讀寫通報和讀寫 DXF DXF 文件相關(guān)的事件文件相關(guān)的事件:VLR-Insert-Reactor :VLR-Insert-Reactor 通報和插入塊有關(guān)的事件通報和插入塊有關(guān)的事件:VLR-Lisp-Reactor :VLR-Lisp-Reactor 通

8、報通報 LISP LISP 事件事件:VLR-Miscellaneous-Reactor :VLR-Miscellaneous-Reactor （表中未列出的）其它編輯器反應(yīng)器類型（表中未列出的）其它編輯器反應(yīng)器類型:VLR-Mouse-Reactor :VLR-Mouse-Reactor 通報鼠標(biāo)事件（例如雙擊）通報鼠標(biāo)事件（例如雙擊）:VLR-SysVar-Reactor :VLR-SysVar-Reactor 通報對系統(tǒng)變量的修改通報對系統(tǒng)變量的修改:VLR-Toolbar-Reactor :VLR-Toolbar-Reactor 通報對工具欄上位圖的修改通報對工具欄上位圖的修改:VLR

9、-Undo-Reactor :VLR-Undo-Reactor 通報通報 undo undo 事件事件:VLR-Wblock-Reactor :VLR-Wblock-Reactor 通報和寫塊有關(guān)的事件通報和寫塊有關(guān)的事件:VLR-Window-Reactor :VLR-Window-Reactor 通報和移動或改變通報和移動或改變AutoCADAutoCAD窗口大小的事件窗口大小的事件:VLR-XREF-Reactor :VLR-XREF-Reactor 通報附著或修改通報附著或修改 XREF XREF 有關(guān)的事件有關(guān)的事件3. 3. 反應(yīng)器回調(diào)事件反應(yīng)器回調(diào)事件 大部分大部分AutoCAD

10、AutoCAD操作都會產(chǎn)生一些特定的事件，這些事件能夠操作都會產(chǎn)生一些特定的事件，這些事件能夠用來觸發(fā)反應(yīng)器的動作，這樣的事件被稱為回調(diào)事件。例如，當(dāng)用來觸發(fā)反應(yīng)器的動作，這樣的事件被稱為回調(diào)事件。例如，當(dāng)發(fā)出發(fā)出SaveSave命令保存圖形時，將會發(fā)生命令保存圖形時，將會發(fā)生AutoCAD保存圖形文件保存圖形文件（:vlr-beginSave:vlr-beginSave）的事件，當(dāng)保存過程結(jié)束時，將會發(fā)生）的事件，當(dāng)保存過程結(jié)束時，將會發(fā)生AutoCAD已將當(dāng)前圖形保存到磁盤（已將當(dāng)前圖形保存到磁盤（:vlr-saveComplete:vlr-saveComplete）的事）的事件。設(shè)計基于

11、反應(yīng)器的應(yīng)用程序就是根據(jù)回調(diào)事件的內(nèi)容編寫這件。設(shè)計基于反應(yīng)器的應(yīng)用程序就是根據(jù)回調(diào)事件的內(nèi)容編寫這些事件發(fā)生時所要激活的函數(shù)。些事件發(fā)生時所要激活的函數(shù)。 vlr-reaction-namesvlr-reaction-names函數(shù)返回與給定反應(yīng)器類型相關(guān)的所有函數(shù)返回與給定反應(yīng)器類型相關(guān)的所有事件組成的表：事件組成的表： (vlr-reaction-names reactor-type)(vlr-reaction-names reactor-type) 參數(shù)參數(shù)reactor-typereactor-type是反應(yīng)器類型的標(biāo)識，見表是反應(yīng)器類型的標(biāo)識，見表11-111-1和表和表11-21

12、1-2。例如，下列代碼將返回和圖形反應(yīng)器相關(guān)的所有事件組成的表：例如，下列代碼將返回和圖形反應(yīng)器相關(guān)的所有事件組成的表：(vlr-reaction-names :VLR-DWG-Reactor)(vlr-reaction-names :VLR-DWG-Reactor)返回返回(:VLR-beginDwgOpen :VLR-endDwgOpen :VLR-dwgFileOpened :VLR-(:VLR-beginDwgOpen :VLR-endDwgOpen :VLR-dwgFileOpened :VLR-databaseConstructed :VLR-databaseToBeDestroy

13、ed :VLR-databaseConstructed :VLR-databaseToBeDestroyed :VLR-beginSave :VLR-saveComplete :VLR-beginClose) beginSave :VLR-saveComplete :VLR-beginClose) 下列代碼將返回和對象反應(yīng)器相關(guān)的所有事件組成的表：下列代碼將返回和對象反應(yīng)器相關(guān)的所有事件組成的表：(vlr-reaction-names :vlr-object-reactor)(vlr-reaction-names :vlr-object-reactor); ;返回返回(:VLR-cancell

14、ed :VLR-copied :VLR-erased :VLR-unerased :VLR-(:VLR-cancelled :VLR-copied :VLR-erased :VLR-unerased :VLR-goodbye :VLR-openedForModify :VLR-modified :VLR-goodbye :VLR-openedForModify :VLR-modified :VLR-subObjModified :VLR-modifyUndone :VLR-modifiedXData :VLR-subObjModified :VLR-modifyUndone :VLR-modi

15、fiedXData :VLR-unappended :VLR-reappended :VLR-objectClosed)unappended :VLR-reappended :VLR-objectClosed) 加載并運(yùn)行以下代碼，將會打印出所有相關(guān)反應(yīng)器事件的列表（按反應(yīng)加載并運(yùn)行以下代碼，將會打印出所有相關(guān)反應(yīng)器事件的列表（按反應(yīng)器類型排序）。器類型排序）。(defun print-reactors-and-events ()(defun print-reactors-and-events () (foreach rtype (vlr-types) (foreach rtype (vlr-

16、types) (princ (strcat n (vl-princ-to-string rtype) (princ (strcat n (vl-princ-to-string rtype) (foreach rname (vlr-reaction-names rtype) (foreach rname (vlr-reaction-names rtype) (princ (strcat nt (vl-princ-to-string rname) (princ (strcat nt (vl-princ-to-string rname) (princ) (princ) ) AutoLISP Refe

17、rence AutoLISP Reference列出了與各種反應(yīng)器類型相關(guān)的所有事件，有關(guān)信列出了與各種反應(yīng)器類型相關(guān)的所有事件，有關(guān)信息在創(chuàng)建反應(yīng)器的函數(shù)部分做了說明。息在創(chuàng)建反應(yīng)器的函數(shù)部分做了說明。 和和ActiveXActiveX一樣，必須首先調(diào)用一樣，必須首先調(diào)用vl-load-comvl-load-com函數(shù)，加載支持反應(yīng)器和其函數(shù)，加載支持反應(yīng)器和其它它AutoLISPAutoLISP擴(kuò)展函數(shù)之后，才能實(shí)現(xiàn)反應(yīng)器的功能。擴(kuò)展函數(shù)之后，才能實(shí)現(xiàn)反應(yīng)器的功能。11.2 11.2 定義反應(yīng)器的回調(diào)函數(shù)定義反應(yīng)器的回調(diào)函數(shù) 反應(yīng)器的回調(diào)函數(shù)就是回調(diào)事件發(fā)生時所要執(zhí)行的函數(shù)。反反應(yīng)器的回調(diào)

18、函數(shù)就是回調(diào)事件發(fā)生時所要執(zhí)行的函數(shù)。反應(yīng)器的回調(diào)函數(shù)是用應(yīng)器的回調(diào)函數(shù)是用AutoLISPAutoLISP定義的。編寫回調(diào)函數(shù)有以下一定義的。編寫回調(diào)函數(shù)有以下一些限制：些限制： 不能使用不能使用commandcommand函數(shù)調(diào)用函數(shù)調(diào)用AutoCADAutoCAD命令，只能用命令，只能用ActiveXActiveX函數(shù)訪問圖形對象。函數(shù)訪問圖形對象。 不能使用不能使用entgetentget和和entmodentmod函數(shù)。函數(shù)。 不能使用選擇集操作函數(shù)。不能使用選擇集操作函數(shù)。 不能使用交互輸入函數(shù)。不能使用交互輸入函數(shù)。 在事件處理函數(shù)中不要加載警告和信息之外的對話框。在事件處理函數(shù)

19、中不要加載警告和信息之外的對話框。 定義對象反應(yīng)器回調(diào)函數(shù)和定義其它反應(yīng)器的回調(diào)函數(shù)也定義對象反應(yīng)器回調(diào)函數(shù)和定義其它反應(yīng)器的回調(diào)函數(shù)也不完全相同。不完全相同。11.2.1 11.2.1 定義對象反應(yīng)器的回調(diào)函數(shù)定義對象反應(yīng)器的回調(diào)函數(shù)定義對象反應(yīng)器的回調(diào)函數(shù)的格式如下：定義對象反應(yīng)器的回調(diào)函數(shù)的格式如下： (defun function (notifier-object reactor-object (defun function (notifier-object reactor-object parameter-list)parameter-list) )參數(shù)參數(shù)notifier-obje

20、ctnotifier-object是事件發(fā)生的對象。是事件發(fā)生的對象。參數(shù)參數(shù)reactor-objecreactor-objec是調(diào)用這個函數(shù)的反應(yīng)器對象。是調(diào)用這個函數(shù)的反應(yīng)器對象。參數(shù)參數(shù)parameter-listparameter-list是回調(diào)事件返回的回調(diào)數(shù)據(jù)表。是回調(diào)事件返回的回調(diào)數(shù)據(jù)表。 例如，例例如，例11-111-1定義了名為定義了名為print-radiusprint-radius的回調(diào)函數(shù)。的回調(diào)函數(shù)。notifier-objectnotifier-object是事件發(fā)生的對象，是事件發(fā)生的對象，reactor-objectreactor-object是調(diào)用是調(diào)用這個

21、函數(shù)的反應(yīng)器對象，這個函數(shù)的反應(yīng)器對象，parameter-listparameter-list是回調(diào)事件返回的回是回調(diào)事件返回的回調(diào)數(shù)據(jù)表。雖然在本例并不關(guān)心調(diào)數(shù)據(jù)表。雖然在本例并不關(guān)心parameter-listparameter-list的值，但定義的值，但定義回調(diào)函數(shù)時，也要進(jìn)行變量聲明?；卣{(diào)函數(shù)時，也要進(jìn)行變量聲明?！纠?1-111-1】定義名字為定義名字為print-radiusprint-radius的回調(diào)函數(shù)，該函數(shù)用來打的回調(diào)函數(shù)，該函數(shù)用來打印圓的半徑。印圓的半徑。(defun print-radius (notifier-object reactor-object pa

22、rameter-list)(defun print-radius (notifier-object reactor-object parameter-list) (vl-load-com) (vl-load-com) (cond (cond (vlax-property-available-p notifier-object Radius)(vlax-property-available-p notifier-object Radius) ；判斷該；判斷該圖形對象是否具有圖形對象是否具有radiusradius特性特性 (princ (princ “這個圓的半徑是：這個圓的半徑是： ) (pr

23、inc (vla-get-radius notifier-object) (princ (vla-get-radius notifier-object) ) ) ) ) )11.2.2 11.2.2 定義其它反應(yīng)器的回調(diào)函數(shù)定義其它反應(yīng)器的回調(diào)函數(shù) 由于其它反應(yīng)器不需要鏈接到由于其它反應(yīng)器不需要鏈接到AutoCADAutoCAD圖元上，因此定義其它圖元上，因此定義其它反應(yīng)器的回調(diào)函數(shù)只需要以下兩個參數(shù)：反應(yīng)器的回調(diào)函數(shù)只需要以下兩個參數(shù)：(defun function(reactor-object parameter-list)(defun function(reactor-object pa

24、rameter-list) )參數(shù)參數(shù)reactor-objectreactor-object是調(diào)用這個函數(shù)的反應(yīng)器對象。是調(diào)用這個函數(shù)的反應(yīng)器對象。參數(shù)參數(shù)parameter-listparameter-list是回調(diào)事件返回的回調(diào)數(shù)據(jù)表。是回調(diào)事件返回的回調(diào)數(shù)據(jù)表。例例11-211-2定義了名為定義了名為saveDrawingInfosaveDrawingInfo的回調(diào)函數(shù)。參數(shù)的回調(diào)函數(shù)。參數(shù)calling-calling-reactorreactor是調(diào)用該函數(shù)的反應(yīng)器對象。參數(shù)是調(diào)用該函數(shù)的反應(yīng)器對象。參數(shù)commandInfocommandInfo是回調(diào)是回調(diào)事件返回的回調(diào)數(shù)據(jù)表。

25、該函數(shù)在發(fā)生保存事件返回的回調(diào)數(shù)據(jù)表。該函數(shù)在發(fā)生保存AutoCADAutoCAD圖形的事件圖形的事件時將被激活，顯示文件的路徑和大小等信息。時將被激活，顯示文件的路徑和大小等信息。 【例例11-211-2】定義名字為定義名字為saveDrawingInfosaveDrawingInfo的回調(diào)函數(shù)。的回調(diào)函數(shù)。(defun saveDrawingInfo(calling-reactor commandInfo / dwgname (defun saveDrawingInfo(calling-reactor commandInfo / dwgname filesize)filesize) (vl

26、-load-com) (vl-load-com) (setq dwgname (cadr commandInfo) filesize (vl-file-size (setq dwgname (cadr commandInfo) filesize (vl-file-size dwgname)dwgname) (alert(strcat (alert(strcat 這個文件（這個文件（ dwgname dwgname ）的大小是）的大小是 (itoa filesize) (itoa filesize) 字節(jié)字節(jié).).) (princ) (princ) ) 在該例中，通過函數(shù)在該例中，通過函數(shù)vl-

27、file-sizevl-file-size獲取圖形文件的大小，通過警告對話獲取圖形文件的大小，通過警告對話框顯示這些信息?？蝻@示這些信息。11.2.3. AutoCAD11.2.3. AutoCAD預(yù)定義的回調(diào)函數(shù)預(yù)定義的回調(diào)函數(shù) AutoCADAutoCAD提供了兩個預(yù)定義的回調(diào)函數(shù)，可以在測提供了兩個預(yù)定義的回調(diào)函數(shù)，可以在測試反應(yīng)器時使用這些函數(shù)：試反應(yīng)器時使用這些函數(shù)： （1 1）vlr-beep-reactionvlr-beep-reaction函數(shù)函數(shù)vlr-beep-reactionvlr-beep-reaction的功能是讓計算機(jī)發(fā)出的功能是讓計算機(jī)發(fā)出“嘟嘟嘟嘟”聲。聲。 （

28、2 2）vlr-trace-reactionvlr-trace-reaction函數(shù)函數(shù)vlr-trace-reactionvlr-trace-reaction函數(shù)的功能是將參數(shù)列表打印到函數(shù)的功能是將參數(shù)列表打印到VLISPVLISP的的“跟蹤跟蹤”窗口。窗口。11.3 11.3 創(chuàng)建反應(yīng)器創(chuàng)建反應(yīng)器 創(chuàng)建反應(yīng)器的主要工作就是將事件和回調(diào)函數(shù)相關(guān)聯(lián)。創(chuàng)建創(chuàng)建反應(yīng)器的主要工作就是將事件和回調(diào)函數(shù)相關(guān)聯(lián)。創(chuàng)建反應(yīng)器用反應(yīng)器用vlr-vlr-reactor-reactor函數(shù)。每種類型的反應(yīng)器都有一個與函數(shù)。每種類型的反應(yīng)器都有一個與之對應(yīng)的用于創(chuàng)建該反應(yīng)器的之對應(yīng)的用于創(chuàng)建該反應(yīng)器的AutoLI

29、SPAutoLISP函數(shù)，這些函數(shù)的名稱函數(shù)，這些函數(shù)的名稱和反應(yīng)器類型的名稱相同，只是沒有前面的冒號。例如，和反應(yīng)器類型的名稱相同，只是沒有前面的冒號。例如，vlr-vlr-acdb-reactoracdb-reactor為創(chuàng)建數(shù)據(jù)庫反應(yīng)器函數(shù)，為創(chuàng)建數(shù)據(jù)庫反應(yīng)器函數(shù)，vlr-toolbar-reactorvlr-toolbar-reactor為創(chuàng)建工具欄反應(yīng)器函數(shù)。所有創(chuàng)建反應(yīng)器的構(gòu)造函數(shù)都返回為創(chuàng)建工具欄反應(yīng)器函數(shù)。所有創(chuàng)建反應(yīng)器的構(gòu)造函數(shù)都返回一個反應(yīng)器對象。一個反應(yīng)器對象。 AutoLISP ReferenceAutoLISP Reference列出了與每種反應(yīng)器類型相關(guān)的所有可列出

30、了與每種反應(yīng)器類型相關(guān)的所有可能事件。例如，通過能事件。例如，通過vlr-DWG-reactorvlr-DWG-reactor條目，可看到表條目，可看到表11-311-3所示所示與與DWGDWG反應(yīng)器相關(guān)的所有可能事件。反應(yīng)器相關(guān)的所有可能事件。表表11-3 DWG反應(yīng)器事件反應(yīng)器事件 事件名稱事件名稱 說明說明:vlr-beginClose :vlr-beginClose 圖形數(shù)據(jù)庫將被關(guān)閉。圖形數(shù)據(jù)庫將被關(guān)閉。:vlr-databaseConstructed :vlr-databaseConstructed 已經(jīng)構(gòu)建圖形數(shù)據(jù)庫。已經(jīng)構(gòu)建圖形數(shù)據(jù)庫。:vlr-databaseToBeDest

31、royed :vlr-databaseToBeDestroyed 將從內(nèi)存中刪除圖形數(shù)據(jù)庫的內(nèi)容。將從內(nèi)存中刪除圖形數(shù)據(jù)庫的內(nèi)容。:vlr-beginDwgOpen AutoCAD:vlr-beginDwgOpen AutoCAD將打開圖形文件。將打開圖形文件。:vlr-endDwgOpen AutoCAD:vlr-endDwgOpen AutoCAD已結(jié)束打開操作。已結(jié)束打開操作。:vlr-dwgFileOpened :vlr-dwgFileOpened 新圖形已被加載到新圖形已被加載到AutoCADAutoCAD圖形窗口。圖形窗口。:vlr-beginSave AutoCAD:vlr-be

32、ginSave AutoCAD將保存圖形文件。將保存圖形文件。:vlr-saveComplete AutoCAD:vlr-saveComplete AutoCAD已將當(dāng)前圖形保存到磁盤。已將當(dāng)前圖形保存到磁盤。11.3.111.3.1創(chuàng)建對象反應(yīng)器創(chuàng)建對象反應(yīng)器 因?yàn)閷ο蠓磻?yīng)器必須鏈接到特定的因?yàn)閷ο蠓磻?yīng)器必須鏈接到特定的AutoCADAutoCAD圖元（對象）上，所以在定義圖元（對象）上，所以在定義對象反應(yīng)器時，必須指定反應(yīng)器所要鏈接的圖元。創(chuàng)建對象反應(yīng)器通過函數(shù)對象反應(yīng)器時，必須指定反應(yīng)器所要鏈接的圖元。創(chuàng)建對象反應(yīng)器通過函數(shù)vlr-object-reactorvlr-object-rea

33、ctor，該函數(shù)的調(diào)用格式如下：，該函數(shù)的調(diào)用格式如下： (vlr-object-reactor owners data callbacks)(vlr-object-reactor owners data callbacks) 參數(shù)參數(shù)ownersowners為為VLAVLA對象表，表內(nèi)可以是多個對象表，表內(nèi)可以是多個VLAVLA對象。這些對象也被稱為對象。這些對象也被稱為反應(yīng)器的所有者。反應(yīng)器的所有者。 參數(shù)參數(shù)datadata為與反應(yīng)器對象相關(guān)聯(lián)的數(shù)據(jù)，如果沒有數(shù)據(jù)則該項為為與反應(yīng)器對象相關(guān)聯(lián)的數(shù)據(jù)，如果沒有數(shù)據(jù)則該項為nilnil。 參數(shù)參數(shù)callbackscallbacks為點(diǎn)對表，

34、用于指明事件和與該事件相關(guān)聯(lián)的回調(diào)函數(shù)。為點(diǎn)對表，用于指明事件和與該事件相關(guān)聯(lián)的回調(diào)函數(shù)。點(diǎn)對表的格式如下：點(diǎn)對表的格式如下： (event-name . callback_function)(event-name . callback_function) 該點(diǎn)對表的該點(diǎn)對表的event-nameevent-name是表是表11-411-4所示所示ObjectObject事件中的名稱標(biāo)識，事件中的名稱標(biāo)識，callback_functioncallback_function為回調(diào)函數(shù)。表為回調(diào)函數(shù)。表11-511-5是針表是針表11-411-4所示對特定的回調(diào)事件所示對特定的回調(diào)事件返回的回調(diào)

35、數(shù)據(jù)表。返回的回調(diào)數(shù)據(jù)表。 該函數(shù)的返回值為該函數(shù)的返回值為reactor_object（對象反應(yīng)器）。（對象反應(yīng)器）。 名稱標(biāo)識名稱標(biāo)識 事件事件:vlr-cancelled :vlr-cancelled 對對象的修改已經(jīng)取消。對對象的修改已經(jīng)取消。:vlr-copied :vlr-copied 對象已被復(fù)制。對象已被復(fù)制。:vlr-erased :vlr-erased 對象的刪除標(biāo)志已被設(shè)置。對象的刪除標(biāo)志已被設(shè)置。:vlr-unerased :vlr-unerased 對象的刪除標(biāo)志已被重置。對象的刪除標(biāo)志已被重置。:vlr-goodbye :vlr-goodbye 即將從內(nèi)存中刪除對象

36、。即將從內(nèi)存中刪除對象。:vlr-openedForModify :vlr-openedForModify 即將修改對象。即將修改對象。:vlr-modified :vlr-modified 對象已被修改。如果取消修改，還將激發(fā)對象已被修改。如果取消修改，還將激發(fā) :vlr-cancelled :vlr-cancelled 和和:vlr-modifyUndone:vlr-modifyUndone。:vlr-subObjModified :vlr-subObjModified 對象的子圖元已被修改。在修改多段線或網(wǎng)格頂對象的子圖元已被修改。在修改多段線或網(wǎng)格頂 點(diǎn)時觸發(fā)該事件。點(diǎn)時觸發(fā)該事件。:

37、vlr-modifyUndone :vlr-modifyUndone 對象的修改已被放棄。對象的修改已被放棄。:vlr-modifiedXData :vlr-modifiedXData 對象的擴(kuò)展圖元數(shù)據(jù)已被修改。對象的擴(kuò)展圖元數(shù)據(jù)已被修改。:vlr-unappended :vlr-unappended 已從圖形數(shù)據(jù)庫中拆離對象。已從圖形數(shù)據(jù)庫中拆離對象。:vlr-reappended :vlr-reappended 對象已被重新鏈接到圖形數(shù)據(jù)庫。對象已被重新鏈接到圖形數(shù)據(jù)庫。:vlr-objectClosed :vlr-objectClosed 對對象的修改已經(jīng)完成。對對象的修改已經(jīng)完成。表

38、表11-4 Object事件及其名稱標(biāo)識事件及其名稱標(biāo)識 名稱名稱 表長度表長度 參數(shù)參數(shù):vlr-cancelled 0:vlr-cancelled 0:vlr-erased :vlr-erased :vlr-unerased :vlr-unerased :vlr-goodbye:vlr-goodbye:vlr-openedForModify :vlr-openedForModify :vlr-modified :vlr-modified :vlr-modifyUndone :vlr-modifyUndone :vlr-modifiedXData :vlr-modifiedXData :vl

39、r-unappended :vlr-unappended :vlr-reappended :vlr-reappended :vlr-objectClosed:vlr-objectClosed:vlr-copied 1 :vlr-copied 1 由復(fù)制操作創(chuàng)建的對象由復(fù)制操作創(chuàng)建的對象(ename)(ename)。:vlr-subObjModified 1 :vlr-subObjModified 1 已被修改的子對象已被修改的子對象(ename)(ename)。表表11-5 Object 事件回調(diào)數(shù)據(jù)事件回調(diào)數(shù)據(jù) 例如，下面的代碼創(chuàng)建了一個對象反應(yīng)器。該對象反應(yīng)器例如，下面的代碼創(chuàng)建了一個對象

40、反應(yīng)器。該對象反應(yīng)器只有一個所有者，即只有一個所有者，即VLAVLA對象對象myCirclemyCircle；與該反應(yīng)器對象相關(guān)；與該反應(yīng)器對象相關(guān)聯(lián)的數(shù)據(jù)為聯(lián)的數(shù)據(jù)為Circle ReactorCircle Reactor；點(diǎn)對表為；點(diǎn)對表為(:vlr-modified . (:vlr-modified . print-radius)print-radius)，當(dāng)發(fā)生，當(dāng)發(fā)生myCirclemyCircle對象被修改（即對象被修改（即:vlr-:vlr-modifiedmodified）事件時，調(diào)用）事件時，調(diào)用print-radiusprint-radius回調(diào)函數(shù)：回調(diào)函數(shù)：(setq

41、circleReactor (vlr-object-reactor (list myCircle) (setq circleReactor (vlr-object-reactor (list myCircle) Circle Reactor (:vlr-modified . print-radius)Circle Reactor (:vlr-modified . print-radius) 上述反應(yīng)器對象賦給了變量上述反應(yīng)器對象賦給了變量circleReactorcircleReactor。可以通過該變。可以通過該變量實(shí)現(xiàn)對該反應(yīng)器的查詢、修改或刪除等。量實(shí)現(xiàn)對該反應(yīng)器的查詢、修改或刪除等。

42、創(chuàng)建對象反應(yīng)器除了必須指定反應(yīng)器所要鏈接的圖元之外，創(chuàng)建對象反應(yīng)器除了必須指定反應(yīng)器所要鏈接的圖元之外，還要注意以下幾點(diǎn)：還要注意以下幾點(diǎn)：（1 1）在定義所有者列表時，只能指定）在定義所有者列表時，只能指定VLAVLA對象，而不允許使用對象，而不允許使用enameename對象。要求對象。要求VLAVLA對象是因?yàn)榛卣{(diào)函數(shù)只能用對象是因?yàn)榛卣{(diào)函數(shù)只能用ActiveXActiveX方法修方法修改改AutoCADAutoCAD對象，而對象，而ActiveXActiveX方法要求使用方法要求使用VLAVLA對象。對象。盡管不能在回調(diào)反應(yīng)器中使用由盡管不能在回調(diào)反應(yīng)器中使用由entlastentla

43、st和和entgetentget等函數(shù)獲取等函數(shù)獲取VLAVLA對象，但可以用對象，但可以用vlax-ename-vla-objectvlax-ename-vla-object函數(shù)將函數(shù)將enameename對象對象轉(zhuǎn)換成轉(zhuǎn)換成VLAVLA對象。對象。（2 2）如果對象已被包括在對象反應(yīng)器的所有者列表之中，那么）如果對象已被包括在對象反應(yīng)器的所有者列表之中，那么就不能在回調(diào)函數(shù)中修改該對象。如果這樣做，將會導(dǎo)致一個就不能在回調(diào)函數(shù)中修改該對象。如果這樣做，將會導(dǎo)致一個出錯消息，并使出錯消息，并使AutoCADAutoCAD崩潰。崩潰。 下面是實(shí)現(xiàn)對象反應(yīng)器功能的實(shí)例下面是實(shí)現(xiàn)對象反應(yīng)器功能的實(shí)

44、例: :（1 1）加載例）加載例11-311-3所示程序段所示程序段【例例11-311-3】生成一個圓的生成一個圓的VLAVLA對象。對象。(setq myCircle(setq myCircle(progn(progn (setq ctrPt (getpoint (setq ctrPt (getpoint n n輸入圓心輸入圓心: : ) ) radius (distance ctrPt (getpoint ctrpt n radius (distance ctrPt (getpoint ctrpt n輸入半徑輸入半徑 : ): ) ) ) (vla-addCircle (vla-addCi

45、rcle (vla-get-ModelSpace (vla-get-ModelSpace ；將圓加入到圖形模型空間；將圓加入到圖形模型空間 (vla-get-ActiveDocument (vlax-get-acad-object)(vla-get-ActiveDocument (vlax-get-acad-object) (vlax-3d-point ctrPt) (vlax-3d-point ctrPt) radius radius ) ) 該代碼使用該代碼使用vla-addCirclevla-addCircle畫一個圓，將返回值賦給變量畫一個圓，將返回值賦給變量myCirclemyCir

46、cle。該返。該返回值是回值是VLAVLA對象，包含指向所畫圓對象的指針。對象，包含指向所畫圓對象的指針。（2 2）加載例）加載例11-1 11-1 所示回調(diào)函數(shù)所示回調(diào)函數(shù)print-radiusprint-radius。（3 3）定義對象反應(yīng)器）定義對象反應(yīng)器(setq circleReactor (vlr-object-reactor (list myCircle)(setq circleReactor (vlr-object-reactor (list myCircle) Circle Reactor (:vlr-modified . print-radius) Circle Reac

47、tor (:vlr-modified . print-radius)（4 4）在）在AutoCADAutoCAD圖形窗口圖形窗口，選取該圓并修改其大小，選取該圓并修改其大小，print-radius print-radius 函函數(shù)將在數(shù)將在AutoCADAutoCAD命令窗口顯示一個消息。例如，如果用夾點(diǎn)或命令窗口顯示一個消息。例如，如果用夾點(diǎn)或STRETCHSTRETCH命令改命令改變了該圓的大小，將在命令提示區(qū)顯示以下信息：變了該圓的大小，將在命令提示區(qū)顯示以下信息： * * * STRETCH STRETCH * * * Specify stretch point or Base po

48、int/Copy/Undo/eXit: Specify stretch point or Base point/Copy/Undo/eXit:這個圓的這個圓的半徑是半徑是: :190.0190.0 如果用夾點(diǎn)或如果用夾點(diǎn)或STRETCHSTRETCH命令改變其他圓時的大小，將沒有該提示信息中的命令改變其他圓時的大小，將沒有該提示信息中的“這個圓的半徑是這個圓的半徑是: :”，這是因?yàn)樵谄渌膱A上沒有鏈接，這是因?yàn)樵谄渌膱A上沒有鏈接circleReactorcircleReactor反應(yīng)反應(yīng)器。器。11.3.2 11.3.2 創(chuàng)建其它反應(yīng)器創(chuàng)建其它反應(yīng)器 其它反應(yīng)器不需要鏈接其它反應(yīng)器不需要鏈

49、接AutoCADAutoCAD圖元，所以在定義時，只需要兩個參數(shù)。圖元，所以在定義時，只需要兩個參數(shù)。創(chuàng)建其它反應(yīng)器通過函數(shù)創(chuàng)建其它反應(yīng)器通過函數(shù)vlr-vlr-reactor-reactor，該函數(shù)的調(diào)用格式如下：，該函數(shù)的調(diào)用格式如下： (vlr-(vlr-reactor data callbacks)-reactor data callbacks) 參數(shù)參數(shù)datadata為任意要與反應(yīng)器對象關(guān)聯(lián)的數(shù)據(jù)，如果沒有數(shù)據(jù)則該項為為任意要與反應(yīng)器對象關(guān)聯(lián)的數(shù)據(jù)，如果沒有數(shù)據(jù)則該項為nilnil。 參數(shù)參數(shù)callbackscallbacks為點(diǎn)對表，指明事件和與該事件相關(guān)聯(lián)的回調(diào)函數(shù)，點(diǎn)對為點(diǎn)

50、對表，指明事件和與該事件相關(guān)聯(lián)的回調(diào)函數(shù)，點(diǎn)對表的格式如下：表的格式如下： (event-name . callback_function)(event-name . callback_function) 例如，下列代碼定義了一個例如，下列代碼定義了一個DWGDWG編輯器反應(yīng)器。當(dāng)用戶發(fā)出編輯器反應(yīng)器。當(dāng)用戶發(fā)出SaveSave命令時，命令時，該反應(yīng)器將激活該反應(yīng)器將激活saveDrawingInfosaveDrawingInfo函數(shù)。函數(shù)。 (vlr-dwg-Reactor nil (:vlr-saveComplete . saveDrawingInfo)(vlr-dwg-Reactor n

51、il (:vlr-saveComplete . saveDrawingInfo) 在該例中，第一個參數(shù)為在該例中，第一個參數(shù)為nilnil是因?yàn)闆]有與反應(yīng)器相關(guān)聯(lián)的數(shù)據(jù)；第二個是因?yàn)闆]有與反應(yīng)器相關(guān)聯(lián)的數(shù)據(jù)；第二個參數(shù)是點(diǎn)對表，指明參數(shù)是點(diǎn)對表，指明:vlr-saveComplete:vlr-saveComplete事件與事件與saveDrawingInfosaveDrawingInfo回調(diào)函數(shù)相回調(diào)函數(shù)相關(guān)聯(lián)。當(dāng)關(guān)聯(lián)。當(dāng):vlr-saveComplete:vlr-saveComplete事件發(fā)生時，事件發(fā)生時，AutoCADAutoCAD傳遞給回調(diào)函數(shù)一個圖形傳遞給回調(diào)函數(shù)一個圖形文件名字的

52、字符串。文件名字的字符串。 每個點(diǎn)對表都指定了反應(yīng)器要通報的事件，以及該事件發(fā)生時要調(diào)用的每個點(diǎn)對表都指定了反應(yīng)器要通報的事件，以及該事件發(fā)生時要調(diào)用的回調(diào)函數(shù)。在本例中，只指定了一個事件回調(diào)函數(shù)。在本例中，只指定了一個事件:vlr-saveComplete:vlr-saveComplete。 只要用戶發(fā)出命令，不管是從只要用戶發(fā)出命令，不管是從AutoCADAutoCAD命令行、菜單、工具欄或命令行、菜單、工具欄或AutoLISPAutoLISP程序，都會通知編輯器反應(yīng)器。所以，該程序，都會通知編輯器反應(yīng)器。所以，該DWGDWG反應(yīng)器的回調(diào)函數(shù)需要明確它反應(yīng)器的回調(diào)函數(shù)需要明確它應(yīng)對什么事件

53、作出響應(yīng)。在本例中，回調(diào)函數(shù)應(yīng)對什么事件作出響應(yīng)。在本例中，回調(diào)函數(shù)saveDrawingInfosaveDrawingInfo只是檢查只是檢查SaveSave命令。命令。 下面是下面是實(shí)現(xiàn)實(shí)現(xiàn)DWGDWG反應(yīng)器功能的實(shí)例：反應(yīng)器功能的實(shí)例： （1) 1) 加載例加載例11-211-2所定義的回調(diào)函數(shù)所定義的回調(diào)函數(shù)saveDrawingInfosaveDrawingInfo。 (2(2） 定義定義DWGDWG反應(yīng)器反應(yīng)器 (vlr-dwg-Reactor nil (:vlr-saveComplete . saveDrawingInfo)(vlr-dwg-Reactor nil (:vlr-s

54、aveComplete . saveDrawingInfo) （3 3）在）在AutoCADAutoCAD圖形窗口點(diǎn)取存盤的圖標(biāo)或調(diào)用存圖的命令。當(dāng)完成存圖形窗口點(diǎn)取存盤的圖標(biāo)或調(diào)用存圖的命令。當(dāng)完成存圖工作時將會彈出圖圖工作時將會彈出圖11-111-1所示的所示的AutoCAD MessageAutoCAD Message對話框。說明該實(shí)例成功。對話框。說明該實(shí)例成功。圖圖11-1AutoCAD11-1AutoCAD的的MessageMessage對話框?qū)υ捒?11.3.3 11.3.3 將數(shù)據(jù)附著到反應(yīng)器對象將數(shù)據(jù)附著到反應(yīng)器對象 利用創(chuàng)建反應(yīng)器函數(shù)的參數(shù)利用創(chuàng)建反應(yīng)器函數(shù)的參數(shù)datad

55、ata可以為反應(yīng)器指定與其關(guān)聯(lián)的數(shù)據(jù)，如可以為反應(yīng)器指定與其關(guān)聯(lián)的數(shù)據(jù)，如果該項為果該項為nilnil，表示不需要為反應(yīng)器指定與其關(guān)聯(lián)的數(shù)據(jù)。，表示不需要為反應(yīng)器指定與其關(guān)聯(lián)的數(shù)據(jù)。 一個對象可能鏈接多個反應(yīng)器，如果它們的參數(shù)一個對象可能鏈接多個反應(yīng)器，如果它們的參數(shù)datadata都為都為nilnil，應(yīng)用程，應(yīng)用程序?qū)o法區(qū)分它們。在這種情況下就應(yīng)該為反應(yīng)器指定文本字符串或應(yīng)用程序?qū)o法區(qū)分它們。在這種情況下就應(yīng)該為反應(yīng)器指定文本字符串或應(yīng)用程序能識別的其它數(shù)據(jù)。序能識別的其它數(shù)據(jù)。 例如，前面創(chuàng)建對象反應(yīng)器例如，前面創(chuàng)建對象反應(yīng)器circleReactorcircleReactor的實(shí)例

56、中，字符串的實(shí)例中，字符串“CircleReactorCircleReactor”就是與反應(yīng)器就是與反應(yīng)器circleReactorcircleReactor相關(guān)聯(lián)的數(shù)據(jù)。相關(guān)聯(lián)的數(shù)據(jù)。11.4 11.4 查詢、修改和控制反應(yīng)器的狀態(tài)查詢、修改和控制反應(yīng)器的狀態(tài)11.4.1 11.4.1 查詢反應(yīng)器查詢反應(yīng)器 有多種不同的方法來獲取反應(yīng)器的信息?？梢允褂脴?biāo)準(zhǔn)的有多種不同的方法來獲取反應(yīng)器的信息?？梢允褂脴?biāo)準(zhǔn)的VLISPVLISP數(shù)據(jù)查數(shù)據(jù)查看工具查看反應(yīng)器的信息，也可以用有關(guān)反應(yīng)器的看工具查看反應(yīng)器的信息，也可以用有關(guān)反應(yīng)器的AutoLISPAutoLISP函數(shù)。函數(shù)。1.1.了解圖形中有關(guān)反

57、應(yīng)器的總體情況了解圖形中有關(guān)反應(yīng)器的總體情況 通過通過vlr-reactorsvlr-reactors函數(shù)可以了解當(dāng)前圖形中總共用到了哪些函數(shù)可以了解當(dāng)前圖形中總共用到了哪些反應(yīng)器或有哪些指定類型的反應(yīng)器。反應(yīng)器或有哪些指定類型的反應(yīng)器。vlr-reactorsvlr-reactors函數(shù)的調(diào)用格函數(shù)的調(diào)用格式如下：式如下：(vlr-reactors reactor-type.)(vlr-reactors reactor-type.) 參數(shù)參數(shù)reactor-typereactor-type為反應(yīng)器類型的標(biāo)識符。如果指定了為反應(yīng)器類型的標(biāo)識符。如果指定了reactor-typereactor-

58、type參數(shù)，該函數(shù)返回由指定類型反應(yīng)器組成的表。如參數(shù)，該函數(shù)返回由指定類型反應(yīng)器組成的表。如果省略參數(shù)果省略參數(shù)reactor-typereactor-type，該函數(shù)返回所有當(dāng)前圖形所有的反應(yīng)，該函數(shù)返回所有當(dāng)前圖形所有的反應(yīng)器。器。 以下表達(dá)式列出圖形中的所有反應(yīng)器：以下表達(dá)式列出圖形中的所有反應(yīng)器： (vlr-reactors)(vlr-reactors) ；返回；返回(:VLR-Object-Reactor #VLR-Object-(:VLR-Object-Reactor #) (:VLR-Editor-Reactor #)Reactor) (:VLR-Editor-Reactor

59、 #)，有一個對象，有一個對象反應(yīng)器和一個編輯器反應(yīng)器。反應(yīng)器和一個編輯器反應(yīng)器。以下表達(dá)式列出所有的對象反應(yīng)器：以下表達(dá)式列出所有的對象反應(yīng)器： (vlr-reactors :vlr-object-reactor)(vlr-reactors :vlr-object-reactor) ；返回；返回(:VLR-Object-(:VLR-Object-Reactor #)Reactor #)，有一個對象反應(yīng)器，有一個對象反應(yīng)器以下表達(dá)式列出所有數(shù)據(jù)庫反應(yīng)器：以下表達(dá)式列出所有數(shù)據(jù)庫反應(yīng)器：(vlr-reactors :vlr-acdb-reactor)(vlr-reactors :vlr-acdb

60、-reactor) ；返回；返回nilnil，沒有數(shù)據(jù)庫反應(yīng)器，沒有數(shù)據(jù)庫反應(yīng)器以下表達(dá)式列出所有以下表達(dá)式列出所有DWGDWG反應(yīng)器：反應(yīng)器： (vlr-reactors :vlr-dwg-reactor)(vlr-reactors :vlr-dwg-reactor)；返回；返回(:VLR-DWG-Reactor (:VLR-DWG-Reactor # #)# #)，有一個，有一個DWGDWG反應(yīng)器，有兩個指反應(yīng)器，有兩個指向該向該DWGDWG反應(yīng)器的指針。反應(yīng)器的指針。2. 2. 用用VLISPVLISP的檢驗(yàn)工具檢查反應(yīng)器的檢驗(yàn)工具檢查反應(yīng)器 可以使用可以使用VLISPVLISP的檢驗(yàn)工