Typ kontrolki hiperłącza
Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika firmy Microsoft dla typu kontrolki Hiperłącze.
Kontrolki hiperłącza tworzą łącza, które umożliwiają użytkownikom nawigowanie w obrębie tej samej strony lub z jednej strony do innej.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Hiperłącze. Wymagania automatyzacji interfejsu użytkownika dotyczą wszystkich kontrolek hiperłączy, w których platforma/platforma interfejsu użytkownika integruje obsługę automatyzacji interfejsu użytkownika dla typów kontrolek i wzorców kontrolek.
Ten temat zawiera następujące sekcje.
- typowa struktura drzewa
- odpowiednie właściwości
- wymagane wzorce kontrolek
- wymagane zdarzenia
- uwagi
- Tematy pokrewne
Typowa struktura drzewa
W poniższej tabeli przedstawiono typowy widok kontrolki i zawartości drzewa automatyzacji interfejsu użytkownika odnoszącego się do kontrolek hiperłączy i opisano, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacji interfejsu użytkownika, zobacz Omówienie drzewa automatyzacji interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
|
|
Odpowiednie właściwości
W poniższej tabeli wymieniono właściwości automatyzacji interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla kontrolek hiperłączy. Aby uzyskać więcej informacji na temat właściwości automatyzacji interfejsu użytkownika, zobacz Pobieranie właściwości z elementów automatyzacji interfejsu użytkownika.
| Właściwość automatyzacji interfejsu użytkownika | Wartość | Notatki |
|---|---|---|
| UIA_AutomationIdPropertyId | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa we wszystkich kontrolkach w aplikacji. |
| UIA_BoundingRectanglePropertyId | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| UIA_ClickablePointPropertyId | Zobacz uwagi. | Punkt klikalny kontrolki hiperłącza musi być punktem, który uruchamia hiperlink po kliknięciu wskaźnika myszy. |
| UIA_ControlTypePropertyId | hiperłącza | |
| UIA_IsContentElementPropertyId | PRAWDZIWY | Kontrolka hiperłącza jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsControlElementPropertyId | PRAWDZIWY | Kontrolka hiperłącza jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika. |
| UIA_IsKeyboardFocusablePropertyId | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| UIA_LabeledByPropertyId | Zobacz uwagi. | Jeśli istnieje statyczna etykieta tekstowa, ta właściwość musi uwidocznić odwołanie do tej kontrolki. |
| UIA_LocalizedControlTypePropertyId | Zobacz uwagi. | Zlokalizowany ciąg odpowiadający typowi kontrolki Hiperłącze. Wartość domyślna to "hiperłącze" dla en-US lub angielskiego (Stany Zjednoczone). |
| UIA_NamePropertyId | Zobacz uwagi. | Nazwa kontrolki hiperłącza to tekst wyświetlany na ekranie, jak podkreślony. |
Wymagane wzorce kontrolek
W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek hiperłączy. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie.
| Wzorzec/wzorzec kontrolki, właściwość | Pomoc techniczna/wartość | Notatki |
|---|---|---|
| IInvokeProvider | Wymagane | Wszystkie kontrolki hiperłączy muszą obsługiwać wzorzec kontrolki Invoke. |
| IValueProvider | Zależy | Kontrolki hiperłączy powinny obsługiwać wzorzec kontrolki value, gdy link zawiera informacje, które mogą być użyteczne i zrozumiałe dla użytkownika. |
| wartości | Na przykład "https://www..." | Adres URL adresu internetowego lub intranetowego to przykład hiperłącza zawierającego informacje istotne dla użytkownika. Jednak łącze programowe ma znaczenie tylko dla aplikacji i nie jest zalecane dla właściwości Value. |
Zdarzenia wymagane
W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika, które są wymagane do obsługi kontrolek hiperłączy. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.
| Zdarzenie automatyzacji interfejsu użytkownika | Notatki |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId zdarzenie zmienione właściwości. | |
| UIA_Invoke_InvokedEventId | |
| UIA_IsEnabledPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsEnabled, musi obsługiwać to zdarzenie. |
| UIA_IsOffscreenPropertyId zdarzenie zmienione właściwości. | Jeśli kontrolka obsługuje właściwość IsOffscreen, musi obsługiwać to zdarzenie. |
| UIA_StructureChangedEventId |
Uwagi
Typ kontrolki Hiperłącze należy zastosować tylko do obiektu, który po kliknięciu powoduje wystąpienie nawigacji; Nie należy go stosować do kontenera hiperłącza. Na przykład tylko kliknięcie "hot spot" wewnątrz mapy obrazu powinno mieć typ kontrolki Hiperłącze. To samo dotyczy hiperlinków w polu tekstowym lub kontenerze dokumentu. W takim przypadku tylko tekst hiperłącza lub obraz powinien mieć typ kontrolki Hiperłącze, a nie kontener.
Wzorzec kontrolki Tekst jest idealny do obsługi osadzonych hiperlinków w elementach tekstu lub dokumentu.
Tematy pokrewne