AccessibleObject.Description Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft eine Zeichenfolge ab, die die visuelle Darstellung des angegebenen Objekts beschreibt. Nicht für alle Objekte liegt eine Beschreibung vor.
public:
virtual property System::String ^ Description { System::String ^ get(); };
public virtual string Description { get; }
public virtual string? Description { get; }
member this.Description : string
Public Overridable ReadOnly Property Description As String
Eigenschaftswert
Eine Beschreibung der visuellen Darstellung des Objekts für den Benutzer oder null
, wenn keine Beschreibung des Objekts vorliegt.
Ausnahmen
Die Beschreibung des Steuerelements kann nicht abgerufen werden.
Hinweise
Diese Eigenschaft beschreibt das visuelle Erscheinungsbild des Objekts für den Benutzer.
Hinweise für Vererber
Die Standardimplementierung gibt die Beschreibung des barrierefreien Objekts zurück, wenn das Objekt ein Systemsteuerelement umschließt; andernfalls wird er zurückgegeben null
. Die Beschreibung wird in der Regel verwendet, um einen größeren Kontext für Sehbehinderte oder blinde Benutzer bereitzustellen. Sie kann auch für die Kontextsuche oder andere Anwendungen verwendet werden. Server müssen die Description Eigenschaft unterstützen, wenn die Beschreibung nicht offensichtlich ist, oder wenn sie redundant ist, basierend auf den Eigenschaften des ObjektsName, StateRole, und Value Eigenschaften. Beispielsweise benötigt eine Schaltfläche mit "OK" keine zusätzlichen Informationen, sondern eine Schaltfläche, die ein Bild eines Cactus anzeigt. Die Name, Roleund vielleicht Help Eigenschaften für die Kaktschaltfläche beschreiben ihren Zweck, aber die Description Eigenschaft vermittelt Informationen, die weniger greifbar sind, wie z. B. "Eine Schaltfläche, die ein Bild eines Kaktes zeigt".