Operator StringParamReference

Operator Library: Parameters

此运算符根据设计中任意位置的模块参数生成一个一对一映射参数（参数“Value”中指定）。您需要在参数“Reference”中指定被引用的参数（路径和名称）。

引用的参数可以是以下三种类型之一：VA_STRING、VA_FILENAME 或 VA_METADATA。映射参数始终为字符串。

您可以在设计层次结构中定义一个目标，以便引用参数在该目标中可见且可访问。该目标由两个参数定义：DisplayHierarchy 和 DisplayName。在 DisplayHierarchy 中，您寻址引用算子本身所在的同一进程内的分层盒（hierarchical box）。在参数 DisplayName 中，您设置目标参数的名称。如果同时设置了 DisplayHierarchy 和 DisplayName，则由 DisplayName 定义的参数将可在 DisplayHierarchy 寻址的分层盒中可用。如果 DisplayName 为空，则不创建参数。如果设置了 DisplayName但 DisplayHierarchy 为空，则由 DisplayName 定义的参数将添加至父级层次结构（即引用算子本身所在的分层盒）。

这使您可以将设计的参数提供给所需的任何层次结构级别（设计中）。例如，您可以使受保护分层盒内的模块参数直接在受保护分层盒本身的 Property 下进行参数化。

映射参数本身也可以被引用。因此，您可以引用引用算子中参数 Value 的内容，或者引用您在参数 DisplayName 和 DisplayHierarchy 中定义的参数。这在由其他受保护分层盒构建受保护分层盒时尤为重要。

[注意] 所有连接的参数会同时更新

如果更改了其中一个连接的参数（引用参数、映射参数 Value 或目标参数），则所有其他连接参数中的值也会随之更改。

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

有关库参数的总体介绍，请参见 Library Parameters。

示例：

映射参数“CoeffFileParam”现在在Process0/Level0/Level1中可用：

I/O Properties

财产 值
操作员类型 无（因为没有输入或输出）

Supported Link Format

无

参数

状态
键入 静态读取参数（尽管 GUI 显示为写入）
默认 无
范围 OK 或错误消息

显示错误状态。如果参数 Activate 设置为 Yes， 则会检查其他模块参数。 此参数显示该检查的结果， 即 OK 或错误消息。

此参数不属于最终 Applet 的一部分。

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

如果您希望在设计中的其他位置（除了引用运算符实例本身之外）授予对引用参数（在参数Reference中定义）的访问权限，则需要定义一个新参数。请在此处指定此新参数的名称。如果此字段为空，则不会创建新参数。

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

在此处指定您要附加在参数 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, 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

值
键入 静态、动态、写入、读取参数
默认 0
范围 有符号整数（64 位），无符号整数（64 位）

用于访问引用参数以及从引用参数访问的映射参数。此参数具有与引用参数相同的 Property。

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

在此处，您可以定义引用参数在设计中的位置。

对于此参数，您可以使用自动完成功能和语法高亮显示。要使用自动完成功能，请在 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 (operator instance or hierarchical box) that contains the referenced parameter.

<ParamName> is the actual 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/CoeffBuffer.CoefficientFile0）。

您还可以使用 ../ 向上移动一层。但是，请注意在设计可自由复制或可重定位的模块时不要使用此选项。

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

Yes = 已激活对引用参数的访问权限以及从引用参数的访问权限（通过映射参数 Value）。

No = 对引用参数的访问权限以及从引用参数的访问权限已被停用，且参数 Status 已禁用。参数 DisplayName 和 DisplayHierarchy 无效。

Examples of Use

以下示例展示了 StringParamReference 运算符的用法：

  上一页     返回上一级     下一步  
内容 顶部 主页