Zeigerinstrument

Referenz der Dashboard-Komponente für das radiale Zeigerinstrument, seine Geometrie, die Voreinstellungen, die Anzeige, die Bereiche der Skala und alle Eigenschaften des Editors.

Als Markdown ansehen

Das Zeigerinstrument zeichnet einen numerischen Datenpunkt auf ein radiales Zifferblatt. Alles daran ist eine Aussage darüber, was das Zifferblatt ist: sein Bogen, was auf den Messwert zeigt, welche Teile der Skala gezeichnet werden, was der Messwert sagt und womit er gemalt ist. Hat der Datenpunkt keinen Messwert (schlechte Qualität, eine nicht aufgelöste Adresse), verschwinden Zeiger, Füllung und Wert zusammen, und das Zifferblatt zeigt das Zeichen für die Lücke (—) an der Stelle einer Zahl; die Bahn mit ihren Bereichen bleibt, denn die Bereiche sind eine Erklärung und keine Messung. Auch NaN ist ein Messwert und keine Lücke: Das Zifferblatt schreibt dieses Wort neben seine Einheit und zeigt auf nichts, denn NaN hat keinen Platz auf der Skala.

Inhalt und Daten

Eigenschaft	Was sie tut	Werte	Vorgabe
Beschriftung	Wahlweise eine Bildunterschrift, die unter den Messwert geschrieben wird.	Text	leer
Adresse	Verwurzelte Logic-Adresse des gezeigten numerischen Datenpunkts. Das Feld schlägt aus der Liste der lebenden Datenpunkte vor, auf numerische Datenpunkte eingeengt, und zeigt den aktuellen Messwert des Datenpunkts, sobald er benannt ist.	Adresse	leer

Format

Eigenschaft	Was sie tut	Werte	Vorgabe
Min.	Wo die Skala beginnt, in der technischen Einheit des Datenpunkts.	Zahl	0
Max.	Wo die Skala endet.	Zahl	100
Einheit	Wahlweise ein Einheitenzeichen, das neben den Wert geschrieben wird.	Text	leer
Dezimalstellen	Feste Nachkommastellen für die Anzeige. Bleibt das Feld leer, wird ein Datenpunkt, dessen Typ eine Ganzzahl ist, ohne Nachkommastellen geschrieben und jede andere Zahl mit den Stellen der Station. Die Stellen des Messwerts sind zugleich das Höchste, was eine Zahl rund um den Bogen trägt: die hier eingetragenen oder, bei leerem Feld, die des Datenpunkts selbst (keine bei einer Ganzzahl, die der Station bei jeder anderen Zahl, und die der Station, bis der Datenpunkt zum ersten Mal antwortet). Jede Zahl des Bogens trägt nur die Stellen, die sie braucht, ein Zifferblatt mit ganzen Teilungen liest also 30 und 60, nicht 30,0 und 60,0.	0 bis 15	leer verwendet die Vorgabe der Station
Ziffern	Wie viele Stellen der mittige Messwert vor dem Dezimaltrennzeichen reserviert. Das entscheidet zugleich, wann ein Wert als zu breit für sein Feld markiert wird (`####`, mit dem ganzen Messwert im Tooltip). Ein Datenpunkt, der in Worten antwortet (ein Auftrag, eine Charge, ein Kennzeichen), trägt dieses Zeichen nie: was die Mitte des Zifferblatts nicht fasst, endet in Auslassungspunkten (…), mit dem ganzen Messwert im Tooltip.	1 bis 20	leer leitet es aus dem größeren von Min. und Max. ab
Schriftgröße	Ob die Zelle über die Schriftgröße entscheidet oder der Bediener sie angibt. Eine angegebene Größe ist wörtlich: sie wird in jeder Zelle in dieser Größe gezeichnet und nie verkleinert, damit etwas passt. Entscheidet die Zelle, wird der Messwert so groß geschrieben, wie der Raum zwischen dem Bogen und seinen Zahlen es zulässt, und nie kleiner als 11 Pixel. Ist der Messwert breiter als der Raum, den das Zifferblatt ihm lässt, in der angegebenen Größe oder, wenn die Zelle entscheidet, schon bei 11 Pixeln, schreibt das Zifferblatt `####` anstelle der Zahl, mit dem ganzen Messwert im Tooltip. Ein Messwert in Worten trägt dieses Zeichen nie und behält seine Auslassungspunkte.	So groß, wie die Zelle es zulässt · Eine Größe, die ich angebe	So groß, wie die Zelle es zulässt
Punkt	Die angegebene Größe. Nur im angegebenen Modus gezeigt.	9 bis 144	12
Liest sich als	Wie der Messwert ausgeschrieben wird.	Zahl · Prozent · Dauer	Zahl
Der Wert zählt in	Was eine Einheit des Werts bedeutet, solange das Format eine Dauer ist.	Sekunden · Millisekunden · Minuten	Sekunden
Den Messwert schreiben	Ob der Messwert im Zifferblatt geschrieben wird.	ein / aus	ein
Die Beschriftung schreiben	Ob die Beschriftung unter dem Messwert mitfährt.	ein / aus	ein

Zifferblatt

Winkel laufen gegen den Uhrzeigersinn von drei Uhr aus, also legt 225° bis −45° die Mitte der Skala nach oben. Eine Voreinstellung ist eine Abkürzung, keine Identität: eine anzuwenden schreibt die Felder der Geometrie und der Anzeige darunter und wird dann vergessen, jedes Feld bleibt danach also einzeln bearbeitbar. Was eine Voreinstellung nicht anrührt, nämlich die Adresse, die Enden der Skala, das Format, die Bereiche, die Referenz, der Akzent und die Frage, ob Messwert und Beschriftung geschrieben werden, bleibt unberührt.

