Link-Steuerelementtyp
Dieses Thema enthält Informationen zu Microsoft Benutzeroberflächenautomatisierung Unterstützung für den Steuerelementtyp Hyperlink.
Linksteuerelemente erstellen Links, mit denen Benutzer innerhalb derselben Seite oder von einer Seite zur anderen navigieren können.
In den folgenden Abschnitten werden die Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Steuerelementtyp Hyperlink definiert. Die Benutzeroberflächenautomatisierung gelten für alle Linksteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Anmerkungen
- Zugehörige Themen
Typische Strukturstruktur
Die folgende Tabelle zeigt ein typisches Steuerelement und eine Inhaltsansicht der Benutzeroberflächenautomatisierung struktur, die sich auf Linksteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur Benutzeroberflächenautomatisierung Struktur finden Sie unter Benutzeroberflächenautomatisierung Strukturübersicht.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Relevante Eigenschaften
In der folgenden Tabelle sind die eigenschaften Benutzeroberflächenautomatisierung, deren Wert oder Definition für die Linksteuerelemente besonders relevant ist. Weitere Informationen zu Eigenschaften Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| 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ßere Rechteck, das das gesamte Steuerelement enthält. |
| UIA _ ClickablePointPropertyId | Siehe Hinweise. | Der klickbare Punkt des Linksteuerfelds muss ein Punkt sein, der den Link startet, wenn mit einem Mauszeiger geklickt wird. |
| UIA _ ControlTypePropertyId | Link | |
| UIA _ IsContentElementPropertyId | TRUE | Das Link-Steuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Das Linksteuer steuerelement ist immer in der Steuerelementansicht 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 es eine statische Textbezeichnung gibt, 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 English (USA). |
| UIA _ NamePropertyId | Siehe Hinweise. | Der Name des Linksteuerfelds ist der Text, der unterstrichen auf dem Bildschirm angezeigt wird. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung, die Linksteuerelemente unterstützen müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster/Mustereigenschaft | Unterstützung/Wert | Notizen |
|---|---|---|
| IInvokeProvider | Erforderlich | Alle Linksteuerelemente müssen das Invoke-Steuerelementmuster unterstützen. |
| IValueProvider | Depends (Abhängig) | Linksteuerelemente sollten das Value-Steuerelementmuster unterstützen, wenn der Link Informationen enthält, die für den Benutzer nutzbar 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 sinnvoll und wird für die Value-Eigenschaft nicht empfohlen. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung aufgeführt, die von Linksteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| 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 Steuerelementtyp Hyperlink sollte nur auf ein Objekt angewendet werden, das beim Klicken die Navigation verursacht. sie sollte nicht auf den Container des Links angewendet werden. Beispielsweise sollten nur die klickbaren "Hotspots" in einer Imagemap 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 Steuerelementtyp Hyperlink und nicht den Container haben.
Das Text-Steuerelementmuster eignet sich ideal für die Unterstützung eingebetteter Links in Text- oder Dokumentelementen.