Operator FloatParamSelector

Operator Library: Parameters

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

被參照的參數必須為 VA_DOUBLE 類型。map 參數反映了目前選取的 被參照參數的所有屬性。

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

  • 如果同時設定了 DisplayHierarchy 與 DisplayName，則由 DisplayName 定義的參數可在 DisplayHierarchy 所指定的階層方塊中使用。
  • 如果 DisplayName 為空，則不會建立任何參數。
  • 如果設定了 DisplayName，但 DisplayHierarchy 為空，則由 DisplayName 定義的參數會新增至父階層（也就是參照運算子本身所在的階層方塊）。

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

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

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

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

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

如需該程式庫的一般介紹，請參閱 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 任何字串

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

對於此參數，您可以使用自動完成功能和語法突顯。若要使用自動完成，請按一下 此參數在 Module Properties 對話方塊中的 Parameter Values 欄位， 然後按下鍵盤上的 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 static, dynamic, write parameter
Default 0
Range 取決於被引用的參數數量

用於在所引用的參數之間切換的選項器。

Value
Type static、dynamic、write、read 參數
Default 0
Range double

用於存取選取參數及其相關參數的映射參數。 此參數具有與目前選取的參考參數相同的屬性。

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

在此輸入參數 Value 的單位。

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

在此輸入參數 Value 的描述。

參考文獻
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 (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}

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

否= 已停用對被引用參數的存取權限，且該參數的「狀態」已停用。 參數「DisplayName」和「DisplayHierarchy」將無效。

Examples of Use

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

  • 「參數選擇」

    範例 — 示範如何使用參數轉換運算子IntParamSelector和FloatParamSelector。

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