Benutzeroberflächenautomatisierungs-Unterstützung für den Calendar-Steuerelementtyp

Aktualisiert: November 2007

Dieses Thema enthält Informationen über die UI-Automatisierung-Unterstützung für den Calendar-Steuerelementtyp. In UI-Automatisierung umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen enthalten bestimmte Richtlinien für die UI-Automatisierung-Struktur, UI-Automatisierung-Eigenschaftenwerte, Steuerelementmuster und UI-Automatisierung-Ereignisse.

Mit Calendar-Steuerelementen kann ein Benutzer das Datum leicht bestimmen und ein anderes Datum auswählen.

In den folgenden Abschnitten werden die UI-Automatisierung-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Calendar-Steuerelementtyp erforderlich sind. Die UI-Automatisierung-Anforderungen gelten für alle Calendar-Steuerelemente, seien dies Windows Presentation Foundation (WPF)-, Win32- oder Windows Forms-Steuerelemente.

Dieses Thema enthält folgende Abschnitte.

  • Erforderliche Benutzeroberflächenautomatisierungs-Struktur
  • Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften
  • Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung
  • Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse
  • Verwandte Abschnitte

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI-Automatisierung-Struktur, die sich auf Calendar-Steuerelemente bezieht, dargestellt und die möglichen Inhalte jeder Ansicht beschrieben. Weitere Informationen über die UI-Automatisierung-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

Steuerelementansicht

Inhaltsansicht

  • Calendar

    • DataGrid

    • Header (untergeordnetes Element von DataGrid)

    • HeaderItem (untergeordnetes Element von Header; die Menge ist abhängig von der Anzahl der angezeigten Tage)

    • ListItem (untergeordnetes Element von Header; die Menge ist abhängig von der Anzahl der angezeigten Tage)

    • Button (untergeordnetes Element von DataGrid, 0 oder 2)

  • Calendar

    • ListItem (die Menge ist abhängig von der Anzahl der angezeigten Tage)

Calendar-Steuerelemente können in vielen verschiedenen Formen in der Benutzeroberfläche dargestellt werden. Die einzigen Steuerelemente, die garantiert in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten sind, sind die Steuerelemente DataGrid, Header, HeaderItem und ListItem.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle sind die UI-Automatisierung-Eigenschaften aufgeführt, deren Wert oder Definition speziell für Calendar-Steuerelemente relevant ist. Weitere Informationen über die UI-Automatisierung-Eigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI-Automatisierung-Eigenschaft

Wert

Hinweise

AutomationIdProperty()

Siehe Hinweise.

Der Wert dieser Eigenschaft muss für alle Steuerelemente einer Anwendung eindeutig sein.

BoundingRectangleProperty

Siehe Hinweise.

Das äußere Rechteck, welches das gesamte Steuerelement umfasst.

ClickablePointProperty

Siehe Hinweise.

Unterstützt, wenn ein umschließendes Rechteck vorhanden ist. Wenn nicht jeder Punkt innerhalb des umschließenden Rechtecks durch Klicken aktiviert werden kann und Sie eine spezielle Trefferprüfung ausführen, überschreiben Sie diese Eigenschaft, und geben Sie einen durch Klicken aktivierbaren Punkt an.

ControlTypeProperty

Calendar

Dieser Wert ist für alle Benutzeroberfläche-Frameworks identisch.

IsContentElementProperty

True

Das Calendar-Steuerelement ist stets in der Inhaltsansicht der UI-Automatisierung-Struktur enthalten.

IsControlElementProperty

True

Das Calendar-Steuerelement ist stets in der Steuerelementansicht der UI-Automatisierung-Struktur enthalten.

IsKeyboardFocusableProperty

Siehe Hinweise.

Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.

LabeledByProperty

Siehe Hinweise.

Wenn eine statische Textbezeichnung vorhanden ist, muss diese Eigenschaft einen Verweis auf das entsprechende Steuerelement verfügbar machen.

LocalizedControlTypeProperty

"Kalender"

Lokalisierte Zeichenfolge, die dem Calendar-Steuerelementtyp entspricht.

NameProperty

Siehe Hinweise.

Das Calendar-Steuerelement ruft seinen Namen in der Regel aus dem aktuellen Datum ab.

Erforderliche Steuerelementmuster der Benutzeroberflächenautomatisierung

In der folgenden Tabelle sind die UI-Automatisierung-Steuerelementmuster aufgeführt, die von allen Calendar-Steuerelementen unterstützt werden müssen. Weitere Informationen über Steuerelementmuster finden Sie unter Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung.

Steuerelementmuster/Mustereigenschaft

Unterstützung/Wert

Hinweise

IGridProvider

Ja

Das Calendar-Steuerelement unterstützt stets das Grid-Muster, da die in einem Monat enthaltenen Tage Elemente sind, zwischen denen räumlich navigiert werden kann.

IScrollProvider

Variabel

Ob im Calendar-Steuerelement ein Bildlauf durchgeführt werden kann, ist abhängig davon, ob die Navigation zu anderen Monaten möglich ist, ohne dabei den Zustand des Steuerelements zu ändern.

ISelectionProvider

Ja

Alle Calendar-Steuerelemente enthalten Elemente, die auswählbare Wochentage darstellen. In einigen Calendar-Steuerelementen können mehrere Elemente gleichzeitig ausgewählt werden, in anderen jeweils nur ein Element.

ITableProvider

Ja

Das Calendar-Steuerelement verfügt immer über einen Header in seiner Teilstruktur für die Wochentage, sodass das Tabellenmuster unterstützt werden muss.

IValueProvider

Nein

Das Value-Muster ist für Calendar-Steuerelementen nicht notwendig, da der Wert nicht direkt in das Steuerelement eingegeben werden kann. Alle Informationen werden mit dem Selection-Muster angegeben.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle sind die UI-Automatisierung-Ereignisse aufgeführt, die von allen Calendar-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI-Automatisierung-Ereignis

Unterstützung/Wert

Hinweise

AutomationFocusChangedEvent

Erforderlich

Keine

Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis.

Erforderlich

Keine

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis.

Erforderlich

Keine

Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis.

Erforderlich

Keine

LayoutInvalidatedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Durch geänderte CurrentViewProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Keine

Durch geänderte HorizontallyScrollableProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

Durch geänderte HorizontalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

Durch geänderte HorizontalViewSizeProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

Durch geänderte VerticalScrollPercentProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

Durch geänderte VerticallyScrollableProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

Durch geänderte VerticalViewSizeProperty-Eigenschaft ausgelöstes Ereignis.

Variabel

Wenn das Steuerelement das Scroll-Steuerelementmuster unterstützt, muss es dieses Ereignis unterstützen.

InvalidatedEvent

Erforderlich

Keine

Siehe auch

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung

Referenz

Calendar