Voreinstellung	Was sie schreibt
Zifferblatt	Anfang 225°, Ende −45°, im Uhrzeigersinn, 10 Teilungen, Nadel als Zeiger, Füllung bis zum Messwert, Teilstriche und Bezifferung ein. Die Form, mit der ein Zeigerinstrument geboren wird, und der Weg zurück von den beiden anderen.
Halbkreis	Anfang 180°, Ende 0°, im Uhrzeigersinn, 5 Teilungen (der halbe Bogen trägt den halben Platz für Zahlen), Nadel, Füllung, Teilstriche und Bezifferung ein.
Ringform	Anfang 90°, Ende −270° (eine ganze Umdrehung), im Uhrzeigersinn, kein Zeiger, Füllung bis zum Messwert ein, Teilstriche und Bezifferung aus: der Bogen selbst ist die Anzeige.

Eigenschaft	Was sie tut	Werte	Vorgabe
Anfang	Wo der Bogen beginnt, in Grad gegen den Uhrzeigersinn von drei Uhr aus.	−360 bis 360	225
Ende	Wo der Bogen endet. Es darf negativ sein und darf vom Anfang aus eine ganze Umdrehung überschreiten.	−360 bis 360	−45
Teilungen	In wie viele Teilungen die Skala geschnitten wird, und damit, wie viele Teilstriche der Bogen trägt; ein kleines Zifferblatt beziffert davon womöglich weniger (siehe Die Teilungen beziffern).	1 bis 50	10
Der Wert wächst im Uhrzeigersinn	An welchem Ende des Bogens das Minimum sitzt: am Anfangswinkel, mit dem Wert, der im Uhrzeigersinn wächst (die Richtung, in der ein Zifferblatt gewöhnlich gelesen wird), oder derselbe Bogen andersherum begangen.	ein / aus	ein
Die Teilstriche zeichnen	Ob die Teilstriche auf dem Bogen gezeichnet werden.	ein / aus	ein
Die Teilungen beziffern	Ob die Teilungen rund um den Bogen beziffert werden. Die Zahlen werden mit dem Dezimaltrennzeichen der Station und seinem Gruppierungszeichen geschrieben, jede nur mit den Stellen, die sie braucht, höchstens mit denen des Messwerts: ein Zifferblatt mit ganzen Teilungen liest 30 und 60, mit wie vielen Stellen der Messwert auch geschrieben wird, und eine Teilung, die diese Stellen nicht fassen, wird auf sie gerundet, eine Zählung von 0 bis 100 in drei Teilungen wird also mit 0, 33, 67 und 100 beziffert. Einheit, Prozentzeichen und Uhr gehören zum Messwert in der Mitte, nie zum Bogen. Ist das Zifferblatt zu klein, um jede Zahl frei von der nächsten zu schreiben, beziffert es weniger Teilungen in gleichem Schritt (zum Beispiel jede zweite oder jede fünfte von zehn), stets mit beiden Enden der Skala, und keine, wo nicht einmal die beiden Enden passen. Auf einem Zifferblatt, das eine volle Umdrehung schließt, fällt das Ende der Skala auf ihren Anfang, und nur der Anfang wird beziffert.	ein / aus	ein

Ein Winkel, der außerhalb seines Bandes getippt wird, wird am nächsten Rand genommen, und der Bereich sagt das; Text, der keine Zahl ist, lässt den Winkel in Kraft.

Eigenschaft	Was sie tut	Werte	Vorgabe
Zeiger	Was auf dem Bogen auf den Messwert zeigt. Der Wert, seine Qualität und der Bereich, in den er fällt, sind dieselben, was auch gezeichnet wird.	Nadel · Marke auf dem Bogen · Kein Zeiger	Nadel
Den Bogen bis zum Messwert füllen	Ob sich der Bogen vom Anfang der Skala bis zum Messwert füllt.	ein / aus	ein
Akzent	Woher die Farbe der Anzeige kommt.	Die übliche Schriftfarbe · Eine Farbe · Ein Farbdatenpunkt	Die übliche Schriftfarbe
Hell / Dunkel	Der Akzent als Paar für das helle und das dunkle Design, beide angegeben, weil das laufende Design entscheidet, welche Hälfte auf dem Bild ist. Nur gezeigt, solange der Akzent eine Farbe ist.	je `#RRGGBB`	`#5470C6` für beide
Farbdatenpunkt	Verwurzelte Logic-Adresse eines Farbdatenpunkts, dem der Akzent folgt. Nur gezeigt, solange der Akzent ein Farbdatenpunkt ist.	Adresse	leer

Skalierung

Der gemeinsame Abschnitt Skalierung erklärt die Abschnitte der Skala und was jeder bedeutet, dazu die Referenz, die das Zifferblatt markiert.

Jeder Bereich deckt alles bis zu seiner Grenze ab, von dort, wo der Bereich über ihm in der Liste endete, die Grenze ist also zugleich der Platz des Bereichs; ein Messwert hinter der letzten Grenze gehört zu keinem Bereich und nimmt die übliche Schriftfarbe. Der Ton, also Unauffällig, Hinweis, Erfolg, Vorsicht oder Kritisch, ist der eigene Wortschatz der Oberfläche, und das Design entscheidet über die Farbe. Einem Bereich ein Wort zu geben benennt den Zustand, und das Zeigerinstrument kann dieses Wort neben seinem Messwert zeigen.
Die Referenz markiert einen Sollwert oder einen Nennwert auf der Skala: nichts, ein fester Wert oder ein Datenpunkt, der sich mit dem Rezept bewegt. Sie wird nur gezeichnet, solange die Skala sie erreicht.