Anmerkung zur Wertzuordnung

Mit der Wertzuordnungsanmerkung können Sie eine Zuordnungszeichenfolge verwenden, um anzugeben, wie der Bildindex eines Elements in einer Listenansicht oder Strukturansicht seiner Rolle oder seinem Zustand entspricht. Beispielsweise kann eine Zuordnungszeichenfolge angeben, dass der Bildindex 0 einer Listenansicht einer Kontrollkästchenrolle zugeordnet ist, während Bildindex 1 einer Optionsfeldrolle zugeordnet wird.

Sie können auch die Wertzuordnungsanmerkung verwenden, um Zeichenfolgen anzugeben, die den numerischen Werten auf einem Schieberegler zugeordnet werden.

Wann sollte diese Technik verwendet werden?

Ziehen Sie in den folgenden Situationen die Verwendung der Wertzuordnungsanmerkung in Betracht.

• Wenn eine vom Besitzer gezeichnete Listenansicht oder Strukturansicht die Verwendung von Bildern umfasst, und Sie eine benutzerdefinierte barrierefreie Beschreibung (Description-Eigenschaft ) basierend auf diesem Bild bereitstellen möchten. Die folgende Abbildung zeigt ein Beispiel.

  

• Wenn eine vom Besitzer gezeichnete Listenansicht oder ein Strukturansichtssteuerelement die Verwendung von Bildern umfasst, damit die Struktur- oder Listenelemente wie einfache Steuerelemente fungieren, werden in der Regel Kontrollkästchen oder Optionsfelder angezeigt, und Sie möchten das Bild einer Rolle zuordnen. Der folgende Screenshot zeigt ein Beispiel.

  

• Wenn ein Schieberegler verwendet wird, um einen Wert auszuwählen, der als etwas anderes als eine einfache ganze Zahl beschrieben werden kann, wie im folgenden Screenshot, wobei die Einstellung für die Bildschirmauflösung durch eine Zeichenfolge beschrieben wird.

  

Mit der Wertzuordnungsanmerkung gibt eine Zuordnungszeichenfolge an, wie der Bildindex der Liste oder Struktur der Rolle oder dem Zustand entspricht. Oder es kann angeben, wie der numerische Wert eines Schiebereglers einer Zeichenfolge entspricht. Beispielsweise kann eine Zuordnungszeichenfolge angeben, dass der Bildindex 0 einer Listenansicht einer Rolle des Kontrollkästchens und dem Bildindex 1 einer Optionsfeldrolle 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 Wertzuordnungen unterstützen, einschließlich Schiebereglerwertzuordnungen, Listenansichten und Strukturansichten.

Schiebereglerwertzuordnung

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 standardprozentigen Zeichenfolge verfügbar gemacht (z. B. "50").

Listenansicht und Strukturansicht

PROPID_ACC_ROLEMAP, PROPID_ACC_STATEMAP und PROPID_ACC_DESCRIPTONMAP Zuordnungen von Zustandsbildindizes zu Rollen- und Zustandswerten bereitstellen. Diese Zuordnungen ermöglichen es, diese Bildindizes den entsprechenden Rollen (normalerweise ROLE_SYSTEM_RADIOBUTTON oder ROLE_SYSTEM_CHECKBUTTON) und zusätzlichen Zustandsbits (normalerweise STATE_SYSTEM_CHECKED) zuzuordnen.

Weitere Informationen zur Anmerkung zur Wertzuordnung finden Sie in den folgenden Themen:

• Verwenden von Wertzuordnungsanmerkungen
• Beispiel für Eine Wertzuordnungsanmerkung

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 ein Doppelpunkt (:) wird verwendet, kann jedoch ein anderes Zeichen mit Ausnahme von NULL oder einem leeren Leerzeichen sein. Da dieses Zeichen als Trennzeichen für die verbleibenden Felder verwendet wird, kann es nicht als Teil eines Werts in der Zuordnung verwendet werden.
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 (Zustandsbildindex) oder 2 (Überlagerungsbildindex) sein. Für Schieberegler und andere Steuerelemente, die keine Auswahl an Tasten bieten, muss dieser Wert 0 sein.
Trennzeichen	:
Schlüssel-Wert-Paare	Jedes Paar besteht aus einer Schlüsselzeichenfolge und einem Trennzeichen. Die Schlüsselzeichenfolge ist eine Zahl und kann im Dezimal- oder Hexadezimalformat (mit einem führenden Präfix "0x") vorliegen.
Wertzeichenfolge	Für Wertzuordnungen ist dies eine Zeichenfolge. Bei Rollen- und Zustandszuordnungen ist dies eine Zahl (dezimal oder hexadezimal).
Trennzeichen	:

 

Eine Karte kann beispielsweise wie folgt aussehen:

A:0:0:Cold:1:Warm:3:Hot:

Wenn diese Wertzuordnung auf ein Schiebereglersteuerelement angewendet wird, wird der Wert "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. Für einen Schieberegler ist der Standardwert ein Prozentwert, z. B. 33.