Shape.AccessibleDescription-Eigenschaft

Artikel
10/24/2012

Ruft die Beschreibung des Steuerelements fest, das durch Clientanwendungen für die Barrierefreiheit verwendet wird.

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: System.String
String , der die Beschreibung des Steuerelements enthält, das durch Clientanwendungen für die Barrierefreiheit verwendet wird.Der Standardwert ist ein NULL-Verweis (Nothing in Visual Basic).

Hinweise

Die AccessibleDescription-Eigenschaft stellt eine Textbeschreibung des Erscheinungsbilds eines Objekts.Die Beschreibung wird hauptsächlich verwendet, um besser Kontext für Sehschwäche oder blinde Benutzer bereitzustellen, sie kann jedoch zum Kontext finden oder anderen Anwendungen verwendet werden.

Die AccessibleDescription-Eigenschaft ist erforderlich, wenn die Beschreibung nicht offensichtlich befindet oder wenn sie auf der Grundlage AccessibleName oder AccessibleRole des Objekts redundant ist.Beispielsweise kann eine Form, die den Text „Click“ angezeigt wird, hier nicht weitere Informationen benötigen, aber eine Form mit einem Bild eines Kaktus angezeigt wurde.Die AccessibleName und AccessibleRole-Eigenschaften für die Kaktus ihren Zweck würden Form beschreiben, aber die AccessibleDescription-Eigenschaft würde Informationen, die weniger fühlbar ist, z. B. „eine Form mitteilen, die zeigt ein Bild eines Kaktus“.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die AccessibleName und AccessibleDescription-Eigenschaften für ein OvalShape-Steuerelement veranschaulicht.Angenommen, Sie eine Datei für Bilder hinzugefügt haben, die „Kaktus“ als Ressource im Projekt.

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.