Benutzeroberflächenautomatisierungs-Unterstützung für den Spinner-SteuerelementtypUI Automation Support for the Spinner Control Type

Hinweis

Diese Dokumentation ist für .NET Framework-Entwickler vorgesehen, die die verwalteten BenutzeroberflächenautomatisierungUI Automation-Klassen verwenden möchten, die im System.Windows.Automation-Namespace definiert sind.This documentation is intended for .NET Framework developers who want to use the managed BenutzeroberflächenautomatisierungUI Automation classes defined in the System.Windows.Automation namespace. Aktuelle Informationen zur BenutzeroberflächenautomatisierungUI Automationfinden Sie auf der Seite zur Windows-Automatisierungs-API: UI-Automatisierung.For the latest information about BenutzeroberflächenautomatisierungUI Automation, see Windows Automation API: UI Automation.

Dieses Thema enthält Informationen zur BenutzeroberflächenautomatisierungUI Automation -Unterstützung für den Steuerelementtyp „Spinner“.This topic provides information about BenutzeroberflächenautomatisierungUI Automation support for the Spinner control type. In BenutzeroberflächenautomatisierungUI Automationumfasst ein Steuerelementtyp eine Reihe von Bedingungen, die ein Steuerelement erfüllen muss, damit die ControlTypeProperty -Eigenschaft verwendet werden kann.In BenutzeroberflächenautomatisierungUI Automation, a control type is a set of conditions that a control must meet in order to use the ControlTypeProperty property. Die Bedingungen schließen bestimmte Richtlinien für BenutzeroberflächenautomatisierungUI Automation -Struktur, BenutzeroberflächenautomatisierungUI Automation -Eigenschaftswerte und Steuerelementmuster ein.The conditions include specific guidelines for BenutzeroberflächenautomatisierungUI Automation tree structure, BenutzeroberflächenautomatisierungUI Automation property values and control patterns.

Spinner-Steuerelemente werden dazu verwendet, um aus einem Bereich von Elementen oder Zahlen auszuwählen.Spinner controls are used to select from a domain of items or a range of numbers.

In den folgenden Abschnitten werden die BenutzeroberflächenautomatisierungUI Automation -Struktur, -Eigenschaften, -Steuerelementmuster und -Ereignisse definiert, die für den Steuerelementtyp „Spinner“ erforderlich sind.The following sections define the required BenutzeroberflächenautomatisierungUI Automation tree structure, properties, control patterns, and events for the Spinner control type. Die BenutzeroberflächenautomatisierungUI Automation Anforderungen gelten für alle Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF)Spinnersteuerelemente, ob , Win32 oder Windows Forms.The BenutzeroberflächenautomatisierungUI Automation requirements apply to all spinner controls, whether Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), Win32, or Windows Forms.

Erforderliche Benutzeroberflächenautomatisierungs-StrukturRequired UI Automation Tree Structure

In der folgende Tabelle wird die Steuerelementansicht und Inhaltsansicht der BenutzeroberflächenautomatisierungUI Automation -Struktur dargestellt, die für Spinner-Steuerelemente gelten, wenn sie die „Range Value“-, „Value“- und „Selection“-Steuerelementmuster unterstützen und beschreiben, was in der jeweiligen Ansicht enthalten sein kann.The following table depicts the control view and the content view of the BenutzeroberflächenautomatisierungUI Automation tree that pertain to spinner controls when they support the Range Value, Value, and Selection control patterns and describes what can be contained in each view. Weitere Informationen zur BenutzeroberflächenautomatisierungUI Automation -Struktur finden Sie unter UI Automation Tree Overview.For more information on the BenutzeroberflächenautomatisierungUI Automation tree, see UI Automation Tree Overview.

„Range Value“- oder „Value“-SteuerelementmusterRange Value or Value control pattern

SteuerelementansichtControl View InhaltsansichtContent View
SpinnerSpinner

- Bearbeiten (0 oder 1)- Edit (0 or 1)
- Taste (2)- Button (2)
SpinnerSpinner

Selection-SteuerelementmusterSelection control pattern

SteuerelementansichtControl View InhaltsansichtContent View
SpinnerSpinner

- Bearbeiten (0 oder 1)- Edit (0 or 1)
- Taste (2)- Button (2)
- Listenelement (0 oder mehr)- List Item (0 or more)
SpinnerSpinner

- ListItem (0 oder mehr)- ListItem (0 or more)

Um sicherzustellen, dass die beiden Schaltflächen in der Teilstruktur der Steuerelementansicht von automatisierten Testtools unterschieden werden können, weisen Sie entsprechend SmallIncrement oder SmallDecrement AutomationId zu.To ensure that the two buttons in the control view subtree can be distinguished by automated test tools, assign the SmallIncrement or SmallDecrement AutomationId as appropriate. Bei einigen Implementierungen ist das zugeordnete Edit-Steuerelement möglicherweise ein Peer des Spinner-Steuerelements.For some implementations, the associated Edit control may be a peer of the Spinner control.

Erforderliche Benutzeroberflächenautomatisierungs-EigenschaftenRequired UI Automation Properties

