IntParamSelector 運算子

Operator Library: Parameters

此運算子會在 「參數值」中產生一個映射參數。您可以透過 「選取」參數，將此映射參數 在設計中任何位置的數個模組參數之間切換。若要指定 被引用的參數路徑與名稱，請在 「參照」參數中加入以分號分隔的清單。

被引用的參數可以屬於以下 三種類型之一：

  • VA_SINT：與參數相同的帶符號整數 運算子中的值 CONST.

  • VA_UINT：與運算子 SCALE 中的參數 ScaleFactor相同之無符號整數。

  • VA_ENUM：類似於SetSignalStatus 運算子中 mode參數的枚舉。

map 參數本身始終為 Int64 類型。map 參數 完全複製當前選取之參照參數的所有屬性。

若要引用一個 使用完整 64 位的無符號參數，則必須 根據 Int64 類型重新解讀該值。

您可以在設計 層級結構中定義一個目標，使所選參數在該處可見且可存取。該目標由 兩個參數定義：DisplayHierarchy和 DisplayName。在 DisplayHierarchy 中，您指定一個位於 與參考運算子本身相同流程內的層級方塊。在參數 DisplayName中，您設定目標 參數的名稱。這表示：

  • 若同時設定了DisplayHierarchy和 DisplayName，則由DisplayName所定義的參數 將可在由DisplayHierarchy 所對應的 階層式方塊中使用。
  • 若DisplayName為空，則不會 建立任何參數。
  • 若已設定`DisplayName`，但 `DisplayHierarchy`為空，則由`DisplayName` 所定義的參數將被新增至父 層級結構中（即參考運算子本身所處的層級方塊）。

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

已映射的參數本身即可被引用。 因此，您可以在引用運算子中引用參數 Value的內容，或是引用 您在參數 DisplayName和 DisplayHierarchy 中所定義的參數。這一點在 受保護的階層式方塊是由其他受保護的階層式 方塊所構建時，尤為重要。

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

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

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

您可以在此找到關於該 函式庫的概覽 Parameters 位於 Library Parameters.

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 任何字串

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

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

請在此處指定您要將新地圖 參數（您已在參數 「顯示名稱」中定義的） 附加到的階層式方塊。

針對此參數，您可以使用自動完成功能和語法高亮顯示。若要使用自動完成功能，請在「模組屬性」對話方塊中，點擊 此參數的「參數值」欄位 ，然後按下 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, the 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

Select
Type static, dynamic, write parameter
Default 0
Range 這取決於被引用的參數數量

用於在參照參數之間進行切換的選擇器。

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

用於存取所選參數的映射參數。此 參數與目前選取的參照 參數具有相同的屬性。

Unit
Type 靜態寫入參數
Default -
Range Latin-1

請在此處輸入參數 「值」的單位。

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

請在此處輸入參數 「值」的說明。

References
Type 靜態寫入參數
Default 無
Range 以分號分隔的清單，用以定義所引用的參數： 模組的相對路徑、模組名稱及參數名稱。

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

[注意] 參照語法

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

字串清單中某個專案的語法如下：

<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 (i.e. an operator instance or a hierarchical box) that contains the referenced parameter.

<ParamName> is the 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/SetParam.Value)。

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

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

是= 已啟用對所引用 參數（透過 map 參數Value）的 存取功能。

否= 停用與所引用 參數之間的存取，且該參數的 「狀態」設為「停用」。參數 「顯示名稱」及 「顯示層級」均無效。

Examples of Use

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

  • 'Parameter Selection'

    範例 - 展示如何使用參數轉換運算子 IntParamSelector 與 FloatParamSelector。

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