Thumb-Steuerelementtyp
Dieses Thema enthält Informationen zur Unterstützung des Thumb-Steuerelementtyps von Microsoft Benutzeroberflächenautomatisierung.
Thumb-Steuerelemente bieten die Funktionen, mit denen ein Steuerelement bewegt (oder gezogen) werden kann, wie ein Schieberegler für Bildlaufleisten, oder in der Größe angepasst werden kann, wie ein Widget für die Größenanpassung von Fenstern. Beachten Sie, dass ein Daumensteuerelement keine Drag-and-Drop-Funktionalität bietet. Daumensteuerelemente können den Mausfokus, aber nicht den Tastaturfokus erhalten. Der Entwickler von Steuerelementen muss das Steuerelement implementieren, damit es entsprechend funktioniert (d. h. es kann gezogen bzw. in der Größe angepasst werden).
In den folgenden Abschnitten werden die erforderlichen Benutzeroberflächenautomatisierung Struktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Thumb-Steuerelementtyp definiert. Die Benutzeroberflächenautomatisierung Anforderungen gelten für alle Daumensteuerelemente, bei denen das Ui-Framework/die Plattform Benutzeroberflächenautomatisierung Unterstützung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält folgende Abschnitte:
- Typische Struktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Zugehörige Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierung Struktur, die sich auf Daumensteuerelemente bezieht, und beschreibt, was in den einzelnen Ansichten enthalten sein kann. Weitere Informationen zur Struktur der Benutzeroberflächenautomatisierung finden Sie unter Übersicht über die Struktur der Benutzeroberflächenautomatisierung.
Steuerelementansicht | Inhaltsansicht |
---|---|
|
(Nicht vorhanden) |
Daumensteuerelemente werden nie in der Inhaltsansicht angezeigt, da sie nur für die Bearbeitung mit der Maus vorhanden sind. Sie werden über ein anderes Steuerelementmuster verfügbar gemacht, z. B . das Scroll-Steuerelementmuster , das Steuerelementmuster transformieren oder das RangeValue-Steuerelementmuster , das im Container des Daumensteuerelements unterstützt wird.
Relevante Eigenschaften
Die folgende Tabelle enthält die Benutzeroberflächenautomatisierungs-Eigenschaften, deren Werte oder Definitionen für Thumb-Steuerelemente besonders relevant sind. Weitere Informationen zu Benutzeroberflächenautomatisierung Eigenschaften finden Sie unter Abrufen von Eigenschaften aus Benutzeroberflächenautomatisierung Elementen.
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. | Ein Punkt innerhalb des sichtbaren Clientbereichs des Daumensteuerelements. |
UIA_ControlTypePropertyId | Ziehpunkt | |
UIA_IsContentElementPropertyId | FALSE | Das Daumensteuerelement ist nie in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
UIA_IsControlElementPropertyId | TRUE | Das Daumensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierung-Struktur enthalten. |
UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. Ein Daumensteuerelement kann den Fokus empfangen, wenn es als "Greifer"-Objekt für die Größenanpassung eines Fensters oder Bereichs verwendet wird. Ein Daumensteuerelement in einem Schieberegler oder einer Bildlaufleiste sollte nie den Fokus erhalten. |
UIA_LabeledByPropertyId | NULL | Thumb-Steuerelemente haben niemals eine Bezeichnung. |
UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem Thumb-Steuerelementtyp entspricht. Der Standardwert ist "thumb" für en-US oder English (USA). |
UIA_NamePropertyId | NULL | Da das Thumb-Steuerelement in der Inhaltsansicht der Benutzeroberflächenautomatisierung-Struktur nicht verfügbar ist, ist kein Name erforderlich. |
Erforderliche Steuerelementmuster
In der folgenden Tabellen sind die Steuerelementmuster der Benutzeroberflächenautomatisierung aufgeführt, die von Thumb-Steuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter UI Automation Control Patterns Overview.
Steuerelementmuster | Support | Hinweise |
---|---|---|
ITransformProvider | Erforderlich | Ermöglicht, dass das Ziehpunkt-Steuerelement auf dem Bildschirm bewegt werden kann. Da die Größe des Daumensteuerelements in der Regel nicht geändert oder gedreht werden kann, unterstützt das Transformieren-Steuerelementmuster in erster Linie die Move-Funktion . |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierung Ereignisse aufgeführt, die von Daumensteuerelementen unterstützt werden 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_StructureChangedEventId |
Zugehörige Themen