Shape.AccessibleDescription (Propiedad)

Artículo
11/02/2012

Obtiene o establece la descripción del control utilizado por aplicaciones cliente de accesibilidad.

Espacio de nombres: Microsoft.VisualBasic.PowerPacks
Ensamblado: Microsoft.VisualBasic.PowerPacks.Vs (en Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxis

'Declaración
<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)

Valor de propiedad

Tipo: System.String
String que contiene la descripción del control utilizado por aplicaciones cliente de accesibilidad.El valor predeterminado es una referencia nula (Nothing en Visual Basic).

Comentarios

La propiedad de AccessibleDescription proporciona una descripción del aspecto visual de un objeto.La descripción se utiliza principalmente para conseguir un mejor contexto para la poca visión o los usuarios invidentes, pero también se puede utilizar para buscar de contexto u otras aplicaciones.

La propiedad de AccessibleDescription es necesaria si la descripción no es evidente, o si es redundante basada en AccessibleName o AccessibleRole del objeto.Por ejemplo, una forma que muestra el texto “haga clic aquí” no necesitaría información adicional, pero la forma que muestra una imagen de un cactus.Las propiedades de AccessibleName y de AccessibleRole de la forma de cactus describirían su propósito, pero la propiedad de AccessibleDescription comunicaría información que es menos tangible, por ejemplo “una forma que muestra una imagen de un cactus.”

Ejemplos

El ejemplo siguiente se muestra cómo establecer las propiedades de AccessibleName y de AccessibleDescription para un control de OvalShape .Suponga que se ha agregado un archivo de imagen denominado “cactus” como recursos en el proyecto.

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";

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.