Operator ResourceReference

Operator Library: Parameters

ライブラリの一般的な紹介については、次を参照してください Parameters in Library Parameters.

このオペレータは、デザイン内のどこに位置するモジュールに対しても、デバイスリソースマッピングから1:1のマップパラメータ(パラメータ ResourceIndex)を生成します。参照先モジュールはパラメータ Reference で、デバイスリソースタイプはパラメータ ResourceName でそれぞれ指定します。

参照されるリソースマッピングは整数値として表現されます。

参照されたリソースマッピングが表示されアクセス可能になる、デザイン階層内のターゲットを定義できます。 ターゲットは、DisplayHierarchy と DisplayName の2つのパラメータによって定義されます。 DisplayHierarchy では、参照オペレータ自体が配置されているプロセスと同じプロセス内の階層ボックスを指定します。 パラメータ DisplayName では、ターゲットパラメータの名前を設定します。つまり、以下のようになります。

  • DisplayHierarchy と DisplayName の両方が設定されている場合、DisplayName で定義されたパラメーターは、DisplayHierarchy で指定された階層ボックスで使用できるようになります。
  • DisplayName が空の場合、パラメーターは作成されません。
  • DisplayName が設定されているが DisplayHierarchy が空である場合、 DisplayName で定義されたパラメーターは親階層(つまり、参照オペレーター自体が配置されている階層ボックス)に追加されます。

これにより、デザインの任意の階層レベルでリソースマッピングのパラメータを利用可能にすることができます。 例えば、保護された階層ボックス内のモジュールのリソースマッピングを、保護された階層ボックス自体の Property の下に直接パラメータ化できるようにすることが可能です。

マップされたリソースパラメータ自体を参照することも可能です。 したがって、参照オペレータ内のパラメータ ResourceIndex のコンテンツを参照するか、あるいはパラメータ DisplayName および DisplayHierarchy で定義したパラメータを参照することができます。 これは、保護された階層ボックスが他の保護された階層ボックスから構築されている場合に特に重要となります。

[注] 接続されているすべてのパラメーターが一度に更新されます

接続されたパラメータのいずれかが変更された場合(参照されるリソースマッピング、マップパラメータ ResourceIndex、または表示参照パラメータ)、値は他のすべての接続されたパラメータでも同様に変更されます。

このオペレーターは、設計のデータフロー構造に干渉しないため、入力と出力を持っていません。

詳細については、ライブラリの一般説明を参照してください。 Parameters in Library Parameters.

I/O Property

Property 値
オペレータータイプ 入力または出力がないため、なし

サポートされているリンクフォーマット

None

パラメーター

Status
タイプ 静的読み取り(GUIには書き込みと表示されます)パラメータ
Default None
範囲 OK またはエラーメッセージが発生します

エラーステータスを表示します。パラメータ Activate が Yes に設定されている場合、他のオペレータ設定がチェックされます。 このパラメータには、このチェックの結果、すなわち OK またはエラーメッセージが表示されます。

このパラメータは最終的なアプレットの一部ではありません。

DisplayName
タイプ static write parameter
Default None
範囲 任意の文字列

参照オペレータインスタンス自体に加えて、デザイン内の別の場所にあるパラメータ Reference で定義された参照先パラメータへのアクセスを許可またはそこからのアクセスを許可する場合は、新しいパラメータを定義する必要があります。 ここにこの新しいパラメータの名前を指定します。 このフィールドが空の場合、新しいパラメータは作成されません。

DisplayHierarchy
タイプ static write parameter
Default None
範囲 任意の文字列

パラメータ 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

ResourceIndex
タイプ static、dynamic、write、readパラメータ
Default 0
範囲 接続されたデバイスリソースのインデックス範囲に依存します

参照されるデバイスリソースマッピング値へのアクセスおよびそれからのアクセスのためのマップパラメータ。

ResourceName
タイプ 静的、動的、書き込みパラメーター
Default 0
範囲 任意の文字列

アクセスするデバイスリソースタイプを定義します。名前はデバイスリソースダイアログで提供されているものと同じです。

Reference
タイプ static write parameter
Default None
範囲 参照されるモジュールを定義する任意の文字列:モジュールへの相対パス

ここでは、デザイン内における参照先モジュールの位置を定義します。

このパラメータでは、オートコンプリート機能と構文ハイライトを使用できます。オートコンプリートを使用するには、Module Properties ダイアログでこのパラメータの Parameter Values フィールドをクリックし、キーボードの TAB キーを押します。オートコンプリート機能の詳細な手順については、「Autocompletion and Syntax Highlighting for Translator and Reference Operators」を参照してください。

説明
タイプ static write parameter
Default None
範囲 任意の文字列

ここでは、生成された参照パラメータの説明を定義します。

Activate
タイプ 動的書き込みパラメータ
Default いいえ
範囲 {No, Yes}

Yes = 参照されるデバイスリソースマッピングへのアクセスおよびそれからのアクセス(マップパラメータ ResourceIndex を介した)が有効化されます。

No = 参照されるデバイスリソースマッピングへのアクセスおよびそれからのアクセスが無効化され、パラメータ Status が無効になります。 パラメータ DisplayName および DisplayHierarchy は効果を持ちません。

使用例

オペレータ ResourceReference の使用方法は、以下の例に示されています。