Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
AccessibleDescription, propriété
Collapse the table of content
Expand the table of content

Control.AccessibleDescription, propriété

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

Espace de noms : System.Windows.Forms
Assembly : System.Windows.Forms (dans system.windows.forms.dll)

[LocalizableAttribute(true)] 
public string AccessibleDescription { get; set; }
/** @property */
public String get_AccessibleDescription ()

/** @property */
public void set_AccessibleDescription (String value)

public function get AccessibleDescription () : String

public function set AccessibleDescription (value : String)

Valeur de la propriété

Description du contrôle utilisé par des applications d'accessibilité. La valeur par défaut est référence Null (Nothing en Visual Basic).

La propriété AccessibleDescription d'un objet fournit une description textuelle sur l'apparence d'un objet. La description sert principalement à fournir plus de contexte aux utilisateurs malvoyants ou non voyants, mais peut être utilisée pour une recherche contextuelle ou pour d'autres applications.

La propriété AccessibleDescription est nécessaire si la description n'est pas évidente, ou si elle est redondante par rapport aux propriétés AccessibleName, AccessibleRole, State et Value de l'objet. Par exemple, un bouton "OK" ne nécessite pas d'informations supplémentaires, contrairement à un bouton qui affiche l'image d'un cactus. Les propriétés AccessibleName et AccessibleRole (et même éventuellement Help) du bouton cactus décriraient sa fonction, mais la propriété AccessibleDescription fournirait des informations moins significatives, par exemple "Bouton qui affiche l'image d'un cactus".

Pour plus d'informations sur les propriétés des objets accessibles, consultez la rubrique « Content of Descriptive Properties » dans MSDN Library à l'adresse http://msdn.microsoft.com/library.

L'exemple de code suivant crée une instance d'une classe dérivée CheckBox, MyCheckBox, lui assigne un Image à sa propriété Image et définit les propriétés AccessibleName et AccessibleDescription, car la propriété Text est référence Null (Nothing en Visual Basic). Cet exemple requiert un Form nommé MyForm.

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 MyForm()
{
    // Create a 'MyCheckBox' control and 
    // display an image on it.
    MyCustomControls.MyCheckBox myCheckBox = 
        new MyCustomControls.MyCheckBox();
    myCheckBox.set_Location(new Point(5, 5));
    myCheckBox.set_Image(Image.FromFile(Application.get_CommonAppDataPath() 
        + "\\Preview.jpg"));
    // Set the AccessibleName property
    // since there is no Text displayed.
    myCheckBox.set_AccessibleName("Preview");
    myCheckBox.set_AccessibleDescription(
        "A toggle button used to show the document preview.");
    this.get_Controls().Add(myCheckBox);
} //MyForm

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2015 Microsoft