Shape.AccessibleDescription-Eigenschaft

Článek
08/23/2008

Aktualisiert: November 2007

Ruft die Beschreibung des von Clientprogrammen für Eingabehilfen 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
'Usage
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)

Eigenschaftenwert

Typ: System.String

String mit der Beschreibung des Steuerelements, das von Clientprogrammen für Eingabehilfen 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, um sehbehinderten oder blinden Benutzern mehr Kontextinformationen zur Verfügung zu stellen. Sie kann aber auch für Kontextsuchen oder andere Anwendungen verwendet werden.

Die AccessibleDescription-Eigenschaft wird benötigt, wenn die Beschreibung nicht eindeutig oder aufgrund der Eigenschaften AccessibleName oder AccessibleRole des Objekts redundant ist. Für eine Form mit dem Text "Hier klicken" sind beispielsweise keine zusätzlichen Informationen erforderlich, während für eine Form mit dem Bild eines Kaktus eine Erklärung benötigt würde. Die Eigenschaften AccessibleName und AccessibleRole der Kaktusform würden deren Zweck beschreiben, während die AccessibleDescription-Eigenschaft weniger konkrete Informationen übermitteln würde, z. B. "Eine Form, die das Bild eines Kaktus zeigt".

Weitere Informationen zu Eigenschaften von zugreifbaren Objekten finden Sie unter Content of Descriptive Properties im Abschnitt "Active Accessibility" der MSDN Library.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Eigenschaften AccessibleName und AccessibleDescription für ein OvalShape-Steuerelement festgelegt werden. Gehen Sie hierfür davon aus, dass Sie eine Bilddatei mit dem Namen "cactus" als Ressource zu dem 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";

Berechtigungen

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.