Shape.AccessibleDescription, propriété

Article
05/16/2015

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

Espace de noms : Microsoft.VisualBasic.PowerPacks
Assembly : Microsoft.VisualBasic.PowerPacks.Vs (dans Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntaxe

'Déclaration
<BrowsableAttribute(True)> _
Public Property AccessibleDescription As String

[BrowsableAttribute(true)]
public string AccessibleDescription { get; set; }

[BrowsableAttribute(true)]
public:
property String^ AccessibleDescription {
    String^ get ();
    void set (String^ value);
}

[<BrowsableAttribute(true)>]
member AccessibleDescription : string with get, set

function get AccessibleDescription () : String 
function set AccessibleDescription (value : String)

Valeur de propriété

Type : String
String qui contient la description du contrôle utilisé par les applications clientes d'accessibilité.La valeur par défaut est une référence null (Nothing en Visual Basic).

Notes

Le AccessibleDescription propriété fournit une description textuelle de l'apparence visuelle d'un objet. La description est principalement utilisée pour fournir un meilleur contexte pour les utilisateurs malvoyants ou faible, mais il peut également servir pour la recherche contextuelle ou d'autres applications.

Le AccessibleDescription propriété est nécessaire si la description n'est pas évidente, ou si elle est redondante selon le AccessibleName ou AccessibleRole de l'objet. Par exemple, une forme et affiche le texte « Cliquez ici » n'a pas besoin d'informations supplémentaires, mais est une forme qui affiche l'image d'un cactus. Le AccessibleName et AccessibleRole propriétés de la forme de cactus décrivent sa fonction, mais la AccessibleDescription propriété communique des informations tangibles, tels que « Forme qui affiche l'image d'un cactus ».

Exemples

L'exemple suivant montre comment définir le AccessibleName et AccessibleDescription propriétés d'un OvalShape contrôle. Supposons que vous avez ajouté un fichier image nommé « cactus » en tant que ressource dans votre projet.

Dim OvalShape1 As New OvalShape
Dim canvas As New ShapeContainer
' Set the form as the parent of the ShapeContainer.
canvas.Parent = Me 
' Set the ShapeContainer as the parent of the OvalShape.
OvalShape1.Parent = canvas
' Assign an image resource to the BackgroundImage property.
OvalShape1.BackgroundImage = My.Resources.cactus
OvalShape1.Size = New Size(My.Resources.cactus.Size)
' Assign the AccessibleName and AccessibleDescription text.
OvalShape1.AccessibleName = "Image"
OvalShape1.AccessibleDescription = "A picture of a cactus"

OvalShape OvalShape1 = new OvalShape();
ShapeContainer canvas = new ShapeContainer();
// Set the form as the parent of the ShapeContainer.
canvas.Parent = this;
// Set the ShapeContainer as the parent of the OvalShape.
OvalShape1.Parent = canvas;
// Assign an image resource to the BackgroundImage property.
OvalShape1.BackgroundImage = VbPowerPacksShapeAccessibleCS.Properties.Resources.cactus;
OvalShape1.Size = new Size(VbPowerPacksShapeAccessibleCS.Properties.Resources.cactus.Height, 
    VbPowerPacksShapeAccessibleCS.Properties.Resources.cactus.Width);
// Assign the AccessibleName and AccessibleDescription text.
OvalShape1.AccessibleName = "Image";
OvalShape1.AccessibleDescription = "A picture of a cactus";

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.