命令“多元可视化元素”

符号：

功能：该命令将打开多元可视化元素对话框，其中包含从模板元素和数组声明派生的配置。您可以在此处重新排列元素，以及它们的数量和对数组数据的索引访问。当您退出对话框时，将从模板元素中创建一个包含类似元素的字段。在新元素的属性中，数组变量现在配置了精确的数组索引。这些新元素是在模板中配置了具有索引访问占位符的数组变量的元素。

调用：菜单栏：可视化; 右键菜单

要求：该可视化处于激活状态，并选择了已配置的模板元素。

对话框“多元可视化元素”

. 基本设置选项卡

元素总数	总数由占位符的索引范围确定，包括高级设置选项卡上的设置。元素的布局可以是一维的(作为列或行)，也可以是二维的(作为表字段)。
水平的	每行元素数默认：占位符$FIRSTDIM$的数组组件数（索引范围）数组示例：axLampIsOn: ARRAY[0..4] OF BOOL; = 5
垂直的	所有元素布局所需的行数 .默认使用索引访问占位符$FIRSTDIM$时：如果占位符的索引范围小于5，则元素的布局是水平的。如果索引范围大于5，则元素的布局尽可能为二次型。使用索引访问占位符$FIRSTDIM$和$SECONDDIM$时：水平元素的数量等于占位符$FIRSTDIM$指定的索引范围的数量。垂直元素的数量等于占位符$SECONDDIM$指定的索引范围的数量。
Offset between elements	新元素之间的距离；影响新元素的位置 0 ：元素的帧重叠一个像素。 1 ：元素接触。 <n> ：元素之间可见n-1像素的距离。
水平的	一行内元素之间的距离(以像素为单位) 示例：2表示一个像素的距离
垂直的	列内元素之间的距离(以像素为单位) 例如，三个像素的距离: 4
元素的排列	新元素定位和排列的起点 .如果垂直或水平 <> 1 从左上方从右上方从左下方从右下方 .如果水平或垂直 = 1 从上方从下方
方向	确定字段中元素的布局（逐行或逐列）逐行逐列

预览	以箭头的形式显示元素的设置布局和方向

.高级设置选项卡

数组访问

基于模板元素，为每个新元素计算访问数组变量的精确索引。该计算基于数组声明中指定的数组索引限制。此处也考虑了设置。

第一维数

替换$FIRSTDIM$的第一个维度的索引的计算准则

第一个新元素将在下面的第一个维度的开始索引中获得指定的值。其他元素都得到一个按增量递增的索引，直到为所有元素计算出一个索引为止。

.示例

开始索引：1
增量：1

第二维数

替换$SECONDDIM$的第二个维度的索引的计算准则

第一个新元素将在第二维数中的开始中获得以下指定的值。其他元素都得到一个按增量递增的索引。

.示例

起始索引：1
增量：1

确定	首先，验证计算的索引是否在数组变量的索引范围内。如果是这样，那么将创建与模板元素匹配的元素，并将其安排为一个字段(行、列或表)。占位符索引将替换为计算出的索引。

.示例

.数组变量的声明

    
VAR
asTexts_Example: ARRAY[1..2,1..2] OF STRING := 
    [ 
        '1A Text', '2A Text', 
        '1B Text', '2B Text' 
    ];
    asToolTips_Example: ARRAY[1..2,1..2] OF STRING := 
     [ 
        '1A Tooltip', '2A Tooltip',  
        '1B Tooltip', '2B Tooltip' 
    ];
    
    axUserInput_Example: ARRAY[1..2,1..2] OF BOOL;
END_VAR

模板元素及其属性配置的可视化

.对话框“多元可视化元素”

基本设置选项卡
元素总数
水平的	2
垂直的	2

Offset between elements
水平的	2
垂直的	2

元素的排列	从左上方
方向	逐行

高级设置选项卡
数组访问
第一维数
开始索引	1
增量	1
第二维数
开始索引	1
增量	1

在runtime中的可视化

.另请参见

配置和扩展可视化元素作为模板