Components 元素參考

Components 元素參考

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"

/>

相关推荐