Typ des Daumensteuerelements
Dieses Thema enthält Informationen zur Unterstützung der Microsoft-Benutzeroberflächenautomatisierung für den Mini--Steuerelementtyp.
Daumensteuerelemente stellen die Funktionalität bereit, mit der ein Steuerelement verschoben (oder gezogen) werden kann, z. B. eine Bildlaufleistenschaltfläche oder eine Größenänderung, z. B. ein Fensteränderungs-Widget. Beachten Sie, dass ein Daumensteuerelement keine Drag-and-Drop-Funktionalität bereitstellt. Daumensteuerelemente können den Mausfokus, aber nicht den Tastaturfokus erhalten. Der Steuerelemententwickler muss das Steuerelement implementieren, damit es entsprechend fungiert (kann gezogen oder die Größe geändert werden).
In den folgenden Abschnitten werden die erforderliche Struktur der Benutzeroberflächenautomatisierungsstruktur, Eigenschaften, Steuerelementmuster und Ereignisse für den Thumb- Steuerelementtyp definiert. Die Anforderungen an die Benutzeroberflächenautomatisierung gelten für alle Daumensteuerelemente, bei denen das Benutzeroberflächenframework/die Plattform die Unterstützung der Benutzeroberflächenautomatisierung für Steuerelementtypen und Steuerelementmuster integriert.
Dieses Thema enthält die folgenden Abschnitte.
- typische Strukturstruktur
- Relevante Eigenschaften
- Erforderliche Steuerelementmuster
- Erforderliche Ereignisse
- Verwandte Themen
Typische Struktur
Die folgende Tabelle zeigt eine typische Steuerelement- und Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur, die sich auf Daumensteuerelemente bezieht, und beschreibt, was in jeder Ansicht enthalten sein kann. Weitere Informationen zur Benutzeroberflächenautomatisierungsstruktur finden Sie unter Ui Automation Tree Overview.
| Steuerelementansicht | Inhaltsansicht |
|---|---|
|
(Nicht zutreffend) |
Daumensteuerelemente werden in der Inhaltsansicht niemals angezeigt, da sie nur mit einer Maus bearbeitet werden können. Sie werden zwar durch ein anderes Steuerelementmuster verfügbar gemacht, z. B. das Scroll- Steuerelementmuster, Transformieren Steuerelementmusters oder RangeValue- Steuerelementmusters, das im Container des Daumensteuerelements unterstützt wird.
Relevante Eigenschaften
In der folgenden Tabelle sind die Eigenschaften der Benutzeroberflächenautomatisierung aufgeführt, deren Wert oder Definition besonders für Daumensteuerelemente relevant ist. Weitere Informationen zu Eigenschaften der Benutzeroberflächenautomatisierung finden Sie unter Abrufen von Eigenschaften aus benutzeroberflächenautomatisierungs-Elementen.
| Benutzeroberflächenautomatisierungs-Eigenschaft | Wert | Notizen |
|---|---|---|
| UIA_AutomationIdPropertyId | Siehe Hinweise. | Der Wert dieser Eigenschaft muss zwischen allen Peerelementen in der unformatierten Ansicht der Benutzeroberflächenautomatisierungs-Struktur eindeutig sein. |
| UIA_BoundingRectanglePropertyId | Siehe Hinweise. | Das äußerste Rechteck, das das gesamte Steuerelement enthält. |
| UIA_ClickablePointPropertyId | Siehe Hinweise. | Ein Punkt innerhalb des sichtbaren Clientbereichs des Daumensteuerelements. |
| UIA_ControlTypePropertyId | Daumen- | |
| UIA_IsContentElementPropertyId | FALSCH | Das Daumensteuerelement ist niemals in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsControlElementPropertyId | STIMMT | Das Daumensteuerelement ist immer in der Steuerelementansicht der Benutzeroberflächenautomatisierungs-Struktur enthalten. |
| UIA_IsKeyboardFocusablePropertyId | Siehe Hinweise. | Wenn das Steuerelement den Tastaturfokus erhalten kann, muss es diese Eigenschaft unterstützen. Ein Daumensteuerelement kann den Fokus erhalten, wenn es als "Ziehelement"-Objekt zum Anpassen eines Fensters oder eines Bereichs verwendet wird. Ein Ziehpunkt-Steuerelement in einem Schieberegler oder einer Bildlaufleiste sollte niemals den Fokus erhalten. |
| UIA_LabeledByPropertyId | NULL | Daumensteuerelemente haben nie eine Beschriftung. |
| UIA_LocalizedControlTypePropertyId | Siehe Hinweise. | Lokalisierte Zeichenfolge, die dem steuerelementtyp Thumb entspricht. Der Standardwert ist "thumb" für en-US oder Englisch (USA). |
| UIA_NamePropertyId | NULL | Da das Daumensteuerelement in der Inhaltsansicht der Benutzeroberflächenautomatisierungs-Struktur nicht verfügbar ist, ist kein Name erforderlich. |
Erforderliche Steuerelementmuster
In der folgenden Tabelle sind die Steuerelementmuster für die Benutzeroberflächenautomatisierung aufgeführt, die von Daumensteuerelementen unterstützt werden müssen. Weitere Informationen zu Steuerelementmustern finden Sie unter Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung.
| Steuerelementmuster | Unterstützen | Notizen |
|---|---|---|
| ITransformProvider- | Erforderlich | Ermöglicht das Verschieben des Daumensteuerelements auf dem Bildschirm. Da die Größe des Ziehpunktsteuerelements in der Regel nicht geändert oder gedreht werden kann, unterstützt das Transform Steuerelementmuster in erster Linie die funktion Verschieben. |
Erforderliche Ereignisse
In der folgenden Tabelle sind die Benutzeroberflächenautomatisierungs-Ereignisse aufgeführt, für die Ministeuerelemente unterstützt werden müssen. Weitere Informationen zu Ereignissen finden Sie unter Ui Automation Events Overview.
| Benutzeroberflächenautomatisierungs-Ereignis | Notizen |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId Eigenschaftsänderungsereignis. | |
| UIA_IsEnabledPropertyId Eigenschaftsänderungsereignis. | Wenn das Steuerelement die IsEnabled--Eigenschaft unterstützt, muss dieses Ereignis unterstützt werden. |
| UIA_IsOffscreenPropertyId Ereignis mit Eigenschaftsänderung. | Wenn das Steuerelement die IsOffscreen--Eigenschaft unterstützt, muss es dieses Ereignis unterstützen. |
| UIA_StructureChangedEventId |
Verwandte Themen
-
Konzeptionelle
-
Übersicht über Steuerelementtypen für die Benutzeroberflächenautomatisierung