SystemVariables 元素 (AutoCAD 2015 系列產品和更高版本、AutoCAD LT 2024 和更高版本)
SystemVariables 元素是可選的元素,並且可以包含一個或多個 SystemVariables 元素。SystemVariable 元素包含外掛程式應建立或修改之系統變數的定義。
SystemVariable 元素
屬性
描述
Name
要建立或修改之系統變數的名稱。
Value
要指定給變數的值。
這個值可以包含其中一個可選的運算子字首:+、-、& 和 |。
請參閱〈變數值運算子字首〉一節以瞭解更多資訊。
註: 將值套用至變數時,不會保留運算子字首。
PrimaryType
要指定給變數的資料類型。修改既有系統變數時為可選。
有效值為:
Int16 - 帶正負號的 16 位元整數
Int32 - 32 位元整數
Real - 浮點或倍精度數值
String - 單一或多個字元值
如果運算子字首做為變數值的一部分使用時,必須指定適當的資料類型。如果未使用適當的資料類型,則此作業將被視為是字串作業。
StorageType
變數值的儲存位置 (如果保留的話)。修改既有系統變數時為可選。
有效值為:
Database - 保留在建立變數的圖檔中
Profile - 保留做為目前 AutoCAD 紀要的一部分
Session - 不會在建立這個階段作業的圖面中或跨圖面階段作業保留
User - 保留做為 FixedProfile for AutoCAD 的一部分
Owner
(可選) AcRX 服務名稱。
用於使系統變數成為唯讀狀態,且僅能由使用 acrxRegisterService() 以註冊服務名稱的應用程式修改。
Flags
(可選) 建立和修改旗標。可指定多個旗標;使用豎線號來分隔每個旗標。
支援下列旗標:
Create - 建立變數 (如果變數不存在)。(預設行為)
Open - 每次載入外掛程式時,以及只有當變數存在時,修改變數的值。
OpenOnce - 在第一次載入外掛程式時,並且僅在變數存在時修改變數的值。解除安裝並重新安裝外掛程式會導致變數的值再次變更。
SpacesAllowed - 允許於指令提示時按空格鍵。如果未指定,則按空格鍵的作用與按 Enter 鍵一樣。
註: 僅與 Create 旗標搭配,且當 PrimaryType 屬性設定為 String 時使用。
DotIsEmpty - 允許藉由輸入「.」(句點) 做為變數的值以清除變數的值。
註: 僅與 Create 旗標搭配,且當 PrimaryType 屬性設定為 String 時使用。
NoUndo - 不記錄變數的變更,而且無法使用 U 或 UNDO 指令退回。
註: 僅與 Create 旗標搭配使用。
Chatty - 觸發反應器通知,即使變數的值是設定為其目前的值亦然。
註: 僅與 Create 旗標搭配使用。
註: Open 或 OpenOnce 旗標必須用於修改變數的值。
以下範例會建立一個名為 MYVARIABLE 的系統變數:
Name="MYVARIABLE" PrimaryType="String" StorageType="User" Value="Example" Owner="" Flags="Create|DotIsEmpty|SpacesAllowed" /> 以下範例會在首次載入外掛程式時,將 CURSORSIZE 系統變數的值變更為 100: Name="CURSORSIZE" Value="100" Flags="OpenOnce" />