Kalendersteuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung des Steuerelementtyps "Kalender" von Microsoft Benutzeroberflächenautomatisierung. Ein Kalendersteuerelement ermöglicht es dem Benutzer, das Datum ganz einfach zu bestimmen und andere Datumsangaben auszuwählen.
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Calendar-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Kalendersteuerelemente, bei denen das Benutzeroberflächenframework bzw. die Benutzeroberflächenplattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur der Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Struktur der Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Kalendersteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
|
Kalendersteuerelemente können in vielen verschiedenen Formen in der Benutzeroberfläche dargestellt werden. Die einzigen Steuerelemente, die sich garantiert in der Steuerelementansicht der Benutzeroberflächenautomatisierung Struktur befinden, sind das Datenraster, die Kopfzeile, das Kopfzeilenelement und das Listenelementsteuerelement.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den Calendar-Steuerelementtyp besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Hinweise |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der Rohansicht der Benutzeroberflächenautomatisierung-Struktur eindeutig sein. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Das äußere Rechteck, das das gesamte Steuerelement enthält. |
| UIA_ClickablePointPropertyId | Siehe Hinweise. | Unterstützt, wenn es ein umschließendes Rechteck gibt. Wenn nicht jeder Punkt innerhalb des begrenzungsenden Rechtecks geklickt werden kann und das Element spezielle Treffertests ausführt, überschreiben Sie, und stellen Sie einen klickbaren Punkt bereit. |
| UIA_ControlTypePropertyId | Calendar | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| UIA_IsContentElementPropertyId | TRUE | Das Kalendersteuerelement ist stets in der Inhaltsansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| UIA_IsControlElementPropertyId | TRUE | Das Kalendersteuerelement ist stets in der Steuerelementansicht der Struktur der Benutzeroberflächenautomatisierung enthalten. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. |
| UIA_LabeledByPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss die Bezeichnung des Dokumentsteuerelements sein. In der Regel wird der Titel des Dokuments verwendet. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem Calendar-Steuerelementtyp entspricht. Der Standardwert ist "calendar" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | Siehe Hinweise. | Das Kalendersteuerelement ruft seinen Namen in der Regel aus dem aktuellen Datum ab. |
Erforderliche Steuerelementmuster
In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von allen Kalendersteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
| Steuerelementmuster/Mustereigenschaft | Unterstützung/Wert | Hinweise |
|---|---|---|
| IGridProvider | Erforderlich | Das Kalendersteuerelement unterstützt immer das Raster-Steuerelementmuster , da die Tage innerhalb eines Monats Elemente sind, die räumlich navigiert werden können. |
| IScrollProvider | Depends (Abhängig) | Die meisten Kalendersteuerelemente unterstützen seitenbezogenes Kippen der Ansicht. Das Scroll-Steuerelementmuster wird empfohlen, um die Pagingnavigation zu unterstützen. |
| ISelectionProvider | Depends (Abhängig) | Die meisten Kalendersteuerelemente behalten einen bestimmten Tag, Einen bestimmten Monat oder ein bestimmtes Jahr als Auswahl des Unterelements bei. Einige Kalender sind mehrfach auswählbar und andere nur einzeln auswählbar. Das Kalendersteuerelement mit auswählbaren Unterelementen sollte das Auswahl-Steuerelementmuster unterstützen. |
| ITableProvider | Erforderlich | Da das Kalendersteuerelement immer über einen Header in seiner Unterstruktur für die Wochentage verfügt, muss das Table-Steuerelementmuster unterstützt werden. |
| IValueProvider | Nein | Das Wert-Steuerelementmuster ist für Kalendersteuerelemente nicht erforderlich, da das -Element den Wert nicht direkt im Steuerelement festlegen kann. Wenn dem Steuerelement ein bestimmtes Datum zugeordnet ist, sollten die Informationen vom Steuerelementmuster Selection bereitgestellt werden. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die Kalendersteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Ereignis der Benutzeroberflächenautomatisierung | Hinweise |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaft geändertes Ereignis. | |
| UIA_IsEnabledPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_IsOffscreenPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_LayoutInvalidatedEventId | |
| UIA_MultipleViewCurrentViewPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement die CurrentView-Eigenschaft des MultipleView-Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_StructureChangedEventId | |
| UIA_ScrollHorizontallyScrollablePropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollHorizontalViewSizePropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollVerticalScrollPercentPropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollVerticallyScrollablePropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_ScrollVerticalViewSizePropertyId Eigenschaft geändertes Ereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_Selection_InvalidatedEventId |
Zugehörige Themen