Control.AccessibleName Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Namen des von Clientanwendungen für die Barrierefreiheit verwendeten Steuerelements ab oder legt diesen fest.

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

public string? AccessibleName { get; set; }

member this.AccessibleName : string with get, set

Public Property AccessibleName As String

Eigenschaftswert

String

Der Name 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 AccessibleName -Eigenschaft ist eine Bezeichnung, die das Objekt in seinem Container kurz beschreibt und identifiziert, z. B. den Text in einem Button, den Namen eines MenuItemoder eine Bezeichnung, die neben einem TextBox Steuerelement angezeigt wird.

Weitere Informationen zu Eigenschaften barrierefreier Objekte finden Sie unter "Inhalt beschreibender Eigenschaften.

Weitere Informationen

• AccessibleDescription
• AccessibleRole
• AccessibleDefaultActionDescription
• Name