Propriedade Shape.AccessibleDescription

Artigo
08/25/2010

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

<BrowsableAttribute(True)> _
Public Property AccessibleDescription As String

Dim instance As Shape
Dim value As String

value = instance.AccessibleDescription

instance.AccessibleDescription = value

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

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

public function get AccessibleDescription () : String
public 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 em Visual Basic).

Comentários

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

The AccessibleDescription propriedade é necessária se a descrição não é óbvia ou se é redundante com base na AccessibleName ou AccessibleRole do objeto. Por exemplo, uma forma de exibir o texto "clicar" aqui não precisa obter informações adicionais, mas uma forma que mostra um imagem de um cacto faria.The AccessibleName e AccessibleRole propriedades para a forma cacto descreveria sua finalidade, mas o AccessibleDescriptionpropriedade deve se comunicar informações que são menos tangíveis, tais sistema autônomo "Uma forma que mostra a figura de um cacto."

Para obter mais informações sobre propriedades de objetos acessíveis, consulte Conteúdo das propriedades descritivas na seção acessibilidade ativo da biblioteca MSDN.

Exemplos

O exemplo a seguir demonstra como conjunto o AccessibleName e AccessibleDescription Propriedades de um OvalShape controle. Suponha que você adicionou um arquivo de imagem denominado "cacto" sistema autônomo um recurso em seu projeto.

Dim OvalShape1 AsNew OvalShape
Dim canvas AsNew 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";

Permissões

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ódigos parcialmente Confiável.