Shape.AccessibleDescription-Eigenschaft

Artikel
05/16/2015

Ruft die Beschreibung des von Clientanwendungen für die Barrierefreiheit verwendeten Steuerelements ab oder legt diese fest.

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

Syntax

'Declaration
<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)

Eigenschaftswert

Typ: String
Ein String , enthält die Beschreibung des Steuerelements, das von Barrierefreiheit-Clientanwendungen verwendet wird.Der Standardwert ist ein NULL-Verweis (Nothing in Visual Basic).

Hinweise

Die AccessibleDescription -Eigenschaft stellt eine Textbeschreibung der visuellen Darstellung eines Objekts bereit. Die Beschreibung wird hauptsächlich verwendet, besseren Kontext sehbehindert oder blind Benutzern bereitgestellt, aber kann auch für die Kontextsuche oder für andere Anwendungen verwendet werden.

Die AccessibleDescription Eigenschaft wird benötigt, wenn die Beschreibung nicht aussagekräftig oder redundante basierend auf den AccessibleName oder AccessibleRole des Objekts. Klicken Sie z. B. eine Form mit dem Text "Hier klicken" würde keine zusätzlichen Informationen erforderlich, während eine Form mit dem Bild eines Kaktus würde. Die AccessibleName und AccessibleRole Eigenschaften für das Shape Kaktus würden deren Zweck beschreiben, aber die AccessibleDescription übermittelt-Eigenschaft weniger konkrete Informationen, wie z. B. "Eine Form mit dem Bild eines Kaktus."

Beispiele

Das folgende Beispiel zeigt die Vorgehensweise beim Festlegen der AccessibleName und AccessibleDescription Eigenschaften für ein OvalShape Steuerelement. Wird davon ausgegangen Sie, dass Sie eine Bilddatei mit dem Namen "Kaktus" als Ressource in Ihrem Projekt hinzugefügt haben.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.