Stöd för användargränssnittsautomatisering för hyperlänkkontrolltypen
Kommentar
Den här dokumentationen System.Windows.Automation är avsedd för .NET Framework-utvecklare som vill använda de hanterade UI Automation-klasserna som definierats i namnområdet. Den senaste informationen om UI Automation finns i Windows Automation API: UI Automation.
Det här avsnittet innehåller information om UI Automation-stöd för hyperlänkkontrolltypen. I UI Automation är en kontrolltyp en uppsättning villkor som en kontroll måste uppfylla för att kunna använda egenskapen ControlTypeProperty . Villkoren innehåller specifika riktlinjer för UI Automation-trädstruktur, UI Automation-egenskapsvärden och kontrollmönster.
Hyperlänkkontroller gör det möjligt för en användare att navigera på en sida, från en sida till en annan, och öppna fönster.
I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för hyperlänkkontrolltypen. Kraven för användargränssnittsautomatisering gäller för alla hyperlänkkontroller, oavsett om windows presentationsfundament (WPF), Win32 eller Windows Forms.
Obligatorisk trädstruktur för användargränssnittsautomatisering
I följande tabell visas kontrollvyn och innehållsvyn för UI Automation-trädet som gäller för hyperlänkkontroller och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i Översikt över UI Automation Tree.
| Kontrollvy | Innehållsvy |
|---|---|
| Hyperlänk | Hyperlänk |
Nödvändiga egenskaper för UI Automation
I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för hyperlänkkontrolltypen. Mer information om egenskaper för UI Automation finns i UI Automation Properties for Clients (Egenskaper för gränssnittsautomatisering för klienter).
| UI Automation-egenskap | Värde | Kommentar |
|---|---|---|
| AutomationIdProperty | Se anteckningar. | Värdet för den här egenskapen måste vara unikt för alla kontroller i ett program. |
| BoundingRectangleProperty | Se anteckningar. | Den yttersta rektangeln som innehåller hela kontrollen. |
| ClickablePointProperty | Se anteckningar. | Stöds om det finns en rektangel för avgränsning. Om inte varje punkt i avgränsningsrektangeln är klickbar och du utför specialiserad träfftestning åsidosätter du och anger en klickbar punkt. |
| IsKeyboardFocusableProperty | Se anteckningar. | Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. |
| NameProperty | Se anteckningar. | Hyperlänkkontrollens namn är den text som visas på skärmen som understruken. |
| ClickablePointProperty | Se anteckningar. | Hyperlänkkontrollens klickbara punkt måste vara en punkt som startar hyperlänken om den klickas med en muspekare. |
| LabeledByProperty | Se anteckningar. | Om det finns en statisk textetikett måste den här egenskapen exponera en referens till den kontrollen. |
| ControlTypeProperty | Hyperlänk | Det här värdet är detsamma för alla gränssnittsramverk. |
| LocalizedControlTypeProperty | "hyperlänk" | Lokaliserad sträng som motsvarar kontrolltypen Hyperlänk. |
| IsContentElementProperty | Sant | Hyperlänkkontrollen ingår alltid i innehållsvyn i UI Automation-trädet. |
| IsControlElementProperty | Sant | Hyperlänkkontrollen ingår alltid i kontrollvyn för UI Automation-trädet. |
Obligatoriska UI Automation-kontrollmönster och egenskaper
I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av alla hyperlänkkontroller. Mer information om kontrollmönster finns i Översikt över UI Automation-kontrollmönster.
| Kontrollmönster/mönsteregenskap | Support/värde | Kommentar |
|---|---|---|
| IInvokeProvider | Ja | Alla hyperlänkkontroller måste ha stöd för mönstret Anropa. |
| IValueProvider | Beror | Hyperlänkkontroller bör ha stöd för värdekontrollmönstret när länken innehåller information som är användbar och meningsfull för användaren. |
| Value | 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 UI Automation-händelser
I följande tabell visas de UI Automation-händelser som krävs för att stödjas av alla hyperlänkkontroller. Mer information om händelser finns i Översikt över UI Automation-händelser.
| UI Automation-händelse | Support | Kommentar |
|---|---|---|
| InvokedEvent | Obligatoriskt | Ingen |
| BoundingRectangleProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsOffscreenProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| IsEnabledProperty händelse som ändrats av egenskapen. | Obligatoriskt | Ingen |
| AutomationFocusChangedEvent | Obligatoriskt | Ingen |
| StructureChangedEvent | Obligatoriskt | Inga |