Freigeben über

Typ des Hyperlinksteuerelements

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung des Hyperlink-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.

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 erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Hyperlink-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Linksteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Ui-Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält folgende Abschnitte:

Typische Struktur der Struktur

Die folgende Tabelle zeigt ein typisches Steuerelement und eine Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Hyperlinksteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.

Steuerelementansicht Inhaltsansicht
  • Hyperlink
  • Hyperlink

 

Relevante Eigenschaften

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

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Hinweise
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußere Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Der klickbare Punkt des Linksteuerelements muss ein Punkt sein, der den Link startet, wenn er mit einem Mauszeiger geklickt wird.
UIA_ControlTypePropertyId Link
UIA_IsContentElementPropertyId TRUE Das Hyperlinksteuerelement ist stets in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung enthalten.
UIA_IsControlElementPropertyId TRUE Das Hyperlinksteuerelement ist stets in der Steuerungsansicht der Struktur der Benutzeroberflächenautomatisierung 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 Textbeschriftung vorhanden ist, muss diese Eigenschaft einen Verweis auf dieses Steuerelement verfügbar machen.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem Typ des Hyperlink-Steuerelements entspricht. Der Standardwert ist "hyperlink" für en-US oder Englisch (USA).
UIA_NamePropertyId Siehe Hinweise. Der Name des Hyperlinksteuerelements ist der Text, der auf dem Bildschirm unterstrichen angezeigt wird.

 

Erforderliche Steuerelementmuster

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster aufgeführt, die von Hyperlinksteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.

Steuerelementmuster/Mustereigenschaft Unterstützung/Wert Hinweise
IInvokeProvider Erforderlich Alle Hyperlinksteuerelemente müssen das Invoke-Steuerelementmuster unterstützen.
IValueProvider Depends (Abhängig) 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. Ein programmgesteuerter Link ist jedoch nur für eine Anwendung von Bedeutung und wird für die Value-Eigenschaft nicht empfohlen.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die von Hyperlinksteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.

Ereignis der Benutzeroberflächenautomatisierung Hinweise
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_Invoke_InvokedEventId
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_IsOffscreenPropertyId Eigenschaftsänderungsereignis. 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 dazu führt, dass die Navigation erfolgt. Sie sollte nicht auf den Container des Links angewendet werden. Beispielsweise sollten nur die klickbaren "Hotspots" innerhalb einer Imagemap den Typ Hyperlink-Steuerelement aufweisen. Dasselbe gilt für Links in einem Textfeld oder Dokumentcontainer. In diesem Fall sollte nur der Hyperlinktext oder das Hyperlinkbild den Typ des Hyperlink-Steuerelements aufweisen, nicht der Container.

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

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung