Wertzuordnungsanmerkung
Mit einer Wertzuordnungsanmerkung können Sie eine Zuordnungszeichenfolge verwenden, um anzugeben, wie der Bildindex eines Elements in einer Listenansicht oder Strukturansicht der Rolle oder des Zustands entspricht. Eine Zuordnungszeichenfolge kann z. B. darauf hinweisen, dass der Bildindex 0 einer Rolle des Kontrollkästchens zugeordnet ist, während der Bildindex 1 einer Rolle des Optionsfelds zugeordnet ist.
Sie können auch eine Wertzuordnungsanmerkung verwenden, um Zeichenfolgen anzugeben, die den numerischen Werten eines Schiebereglers zugeordnet sind.
Wann diese Technik verwendet werden soll
Erwägen Sie die Verwendung der Wertzuordnungsanmerkung in den folgenden Situationen.
Wenn eine vom Besitzer gezeichnete Listenansicht oder Strukturansicht die Verwendung von Bildern enthält und Sie basierend auf diesem Bild eine benutzerdefinierte beschreibung (Description-Eigenschaft) bereitstellen möchten. Die folgende Abbildung zeigt ein Beispiel.
Wenn ein vom Besitzer gezeichnetes Listenansichts- oder Strukturansichts-Steuerelement die Verwendung von Bildern enthält, damit die Struktur oder Listenelemente wie einfache Steuerelemente funktionieren, in der Regel Kontrollkästchen oder Optionsfelder, und Sie das Bild einer Rolle zuordnen möchten. Der folgende Screenshot zeigt ein Beispiel.
Wenn ein Schieberegler verwendet wird, um einen Wert auszuwählen, der als eine andere als eine einfache ganze Zahl beschrieben werden kann, wie im folgenden Screenshot, in dem die Bildschirmauflösungseinstellung durch eine Zeichenfolge beschrieben wird.
Mit der Wertzuordnungsanmerkung gibt eine Zuordnungszeichenfolge an, wie der Bildindex der Liste oder der Struktur der Rolle oder des Zustands entspricht. Sie kann auch angeben, wie der numerische Wert eines Schiebereglers einer Zeichenfolge entspricht. Eine Zuordnungszeichenfolge kann z. B. darauf hinweisen, dass der Bildindex 0 einer Rolle des Kontrollkästchens und bildindex 1 einer Rolle eines Optionsfelds zugeordnet ist. Verwenden Sie IAccPropServices::SetHwndPropStr()-, um die Zuordnungszeichenfolge an das Steuerelement anzufügen.
Da steuerelementspezifische Kenntnisse erforderlich sind, um die Wertzuordnung zu unterstützen, gibt es eine begrenzte Anzahl von Steuerelementen und Eigenschaften, die die Wertzuordnung unterstützen, einschließlich Schieberegler-Wertzuordnungen, Listenansichten und Strukturansichten.
Schieberegler-Wertzuordnung
PROPID_ACC_VALUEMAP enthält eine Zuordnung von internen Schiebereglerpositionen zu lesbaren Zeichenfolgen. Diese Eigenschaft wird vom Oleacc.dll Schiebereglerproxy unterstützt. Wenn der aktuelle Schiebereglerwert in der Wertzuordnung gefunden wird, wird die entsprechende Zeichenfolge als Wert anstelle der Standardprozentzeichenfolge (z. B. "50") verfügbar gemacht.
Listenansicht und Strukturansicht
PROPID_ACC_ROLEMAP, PROPID_ACC_STATEMAPund PROPID_ACC_DESCRIPTONMAP Zuordnungen von Zustandsbildindizes zu Rollen- und Zustandswerten bereitstellen. Diese Zuordnungen ermöglichen es diesen Bildindizes, geeignete Rollen (in der Regel ROLE_SYSTEM_RADIOBUTTON oder ROLE_SYSTEM_CHECKBUTTON) und zusätzliche Zustandsbits (in der Regel STATE_SYSTEM_CHECKED) zuzuordnen.
Weitere Informationen zur Wertzuordnungsanmerkung finden Sie in den folgenden Themen:
- Verwenden der "Wertzuordnungsanmerkung"
- Beispiel für die Wertzuordnung
Anmerkungszuordnungsformat
In der folgenden Tabelle werden die Felder beschrieben, die in einer Anmerkungszuordnung enthalten sind.
| Feld | Beschreibung |
|---|---|
| 'A' | Gibt an, dass ein bestimmtes Codierungsschema verwendet wird. Für zukünftige Codierungsschemas können zusätzliche Präfixe unterstützt werden. |
| Trennzeichen | Normalerweise wird ein Doppelpunkt (:) wird verwendet, kann jedoch ein anderes Zeichen sein, mit Ausnahme NULL- oder leerer Leerzeichen. Da dieses Zeichen als Trennzeichen für die verbleibenden Felder verwendet wird, wird es möglicherweise nicht als Teil eines Werts in der Zuordnung verwendet. |
| 0, 1 oder 2 | Ein Wert, der angibt, welcher Schlüssel verwendet wird. Bei Rollen- und Zustandszuordnungen der Strukturansicht und listenansicht kann dieser Schlüssel 0 (Bildindex), 1 (Statusbildindex) oder 2 (Überlagerungsbildindex) sein. Bei Schiebereglern und anderen Steuerelementen, die keine Auswahl an Tasten bieten, muss dieser Wert 0 sein. |
| Trennzeichen | : |
| Schlüsselwertpaare | Jedes Paar besteht aus einer Schlüsselzeichenfolge und einem Trennzeichen. Die Schlüsselzeichenfolge ist eine Zahl und kann im Präfixformat "0x" als Dezimal- oder Hexadezimalzahl verwendet werden. |
| Wertzeichenfolge | Bei Wertzuordnungen ist dies eine Zeichenfolge. Bei Rollen- und Statuszuordnungen ist dies eine Zahl (dezimal oder hexadezimal). |
| Trennzeichen | : |
Eine Karte kann z. B. wie folgt aussehen:
A:0:0:Cold:1:Warm:3:Hot:
Wenn diese Wertzuordnung auf ein Schieberegler-Steuerelement angewendet wird, wird ein Wert von "Warm" verfügbar gemacht, wenn sich der Schieberegler an Position 1 befindet. Da der Wert 2 in diesem Beispiel nicht enthalten ist, wird der Standardwert für diese Position verfügbar gemacht. Bei einem Schieberegler wäre der Standardwert ein Prozentwert, z. B. 33.