Operator EnumParamReference

Operator Library: Parameters

此運算子會從設計中任何位置的模組參數產生 1:1 的對應參數 (位於參數 Value 中)。您可以在參數 Reference 中指定參照的參數 (路徑與名稱)。

被引用的參數類型為 VA_ENUM。 map 參數反映了被引用參數的所有屬性，且類型同樣為 VA_ENUM。

您可以在設計階層內定義一個目標，讓參照的參數在該處可見且可存取。目標由兩個參數定義：DisplayHierarchy 與 DisplayName。在 DisplayHierarchy 中，您指定參照 operator 本身所在的同一個處理程序中的階層方塊。在參數 DisplayName 中，您設定目標參數的名稱。如果同時設定了 DisplayHierarchy 與 DisplayName，則由 DisplayName 定義的參數將可在 DisplayHierarchy 所指定的階層方塊中使用。如果 DisplayName 為空，則不會建立參數。如果設定了 DisplayName，但 DisplayHierarchy 為空，則由 DisplayName 定義的參數會新增至父階層（也就是參照 operator 本身所在的階層方塊）。

這可讓您將設計的參數提供給您想要的任何階層層級（設計中）使用。例如，您可以讓受保護階層方塊內的模組參數直接在受保護階層方塊本身的屬性下進行參數化。

對應參數本身也可以被參照。因此，您既可以參照參照 operator 中參數 Value 的內容，也可以參照您在參數 DisplayName 與 DisplayHierarchy 中定義的參數。當受保護階層方塊是由其他受保護階層方塊組成時，這點尤其重要。

[注意] 所有連接的參數會同時更新

如果其中一個連接的參數（參照參數、對應參數 Value 或目標參數）遭到變更，所有其他連接的參數中的值也會隨之變更。

此 operator 沒有輸入和輸出，因為它不會干擾設計的資料流結構。

關於 Library Parameters 的一般介紹，請參閱 Library Parameters。

範例：

地圖參數「SignalParamRef」現已可在 Process0/Level0/Level1 中使用：

I/O Properties

Property Value
Operator Type 無（因為沒有輸入或輸出）

Supported Link Format

無

Parameters

Status
Type 靜態讀取參數（儘管 GUI 顯示為寫入）
Default 無
Range OK 或錯誤訊息

顯示錯誤狀態。如果參數 Activate 設定為 Yes，則會檢查其他模組參數。此參數會顯示檢查結果，即 OK 或錯誤訊息。

此參數不屬於最終 applet 的一部分。

DisplayName
Type 靜態寫入參數
Default 無
Range 任何字串

如果您想在設計的其他位置（除參照運算子執行個體本身外）授權存取參照參數（定義於參數 Reference 中），您需要定義一個新參數。請在此處指定這個新參數的名稱。

如果此欄位為空白，則不會建立新參數。

DisplayHierarchy
Type 靜態寫入參數
Default 無
Range 任何字串

在此指定您要附加在參數 DisplayName 中定義的新 map 參數的階層式方塊。

對於此參數，您可以使用自動完成功能和語法突顯。若要使用自動完成，請按一下 此參數在 Module Properties 對話方塊中的 Parameter Values 欄位， 然後按下鍵盤上的 TAB 鍵。如需有關自動完成功能的 更詳細說明，請參閱 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'。

如果您定義了新參數 DisplayName， 但將參數 DisplayHierarchy 留空：新參數將會 新增至包含參考 operator 實例的階層式方塊。 （請記住，如果參考 operator 實例 位於最高（製程）層級，則無法這樣做。）

[注意] 設定顯示目標路徑的語法

若要讓新參數顯示在設計的其他位置， 您需要在 DisplayHierarchy 參數中指定包含新參數之階層方塊的路徑。

語法如下：

<Path> is the relative path from process level to the hierarchical level of the design where the <Hierarchical Box> is located that is to receive the new parameter. Thus, parameter DisplayHierarchy can only address hierarchical boxes within the same process. Use a slash as separator between different hierarchical levels.

<HierarchicalBox> is the name of the hierarchical box that is to receive the new map parameter.

範例： Level0/Level1

Value
Type static、dynamic、write、read 參數
Default 0
Range 帶號整數 (64 位元)、無帶號整數 (64 位元)

用於存取參照參數的對應參數。此參數會鏡射參照參數的所有屬性。

描述
Type 靜態寫入參數
Default -
Range 任何文字

在此輸入參數 Value 的描述。

Reference
Type 靜態寫入參數
Default 無
Range 定義參照參數的任意字串：模組的相對路徑、模組名稱與參數名稱

在此，您可以定義參照參數在設計中的位置。

對於此參數，您可以使用自動完成功能和語法突顯。若要使用自動完成，請按一下 此參數在 Module Properties 對話方塊中的 Parameter Values 欄位， 然後按下鍵盤上的 TAB 鍵。如需有關自動完成功能的 更詳細說明，請參閱 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'。

[注意] 參照語法

語法如下：

<Path> is the relative path to the hierarchical level where the referenced module "Module" is located. Use a slash as separator between different hierarchical levels. Define the path as relative path from the hierarchical level the reference operator instance is located in.

<Module> is the name of the module (operator instance or hierarchical box) that contains the referenced parameter.

<ParamName> is the actual name of the referenced parameter.

If <Path> starts with a slash, the path is interpreted as absolute path starting from design level (e.g., /Process0/UUT/Signal.Mode)。

您也可以使用 ../ 來返回上一層。 不過，在設計可自由複製或可重新定位的模組時，請注意不要使用此選項。

Activate
Type dynamic write parameter
Default 否
Range {No, Yes}

Yes = 已啟用對參照參數的存取以及來自參照參數的存取 (透過對應參數 Value)。

No = 對參照參數的存取及來自參照參數的存取已停用，且 Status 參數已停用。 DisplayName 與 DisplayHierarchy 參數將無效。

Examples of Use

以下範例展示了 EnumParamReference 運算子的用法：

  上一頁     上一層     下一頁  
內容 頂端 首頁