WklGauge and WklKpiCard

Two controls for start pages and status pages: WklGauge shows a value on a scale with colored ranges, WklKpiCard shows a key figure with its deviation from a comparison value, a status, a sparkline and a badge.

None

• How to: Build a start page with key figures
• How to: Print gauges and charts in a report: one gauge per record, ranges told apart by pattern on a grayscale printout (PrintStyle).

┌ CPU ─────────────┐   ┌ Locked accounts ───────(3)┐
│    ╭────────╮     │   │ ( Action needed )          │
│  ╭─┘  87 %  └─╮   │ ▌ │ 1   ▲ +1                   │
│  ① ② ③ ④     │   │ last reading               │
│  Average 5 min    │   │ ╱╲__╱‾‾╲                  │
└───────────────────┘   └────────────────────────────┘

• Colors by meaning. Both controls take their colors from the status kinds (wskOk, wskWarn, wskBad, wskInfo, wskNeutral, wskMuted) that WklStatusLabel, WklBadge, WklButton and the status columns of WklGrid use; in Windows high contrast mode the system colors.
• Bound or set by code. Steuerelementinhalt writes a field into Value on every record change; a start page sets Value from a timer instead.
• Quiet updates. A gauge glides to a new value (off with Windows animations off) and tells screen readers only when the value moves into another range (RangeChange); a card is not announced at all, and screen readers read its statement when they reach it.
• Shapes. Half circle, three-quarter circle, horizontal and vertical bar; filled or with a needle; several bars with a legend, side by side or stacked.
• Clicks with a key. Click(Key) on both, so one procedure opens the right list for every card.

The controls draw themselves (no Access controls inside) and are bound like WklStatusLabel: Value is the default bound property and is never written back. What is shown is computed by the core of the framework (GaugeReading, KpiReading): position on the scale, kind of the range, the formatted text and the statement for screen readers, the same in the window, in design view and in print preview. The values of bars and the points of a sparkline belong to the running form and are not saved with it.

• How to: Install the released package
• How to: Deploy an application with WKL controls to user PCs
• What the per-user registration writes

None

• API reference: WklGauge
• API reference: WklKpiCard

None