Freigeben über

Kalendersteuerelementtyp

  • Artikel

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

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
  • 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 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

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung