Description-Eigenschaft (Windows-Barrierefreiheitsfeatures)

Hinweis

Die Description-Eigenschaft wird häufig falsch verwendet und von Microsoft Benutzeroberflächenautomatisierung nicht unterstützt. Microsoft Active Accessibility-Serverentwickler sollten diese Eigenschaft nicht verwenden. Wenn weitere Informationen für Barrierefreiheits- und Automatisierungsszenarien erforderlich sind, verwenden Sie die Eigenschaften, die von Benutzeroberflächenautomatisierung Elementen und Steuerelementmustern unterstützt werden.

 

Die Description-Eigenschaft eines Objekts stellt eine Textbeschreibung zur visuellen Darstellung eines Objekts bereit. Die Beschreibung wird in erster Linie verwendet, um einen größeren Kontext für sehbehinderte oder blinde Benutzer bereitzustellen, wird aber auch für die Kontextsuche oder andere Anwendungen verwendet. Diese Eigenschaft kann Benutzern helfen, ein Symbol oder die gesamte visuelle Darstellung zu verstehen.

Die Description-Eigenschaft wird durch Aufrufen von IAccessible::get_accDescription abgerufen.

Wann die Beschreibungseigenschaft unterstützt werden soll

Server unterstützen die Description-Eigenschaft , wenn die Beschreibung nicht offensichtlich ist oder wenn sie nicht redundant ist, basierend auf den Eigenschaften Name, Role, State und Value des Objekts. Beispielsweise benötigt eine Schaltfläche mit der Bezeichnung "OK" keine zusätzlichen Informationen, während eine Schaltfläche, die ein Bild eines Kaktus anzeigt, dies wäre. Die Eigenschaften Name, Rolle und Hilfe für eine solche Schaltfläche beschreiben ihren Zweck, aber die Description-Eigenschaft übermittelt Informationen, die weniger greifbar sind. Beispiel: "Diese Schaltfläche zeigt ein Bild eines Kaktus."

Ein Microsoft Active Accessibility-Server kann Unterstützung für Benutzeroberflächenautomatisierung hinzufügen, indem er direct Annotation verwendet, die IAccessibleEx-Schnittstelle verwendet oder Microsoft Active Accessibility implementiert und Benutzeroberflächenautomatisierung parallel zu beiden Implementierungen, die die WM_GETOBJECT-Nachricht behandeln.

Verwenden der direkten Anmerkung

Die IAccessibleEx-Schnittstelle