Control.AccessibleDescription Propriété

  • Référence

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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

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

Valeur de propriété

String

Description du contrôle utilisée 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’affecte 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 contexte plus élevé pour les utilisateurs de faible vision ou aveugle, 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 AccessibleNamepropriétés, AccessibleRoleet StateValue des propriétés de l’objet. Par exemple, un bouton avec « OK » n’aurait pas besoin d’informations supplémentaires, mais un bouton qui affiche 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é transmettreait des informations moins tangibles, telles que « Un bouton qui affiche une image d’un cactus ».

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

S’applique à

Voir aussi