Parametrizar visualización con interfaz

Puede declarar una interfaz para parámetros en una visualización a la que se hace referencia. Cuando se llama a la visualización en tiempo de ejecución, los parámetros reales se pasan a la interfaz, de forma similar a un bloque de funciones.

Este tipo de visualización se utiliza como plantilla de visualización a la que hace referencia una visualización superior a través de un marco o elemento de pestaña. Las variables de la interfaz se declaran en el editor de interfaz de la visualización de la plantilla. En la visualización superior que llama a la visualización de plantilla, los parámetros de transferencia se asignan al elemento de referencia (marco o pestaña).

En primer lugar, declare las variables de la interfaz en el editor de interfaz de la visualización de la plantilla. Luego configure los parámetros asignando una variable de aplicación compatible con el tipo de datos a cada variable de interfaz. Los parámetros se asignan al elemento de marco (o elemento de pestaña) en las propiedades del elemento (Propiedades vista).

Dependiendo de la variante de representación, la transferencia de parámetros de variables locales (con alcance VAR) restringido.

Nota

Si ejecuta la visualización como una visualización integrada, solo podrá transferir como parámetros variables locales que tengan un tipo de datos básico. Si la visualización se llama como CODESYS TargetVisu o CODESYS WebVisu, también podrá transferir parámetros con un tipo de datos definido por el usuario.

Asistencia al actualizar los parámetros del marco.

Si cambia las variables de la interfaz en una plantilla de visualización, recibirá ayuda para actualizar las ubicaciones de ocurrencia.

Durante la compilación se detectan los lugares cuya transferencia de parámetros ya no es válida y se muestran en la vista de mensajes. Se muestra el siguiente mensaje de error para cada ubicación detectada: La interfaz de la visualización referenciada. <nombre de la visualización> no coincide con la configuración actual. Realice una actualización de las referencias de marco de la visualización actual.

Si hace doble clic en el mensaje, se le ayudará a corregir el error y el Actualizar los parámetros del marco Se abrirá el cuadro de diálogo. Allí podrá editar la transferencia de parámetros en el lugar correspondiente. Sin embargo, también puede editar la transferencia de parámetros de todas las ubicaciones afectadas en todo el proyecto.

Para más información, ver: Actualizar parámetros de cuadro, Opciones: Visualización

Visualización de llamadas con interfaz (VAR_IN_OUT).

Requisito: El proyecto contiene una visualización y una visualización principal. La visualización principal contiene un elemento al que hace referencia la visualización.

Abra la visualización.
Elige el comando Visualización → Editor de interfaz .
Declare una variable en el editor de interfaz.
La visualización tiene una interfaz y el diálogo Actualización de parámetros de cuadro aparece automáticamente.
Asigne un parámetro de transferencia compatible con el tipo a la variable de interfaz en todas las llamadas usando debajo valor especificar una variable de aplicación. Termina el diálogo.
Se asigna un parámetro de transferencia en los puntos donde se hace referencia a la visualización. Estos ahora aparecen en la visualización principal bajo su propiedad visualización referenciada.

ejemplo 17. ejemplo

la visualización visPie contiene un sector de círculo de color animado. La visualización principal visMain llama a la visualización visPie en pestañas arriba varias veces. A través de la variable de interfaz pieToDisplay se pasa información de color, información de ángulo y una etiqueta. En tiempo de ejecución, los sectores del círculo varían en él.

visualización visPie:

tabla 3. Propiedades del elemento Sector:

variable para el comienzo	`pieToDisplay.iStart`
Variable final	`pieToDisplay.iEnd`
Textos → Texto	%s
Variables de texto → Variable de texto	`pieToDisplay.sLabel`
Color variable → estado normal	`pieToDisplay.dwColor`

Interfaz de la visualización visPie:

                            VAR_IN_OUT
                            pieToDisplay : DATAPIE;
                            END_VAR

visualización principal visMain:

tabla 4. Propiedades del elemento Tabulaciones:

Visualizaciones referenciadas
vispie
titular	`A`
`pieToDisplay`	`PLC_PRG.pieA`
vispie
titular	`B`
`pieToDisplay`	`PLC_PRG.pieB`
vispie
titular	`C`
`pieToDisplay`	`PLC_PRG.pieC`