In der folgenden Tabelle werden die BenutzeroberflächenautomatisierungUI Automation -Eigenschaften aufgelistet, deren Wert oder Definition für Spinner-Steuerelemente besonders relevant ist.The following table lists the BenutzeroberflächenautomatisierungUI Automation properties whose value or definition is especially relevant to spinner controls. Weitere Informationen BenutzeroberflächenautomatisierungUI Automation zu Eigenschaften finden Sie unter UI Automation Properties for Clients.For more information on BenutzeroberflächenautomatisierungUI Automation properties, see UI Automation Properties for Clients.

BenutzeroberflächenautomatisierungUI Automation -EigenschaftProperty valueValue NotizenNotes
AutomationIdProperty Siehe Hinweise.See notes. Der Wert dieser Eigenschaft muss für alle Steuerelemente in einer Anwendung eindeutig sein.The value of this property needs to be unique across all controls in an application.
BoundingRectangleProperty Siehe Hinweise.See notes. Das äußere Rechteck, das das gesamte Steuerelement enthält.The outermost rectangle that contains the whole control.
ClickablePointProperty Siehe Hinweise.See notes. Der durch Klicken aktivierbare Punkt des Spinner-Steuerelements übergibt den Fokus an den Bearbeitungsbereich des Steuerelements.The spinner control's clickable point gives focus to the edit portion of the control.
IsKeyboardFocusableProperty Siehe Hinweise.See notes. Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen.If the control can receive keyboard focus, it must support this property.
NameProperty Siehe Hinweise.See notes. Das Spinner-Steuerelement ruft seinen Namen in der Regel aus einer statischen Textbezeichnung ab.The spinner control typically gets its name from a static text label.
LabeledByProperty Siehe Hinweise.See notes. Spinner-Steuerelemente verfügen über eine statische Textbezeichnung.Spinner controls have a static text label.
ControlTypeProperty SpinnerSpinner Dieser Wert ist für alle Benutzeroberflächen-Frameworks gleich.This value is the same for all UI frameworks.
LocalizedControlTypeProperty „Drehfeld“"spinner" Lokalisierte Zeichenfolge für den Steuerelementtyp „Spinner“.Localized string corresponding to the Spinner control type.
IsContentElementProperty TrueTrue Das Spinner-Steuerelement muss immer ein Inhaltselement sein.The spinner control must always be content.
IsControlElementProperty TrueTrue Das Spinner-Steuerelement muss immer ein Steuerelement sein.The Spinner control must always be a control.

Erforderliche Benutzeroberflächenautomatisierungs-Steuerelementmuster und -EigenschaftenRequired UI Automation Control Patterns and Properties

In der folgenden Tabelle werden die BenutzeroberflächenautomatisierungUI Automation -Steuerelementmuster aufgelistet, die von allen Spinner-Steuerelementen unterstützt werden müssen.The following table lists the BenutzeroberflächenautomatisierungUI Automation control patterns required to be supported by spinner controls. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.For more information about control patterns, see UI Automation Control Patterns Overview.

Steuerelementmuster/MustereigenschaftControl Pattern/Pattern Property Unterstützung/WertSupport/Value NotizenNotes
ISelectionProvider Depends (Abhängig)Depends Spinner-Steuerelemente mit einer zur Auswahl stehenden Liste von Elementen müssen dieses Muster unterstützen.Spinner controls that have a list of items to be selected must support this pattern.
CanSelectMultiple FalseFalse Spinner-Steuerelemente sind immer Einfachauswahlcontainer.Spinner controls are always single selection containers.
IRangeValueProvider Depends (Abhängig)Depends Spinner-Steuerelemente, die einen numerischen Bereich umfassen, können dieses Muster unterstützen.Spinner controls that span a numeric range can support this pattern.
IValueProvider Depends (Abhängig)Depends Spinner-Steuerelemente, die einen einzelnen Satz von Optionen oder Zahlen umfassen, können dieses Muster unterstützen.Spinner controls that span a discrete set of options or numbers can support this pattern.

Erforderliche Benutzeroberflächenautomatisierungs-EreignisseRequired UI Automation Events

Die folgende Tabelle enthält die BenutzeroberflächenautomatisierungUI Automation -Ereignisse, die von allen Spinner-Steuerelementen unterstützt werden müssen.The following table lists the BenutzeroberflächenautomatisierungUI Automation events required to be supported by all spinner controls. Weitere Informationen zu Ereignissen finden Sie unter UI Automation Events Overview.For more information on events, see UI Automation Events Overview.

BenutzeroberflächenautomatisierungUI Automation -EreignisEvent SupportSupport NotizenNotes
InvalidatedEvent Depends (Abhängig)Depends KeineNone
Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis.BoundingRectangleProperty property-changed event. ErforderlichRequired KeineNone
Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis.IsOffscreenProperty property-changed event. ErforderlichRequired KeineNone
Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis.IsEnabledProperty property-changed event. ErforderlichRequired KeineNone
Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis.ValueProperty property-changed event. Depends (Abhängig)Depends KeineNone
Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis.ValueProperty property-changed event. Depends (Abhängig)Depends KeineNone
AutomationFocusChangedEvent ErforderlichRequired KeineNone
StructureChangedEvent ErforderlichRequired KeineNone

Weitere InformationenSee also