Obsługa automatyzacji interfejsu użytkownika dla kontrolek typu dokument
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 Dokument. 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 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 sformatowany i sformatowany.
W poniższych sekcjach zdefiniowano wymaganą strukturę drzewa automatyzacja interfejsu użytkownika, właściwości, wzorce kontrolek i zdarzenia dla typu kontrolki Dokument. Wymagania dotyczące automatyzacja 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 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 dokumentów 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 |
|---|---|
| Dokument -Różni się |
Dokument -Różni się |
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 kontrolek dokumentów. 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. | 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 automatyzacja interfejsu użytkownika. |
| IsControlElementProperty | Prawda | Kontrolka dokumentu jest zawsze uwzględniana w widoku kontrolki drzewa automatyzacja 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. | Kontrolka dokumentu zwykle pobiera nazwy z nazwy pliku, z których jest ładowana. Jest to często wyświetlane w tytule zawierającym okno lub ramkę. |
Wymagane wzorce kontrolek automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono wzorce kontrolek automatyzacja interfejsu użytkownika wymagane do obsługi przez kontrolki dokumentów. 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 |
|---|---|---|
| IScrollProvider | Zależy | Kontrolka dokumentu może obejmować więcej niż ten zakresportu widoku. Kontrolka powinna obsługiwać wzorzec kontrolki Przewijanie, jeśli zawartość można przewijać. |
| ITextProvider | Wymagania | Kontrolka dokumentu może obejmować więcej niż ten zakresportu widoku. Kontrolka powinna obsługiwać wzorzec kontrolki Przewijanie, 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ę. automatyzacja interfejsu użytkownika klienci powinni używać TextPattern do uzyskiwania informacji tekstowych o dokumencie. |
Wymagane zdarzenia automatyzacja interfejsu użytkownika
W poniższej tabeli wymieniono zdarzenia automatyzacja interfejsu użytkownika wymagane do obsługi przez wszystkie kontrolki dokumentów. Aby uzyskać więcej informacji na temat zdarzeń, zobacz omówienie zdarzeń automatyzacja interfejsu użytkownika.
| zdarzenie automatyzacja interfejsu użytkownika | Pomoc techniczna | Uwagi |
|---|---|---|
| AutomationFocusChangedEvent | Wymagania | Brak |
| BoundingRectangleProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsEnabledProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| IsOffscreenProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| StructureChangedEvent | Wymagania | Brak |
| HorizontallyScrollableProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| HorizontalScrollPercentProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| HorizontalViewSizeProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| VerticalScrollPercentProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| VerticallyScrollableProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| VerticalViewSizeProperty zdarzenie zmienione właściwości. | Wymagania | Brak |
| InvalidatedEvent | Zależy | Jeśli kontrolka obsługuje wzorzec kontrolki Wybór, musi obsługiwać to zdarzenie. |
| TextSelectionChangedEvent | Wymagania | Brak |
| TextChangedEvent | Wymagania | Brak |
| ValueProperty zdarzenie zmienione właściwości. | Nigdy | Brak |