DATAPIE (STRUCT)

TYPE DATAPIE : // Parameter type used in visPie
STRUCT
    dwColor : DWORD; // Color data
    iStart : INT; // Angle data
    iEnd : INT;
    sLabel : STRING;
END_STRUCT
END_TYPE

GVL

{attribute 'qualified_only'}
VAR_GLOBAL CONSTANT
    c_dwBLUE : DWORD := 16#FF0000FF; // Highly opaque
    c_dwGREEN : DWORD := 16#FF00FF00; // Highly opaque
    c_dwYELLOW : DWORD := 16#FFFFFF00; // Highly opaque
    c_dwGREY : DWORD :=16#88888888; // Semitransparent
    c_dwBLACK : DWORD := 16#88000000; // Semitransparent
    c_dwRED: DWORD := 16#FFFF0000;  // Highly opaque
END_VAR

PLC_PRG

PROGRAM PLC_PRG
VAR
    iInit: BOOL := TRUE;
    pieA : DATAPIE; // Used as argument when visPie is called
    pieB : DATAPIE;
    pieC : DATAPIE;
    iDegree : INT; // Variable center angle for the pie element used for animation
END_VAR

IF iInit = TRUE THEN
    pieA.dwColor := GVL.c_dwBLUE;
    pieA.iStart := 0;
    pieA.sLabel := 'Blue';

    pieB.dwColor := GVL.c_dwGREEN;
    pieB.iStart := 22;
    pieB.sLabel := 'Green';

    pieC.dwColor := GVL.c_dwYELLOW;
    pieC.iStart := 45;
    pieC.sLabel := 'Yellow';

    iInit := FALSE;
END_IF
iDegree := (iDegree + 1) MOD 360;
pieA.iEnd := iDegree;
pieB.iEnd := iDegree;
pieC.iEnd := iDegree;

visualización principal visMain en tiempo de ejecución:

Nombre de instancia de salida de un parámetro de transferencia

Para obtener y generar el nombre de instancia de un parámetro de transferencia, puede usar una variable de interfaz (tipo de datos STRING) con pragma {attribute 'parameterstringof'} bajo el alcance VAR_INPUT para implementar.

Hay una visualización y una visualización principal en el proyecto. La visualización principal contiene elementos a los que hace referencia la visualización.

Abra la visualización.
Elige el comando Visualización → Editor de interfaz .
Declarar una variable de interfaz (VAR_IN_OUT).
pieToDisplay : DATAPIE;
En el editor de interfaz, declare una variable (VAR_INPUT) con atributo {attribute 'parameterstringof'}.
{attribute 'parameterstringof' := 'pieToDisplay'}
sNameToDisplay : STRING;
Guarde los cambios.
El diálogo Actualización de parámetros de cuadro no se abre.
Agregar un elemento caja de texto un.
Asignar al cuadro de texto en la propiedad letra, texto un texto de salida.
Visualization of %s
En el Variables de textovariable de texto propiedad, asigne la variable de interfaz al campo de texto.
sNameToDisplay
visPie tiene un encabezado.

ejemplo 18. Ejemplo

los visPie visualización consiste en un pastel hasta ahora. los visMain principales llamadas de visualización visPie en Pestañas tres veces con diferentes parámetros de transferencia.

visPie se amplía con un campo de texto que genera el nombre de los parámetros reales pasados a la visualización. Además, la interfaz de visPie se amplía con una variable de cadena que contiene el nombre de instancia del parámetro de transferencia especificado. En tiempo de ejecución, cada pastel se sobrescribe.

tabla 5. Propiedades del elemento "Campo de texto":

Textos, Texto	`Visualization of %s`
Variables de texto, variable de texto	`sNameToDisplay`

Interfaz de la visPie visualización

VAR_INPUT
    {attribute 'parameterstringof' := 'pieToDisplay'}
    sNameToDisplay : STRING;
END_VAR
VAR_IN_OUT
    pieToDisplay : DATAPIE;
END_VAR