# Gráfico de barras

> Referencia del componente Gráfico de barras, la comparación categórica de puntos en vivo, con todas sus propiedades del editor.

El **Gráfico de barras** compara puntos en vivo uno junto a otro: una barra por dirección, leída en
este momento. Es un gráfico categórico, no un gráfico de tiempo: no hay eje de tiempo, ni ventana,
ni cadencia de muestreo, ni retención por detrás. Para seguir puntos a lo largo del tiempo, use el
[Gráfico de líneas](component-line-chart).

Un punto que no está leyendo se deja fuera de la comparación en lugar de dibujarse a cero, y el
gráfico lo dice bajo el dibujo (`1 de 4 puntos no está leyendo y se deja fuera.`). Un sinóptico que
acaba de abrirse todavía no dice nada: no leído todavía no es lo mismo que no leyendo.

## Contenido y puntos {#content-and-points}

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Título del gráfico | Encabezado opcional dibujado dentro del trazado. Es el encabezado propio del gráfico, no el título de esquina del componente (ese vive en la sección Apariencia compartida). | texto | vacío |
| Puntos | Las categorías comparadas, una tarjeta por barra, en el orden declarado. Cada tarjeta contiene los tres campos de abajo. **Añadir punto** añade una. | lista | vacío |
| Dirección | La dirección de Logic con raíz que lee la barra. El campo sugiere de la lista de puntos en vivo, filtrada a puntos numéricos, y muestra la lectura actual del punto una vez nombrado. | dirección | vacío |
| Nombre | Cómo llaman a la barra el eje y la leyenda. | texto | en blanco recae en la dirección |
| Color del punto | La tinta de la barra como `#RRGGBB`. | color hexadecimal | en blanco toma el turno de la paleta |
| Orden | El orden en el que se dibujan las barras. El orden declarado conserva una estación donde la puso el operador, produjera lo que produjera; ordenar responde en cambio a quién va en cabeza. | tal como se declaran · de menor a mayor · de mayor a menor | tal como se declaran |

## Formato {#format}

Una sola declaración para el gráfico entero, en las barras, en las informaciones emergentes y en
las etiquetas por igual, porque un gráfico escribe un número de una sola manera.

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Unidad | Unidad de ingeniería opcional escrita después de cada lectura. | texto | vacío |
| Decimales | Decimales fijos para las lecturas. | de 0 a 15 | en blanco usa la preferencia de la estación |
| Se lee como | Cómo se escribe cada lectura. El propio valor no se reescala nunca por la elección. | Número · Porcentaje · Duración | Número |
| El valor cuenta | Qué significa una unidad del valor mientras el formato es una duración. Se muestra solo para ese formato. | Segundos · Milisegundos · Minutos | Segundos |

## Barras {#bars}

| Propiedad | Qué hace | Valores | Por defecto |
|---|---|---|---|
| Tumbar las barras | Dibuja las barras en horizontal. Los nombres largos se leen mejor a lo ancho que bajo una barra. Cuando la celda es demasiado estrecha para los nombres, las lecturas y la escala uno junto a otro, cede espacio en este orden: un nombre más largo que su parte del ancho termina en puntos suspensivos, después se omiten las lecturas y después los propios nombres. La información emergente sobre una barra sigue mostrando su nombre entero y su lectura, y cada parte vuelve en cuanto la celda es lo bastante ancha para ella. | activado / desactivado | desactivado |
| Apilarlas en una sola barra | Apila las categorías en una sola barra en lugar de ponerlas una junto a otra. Una junto a otra responde a "cuánto hizo cada una"; apiladas responden a "cómo se divide el todo", que es la pregunta del gráfico circular dibujada recta. | activado / desactivado | desactivado |
| Escribir cada lectura en su barra | Escribe el valor con formato en todas las barras. Una celda demasiado baja para escribir las lecturas sobre las barras de pie o, con las barras tumbadas, demasiado estrecha para escribirlas junto a ellas las deja a la información emergente. Una lectura que quedaría escrita sobre la de su vecina también se omite y queda en la información emergente. | activado / desactivado | activado |
| Mín | El suelo en el que se retiene el eje de valores, en la unidad propia de las lecturas. En blanco deja que el eje se reajuste a lo que se esté leyendo, lo que pone la barra más alta en lo alto del trazado midiera lo que midiera. Una escala retenida es lo que hace comparables dos vistazos. | número | en blanco (automático) |
| Máx | El techo en el que se retiene el eje de valores. Los dos extremos son independientes: un suelo puede retener mientras el techo sigue a los datos. | número | en blanco (automático) |
| Leyenda | Dónde se sitúa la leyenda. Se ofrece solo mientras las barras están apiladas: separadas, las barras ya están nombradas en el eje y una leyenda imprimiría dos veces la misma lista; apiladas en una columna, la leyenda es lo único que puede distinguir los segmentos. Una celda demasiado estrecha para escribir todos los nombres en la única línea de la leyenda enumera los segmentos, uno por línea: un nombre más largo que su línea termina en puntos suspensivos y la información emergente sobre la línea lo muestra entero. La lista ocupa como mucho cinco líneas, y menos en una celda demasiado baja para dejar además al trazado un tercio de su altura: con más segmentos que líneas, los muestra página a página, con las flechas y el contador de páginas (como 1/3) en su última línea. La línea vuelve en cuanto la celda es lo bastante ancha. | encima del trazado · debajo del trazado · ninguna | encima del trazado |

Una celda demasiado pequeña para todo omite partes antes de que el trazado quede demasiado pequeño
para leerse. En una celda baja, las barras de pie una junto a otra omiten primero las lecturas
sobre ellas y después los nombres bajo ellas, y las barras tumbadas, una junto a otra o apiladas,
omiten los números de la escala bajo ellas. En una celda estrecha, las barras de pie, una junto a
otra o apiladas, omiten los números de la escala junto a ellas, y un nombre bajo una barra que ya
no cabe termina en puntos suspensivos. La información emergente sobre una barra sigue mostrando su
nombre y su lectura, y cada parte vuelve en cuanto la celda tiene sitio para ella.

## Bandas de escala {#scale-bands}

La sección **Escala** declara tramos del intervalo de valores y lo que significa cada uno, con el
mismo editor de bandas que comparten todos los componentes de visualización. En un gráfico de
barras, las bandas son una paleta: tiñen las barras según dónde caiga cada lectura, y nada más. Se
comparan varias lecturas a la vez, así que no hay un único tramo en el que el dibujo *esté*; aquí
las bandas no llevan campo de texto y no se ofrece ninguna marca de referencia.

Cada banda cubre todo hasta su límite, desde donde terminó la banda que está encima de ella en la
lista; una lectura que pasa del último límite no pertenece a ninguna banda y conserva la tinta
escrita de la barra. El tono nombra el significado (Neutro, Información, Correcto, Precaución,
Crítico) y el tema en marcha decide la pintura.

## Caja de herramientas {#toolbox}

La sección **Caja de herramientas** elige qué botones recibe el operador en este gráfico. Una
comparación no tiene ningún eje que recorrer, así que solo se ofrecen las herramientas que puede
honrar; sin ninguna de ellas marcada no se dibuja ninguna barra de herramientas.

| Herramienta | Qué hace | En el conjunto por defecto |
|---|---|---|
| Guardar PNG | Descarga el dibujo como un PNG. | sí |
| Copiar PNG | Pone el dibujo en el portapapeles como un PNG. | sí |
| Pantalla completa | Llena la ventana con este gráfico. | sí |