Botón

La tecla de mando: escribe un valor preestablecido, dispara un comando de corrida de una unidad, abre otro panel de control o ejecuta una acción de Logic.

Ver como Markdown

Botón es la tecla de mando de la paleta. Un clic hace la única cosa que declara el componente, su acción, y el panel de propiedades pide entonces solo los campos propios de esa acción, así que ningún campo se queda en pantalla bajo una regla escondida sobre cuándo cuenta. Es un componente de Mando; uno nuevo ocupa 3 × 1 celdas.

Sea cual sea la acción, el botón lleva su propio aspecto: un par de colores y un icono opcional. En un panel de operación, el botón es la pieza a la que va la mano del operador, y el color y la marca son lo que hace que se encuentre de un vistazo.

Contenido

Campo	Qué hace	Valores	Predeterminado
Etiqueta	El rótulo de la tecla. Vacío cae de vuelta a aquello que apunta la acción elegida: el último segmento de dirección del punto escrito, el nombre del panel de control de destino, o el nombre de la acción de Logic vinculada, y "(sin punto)", "(sin panel de control)", "(sin acción)" o "(falta)" mientras no haya nada que nombrar.	Texto libre	vacío

Acción

Campo	Qué hace	Valores	Predeterminado
Al hacer clic	Qué hace el clic. Todos los campos de abajo son de la acción elegida.	`Escribir un valor` · `Ejecutar un comando de unidad` · `Abrir otro panel de control` · `Ejecutar una acción de Logic`	`Escribir un valor`

Escribir un valor

Campo	Qué hace	Valores	Predeterminado
Punto	El punto escrito. La lista se estrecha a lo que de verdad se puede escribir: las variables de memoria y los tags que no son de solo lectura.	Texto libre; sugerencias de puntos escribibles	vacío
Valor escrito	El literal preestablecido que se manda en cada clic. Se lee primero contra el propio tipo del punto, así que un valor que el punto no puede contener se rechaza en la línea de respuesta del botón y nunca llega a la cola.	Texto libre	`true`

La escritura pasa por el punto único de escritura de la lógica de la estación y queda registrada como cualquier otra escritura; la línea de respuesta dice "Escrito".

Ejecutar un comando de unidad

Campo	Qué hace	Valores	Predeterminado
Comando	Un punto de comando de corrida de una unidad (`Process.<Model>.<Unit>.Commands.*`). Disparar el comando es la instrucción entera: no hay ningún valor que escribir.	Texto libre; la lista ofrece los puntos de comando de corrida de la unidad	vacío

Un punto de comando lee "se puede ejecutar ahora", así que el botón se desactiva solo mientras el comando no aplica; un Arrancar con el runtime bloqueado muestra además el motivo del bloqueo. La pulsación ejecuta el comando contra la unidad, atribuido al operador con la sesión iniciada, y la línea de respuesta nombra el comando que corrió.

Abrir otro panel de control

Campo	Qué hace	Valores	Predeterminado
Panel de control	El sinóptico de destino. El selector enumera los paneles de control de la estación; los sinópticos definidos sobre un modelo de Process no se ofrecen, porque solo abren desde una unidad.	`(ninguno)` o un panel de control	`(ninguno)`

Cambiar de sinóptico es un gesto de operación: un panel que corre a pantalla completa se queda a pantalla completa cuando el operador llega. La referencia es floja: un sinóptico que se eliminó, o que el rol con la sesión iniciada no ve, no desactiva nada más; la pulsación contesta "Ese panel de control no está disponible." en la línea propia del botón en lugar de romper el sinóptico.

Ejecutar una acción de Logic

Campo	Qué hace	Valores	Predeterminado
Acción	La acción de Logic vinculada (véase la página Logic).	`(ninguna)` o una acción	`(ninguna)`

La acción corre en la cola de la lógica, registrada como venida del panel de control. La línea de respuesta informa del resultado: "Ejecutado · 12 ms", o el error propio de la acción. Una acción eliminada o desactivada desactiva el botón en lugar de romperlo.

Color e icono

Se leen sea cual sea la acción:

Campo	Qué hace	Valores	Predeterminado
Color del botón	La cara de la tecla, como un par, una mitad por tema, las dos en pantalla a la vez, porque el tema en marcha decide cuál pinta. Un hexadecimal a medio escribir se rechaza y los campos regresan de golpe a los colores en vigor. Lo que significa un color es su convención; la aplicación no lee ninguna.	`#RRGGBB` cada uno	`#FFFFFF` claro · `#2B2B2B` oscuro
Icono	Marca opcional delante del rótulo, elegida de la biblioteca de iconos de la aplicación (unas 2770 marcas), buscada por nombre o etiqueta ("reproducir, detener, advertencia…"). La celda `—` es la elección de ningún icono.	Glifo del catálogo o ninguno	ninguno

La tinta del rótulo es derivada, nunca escrita: sobre cada mitad de la cara, la aplicación elige cuál de sus dos tonos de texto contrasta mejor, así que ningún color que usted elija puede dejar el rótulo ilegible. El rótulo se dimensiona con el contrato de presentación compartido: lo que la tecla no puede sostener se corta con puntos suspensivos, con el rótulo completo en la información emergente.

Los permisos y el candado

Toda acción necesita el permiso del rol para operar paneles de control. Lo que una pulsación necesita además de eso se lee de su objetivo, no de la clase: solo Ejecutar un comando de unidad llega a una mutación de Process y necesita además el permiso de ejecutar procedimientos. Una pulsación que el rol con la sesión iniciada no puede hacer dibuja la marca de candado compartida con el motivo en la información emergente del componente (véase la página de paneles de control); la autorización se vuelve a verificar en el clic. La línea de respuesta transitoria vence a los pocos segundos.

Las secciones compartidas Apariencia, Identificación, Posición y capa y Acciones se describen en la página de componentes.