Color scheme: Light
You are here: start » de » Dokumentation » Werkzeuge für Microsoft Access » WKL Forms Object Library » Dateneditoren » WklTokenBox

WklTokenBox

WklTokenBox zeigt die kurze Liste von Werten, die zu einem Datensatz gehören – die Rollen eines Benutzers, die Schlagwörter eines Dokuments – als Tokens mit einer Schaltfläche zum Entfernen; neue Werte tippt der Benutzer mit Vorschlägen ein. Gebunden wird das Feld wie ein Unterformular: Jedes Token ist eine Zeile einer untergeordneten Tabelle und wird sofort eingefügt oder gelöscht.

Erste Schritte

Häufige Aufgaben

Schaubild

+- frmBenutzer: Formularansicht ---------------------------------------+
|  Name   [ Meier                        ]                             |
|  Rollen [ (Leser x) (Autor x)  adm|                    ]   1  2  3   |
|         +---------------------+                                      |
|         | Admin               |                               4      |
|         +---------------------+                                      |
+----------------------------------------------------------------------+
BereichBedeutung
1Ein Token: eine untergeordnete Zeile von tblBenutzerRolle, mit seiner Schaltfläche zum Entfernen
2Ein weiteres Token; Nach-links und Nach-rechts wechseln zwischen den Tokens, Entf entfernt das ausgewählte
3Die Eingabe: Beim Tippen erscheinen Vorschläge, die Eingabetaste oder ein Trennzeichen fügt den Wert hinzu
4Die Vorschläge aus SuggestionSource (oder SuggestionList); Nach-unten öffnet sie

Wichtige Funktionen

  • Gebunden wie ein Unterformular (RecordSource, ValueField, LinkChildFields, LinkMasterFields), auch mit mehreren Verknüpfungsfeldern und über ODBC; folgt dem Datensatz des Formulars über seinen Steuerelementinhalt.
  • Vorschläge beim Tippen aus einer Werteliste oder einer Tabelle, Abfrage oder SQL-Anweisung; auf Wunsch nur vorgeschlagene Werte (AllowFreeText).
  • Regeln je Wert: ein regulärer Ausdruck mit seiner Meldung (Pattern, ValidationText), keine Duplikate; der Grund einer Ablehnung erscheint unter dem Feld und in ErrorText.
  • Ereignisse vor und nach jeder Änderung (TokenAdding … Change), mit Cancel; DataError für Zeilen, die die Tabelle ablehnt.
  • Dieselben Chips in Listen: eine schreibgeschützte Spalte wedTokens in WklGrid und WklTreeList.
  • Sprachausgaben melden eine Liste mit einer Schaltfläche zum Entfernen je Token.
  • Designer (Zeile Benutzerdefiniert [...]): Daten, Vorschläge und Regeln, Aussehen.

Grundkonzepte

Zeilen, kein Feld. Die Werte liegen in einer untergeordneten Tabelle, eine Zeile je Token. Es gibt keinen schwebenden Zustand und kein Rückgängig – so wie ein Unterformular seine Zeilen speichert. Mehrwertige Felder von Access werden bewusst vermieden: Es gibt sie nur in Access-Tabellen.

Der Datensatz entscheidet. Bei einem neuen Datensatz ohne Schlüssel lehnt das Feld Eingaben ab, so wie ein Unterformular Zeilen ablehnt, bevor sein übergeordneter Datensatz existiert. Ein gesperrtes Feld oder ein Formular, das keine Bearbeitungen zulässt, zeigt die Tokens ohne Schaltflächen zum Entfernen.

Ungebundene Verwendung. Ohne RecordSource hält das Feld seine Werte in Text, getrennt durch Separator, und Ihr Code speichert sie.

Administration

Fehlerbehebung

Für Entwickler

Verwandte Themen

Keine

de/wiki/msaccess/comctl/data-editors/tokens/start.txt · Last modified: by Wolfgang van der Stille