Control.AccessibleDescription Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

Control.cs

Obtient ou définit la description du contrôle utilisé par les applications clientes d’accessibilité.

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

public string? AccessibleDescription { get; set; }

member this.AccessibleDescription : string with get, set

Public Property AccessibleDescription As String

Valeur de propriété

String

Description 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, MyCheckBoxl’assigne Image à sa Image propriété et définit les propriétés et AccessibleDescription les AccessibleName propriétés, car la Text propriété est null. Cet exemple nécessite que vous ayez un Form nom 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 propriété d’un AccessibleDescription objet fournit une description textuelle de l’apparence visuelle d’un objet. La description est principalement utilisée pour fournir un plus grand contexte pour les utilisateurs malvoyants ou aveugles, mais peut également être utilisée pour la recherche de contexte ou d’autres applications.

La AccessibleDescription propriété est nécessaire si la description n’est pas évidente ou si elle est redondante en fonction des propriétés, et StateAccessibleRoleValue des propriétés de AccessibleNamel’objet. Par exemple, un bouton avec « OK » n’aurait pas besoin d’informations supplémentaires, mais un bouton qui montre une image d’un cactus. Les AccessibleNamepropriétés , et (et AccessibleRole peut-être Help) pour le bouton de cactus décrivent son objectif, mais la AccessibleDescription propriété transmettrait des informations moins tangibles, telles que « Un bouton qui montre une image d’un cactus ».

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

Voir aussi

• AccessibleName
• AccessibleRole
• AccessibleDefaultActionDescription
• Description