Calendar-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung von Microsoft Benutzeroberflächenautomatisierung für den Steuerelementtyp Calendar. Mit einem Kalendersteuerelement kann der Benutzer das Datum leicht bestimmen und andere Datumsangaben auswä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 Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische 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 Benutzeroberflächenautomatisierung-Struktur finden Sie unter übersicht über Benutzeroberflächenautomatisierung-Struktur.
| 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 die Steuerelemente für Datenraster, Header, Headerelemente und Listenelemente.
Relevante Eigenschaften
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Eigenschaften aufgeführt, deren Wert oder Definition für den Steuerelementtyp Calendar besonders relevant ist. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elements.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA _ AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss für alle Peerelemente in der rohen Ansicht 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 umschließenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreibt und stellt einen klickbaren Punkt bereit. |
| UIA _ ControlTypePropertyId | Kalender | Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich. |
| UIA _ IsContentElementPropertyId | TRUE | Das Kalendersteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
| UIA _ IsControlElementPropertyId | TRUE | Das Kalendersteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur 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 erhält seinen Namen in der Regel aus dem aktuellen Datum. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Steuerelementmuster 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 | Notizen |
|---|---|---|
| IGridProvider | Erforderlich | Das Kalendersteuerelement unterstützt immer das Grid-Steuerelementmuster, da die Tage innerhalb eines Monats Elemente sind, durch die räumlich navigiert werden kann. |
| 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, Monat oder 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 Auswahlsteuerelementmuster unterstützen. |
| ITableProvider | Erforderlich | Da das Kalendersteuerelement für die Wochentage immer über einen Header innerhalb seiner Unterstruktur verfügt, muss das Tabellensteuerelementmuster unterstützt werden. |
| IValueProvider | Nein | Das Value-Steuerelementmuster ist für Kalendersteuerelemente nicht erforderlich, da das Element den Wert nicht direkt auf dem Steuerelement festlegen kann. Wenn dem Steuerelement ein bestimmtes Datum zugeordnet ist, sollten die Informationen vom Auswahlsteuerelementmuster bereitgestellt werden. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die von Kalendersteuerelementen unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.
| Benutzeroberflächenautomatisierung-Ereignis | Notizen |
|---|---|
| UIA _ AutomationFocusChangedEventId | |
| UIA _ Das BoundingRectanglePropertyId-Eigenschaftswechselereignis. | |
| UIA _ Das IsEnabledPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsEnabled-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ IsOffscreenPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die IsOffscreen-Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| _UIA-LayoutInvalidatedEventId | |
| UIA _ Das MultipleViewCurrentViewPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement die CurrentView-Eigenschaft des MultipleView-Steuerelementmusters unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ StructureChangedEventId | |
| UIA _ ScrollHorizontallyScrollablePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ScrollHorizontalScrollPercentPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ScrollHorizontalViewSizePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ScrollVerticalScrollPercentPropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ScrollVerticallyScrollablePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ ScrollVerticalViewSizePropertyId-Eigenschaftswechselereignis. | Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen. |
| UIA _ Selection _ InvalidatedEventId |