Control.AccessibleDescription Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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 die Beschreibung des von Clientanwendungen für die Barrierefreiheit verwendeten Steuerelements ab oder legt diese fest.

public:
 property System::String ^ AccessibleDescription { System::String ^ get(); void set(System::String ^ value); };

public string AccessibleDescription { get; set; }

public string? AccessibleDescription { get; set; }

member this.AccessibleDescription : string with get, set

Public Property AccessibleDescription As String

Eigenschaftswert

String

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

Beispiele

Im folgenden Codebeispiel wird eine Instanz einer CheckBox abgeleiteten Klasse erstellt, MyCheckBoxund weist sie ihrer Image -Eigenschaft zu Image und legt die AccessibleName Eigenschaften und AccessibleDescription fest, da die Text -Eigenschaft istnull. Dieses Beispiel erfordert, dass Sie über einen Form namens verfügen MyForm.

public:
   MyForm()
   {
      // Create a 'MyCheckBox' control and
      // display an image on it.
      MyCustomControls::MyCheckBox^ myCheckBox = gcnew MyCustomControls::MyCheckBox;
      myCheckBox->Location = Point(5,5);
      myCheckBox->Image = Image::FromFile( String::Concat( 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 );
   }

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);
}

Public Sub New()
   ' Create a 'MyCheckBox' control and 
   ' display an image on it. 
   Dim myCheckBox As 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"

   ' Set the AccessibleDescription text.
   myCheckBox.AccessibleDescription = _
     "A toggle button used to show the document preview."
   Me.Controls.Add(myCheckBox)
End Sub

Hinweise

Die -Eigenschaft eines AccessibleDescription 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, kann aber auch für Kontextsuche oder andere Anwendungen verwendet werden.

Die AccessibleDescription -Eigenschaft wird benötigt, wenn die Beschreibung nicht offensichtlich ist oder wenn sie basierend auf den Eigenschaften , AccessibleRole, Stateund Value des AccessibleNameObjekts redundant ist. Beispielsweise würde eine Schaltfläche mit "OK" keine zusätzlichen Informationen benötigen, sondern eine Schaltfläche, die ein Bild eines Kakteen zeigt. Die AccessibleNameEigenschaften , und AccessibleRole (und vielleicht Help) für die Kakteenschaltfläche würden ihren Zweck beschreiben, aber die AccessibleDescription Eigenschaft würde weniger greifbare Informationen vermitteln, z. B. "Eine Schaltfläche, die ein Bild eines Kaktus zeigt."

Weitere Informationen zu Eigenschaften von barrierefreien Objekten finden Sie unter Inhalt beschreibender Eigenschaften.

Gilt für:

Freigeben über