Obsługa automatyzacji interfejsu użytkownika dla formantów typu obraz
Uwaga
Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacja interfejsu użytkownika zdefiniowanych w System.Windows.Automation przestrzeni nazw. Aby uzyskać najnowsze informacje na temat automatyzacja interfejsu użytkownika, zobacz Interfejs API usługi Windows Automation: automatyzacja interfejsu użytkownika.
Ten temat zawiera informacje o obsłudze automatyzacja interfejsu użytkownika dla typu kontrolki Obraz. W automatyzacja interfejsu użytkownika typ kontrolki jest zestawem warunków, które musi spełniać kontrolka ControlTypeProperty w celu użycia właściwości . Warunki obejmują konkretne wytyczne dotyczące struktury drzewa automatyzacja interfejsu użytkownika, automatyzacja interfejsu użytkownika wartości właściwości i wzorce kontrolek.
Kontrolki obrazów używane jako ikony, grafika informacyjna i wykresy będą obsługiwać typ kontrolki Obraz. Kontrolki używane jako obrazy tła lub znaku wodnego nie będą obsługiwać typu kontrolki Obraz.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Obraz. Wymagania dotyczące automatyzacja interfejsu użytkownika dotyczą wszystkich kontrolek obrazów, niezależnie od tego, czy windows Presentation Foundation (WPF), Win32 lub Windows Forms.
Wymagana struktura drzewa automatyzacja interfejsu użytkownika
W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacja interfejsu użytkownika odnoszącego się do kontrolek obrazu i opisano, co można zawierać w każdym widoku. Aby uzyskać więcej informacji na temat drzewa automatyzacja interfejsu użytkownika, zobacz omówienie drzewa automatyzacja interfejsu użytkownika.
| Widok kontrolki | Widok zawartości |
|---|---|
| Obraz | Obraz (zależy od tego, czy obraz zawiera informacje (na podstawie wartości IsContentElement właściwości)) |
Wymagane właściwości automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono właściwości automatyzacja interfejsu użytkownika, których wartość lub definicja jest szczególnie istotna dla typu kontrolki Obraz. Aby uzyskać więcej informacji na temat właściwości automatyzacja interfejsu użytkownika, zobacz automatyzacja interfejsu użytkownika Właściwości dla klientów.
| właściwość automatyzacja interfejsu użytkownika | Wartość | Uwagi |
|---|---|---|
| AutomationIdProperty | Zobacz uwagi. | Wartość tej właściwości musi być unikatowa we wszystkich kontrolkach w aplikacji. |
| BoundingRectangleProperty | Zobacz uwagi. | Najbardziej oddalony prostokąt, który zawiera całą kontrolkę. |
| ClickablePointProperty | Zobacz uwagi. | Punkt klikalny kontrolki obrazu musi być punktem w obrębie prostokąta ograniczenia kontrolki obrazu. |
| IsKeyboardFocusableProperty | Zobacz uwagi. | Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość. |
| NameProperty | Zobacz uwagi. | Właściwość Name musi być uwidoczniona dla wszystkich kontrolek obrazów zawierających informacje. Dostęp programowy do tych informacji wymaga podania tekstu równoważnego z grafiką. Jeśli kontrolka obrazu jest czysto dekoracyjna, musi być wyświetlana tylko w widoku sterowania drzewa automatyzacja interfejsu użytkownika i nie musi mieć nazwy. Struktury interfejsu użytkownika muszą obsługiwać właściwość ALT lub alternatywny tekst na obrazach, które można ustawić z poziomu ich struktury. Ta właściwość zostanie następnie zamapowana na właściwość automatyzacja interfejsu użytkownika Name. |
| LabeledByProperty | Zobacz uwagi. | Jeśli istnieje statyczna etykieta tekstowa, ta właściwość musi uwidocznić odwołanie do tej kontrolki. |
| ControlTypeProperty | Obraz | Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika. |
| LocalizedControlTypeProperty | "obraz" | Zlokalizowany ciąg odpowiadający typowi kontrolki Obraz. |
| IsContentElementProperty | Zobacz uwagi. | Kontrolka obrazu musi być uwzględniona w widoku zawartości drzewa automatyzacja interfejsu użytkownika, gdy zawiera istotne informacje, które nie zostały jeszcze ujawnione użytkownikowi końcowemu. |
| IsControlElementProperty | Prawda | Kontrolka obrazu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja interfejsu użytkownika. |
| HelpTextProperty | Zobacz uwagi. | Właściwość HelpText uwidacznia zlokalizowany ciąg, który opisuje rzeczywisty wygląd wizualizacji kontrolki (na przykład czerwony kwadrat z białym znakiem "X") lub inne informacje etykietki narzędzia skojarzone z obrazem. Ta właściwość musi być obsługiwana, gdy potrzebny jest długi opis, aby przekazać więcej informacji o kontrolce obrazu. Na przykład skomplikowany wykres lub diagram. Ta właściwość mapuje na tag LONGDesc HTML i tag Desc skalowalnej grafiki wektorowej (SVG). Deweloperzy pracujący z kontrolkami obrazów muszą obsługiwać właściwość, aby umożliwić ustawianie opisu wizualizacji w kontrolce. Ta właściwość musi zostać zamapowana na właściwość automatyzacja interfejsu użytkownika VisualDescription. |
| ItemStatusProperty | Zobacz uwagi. | Jeśli kontrolka obrazu reprezentuje informacje o stanie określonego elementu na ekranie, kontrolka powinna być zawarta w elemencie. Gdy obraz jest zawarty w elemencie, element musi obsługiwać właściwość statusu i zgłaszać odpowiednie powiadomienia, gdy stan ulegnie zmianie. Jeśli obraz jest kontrolką autonomiczną i przekazuje stan, ta właściwość musi być obsługiwana. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki obrazu. Aby uzyskać więcej informacji na temat wzorców kontrolek, zobacz automatyzacja interfejsu użytkownika Control Patterns Overview (Omówienie wzorców kontrolek automatyzacja interfejsu użytkownika).
| Wzorzec kontrolki | Pomoc techniczna | Uwagi |
|---|---|---|
| IGridItemProvider | Zależy | Kontrolka obrazu obsługuje wzorzec elementu siatki, jeśli kontrolka znajduje się w kontenerze siatki. |
| ITableItemProvider | Zależy | Kontrolka obrazu obsługuje wzorzec elementu tabeli, jeśli kontrolka znajduje się w kontenerze zawierającym kontrolki nagłówka. |
| IInvokeProvider | Nigdy | Jeśli kontrolka obrazu zawiera obraz możliwy do kliknięcia, kontrolka powinna obsługiwać typ kontrolki obsługujący wzorzec Invoke, taki jak typ kontrolki Przycisk. |
| ISelectionItemProvider | Nigdy | Kontrolki obrazów nie powinny obsługiwać wzorca elementu zaznaczenia. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki obrazu. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| InvokedEvent | Nigdy | Brak |
| ElementAddedToSelectionEvent | Nigdy | Brak |
| ElementRemovedFromSelectionEvent | Nigdy | Brak |
| ElementSelectedEvent | Nigdy | Brak |
| BoundingRectangleProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsOffscreenProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsEnabledProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| NameProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| AutomationFocusChangedEvent | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |