Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Control.AccessibleDescription-Eigenschaft

 

Veröffentlicht: Oktober 2016

Ruft die Beschreibung des, von Clientanwendungen für die Barrierefreiheit verwendeten, Steuerelements ab oder legt diese fest.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public string AccessibleDescription { get; set; }

Eigenschaftswert

Type: System.String

Die Beschreibung des von Clientanwendungen für die Barrierefreiheit verwendeten Steuerelements. Die Standardwert ist null.

Ein Objekt AccessibleDescription Eigenschaft enthält eine Beschreibung zur visuellen Darstellung eines Objekts. Die Beschreibung wird hauptsächlich für Sehbehinderte oder blinden Benutzern ein größerer Kontext bereitgestellt, aber es kann auch zum Kontext suchen oder anderen Programmen verwendet werden.

Die AccessibleDescription Eigenschaft wird benötigt, wenn die Beschreibung nicht offensichtlich ist oder wenn redundante basierend auf des Objekts AccessibleName, AccessibleRole, State, und Value Eigenschaften. Z. B. eine Schaltfläche "OK" würde keine zusätzlichen Informationen erforderlich, während für eine Schaltfläche mit dem Bild eines Kaktus würde. Die AccessibleName, und AccessibleRole (und vielleicht Help)-Eigenschaft der Kaktusschaltfläche würden deren Zweck beschreiben, aber die AccessibleDescription Eigenschaft übermitteln würde weniger konkrete Informationen, z. B. "Eine Schaltfläche mit dem Bild eines Kaktus".

Weitere Informationen zu Eigenschaften von zugreifbaren Objekten finden Sie unter Content of Descriptive Properties.

Der folgende Code erstellt einer Instanz von eine CheckBox abgeleitete Klasse, MyCheckBox, weist sie eine Image zu seine Image Eigenschaft und legt die AccessibleName und AccessibleDescription Eigenschaften, da der Text Eigenschaft ist null. Dieses Beispiel benötigen Sie ein Form namens MyForm.

public MyForm()
{
   // Create a 'MyCheckBox' control and 
   // display an image on it.
   MyCustomControls.MyCheckBox myCheckBox = 
      new MyCustomControls.MyCheckBox();
   myCheckBox.Location = new Point(5,5);
   myCheckBox.Image = Image.FromFile(
     Application.CommonAppDataPath + "\\Preview.jpg");

   // Set the AccessibleName property
   // since there is no Text displayed.
   myCheckBox.AccessibleName = "Preview";
   myCheckBox.AccessibleDescription =
     "A toggle button used to show the document preview.";
   this.Controls.Add(myCheckBox);
}

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: