WklGauge und WklKpiCard

Zwei Steuerelemente für Start- und Statusseiten: WklGauge zeigt einen Wert auf einer Skala mit farbigen Bereichen, WklKpiCard zeigt eine Kennzahl mit ihrer Abweichung von einem Vergleichswert, einem Status, einer Sparkline und einem Badge.

Erste Schritte

Keine

Häufige Aufgaben

Startseite mit Kennzahlen aufbauen
Messanzeigen und Diagramme in einem Bericht drucken: eine Messanzeige je Datensatz, Bereiche auf einem Graustufenausdruck durch Muster unterschieden (PrintStyle).

Schaubild

+ CPU --------------+   + Gesperrte Personen -----(3)+
|     +--------+    |   |#( Handlung nötig )         |
|   +-+  87 %  +-+  |   |# 1   ^ +1                  |
|   1  2  3   4     |   |# letzte Messung            |
|  Mittel 5 min     |   |#  /\__/--\                 |
+-------------------+   +----------------------------+

Bereich	Bedeutung
1 2 3	Bereiche der Skala in den hellen Farben ihrer Arten (`AddRange`): in Ordnung, Warnung, schlecht.
4	Der Wert als Füllung (oder Zeiger) in der kräftigen Farbe des Bereichs, in dem er liegt; eine Markierung kann ein Ziel zeigen.
( Handlung nötig ) und `#`	`StatusText` als Pille und als Streifen in der Farbe von `StatusKind`.
`^ +1`	Die Abweichung `Value - Compare` in der Textfarbe von `DeltaKind`.
(3)	`BadgeCount` in der Farbe von `BadgeKind`.
`/\__/`	Die Sparkline der letzten Punkte (`AddPoint`, `SetSeries`).

Wichtige Funktionen

Farben nach Bedeutung. Beide Steuerelemente beziehen ihre Farben aus den Statusarten (wskOk, wskWarn, wskBad, wskInfo, wskNeutral, wskMuted), die auch WklStatusLabel, WklBadge, WklButton und die Statusspalten von WklGrid verwenden; im Modus „Hoher Kontrast“ von Windows die Systemfarben.
Gebunden oder per Code gesetzt. Steuerelementinhalt schreibt bei jedem Datensatzwechsel ein Feld in Value; eine Startseite setzt Value stattdessen aus einem Zeitgeber.
Ruhige Aktualisierung. Eine Messanzeige gleitet zu einem neuen Wert (nicht, wenn die Windows-Animationen ausgeschaltet sind) und meldet sich bei Sprachausgaben nur, wenn der Wert in einen anderen Bereich wechselt (RangeChange). Eine Karte wird gar nicht angesagt; Sprachausgaben lesen ihre Aussage, wenn sie die Karte erreichen.
Formen. Halbkreis, Dreiviertelkreis, waagerechter und senkrechter Balken; gefüllt oder mit Zeiger; mehrere Balken mit Legende, nebeneinander oder gestapelt.
Klicks mit Schlüssel. Click(Key) bei beiden; eine einzige Prozedur öffnet so für jede Karte die richtige Liste.

Grundkonzepte

Die Steuerelemente zeichnen sich selbst (ohne Access-Steuerelemente im Inneren) und werden wie WklStatusLabel gebunden: Value ist die standardmäßig gebundene Eigenschaft und wird nie zurückgeschrieben. Was angezeigt wird, berechnet der Kern des Frameworks (GaugeReading, KpiReading): Position auf der Skala, Art des Bereichs, der formatierte Text und die Aussage für Sprachausgaben – im Fenster, in der Entwurfsansicht und in der Seitenansicht gleich. Die Werte der Balken und die Punkte einer Sparkline gehören zum laufenden Formular und werden nicht mit ihm gespeichert.

Administration

Fehlerbehebung