Udostępnij za pomocą

Obsługa automatyzacji interfejsu użytkownika dla typu kontrola dokumentu

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.

Temat ten zawiera informacje na temat wsparcia dla automatyzacji interfejsu użytkownika w przypadku typu kontrolki Dokument. 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ą określone wytyczne dotyczące struktury drzewa automatyzacji interfejsu użytkownika, wartości właściwości automatyzacji interfejsu użytkownika i wzorców kontrolek.

Kontrolki dokumentu umożliwiają użytkownikowi wyświetlanie i manipulowanie wieloma stronami tekstu. W przeciwieństwie do kontrolek edycji, które obsługują tylko prosty wiersz tekstu niesformatowanego, kontrolki dokumentu mogą hostować tekst bogato stylizowany i sformatowany.

W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacji interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Dokument. Wymagania automatyzacji interfejsu użytkownika mają zastosowanie do wszystkich kontrolek dokumentó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ącego się do kontrolek dokumentó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
Dokument

-Różni się		 Dokument

-Różni się

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 są szczególnie istotne dla kontrolek dokumentów. 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. Dokument ma klikalny punkt, który spowoduje, że dokument jednego z jego elementów w kontenerze dokumentów ma fokus.
ControlTypeProperty Dokument Ta wartość jest taka sama dla wszystkich struktur interfejsu użytkownika.
IsContentElementProperty Prawda Kontrolka dokumentu jest zawsze uwzględniana w widoku zawartości drzewa automatyzacji interfejsu użytkownika.
IsControlElementProperty Prawda Kontrolka dokumentu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacji interfejsu użytkownika.
IsKeyboardFocusableProperty Zobacz uwagi. Jeśli kontrolka może odbierać fokus klawiatury, musi obsługiwać tę właściwość.
LabeledByProperty Zobacz uwagi. Wartość tej właściwości powinna być etykietą kontrolki dokumentu. Zazwyczaj jest używany tytuł dokumentu.
LocalizedControlTypeProperty "dokument" Zlokalizowany ciąg odpowiadający typowi kontrolki Dokument.
NameProperty Zobacz uwagi. Kontrola dokumentów zwykle pobiera swoją nazwę z nazwy pliku, z którego jest ładowana. Jest to często wyświetlane w tytule zawierającym okno lub ramkę.

Wymagane wzorce kontrolek automatyzacji interfejsu użytkownika

W poniższej tabeli wymieniono wzorce kontrolek automatyzacji interfejsu użytkownika wymagane do obsługi przez kontrolki dokumentó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
IScrollProvider Zależy Kontrolka dokumentu może obejmować więcej niż ten zakresportu widoku. Kontrolka powinna obsługiwać wzorzec przewijania, jeśli zawartość można przewijać.
ITextProvider Wymagane Kontrolka dokumentu może obejmować więcej niż ten zakresportu widoku. Kontrolka powinna obsługiwać wzorzec przewijania, jeśli zawartość można przewijać.
IValueProvider Nigdy Kontrolka dokumentu nie obsługuje tego wzorca kontrolki, ponieważ zawartość kontrolki często obejmuje więcej niż jedną stronę. Klienci automatyzacji interfejsu użytkownika powinni używać TextPattern do uzyskiwania informacji tekstowych dotyczących dokumentu.

Wymagane zdarzenia automatyzacji interfejsu użytkownika

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

Zdarzenie automatyzacji interfejsu użytkownika Wsparcie Notatki
AutomationFocusChangedEvent Wymagane Żaden
BoundingRectangleProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsEnabledProperty zdarzenie zmiany właściwości. Wymagane Żaden
IsOffscreenProperty zdarzenie zmiany właściwości. Wymagane Żaden
StructureChangedEvent Wymagane Żaden
HorizontallyScrollableProperty zdarzenie zmiany właściwości. Wymagane Żaden
HorizontalScrollPercentProperty zdarzenie zmiany właściwości. Wymagane Żaden
HorizontalViewSizeProperty zdarzenie zmiany właściwości. Wymagane Żaden
VerticalScrollPercentProperty zdarzenie zmiany właściwości. Wymagane Żaden
VerticallyScrollableProperty zdarzenie zmiany właściwości. Wymagane Żaden
VerticalViewSizeProperty zdarzenie zmiany właściwości. Wymagane Żaden
InvalidatedEvent Zależy Jeśli kontrolka obsługuje wzorzec kontrolki Wybór, musi obsługiwać to zdarzenie.
TextSelectionChangedEvent Wymagane Żaden
TextChangedEvent Wymagane Żaden
ValueProperty zdarzenie zmiany właściwości. Nigdy Żaden

Zobacz także

  • Last updated on