WklActionBar
Der Kopf einer Seite oder eines Anwendungsrahmens: ein Band mit Titel, Untertitel und Status und darunter eine Befehlszeile im Stil der Office-Befehlsleisten.
Erste Schritte
Keine
Häufige Aufgaben
Schaubild
┌──────────────────────────────────────────────────────────────────────────────┐ │ Personen ( Verbunden ) (3) ①│ │ Personen, ihre Schlüssel und Anmeldungen ②│ ├──────────────────────────────────────────────────────────────────────────────┤ │ + Neu ✎ Bearbeiten 🗑 Löschen [ 🔑 Schlüssel ausstellen … | ⌄ ] ··· Weitere ⌄ ⇥ Exportieren … ⟳ Aktualisieren │ │ ③ ④ ⑤ ⑥ │ └──────────────────────────────────────────────────────────────────────────────┘
| Bereich | Bedeutung |
|---|---|
| ① | StatusText als Pille in den Farben von StatusKind, daneben StatusCount. |
| ② | Das Band: Caption (leer: die Beschriftung des Formulars) und Subtitle, in BackColor und ForeColor; ab 1.58 optional ein Logo links, die Texte daneben. |
| ③ | Befehle mit wcpStandard, in der Reihenfolge, in der sie hinzugefügt wurden; ist die Zeile zu schmal, wandern sie in Weitere. |
| ④ | Der Hauptbefehl (wcpPrimary) in der Akzentfarbe; mit untergeordneten Befehlen (Parent) ist er eine geteilte Schaltfläche. |
| ⑤ | Weitere (MoreCaption, MoreGlyph): die Befehle mit wcpMenu, danach die, die nicht in die Zeile passten. |
| ⑥ | Die rechte Gruppe (wcpRight), immer sichtbar. |
Wichtige Funktionen
- Eine Leiste für eine ganze Anwendungsshell. Die Shell setzt die Befehle jeder Seite im Code – als einen JSON-Text (
Commands) oder mitAddCommand– und erhält jede Wahl in einem einzigen Ereignis,CommandClick(Key). - Misst sich selbst. Schaltflächen sind so breit wie ihre Beschriftungen; was nicht passt, wandert vom Ende der Zeile her in Weitere, der Hauptbefehl zuletzt; die rechte Gruppe bleibt stehen.
- Wie Office. Zugriffstasten (
&in Beschriftungen), QuickInfos mit der Tastenkombination („Neu (Strg+N)“), geteilte Schaltflächen, Trennlinien (BeginGroup), ein einziger Tabstopp mit den Pfeiltasten im Inneren und für Sprachausgaben eine Symbolleiste mit Schaltflächen. - Tastenkombinationen für das ganze Formular. Der
Shortcuteines Befehls (^N,{F5}) wirkt, wo immer der Fokus steht, auch in Unterformularen. - Zustand je Datensatz.
CommandEnabled,CommandVisibleundCommandCaptionüber den Schlüssel, für Schaltflächen und Menüeinträge gleichermaßen.
Grundkonzepte
Die Befehlszeile ist 40 Pixel hoch; das Band nimmt den Rest der Höhe des Steuerelements ein. Titel (14 pt) und Untertitel (9 pt) brauchen etwa 48 Pixel Band; geben Sie dem Steuerelement daher mindestens 88 Pixel (1.320 Twips bei 100 %). Bei weniger Höhe zeigt das Band nur den Titel und lässt den Untertitel weg, statt ihn abzuschneiden.
Die Befehle sind ein Modell im Kern des Frameworks (ActionCommands): Schlüssel, Platzierung,
untergeordnete Befehle, Tastenkombinationen und deren Regeln sowie die Anordnung einer Zeile
gegebener Breite (ActionBarLayout). Die Leiste zeichnet dieses Modell; die Schaltflächen
zeichnet derselbe Code wie bei WklButton, die Menüs sind die Menüs von WklButton. In der
Entwurfsansicht gesetzte Befehle werden mit dem Formular gespeichert; in der Formularansicht
gesetzte Befehle ändern das Formular nicht. Tastenkombinationen überwacht derselbe
Nachrichten-Hook des Formulars wie F6 von WklDockLayout; eine Kombination gehört daher
entweder zur Leiste oder zu WklDockLayout.ShortcutKeys.
Administration
Fehlerbehebung
Keine
Für Entwickler
Verwandte Themen
Keine