Hyperlänkkontrolltyp
Det här avsnittet innehåller information om Microsoft UI Automation-stöd för Hyperlänk kontrolltyp.
Hyperlänkkontroller skapar länkar som gör det möjligt för användare att navigera på samma sida eller från en sida till en annan.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för Hyperlänk kontrolltyp. Kraven för UI Automation gäller för alla hyperlänkkontroller där UI-ramverket/plattformen integrerar UI Automation-stöd för kontrolltyper och kontrollmönster.
Det här avsnittet innehåller följande avsnitt.
- typisk trädstruktur
- relevanta egenskaper
- nödvändiga kontrollmönster
- nödvändiga händelser
- kommentarer
- Relaterade ämnen
Typisk trädstruktur
I följande tabell visas en typisk kontroll- och innehållsvy över UI Automation-trädet som avser hyperlänkkontroller och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i UI Automation Tree Overview.
Kontrollvy | Innehållsvy |
---|---|
|
|
Relevanta egenskaper
I följande tabell visas de UI Automation-egenskaper vars värde eller definition är särskilt relevant för hyperlänkkontrollerna. Mer information om egenskaper för UI Automation finns i Hämta egenskaper från UI Automation-element.
UI Automation-egenskap | Värde | Anteckningar |
---|---|---|
UIA_AutomationIdPropertyId | Se anteckningar. | Värdet för den här egenskapen måste vara unikt för alla kontroller i ett program. |
UIA_BoundingRectanglePropertyId | Se anteckningar. | Den yttersta rektangeln som innehåller hela kontrollen. |
UIA_ClickablePointPropertyId | Se anteckningar. | Hyperlänkkontrollens klickbara punkt måste vara en punkt som startar hyperlänken om den klickas med en muspekare. |
UIA_ControlTypePropertyId | hyperlänk | |
UIA_IsContentElementPropertyId | SANN | Hyperlänkkontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
UIA_IsControlElementPropertyId | SANN | Hyperlänkkontrollen ingår alltid i kontrollvyn för UI Automation-trädet. |
UIA_IsKeyboardFocusablePropertyId | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
UIA_LabeledByPropertyId | Se anteckningar. | Om det finns en statisk textetikett måste den här egenskapen exponera en referens till den kontrollen. |
UIA_LocalizedControlTypePropertyId | Se anteckningar. | Lokaliserad sträng som motsvarar hyperlänk kontrolltyp. Standardvärdet är "hyperlänk" för en-US eller engelska (USA). |
UIA_NamePropertyId | Se anteckningar. | Hyperlänkkontrollens namn är den text som visas på skärmen som understruken. |
Nödvändiga kontrollmönster
I följande tabell visas de UI Automation-kontrollmönster som hyperlänkkontroller krävs för att stödja. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.
Kontrollmönster/mönsteregenskap | Support/värde | Anteckningar |
---|---|---|
IInvokeProvider | Krävs | Alla hyperlänkkontroller måste ha stöd för Anropa kontrollmönster. |
IValueProvider | Beror | Hyperlänkkontroller bör ha stöd för value kontrollmönster när länken innehåller information som är användbar och meningsfull för användaren. |
Värde | Till exempel "https://www..." | En URL för en Internet- eller intranätadress är ett exempel på en hyperlänk som innehåller information som är meningsfull för användaren. En programmatisk länk är dock bara meningsfull för ett program och rekommenderas inte för egenskapen Value. |
Nödvändiga händelser
I följande tabell visas de UI Automation-händelser som hyperlänkkontroller krävs för att stödja. Mer information om händelser finns i UI Automation Events Overview.
UI Automation-händelse | Anteckningar |
---|---|
UIA_AutomationFocusChangedEventId | |
UIA_BoundingRectanglePropertyId händelse som ändrats av egenskapen. | |
UIA_Invoke_InvokedEventId | |
UIA_IsEnabledPropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder egenskapen IsEnabled måste den stödja den här händelsen. |
UIA_IsOffscreenPropertyId händelse som ändrats av egenskapen. | Om kontrollen stöder egenskapen IsOffscreen måste den ha stöd för den här händelsen. |
UIA_StructureChangedEventId |
Anmärkningar
Kontrolltypen Hyperlänk ska endast tillämpas på ett objekt som, när det klickas, gör att navigeringen sker. Den bör inte tillämpas på hyperlänkens container. Till exempel bör endast klickbara "hot spots" i en bildkarta ha Hyperlänk kontrolltyp. Detsamma gäller hyperlänkar i ett textfält eller en dokumentcontainer. I det här fallet ska endast hyperlänktexten eller bilden ha Hyperlänk kontrolltyp, inte containern.
Kontrollmönstret Text är perfekt för att stödja inbäddade hyperlänkar i text- eller dokumentelement.
Relaterade ämnen
-
konceptuell
-
översikt över UI Automation-kontrolltyper
-
översikt över UI Automation