Propriedade Shape.AccessibleDescription

Artigo
10/26/2012

Obtém ou define a descrição do controle que é usado por aplicativos cliente de acessibilidade.

Namespace: Microsoft.VisualBasic.PowerPacks
Assembly: Microsoft.VisualBasic.PowerPacks.Vs (em Microsoft.VisualBasic.PowerPacks.Vs.dll)

Sintaxe

'Declaração
<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 propriedade

Tipo: System.String
A String que contém a descrição do controle que é usado por aplicativos cliente de acessibilidade.O padrão é uma referência nula (Nothing na Visual Basic).

Comentários

O AccessibleDescription propriedade fornece uma descrição textual da aparência visual de um objeto.A descrição é usada principalmente para fornecer um melhor contexto para usuários com deficiência ou cegos, mas também pode ser usado para pesquisa de contexto ou de outros aplicativos.

O AccessibleDescription propriedade é necessário se a descrição não é óbvia, ou se ele é redundante de acordo com o AccessibleName ou AccessibleRole do objeto.Por exemplo, uma forma de exibir o texto "Clique" aqui não precisaria obter informações adicionais, mas gostaria de uma forma que mostra a figura de um cacto.O AccessibleName e AccessibleRole propriedades para a forma de cacto descreveria a sua finalidade, mas o AccessibleDescription propriedade seria comunicar informações que é menos tangíveis, como, por exemplo, "Uma forma que mostra a figura de um cacto".

Exemplos

O exemplo a seguir demonstra como definir o AccessibleName e AccessibleDescription propriedades de um OvalShape controle.Suponha que você adicionou um arquivo de imagem denominado "cacto" como um recurso em seu projeto.

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.