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. Die neuesten Informationen zu BenutzeroberflächenautomatisierungUI Automationfinden Sie unter Windows Automation-API: Automatisierungder Benutzeroberfläche.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 Spinner-Steuerelemente in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), Win32Win32oder Windows FormsWindows Forms.The BenutzeroberflächenautomatisierungUI Automation requirements apply to all spinner controls, whether Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), Win32Win32, or Windows FormsWindows 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

-Edit (0 oder 1)- Edit (0 or 1)
-Schaltfläche (2)- Button (2)
SpinnerSpinner

Selection-SteuerelementmusterSelection control pattern

SteuerelementansichtControl View InhaltsansichtContent View
SpinnerSpinner

-Edit (0 oder 1)- Edit (0 or 1)
-Schaltfläche (2)- Button (2)
-List item (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 Steuerelement Ansicht von automatisierten Testtools unter SmallIncrement schieden SmallDecrement werden können, weisen Sie oder AutomationId nach Bedarf 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 zu BenutzeroberflächenautomatisierungUI Automation 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 WertValue HinweiseNotes
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ächenframeworks 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 HinweiseNotes
ISelectionProvider VariabelDepends 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 VariabelDepends 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 VariabelDepends 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 UI Automation Events Overview-Ereignissen finden Sie unterFor more information on events, see UI Automation Events Overview.

BenutzeroberflächenautomatisierungUI Automation -EreignisEvent UnterstützungSupport HinweiseNotes
InvalidatedEvent VariabelDepends NoneNone
Durch geänderteBoundingRectangleProperty -Eigenschaft ausgelöstes Ereignis.BoundingRectangleProperty property-changed event. RequiredRequired NoneNone
Durch geänderteIsOffscreenProperty -Eigenschaft ausgelöstes Ereignis.IsOffscreenProperty property-changed event. ErforderlichRequired NoneNone
Durch geänderteIsEnabledProperty -Eigenschaft ausgelöstes Ereignis.IsEnabledProperty property-changed event. RequiredRequired NoneNone
Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis.ValueProperty property-changed event. VariabelDepends NoneNone
Durch geänderteValueProperty -Eigenschaft ausgelöstes Ereignis.ValueProperty property-changed event. VariabelDepends NoneNone
AutomationFocusChangedEvent ErforderlichRequired NoneNone
StructureChangedEvent ErforderlichRequired NoneNone

Siehe auchSee also