Freigeben über


Benutzeroberflächenautomatisierungs-Unterstützung für den Hyperlink-Steuerelementtyp

HinweisHinweis

Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den Link-Steuerelementtyp. In UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Link-Steuerelemente ermöglichen das Navigieren innerhalb einer Seite und zwischen Seiten sowie das Öffnen von Fenstern.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Link-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Link-Steuerelemente, seien dies Windows Presentation Foundation (WPF)-, Win32- oder Windows Forms-Steuerelemente.

Dieses Thema enthält folgende Abschnitte.

  • Erforderliche Benutzeroberflächenautomatisierungs-Struktur
  • Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
  • Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften
  • Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur, die sich auf Link-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

Link

Link

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für den Link-Steuerelementtyp besonders relevant sind. Weitere Informationen zu UI Automationseigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-Eigenschaft

Wert

Hinweise

AutomationIdProperty

Siehe Hinweise.

Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.

BoundingRectangleProperty

Siehe Hinweise.

Das äußere Rechteck, welches das gesamte Steuerelement umfasst.

ClickablePointProperty

Siehe Hinweise.

Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, setzen Sie diese Eigenschaft außer Kraft, und geben Sie einen durch Klicken aktivierbaren Punkt an.

IsKeyboardFocusableProperty

Siehe Hinweise.

Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.

NameProperty

Siehe Hinweise.

Der Name des Link-Steuerelements ist der Text, der auf dem Bildschirm unterstrichen angezeigt wird.

ClickablePointProperty

Siehe Hinweise.

Der durch Klicken aktivierbare Punkt des Link-Steuerelements muss ein Punkt sein, der den Link ausführt, wenn mit dem Mauszeiger auf ihn geklickt wird.

LabeledByProperty

Siehe Hinweise.

Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen.

ControlTypeProperty

Link

Dieser Wert ist für alle UI-Frameworks identisch.

LocalizedControlTypeProperty

"Link"

Lokalisierte Zeichenfolge für den Link-Steuerelementtyp.

IsContentElementProperty

True

Das Link-Steuerelement ist stets in der Inhaltsansicht der UI Automation-Struktur enthalten.

IsControlElementProperty

True

Das Link-Steuerelement ist stets in der Steuerelementansicht der UI Automation-Struktur enthalten.

Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften

In der folgenden Tabelle werden die UI Automation-Steuerelementmuster aufgelistet, die von allen Link-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster/Mustereigenschaft

Unterstützung/Wert

Hinweise

IInvokeProvider

Ja

Alle Link-Steuerelemente müssen das Invoke-Muster unterstützen.

IValueProvider

Variabel

Link-Steuerelemente müssen das Value-Steuerelementmuster unterstützen, wenn der Link für den Benutzer nutzbare und sinnvolle Informationen enthält.

Value

Beispiel: "http://www..."

Eine URL für eine Internet- oder Intranetadresse ist ein Beispiel für einen Link, der für den Benutzer sinnvolle Informationen enthält. Ein programmgesteuerter Link ist dagegen nur für eine Anwendung sinnvoll und wird für die Value-Eigenschaft nicht empfohlen.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle werden die UI Automation-Ereignisse aufgelistet, die von allen Link-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis

Unterstützung

Hinweise

InvokedEvent

Erforderlich

Keine

Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Referenz

Hyperlink

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung