FloatParamSelector 運算子

Operator Library: Parameters

此運算子會在參數 Value 中產生一個對應參數。您可以透過參數 Select 在設計中任何位置的數個模組參數之間切換此對應參數。若要指定參照參數的路徑與名稱,請在參數 References 中新增以分號分隔的清單。

參照參數必須屬於 VA_DOUBLE 類型。對應參數會鏡射目前所選參照參數的所有 Property。

您可以在設計階層中定義一個目標,讓所選參數在該處可見且可存取。 此目標由兩個參數定義:DisplayHierarchy 與 DisplayName。 在 DisplayHierarchy 中,您可以定址參考運算子本身所在的相同程序內的階層方塊。 在參數 DisplayName 中,您可為目標參數設定名稱。這表示:

  • 若 DisplayHierarchy 與 DisplayName 皆已設定,則由 DisplayName 定義的參數可在 DisplayHierarchy 所定址的階層方塊中使用。
  • 若 DisplayName 為空白,則不會建立任何參數。
  • 若已設定 DisplayName,但 DisplayHierarchy 為空白, 則由 DisplayName 定義的參數會新增至父階層(亦即參考運算子本身所在的階層方塊)。

這可讓您在設計的任何所需階層層級上使用所選參數。 例如,您可以讓受保護階層方塊內的模組參數直接在受保護階層方塊本身的 Property 下進行參數化。

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

[備註] 所有連接的參數會同時更新

如果其中一個連接的參數遭到變更(也就是所選參數、對應參數 Value 或顯示目標參數),則所有其他連接參數中的值也會隨之變更。

由於此運算子不會干擾設計的資料流結構,因此沒有輸入與輸出。

您可以在此找到庫的一般介紹 Parameters in Library Parameters.

I/O Properties

Property Value
Operator Type 無,因為沒有任何輸入或輸出

支援的 Link 格式

無

參數

Status
Type 靜態讀取(儘管 GUI 顯示為寫入)參數
Default 無
Range 會傳回 OK 或發生錯誤訊息

顯示錯誤狀態。如果參數 Activate 設定為 Yes, 就會檢查其他模組參數。 此參數會顯示檢查結果, 亦即傳回 OK 或發生錯誤訊息。

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

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

如果您除了參考運算子執行個體本身之外,還想要在設計中的其他位置授權存取參數 Reference 中定義的參照參數(雙向存取), 您就需要定義一個新參數。 請在此指定此新參數的名稱。 如果此欄位為空白,則不會建立新參數。

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

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

針對此參數,您可以使用自動完成功能與語法突顯。若要使用自動完成,請按一下 Parameter Values 欄位中的 此參數對應至 Module Properties 對話方塊,並按下鍵盤上的 TAB 鍵。關於自動完成功能的詳細 說明,請參閱 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'。

如果您定義了新參數 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 靜態、動態、寫入參數
Default 0
Range 取決於參照參數的數量

用於在參照參數之間切換的選取器。

Value
Type 靜態、動態、寫入、讀取引數
Default 0
Range double

用於存取所選參數(雙向)的對應參數。 此參數具有與目前所選參照參數相同的 Property。

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

在此輸入引數 Value 的單位。

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

在此輸入引數 Value 的說明。

參考資料
Type 靜態寫入參數
Default 無
Range 以分號分隔的清單來定義所參考參數的字串:模組的相對路徑、模組名稱以及參數名稱

在此,您可定義所參考參數在設計中的位置。

針對此參數,您可以使用自動完成功能與語法突顯。若要使用自動完成,請按一下 Parameter Values 欄位中的 此參數對應至 Module Properties 對話方塊,並按下鍵盤上的 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 (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 動態寫入參數
Default 否
Range {No, Yes}

Yes = 啟用對參考引數的雙向存取(透過對應引數 Value)。

No = 對所參考參數的存取與連線已停用,且參數 Status 已停用。 參數 DisplayName 與 DisplayHierarchy 將不會生效。

使用範例

以下範例展示了 FloatParamSelector 運算子的使用方式:

  • 'Parameter Selection'

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