Shape.AccessibleDescription, propriété

Article
11/15/2012

Obtient ou définit la description du contrôle qui est utilisé par des applications 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 : System.String
String qui contient la description du contrôle qui est utilisé par des applications d'accessibilité.La valeur par défaut est une référence null (Nothing en Visual Basic).

Notes

La propriété d'AccessibleDescription fournit une description textuelle de l'apparence visuelle d'un objet.La description est principalement utilisée pour fournir un meilleur contexte pour le malvoyance ou les utilisateurs aveugle, mais elle peut également être utilisée pour rechercher de contexte ou d'autres applications.

La propriété d'AccessibleDescription est nécessaire si la description n'est pas évident, ou si elle est redondante selon AccessibleName ou AccessibleRole de l'objet.Par exemple, une forme affichant le texte « cliquez ici » n'aurait pas besoin d'informations supplémentaires, mais une forme qui montre une image d'un cactus.Les propriétés d'AccessibleName et d'AccessibleRole pour la forme de cactus décriraient son objectif, mais la propriété d'AccessibleDescription communiquerait les informations qui sont moins réelles, par exemple « une forme qui montre une image d'un cactus ».

Exemples

L'exemple suivant montre comment définir les propriétés d'AccessibleName et d'AccessibleDescription pour un contrôle d'OvalShape.Supposons que vous avez ajouté un fichier image qui est 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, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.