Operator ResourceReference

Operator Library: Parameters

您可以在此处找到有关该库的总体介绍 Parameters in Library Parameters.

此算子根据设计中任意位置模块的设备资源映射,生成一个 1:1 的映射参数(位于参数 ResourceIndex 中)。您可以在参数 Reference 中指定引用的模块,并在参数 ResourceName 中指定设备资源类型。

引用的资源映射以整数值表示。

您可以在设计层级结构中定义一个目标,以便使引用的资源映射在该处可见且可访问。该目标由两个参数定义:DisplayHierarchy 和 DisplayName。在 DisplayHierarchy 中,您指定引用算子本身所在的同一进程中的分级框。在参数 DisplayName 中,您设置目标参数的名称。这意味着:

  • 如果同时设置了 DisplayHierarchy 和 DisplayName,则由 DisplayName 定义的参数将在由 DisplayHierarchy 指定的分级框中可用。
  • 如果 DisplayName 为空,则不会创建任何参数。
  • 如果设置了 DisplayName,但 DisplayHierarchy 为空,则由 DisplayName 定义的参数将添加到父级层级结构中(即引用算子本身所在的分级框)。

这使您能够在所需的任何设计层级上提供资源映射参数。例如,您可以直接在受保护分级框自身的 Property 下,提供受保护分级框内部模块的资源映射,以便进行参数化。

映射的资源参数本身也可以被引用。因此,您既可以在引用算子中引用参数 ResourceIndex 的内容,也可以引用您在参数 DisplayName 和 DisplayHierarchy 中定义的参数。当受保护分级框由其他受保护分级框构成时,这一点尤其重要。

[注意] 所有相关参数同时更新

如果更改了其中一个连接的参数(引用的资源映射、映射参数 ResourceIndex 或显示引用参数),则所有其他连接参数中的值也会随之更改。

该运算符没有输入和输出,因为它不会干扰设计的数据流结构。

有关更多详细信息,请参阅该库的通用说明 Parameters in Library Parameters.

I/O Property

Property 值
Operator Type 无,因为没有输入或输出

Supported Link Format

无

参数

状态
键入 静态读取(尽管 GUI 显示为写入)参数
默认 无
范围 OK 否则会发生错误消息

显示错误状态。如果将参数 Activate 设置为 Yes,则会检查其他算子设置。该参数显示此检查的结果,即出现 OK 或错误消息。

此参数不包含在最终的小程序中。

显示名称
键入 静态写参数
默认 无
范围 任意字符串

如果您除了引用算子实例本身之外,还希望在设计的另一个位置授予对参数 Reference 中定义的引用参数的访问权限(双向),则需要定义一个新参数。请在此处指定此新参数的名称。如果此字段为空,则不会创建新参数。

显示层级
键入 静态写参数
默认 无
范围 任意字符串

请在此处指定您要附加在参数 DisplayName 中定义的新映射参数的分级框。

对于此参数,您可以使用自动完成功能和语法高亮显示。要使用自动完成功能,请单击 此参数在 Module Properties 对话框中的 Parameter Values 字段 ,然后按键盘上的 TAB 键。有关自动完成功能的更多详细说明, 请访问 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'。

如果您定义了新参数 DisplayName,但将参数 DisplayHierarchy 留空:新参数将添加到包含引用算子实例的分级框中。如果引用算子实例位于最高进程级别,则无法执行此操作。

[注意] 设置显示目标路径的语法

如果您希望新参数显示在设计的其他位置,则需要在参数 DisplayHierarchy 中指定包含该新参数的分级框的路径。

The syntax is as follows:

<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 parameter
默认 0
范围 取决于所连接设备资源的索引范围

用于访问引用的设备资源映射值(双向)的映射参数。

ResourceName
键入 静态、动态、写入参数
默认 0
范围 任意字符串

定义要访问的设备资源类型。该名称与设备资源对话框中提供的名称相同。

Reference
键入 静态写参数
默认 无
范围 定义引用模块的任意字符串:到模块的相对路径

您在此处定义引用模块在设计中的位置。

对于此参数,您可以使用自动完成功能和语法高亮显示。要使用自动完成功能,请单击 此参数在 Module Properties 对话框中的 Parameter Values 字段 ,然后按键盘上的 TAB 键。有关自动完成功能的更多详细说明, 请访问 'Autocompletion and Syntax Highlighting for Translator and Reference Operators'。

描述
键入 静态写参数
默认 无
范围 任意字符串

您在此处定义生成引用参数的描述。

Activate
键入 动态写入参数
默认 无
范围 {No, Yes}

Yes = 激活对引用的设备资源映射的访问权限(双向,通过映射参数 ResourceIndex)。

No = 停用对引用的设备资源映射的访问权限(双向),并且参数 Status 禁用。DisplayName 和 DisplayHierarchy 参数将失效。

使用示例

以下示例展示了 operator ResourceReference 的用法: