Freigeben über

Hyperlink-Steuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Hyperlink- Steuerelementtyp.

Hyperlinksteuerelemente erstellen Links, mit denen Benutzer innerhalb derselben Seite oder von einer Seite zu einer anderen navigieren können.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Hyperlink- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Hyperlinksteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Hyperlinksteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Hyperlink
  • Hyperlink

 

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für die Hyperlinksteuerelemente relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußerste Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Der klickbare Punkt des Hyperlinksteuerelements muss ein Punkt sein, der den Link startet, wenn er mit einem Mauszeiger geklickt wird.
UIA_ControlTypePropertyId Hyperlink-
UIA_IsContentElementPropertyId STIMMT Das Hyperlink-Steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId STIMMT Das Hyperlink-Steuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsKeyboardFocusablePropertyId Siehe Hinweise. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.
UIA_LabeledByPropertyId Siehe Hinweise. Wenn eine statische Beschriftung vorhanden ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem steuerelementtyp Hyperlink entspricht. Der Standardwert ist "hyperlink" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Name des Linksteuerelements ist der Text, der auf dem Bildschirm als unterstrichen angezeigt wird.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die Linksteuerelemente unterstützen müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Control Pattern/Pattern-Eigenschaft Support/Wert Notizen
IInvokeProvider- Erforderlich Alle Hyperlinksteuerelemente müssen das Aufrufen Steuerelementmusters unterstützen.
IValueProvider- Hängt Hyperlinksteuerelemente sollten das Wert- Steuerelementmuster unterstützen, wenn der Link Informationen enthält, die für den Benutzer verwendbar und aussagekräftig sind.
Wert Beispiel: "https://www..." Eine URL für eine Internet- oder Intranetadresse ist ein Beispiel für einen Link, der Informationen enthält, die für den Benutzer aussagekräftig sind. Eine programmgesteuerte Verknüpfung ist jedoch nur für eine Anwendung sinnvoll und wird für die eigenschaft Value nicht empfohlen.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Linksteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_Invoke_InvokedEventId
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden.
UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_StructureChangedEventId

 

Bemerkungen

Der Hyperlink-Steuerelementtyp sollte nur auf ein Objekt angewendet werden, das beim Klicken auf die Navigation auftritt. sie sollte nicht auf den Container des Links angewendet werden. Beispielsweise sollte nur die klickbaren "Hotspots" in einer Bildzuordnung den steuerelementtyp Hyperlink haben. Dasselbe gilt für Links in einem Textfeld oder Dokumentcontainer. In diesem Fall sollte nur der Linktext oder das Bild den Hyperlink- Steuerelementtyp aufweisen, nicht den Container.

Das Text Steuerelementmusters eignet sich ideal für die Unterstützung eingebetteter Hyperlinks in Text- oder Dokumentelementen.

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung