Navigationseinträge gestalten

Geben Sie einer WklNavBar ihre Gruppen und Einträge – feste, die mit dem Formular gespeichert werden, oder solche, die zur Laufzeit vom Benutzer oder von den Daten abhängen.

Voraussetzungen: WKL Forms Object Library 1.24 oder höher.

In der Entwurfsansicht gestaltete Einträge werden mit dem Formular gespeichert: im Designer (Eigenschaftenblatt, Registerkarte Andere, Zeile Benutzerdefiniert [...], Seite Einträge) oder per Code in der Entwurfsansicht. Zur Laufzeit ändern AddGroup, AddItem, RemoveItem, ItemVisible und ItemEnabled die Navigationsleiste nur für dieses eine Öffnen; Items liefert oder übernimmt alle Gruppen und Einträge als einen einzigen Text.

Im Designer fügen Gruppe und Eintrag eine Gruppe oder einen Eintrag an der Stelle der Auswahl hinzu (in die ausgewählte Gruppe, neben den ausgewählten Eintrag oder am unteren Rand). Nach oben und Nach unten verschieben ihn unter den Einträgen seines Platzes, und Platz verschiebt ihn in eine andere Gruppe, nach oben ohne Gruppe oder an den unteren Rand. Auswählen … neben Symbol öffnet eine Galerie der Windows-Symbolschrift, durchsuchbar nach Code (E80F) oder Name (haus); die Eingabetaste übernimmt den ersten Treffer.

Einträge, die vom Benutzer abhängen, beim Öffnen des Formulars hinzugefügt:

Private Sub Form_Load()
    With Me!navMain.Object
        If IsAdmin() Then                         ' your own check
            .AddGroup "admin", "Verwaltung"
            .AddItem "users", "Benutzer", "E716", "admin"
            .AddItem "audit", "Protokoll", "E81C", "admin"
        End If
        .ItemEnabled("reports") = DCount("*", "tblBerichte") > 0
    End With
End Sub

Die Einträge einer Navigationsleiste in eine andere kopieren:

Forms!frmShell2!navMain.Object.Items = Forms!frmShell!navMain.Object.Items

• Schlüssel sind eindeutig, Groß- und Kleinschreibung wird nicht unterschieden. Aus dem Code lösen ein leerer Schlüssel oder ein ungültiger Symbolcode wkeInvalidValue aus, ein doppelter Schlüssel wkeDuplicateKey und eine unbekannte Gruppe wkeKeyNotFound. Im Designer halten solche Einträge das Fenster offen, und das Problem wird benannt.
• Einträge am unteren Rand haben keine Gruppe. Wird im Designer eine Gruppe entfernt, bleiben ihre Einträge erhalten, ohne Gruppe oben; RemoveGroup aus dem Code entfernt sie zusammen mit der Gruppe.
• Ein Symbol, das nur Segoe Fluent Icons enthält (Windows 11), bleibt unter Windows 10 leer; die Galerie zeigt die Symbole der Schrift, die auf dem Computer installiert ist, auf dem sie läuft.
• Änderungen zur Laufzeit werden nicht mit dem Formular gespeichert und gehören nicht zum Benutzerzustand.

• WklNavBar
• API-Referenz (Englisch): WklNavBar (AddGroup, AddItem, Items)