Control.AccessibleName Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
Control.cs
Source:
Control.cs
Source:
Control.cs

Obtient ou définit le nom du contrôle utilisé par les applications clientes d'accessibilité.

public:
 property System::String ^ AccessibleName { System::String ^ get(); void set(System::String ^ value); };
public string AccessibleName { get; set; }
public string? AccessibleName { get; set; }
member this.AccessibleName : string with get, set
Public Property AccessibleName As String

Valeur de propriété

String

Nom du contrôle utilisé par les applications clientes d'accessibilité. La valeur par défaut est null.

Exemples

L’exemple de code suivant crée une instance d’une CheckBox classe dérivée, MyCheckBox, lui attribue un Image à sa Image propriété et définit les AccessibleName propriétés et AccessibleDescription puisque la Text propriété est null. Cet exemple nécessite que vous ayez un Form nommé 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

Remarques

La AccessibleName propriété est une étiquette qui décrit et identifie brièvement l’objet dans son conteneur, comme le texte d’un Button, le nom d’un MenuItemou une étiquette affichée en regard d’un TextBox contrôle.

Pour plus d’informations sur les propriétés des objets accessibles, consultez « Contenu des propriétés descriptives.

S’applique à

Voir aussi