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

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
  • Kalender
    • DataGrid
      • Header (0 oder 1)
        • HeaderItem (0 oder 7, Menge hängt davon ab, wie viele Tage in Spalten angezeigt werden)
      • ListItem (die Menge hängt davon ab, wie viele Tage angezeigt werden)
      • Button (0 oder 2; für Seitenverwaltung der Kalenderansicht)
  • Kalender
    • ListItem (die Menge hängt davon ab, wie viele Tage angezeigt werden)

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

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung