Description-Eigenschaft (Windows-Barrierefreiheitsfeatures)
Anmerkung
Die Description-Eigenschaft wird häufig falsch verwendet und wird von der 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 von Benutzeroberflächenautomatisierungselementen und Steuerelementmustern unterstützten Eigenschaften.
Die Description-Eigenschaft eines Objekts stellt eine Textbeschreibung zur visuellen Darstellung eines Objekts bereit. Die Beschreibung wird hauptsächlich 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 allgemeine visuelle Darstellung zu verstehen.
Die eigenschaft Description wird abgerufen, indem IAccessible::get_accDescriptionaufgerufen wird.
Gründe für die Unterstützung der Description-Eigenschaft
Server unterstützen die eigenschaft Description if the description is not obvious, or when it is not redundant based on the object's Name, Role, State, and Value properties. Beispielsweise würde eine Schaltfläche mit der Bezeichnung "OK" keine zusätzlichen Informationen benötigen, während eine Schaltfläche, die ein Bild eines Kakteen zeigt, dies wäre. Der Name, Rolleund Hilfe Eigenschaften für eine solche Schaltfläche beschreiben seinen Zweck, aber die Description Eigenschaft vermittelt Informationen, die weniger spürbar sind; Beispiel: "Diese Schaltfläche zeigt ein Bild eines Kakteen" an.
Ein Microsoft Active Accessibility-Server kann Unterstützung für die Benutzeroberflächenautomatisierung hinzufügen, indem Direct Annotationverwendet wird, mithilfe der IAccessibleEx--Schnittstelle oder durch die Implementierung von Microsoft Active Accessibility and UI Automation parallel zu beiden Implementierungen, die die WM_GETOBJECT Nachricht behandeln.
Verwandte Themen