運算子 StringParamReference

運算子函式庫：參數

此運算子會根據設計中任何位置的模組參數， 產生一個 1:1 的映射參數（位於「Value」參數中）。您需在「Reference」參數中指定 所引用的參數（路徑與名稱）。

被引用的參數可以是以下三種類型之一：VA_STRING、VA_FILENAME 或 VA_METADATA。 map 參數始終為字串。

您可以在設計層級結構中定義一個目標位置，使被引用的 參數在此處可見且可存取。 該目標由兩個參數定義：DisplayHierarchy與DisplayName。 在DisplayHierarchy中，您指定位於 與引用的運算子本身相同流程內的層級方塊。 在DisplayName參數中，您可設定目標參數的名稱。 若DisplayHierarchy與DisplayName皆已設定，則由DisplayName所定義的參數將 出現在由DisplayHierarchy 所指定的層級方塊中。 若DisplayName為空，則不會建立任何參數。 若已設定DisplayName，但DisplayHierarchy為空， 則由DisplayName定義的參數將新增至父層級（即 參考運算子本身所處的層級方塊）。

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

已映射的參數本身也可以被引用。 因此，您可以在引用運算子中引用參數 Value的內容， 或引用您在參數DisplayName和DisplayHierarchy 中所定義的參數。 這在 受保護的層級方塊由其他受保護的層級方塊所組成時，尤其重要。

[註] 所有相關參數會同時更新

若其中一個相連的參數發生變更（被引用參數、地圖參數 「值」，或目標參數），則所有其他相連的參數的值也會隨之變更。

該運算子沒有輸入和輸出，因為它不會干擾設計的資料流結構。

關於「庫參數」的一般介紹，請參閱 「函式庫參數」中。

範例：

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

I/O 屬性

屬性 價值
運算子類型 無（因為沒有輸入或輸出）

支援的連結格式

無

參數

狀態
類型 靜態讀取（儘管 GUI 顯示為寫入）參數
預設 無
範圍 「OK」或錯誤訊息

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

此參數不屬於最終的小程式的一部分。

顯示名稱
類型 靜態寫入參數
預設 無
範圍 任何字串

若您希望允許從設計中的其他位置存取被參照的參數 （定義於「參照」參數中） （除了參照運算子實例本身之外）， 則需定義一個新參數。 請在此處指定此新參數的名稱。 若此欄位為空，則不會建立新參數。

顯示層級
類型 靜態寫入參數
預設 無
範圍 任何字串

請在此處指定您要將新地圖參數附加到的階層式方塊， 該參數即您在「DisplayName」參數中定義的參數。

針對此參數，您可以使用自動完成功能和語法高亮顯示。若要使用自動完成功能，請在「模組屬性」對話方塊中，點擊 此參數的「參數值」欄位 ，然後按下 TAB 鍵。有關自動完成 功能的更詳細說明，請參閱「Translator 和 Reference 運算子的自動完成與語法高亮顯示」。

若您定義了新的參數DisplayName， 但將參數DisplayHierarchy留空：該新參數將 新增至包含該參考運算子實例的階層方塊中。 （請注意，若參考運算子實例 位於最高（程序）層級，則無法執行此操作。）

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

若要讓新參數顯示在設計的另一處， 您需要在參數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

價值
類型 靜態、動態、寫入、讀取參數
預設 0
範圍 有符號整數（64 位元）、無符號整數（64 位元）

用於存取被引用參數的映射參數。 此參數與被引用參數具有相同的屬性。

參考資料
類型 靜態寫入參數
預設 無
範圍 任何用來定義所引用參數的字串：模組的相對路徑、模組名稱及參數名稱

在此處，您可以定義被引用參數在設計中的位置。

針對此參數，您可以使用自動完成功能和語法高亮顯示。若要使用自動完成功能，請在「模組屬性」對話方塊中，點擊 此參數的「參數值」欄位 ，然後按下 TAB 鍵。有關自動完成 功能的更詳細說明，請參閱「Translator 和 Reference 運算子的自動完成與語法高亮顯示」。

[註] 引用語法

語法如下：

<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/CoeffBuffer.CoefficientFile0).

您也可以使用 ../ 以提升一個層級。 不過，在設計可自由複製或重新定位的模組時，請務必避免使用此選項。

啟用
類型 動態寫入參數
預設 否
範圍 {否，是}

是= 已啟用對所引用參數的存取（透過地圖參數「Value」）及其反向存取。

No= 已停用對被引用參數的存取權限，且該參數的「狀態」已停用。 參數「DisplayName」和「DisplayHierarchy」將不產生任何效果。

使用範例

以下範例展示了 StringParamReference 運算子的使用方式：

  上一頁     升級     下一頁  
內容 頂部 首頁