Freigeben über


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

HinweisHinweis

Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten UI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.Aktuelle Informationen zu UI Automation finden Sie unter Windows Automation API: UI Automation.

Dieses Thema enthält Informationen über die UI Automation-Unterstützung für den Spinner-Steuerelementtyp. In UI Automation umfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty-Eigenschaft verwendet werden kann. Die Bedingungen schließen bestimmte Richtlinien für UI Automation-Struktur, UI Automation-Eigenschaftswerte und Steuerelementmuster ein.

Spinner-Steuerelemente werden verwendet, um aus einer Domäne von Elementen oder einem Bereich von Zahlen auszuwählen.

In den folgenden Abschnitten werden die UI Automation-Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Spinner-Steuerelementtyp erforderlich sind. Die UI Automation-Anforderungen gelten für alle Spinner-Steuerelemente, einschließlich Windows Presentation Foundation (WPF), Win32 und Windows Forms.

Dieses Thema enthält folgende Abschnitte.

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

Erforderliche Benutzeroberflächenautomatisierungs-Struktur

In der folgenden Tabelle werden die Steuerelementansicht und die Inhaltsansicht der UI Automation-Struktur für Drehfelder mit Unterstützung des RangeValue-, Value- und Selection-Steuerelementmusters beschrieben. Weiterhin wird der Inhalt der einzelnen Ansichten erläutert. Weitere Informationen über die UI Automation-Struktur finden Sie unter Übersicht über die Benutzeroberflächenautomatisierungs-Struktur.

RangeValue- oder Value-Steuerelementmuster

Steuerelementansicht

Inhaltsansicht

Drehfeld

  • Bearbeiten (0 oder 1)

  • Button (2)

Drehfeld

Selection-Steuerelementmuster

Steuerelementansicht

Inhaltsansicht

Drehfeld

  • Bearbeiten (0 oder 1)

  • Button (2)

  • Listenelement (0 oder mehr)

Drehfeld

  • ListItem (beliebige Anzahl)

Um sicherzustellen, dass automatisierte Testtools die beiden Schaltflächen in der Steuerelementansicht-Teilstruktur unterscheiden können, weisen Sie SmallIncrement bzw. SmallDecrement AutomationId entsprechend zu. Für einige Implementierungen ist das zugeordnete Bearbeitungssteuerelement möglicherweise ein Peer des Drehfelds.

Erforderliche Benutzeroberflächenautomatisierungs-Eigenschaften

In der folgenden Tabelle werden die UI Automation-Eigenschaften aufgelistet, deren Werte oder Definitionen für Spinner-Steuerelemente besonders wichtig sind. Weitere Informationen zu UI Automationseigenschaften finden Sie unter Benutzeroberflächenautomatisierungs-Eigenschaften für Clients.

UI Automation-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.

Der klickbare Punkt des Spinner-Steuerelements überträgt den Fokus auf den Bearbeitungsbereich des Steuerelements.

IsKeyboardFocusableProperty

Siehe Hinweise.

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

NameProperty

Siehe Hinweise.

Das Spinner-Steuerelement ruft seinen Namen in der Regel aus einer statischen Textbezeichnung ab.

LabeledByProperty

Siehe Hinweise.

Spinner-Steuerelemente verfügen über eine statische Textbezeichnung.

ControlTypeProperty

Drehfeld

Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.

LocalizedControlTypeProperty

"Drehfeld"

Lokalisierte Zeichenfolge, die dem Spinner-Steuerelementtyp entspricht.

IsContentElementProperty

True

Das Spinner-Steuerelement muss stets ein Inhaltselement sein.

IsControlElementProperty

True

Das Spinner-Steuerelement muss stets ein Steuerelement sein.

Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und Eigenschaften

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

Steuerelementmuster/Mustereigenschaft

Unterstützung/Wert

Hinweise

ISelectionProvider

Variabel

Spinner-Steuerelemente, die eine Liste auszuwählender Elemente aufweisen, müssen dieses Muster unterstützen.

CanSelectMultiple

False

Spinner-Steuerelemente sind immer Einzelauswahlcontainer.

IRangeValueProvider

Variabel

Drehfelder, die einen numerischen Bereich umfassen, können dieses Muster unterstützen.

IValueProvider

Variabel

Drehfelder, die einen einzelnen Satz von Optionen oder Zahlen umfassen, können dieses Muster unterstützen.

Erforderliche Benutzeroberflächenautomatisierungs-Ereignisse

In der folgenden Tabelle werden die UI Automation-Ereignisse aufgelistet, die von allen Spinner-Steuerelementen unterstützt werden müssen. Weitere Informationen über Ereignisse finden Sie unter Übersicht über Benutzeroberflächenautomatisierungs-Ereignisse.

UI Automation-Ereignis

Unterstützung

Hinweise

InvalidatedEvent

Variabel

Keine

Durch geänderte BoundingRectangleProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsOffscreenProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte IsEnabledProperty-Eigenschaft ausgelöstes Ereignis

Erforderlich

Keine

Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

Durch geänderte ValueProperty-Eigenschaft ausgelöstes Ereignis

Variabel

Keine

AutomationFocusChangedEvent

Erforderlich

Keine

StructureChangedEvent

Erforderlich

Keine

Siehe auch

Referenz

Spinner

Konzepte

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung