Thumb-Steuerelementtyp

  • Artikel

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

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
  • Ziehpunkt
 (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

 

Konzept

Übersicht über Steuerelementtypen für Benutzeroberflächenautomatisierung

Übersicht über die Benutzeroberflächenautomatisierung