Freigeben über

Kalendersteuerelementtyp

  • Artikel

Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Kalender- Steuerelementtyp. Ein Kalendersteuerelement ermöglicht es dem Benutzer, das Datum auf einfache Weise zu bestimmen und andere Datumsangaben auszuwählen.

In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Kalender- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Kalendersteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Benutzeroberflächenautomatisierungsunterstützung für Steuerelementtypen und Steuerelementmuster integriert.

Dieses Thema enthält die folgenden Abschnitte.

Typische Struktur

Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Kalendersteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.

Steuerelementansicht Inhaltsansicht
  • Kalender
    • DataGrid
      • Kopfzeile (0 oder 1)
        • HeaderItem (0 oder 7, Menge hängt davon ab, wie viele Tage in Spalten angezeigt werden)
      • ListItem (Menge hängt davon ab, wie viele Tage angezeigt werden)
      • Schaltfläche (0 oder 2; für die Auslagerungskalenderansicht)
  • Kalender
    • ListItem (Menge hängt davon ab, wie viele Tage angezeigt werden)

 

Kalendersteuerelemente können in vielen verschiedenen Formularen auf der Benutzeroberfläche dargestellt werden. Die einzigen Steuerelemente, die sich garantiert in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur befinden, sind das Datenraster, die Kopfzeile, das Kopfzeilenelement und listenelementsteuerelemente.

Relevante Eigenschaften

In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für den steuerelementtyp Calendar relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.

Benutzeroberflächenautomatisierungs-Eigenschaft Wert Notizen
UIA_AutomationIdPropertyId Siehe Hinweise. Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein.
UIA_BoundingRectanglePropertyId Siehe Hinweise. Das äußerste Rechteck, das das gesamte Steuerelement enthält.
UIA_ClickablePointPropertyId Siehe Hinweise. Wird unterstützt, wenn ein umgebendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umgebenden Rechtecks klickbar ist und das Element spezielle Treffertests durchführt, überschreiben Und stellen Sie einen klickbaren Punkt bereit.
UIA_ControlTypePropertyId Kalender- Dieser Wert ist für alle Benutzeroberflächenframeworks identisch.
UIA_IsContentElementPropertyId STIMMT Das Kalendersteuerelement ist immer in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten.
UIA_IsControlElementPropertyId STIMMT Das Kalendersteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-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 sollte die Bezeichnung des Dokumentsteuerelements sein. Normalerweise wird der Titel des Dokuments verwendet.
UIA_LocalizedControlTypePropertyId Siehe Hinweise. Lokalisierte Zeichenfolge, die dem steuerelementtyp Calendar 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 Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von allen Kalendersteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.

Control Pattern/Pattern-Eigenschaft Support/Wert Notizen
IGridProvider- Erforderlich Das Kalendersteuerelement unterstützt immer das Raster- Steuerelementmuster, da die Tage innerhalb eines Monats Elemente sind, die räumliche Navigation möglich sind.
IScrollProvider- Hängt Die meisten Kalendersteuerelemente unterstützen das Kippen der Ansicht nach Seite. Das Steuerelementmusters wird empfohlen, um die Seitennavigation zu unterstützen.
ISelectionProvider- Hängt Die meisten Kalendersteuerelemente behalten einen bestimmten Tag, Monat oder Jahr als Auswahl des Unterelements bei. Einige Kalender sind mehrfach auswählbar und können nur einzeln ausgewählt werden. Das Kalendersteuerelement mit auswählbaren Unterelementen sollte das Auswahl- Steuerelementmusters unterstützen.
ITableProvider- Erforderlich Da das Kalendersteuerelement immer eine Kopfzeile innerhalb der Unterstruktur für die Wochentage aufweist, muss das Tabellen- Steuerelementmuster unterstützt werden.
IValueProvider- Nein Das Steuerelementmuster Wert ist für Kalendersteuerelemente nicht erforderlich, da das Element den Wert nicht direkt für das Steuerelement festlegen kann. Wenn dem Steuerelement ein bestimmtes Datum zugeordnet ist, sollten die Informationen durch das Selection-Steuerelementmuster bereitgestellt werden.

 

Erforderliche Ereignisse

In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungsereignisse aufgeführt, die Kalendersteuerelemente unterstützen müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.

Benutzeroberflächenautomatisierungs-Ereignis Notizen
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis.
UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden.
UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen.
UIA_LayoutInvalidatedEventId
UIA_MultipleViewCurrentViewPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement die CurrentView--Eigenschaft des MultipleView Steuerelementmusters unterstützt, muss dieses Ereignis unterstützt werden.
UIA_StructureChangedEventId
UIA_ScrollHorizontallyScrollablePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalScrollPercentPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollHorizontalViewSizePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalScrollPercentPropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticallyScrollablePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_ScrollVerticalViewSizePropertyId Eigenschaftsänderungsereignis. Wenn das Steuerelement das Scroll- Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.
UIA_Selection_InvalidatedEventId

 

Konzeptionelle

Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung