WklButton

WklButton ist die Befehlsschaltfläche im aktuellen Office-Stil für Access-Formulare: Beschriftung mit Zugriffstaste, ein Symbol aus Segoe Fluent Icons, vier Stile und als Variante im selben Steuerelement eine Menü-, eine geteilte oder eine Segmentschaltfläche. Sie ist für Befehlsleisten in Formularköpfen und für Dialoge gedacht; für den Entwickler verhält sie sich wie die Befehlsschaltfläche von Access.

Erste Schritte

Eine Befehlsleiste bauen

Häufige Aufgaben

Schaubild

+- frmKunden: Formularkopf ------------------------------------------------------------+
|  Kunden                     [1 (+) Neu ] [2 (S) Speichern | v ] [3 Ansicht v] [4 (!)3] |
|                             [5  Liste | Karten | Karte ]                              |
+--------------------------------------------------------------------------------------+
                              [3] geöffnet:
                              +-----------------------------+
                              | (+) Neu            Strg+N   |
                              |-----------------------------|
                              |  *  Tag                     |
                              |     Woche                   |
                              | (E) Exportieren          >  |---+ Excel |
                              |     Alle löschen (gesperrt) |   | PDF   |
                              +-----------------------------+   +-------+

Bereich	Bedeutung
1	Befehlsschaltfläche (`Kind = wbkButton`), Stil „Hauptbefehl“ (`wbsPrimary`): löst `Click` aus
2	Geteilte Schaltfläche (`wbkSplit`): Der Hauptteil löst `Click` aus, der Pfeil öffnet das Menü mit den Varianten („Speichern unter“)
3	Menüschaltfläche (`wbkMenu`), Stil „Unauffällig“ (`wbsSubtle`): öffnet das Menü – Einträge mit Symbol und Text der Tastenkombination, eine Optionsgruppe, ein Untermenü, ein deaktivierter Eintrag
4	Schaltfläche, die nur ihr Symbol zeigt (`GlyphPosition = wgpOnly`), mit einem Zähler-Badge (`BadgeCount`)
5	Segmentschaltfläche (`wbkSegment`): Optionen nebeneinander, eine davon ausgewählt; `Change`, wenn der Benutzer eine andere wählt

Wichtige Funktionen

Ein Steuerelement, vier Arten (Kind): Befehlsschaltfläche, Menüschaltfläche, geteilte Schaltfläche, Segmente.
Office-Stil: abgerundete Ecken, die Fluent-Stile Standard, Hauptbefehl, Unauffällig und Gefährlich, Zustände für Zeigen und Drücken, der zweifarbige Fokusrahmen; im hohen Kontrast die Systemfarben.
Menüs ohne CommandBars: Einträge mit Symbol, Text der Tastenkombination, Häkchen, Optionsgruppe, Grund der Deaktivierung und einer Untermenüebene, entworfen mit dem Formular oder im Code unmittelbar vor dem Öffnen gefüllt (DropDown). Dasselbe Menü läuft in Access, in Access Runtime, in Excel und in Word.
Segmente wie eine Optionsgruppe: ein Tabstopp, die Pfeiltasten wählen aus, eine Einfachauswahl kann der Benutzer nicht aufheben; MultiSelect macht jedes Segment zu einem Umschalter.
Zähler-Badge (BadgeCount, BadgeKind, BadgeDot) in den Farben der Badges von WklNavBar.
Access-Konventionen bleiben erhalten: Caption mit &, Click; Enabled, Visible, ControlTipText und TabStop sind die Eigenschaften, die Access jedem Steuerelement gibt. Ereignisse treten erst ein, wenn der Klick oder das Menü beendet ist; eine Ereignisprozedur darf daher ein Meldungsfenster zeigen oder das Formular schließen.
Designer (Zeile Benutzerdefiniert [...]): Art, Beschriftung, Symbol, Stil, Badge, Farben, das Menü und die Segmente als Tabellen, mit einer Vorschau.
Tastatur und Sprachausgaben: Leertaste und Eingabetaste drücken die Schaltfläche, Alt+Nach-unten oder F4 öffnen das Menü; Sprachausgaben hören eine Schaltfläche, eine geteilte Schaltfläche oder eine Liste von Optionen mit der Beschriftung und dem Zählerstand des Badges.

Grundkonzepte

Für den Entwickler gilt die Seite von Access. Ein WklButton wird genau wie eine Befehlsschaltfläche aktiviert, ausgeblendet, mit einer QuickInfo versehen und in die Aktivierreihenfolge aufgenommen – über das Eigenschaftenblatt und dieselben Eigenschaften im Code. Steht Enabled auf Nein, entfernt Access das Fenster des Steuerelements; die Schaltfläche zeichnet sich dann selbst grau.

Entwurfszeit und Laufzeit. Was in der Entwurfsansicht festgelegt wird – Beschriftung, Stil, Menü, Segmente und deren Auswahl –, wird mit dem Formular gespeichert. Änderungen per Code in der Formularansicht (das Menü in Form_Load füllen, ein Zählerstand des Badges, die Auswahl) ändern das Formular nicht und werden nicht gespeichert. Code, der das Menü füllt, beginnt mit ClearMenu, weil ein Schlüssel nur einmal vorkommen darf.

Ereignisse kommen vom Benutzer. Click, DropDown, MenuItemClick und Change melden, was der Benutzer getan hat – mit der Maus, der Tastatur oder einer Sprachausgabe. Wer SelectedKey oder MenuItemChecked per Code setzt, löst nichts aus, so wie das Setzen des Werts eines Access-Steuerelements kein AfterUpdate auslöst.

Administration

Fehlerbehebung

Eine deaktivierte Schaltfläche oder ein deaktivierter Schalter wird nicht gezeichnet

Für Entwickler

API-Referenz (Englisch): WklButton