Udostępnij za pomocą

Obsługa automatyzacji interfejsu użytkownika dla typu kontrolki obrazu

Uwaga / Notatka

Ta dokumentacja jest przeznaczona dla deweloperów programu .NET Framework, którzy chcą używać zarządzanych klas automatyzacji interfejsu użytkownika zdefiniowanych w przestrzeni nazw System.Windows.Automation. Aby uzyskać najnowsze informacje na temat automatyzacji interfejsu użytkownika, zobacz Windows Automation API: Automatyzacja interfejsu użytkownika.

Ten temat zawiera informacje o obsłudze automatyzacji interfejsu użytkownika dla kontrolki typu Obraz. W Automatyzacji interfejsu użytkownika typ kontrolki jest zestawem warunków, które musi spełniać kontrolka, aby korzystać z właściwości ControlTypeProperty. Warunki obejmują konkretne wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika i wzorców 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 automatyzacji interfejsu użytkownika, właściwości, wzorce sterowania i zdarzenia dla typu kontrolki Obraz. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek obrazów, niezależnie od tego, czy windows Presentation Foundation (WPF), Win32 lub Windows Forms.

Wymagana struktura drzewa automatyzacji interfejsu użytkownika

W poniższej tabeli przedstawiono widok kontrolki i widok zawartości drzewa automatyzacji interfejsu użytkownika odnoszący się do kontrolek obrazów 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 sterowania Widok zawartości
Obraz Obraz (zależy od tego, czy obraz zawiera informacje, w oparciu o wartość właściwości IsContentElement)

Wymagane właściwości automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono właściwości automatyzacji 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 automatyzacji interfejsu użytkownika, zobacz Właściwości automatyzacji interfejsu użytkownika dla klientów.

Właściwość automatyzacji interfejsu użytkownika Wartość Notatki
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 znajdować się w obrębie prostokąta ograniczającego kontrolkę 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 automatyzacji 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ść Nazwa automatyzacji interfejsu użytkownika.
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 automatyzacji interfejsu użytkownika, jeśli 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 automatyzacji interfejsu użytkownika.
HelpTextProperty Zobacz uwagi. Właściwość HelpText uwidacznia zlokalizowany ciąg, który opisuje rzeczywisty wygląd kontrolki (na przykład czerwony kwadrat z białym znakiem "X") lub inne informacje z etykietki 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ść jest odwzorowana na tag LongDesc w HTML i tag Desc w skalowalnej grafice 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 odpowiadać właściwości 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 automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi wszystkich kontrolek obrazów. Aby uzyskać więcej informacji na temat wzorców elementów sterujących, zajrzyj do Omówienie wzorców automatyzacji interfejsu użytkownika.

Wzorzec kontrolki Wsparcie Notatki
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 wyboru elementu.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono zdarzenia automatyzacji interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki obrazów. Aby uzyskać więcej informacji na temat zdarzeń, zobacz Omówienie zdarzeń automatyzacji interfejsu użytkownika.

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
InvokedEvent Nigdy Żaden
ElementAddedToSelectionEvent Nigdy Żaden
ElementRemovedFromSelectionEvent Nigdy Żaden
ElementSelectedEvent Nigdy Żaden
BoundingRectangleProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsOffscreenProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsEnabledProperty zdarzenie zmiany właściwości. Wymagane Żaden
NameProperty zdarzenie zmiany właściwości. Wymagane Żaden
AutomationFocusChangedEvent Wymagane Żaden
StructureChangedEvent Wymagane Żaden

Zobacz także

  • Last updated on