Operator ResourceReference

Operator Library: Parameters

您可以在此找到關於此函式庫的一般性介紹 Parameters 在 Library Parameters.

此運算子會根據設計中任何位置的模組之裝置資源映射, 產生一個 1:1 的映射參數(位於ResourceIndex 參數中)。您可在 Reference參數中指定被引用的模組,並在ResourceName 參數中指定裝置資源類型。

所引用的資源映射以整數值表示。

您可以在設計層級結構中定義一個目標,使被引用的 資源映射在此處可見且可存取。 該目標由兩個參數定義:DisplayHierarchy和DisplayName。 在DisplayHierarchy中,您指定位於 與引用運算子本身相同流程內的層級方塊。 在DisplayName參數中,您需為目標參數設定名稱。這表示:

  • 若同時設定了DisplayHierarchy和DisplayName,則由DisplayName所定義的參數, 將可在由DisplayHierarchy 所指向的階層式方塊中使用。
  • 若DisplayName為空,則不會建立任何參數。
  • 若已設定DisplayName,但DisplayHierarchy為空, 則由DisplayName所定義的參數將被新增至父層級(即該 參考運算子本身所處的層級方塊中)。

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

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

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

若其中一個關聯參數發生變更(所引用的資源映射、map 參數 ResourceIndex,或顯示參考參數),則所有其他關聯參數的值也會隨之變更。

此 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

資源索引
Type static、dynamic、write、read 參數
Default 0
Range 這取決於已連線裝置資源的索引範圍

用於存取所引用裝置資源映射值的映射參數。

資源名稱
Type 靜態、動態、寫入參數
Default 0
Range 任何字串

請定義要存取的裝置資源類型。其名稱應與「裝置資源」對話方塊中提供的名稱相同。

Reference
Type 靜態寫入參數
Default 無
Range 任何定義所引用模組的字串:模組的相對路徑

在此處,您可以定義所引用模組在設計中的位置。

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

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

在此處,您可以定義所產生參考參數的描述。

Activate
Type dynamic write parameter
Default 否
Range {否,是}

是= 已啟用與所引用裝置資源映射(透過 map 參數的ResourceIndex)之間的存取功能。

No= 往返於所引用的裝置資源映射的存取功能已停用,且「Status」參數亦已停用。 「DisplayName」與「DisplayHierarchy」參數將不產生任何效果。

Examples of Use

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