Dela via

Typ av tumkontroll

  • Artikel

Det här avsnittet innehåller information om Microsoft UI Automation-stöd för kontrolltypen Tumme.

Tumkontroller ger funktioner som gör att en kontroll kan flyttas (eller dras), till exempel en rullningslistknapp eller ändra storlek, till exempel en fönsterändringswidget. Observera att en tumkontroll inte ger dra och släpp-funktioner. Tumkontroller kan få musfokus men inte tangentbordsfokus. Kontrollutvecklaren måste implementera kontrollen så att den fungerar korrekt (kan dras eller ändras).

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaper, kontrollmönster och händelser för Tumme kontrolltyp. Kraven för UI Automation tillämpar alla tumkontroller där UI-ramverket/plattformen integrerar UI Automation-stöd för kontrolltyper och kontrollmönster.

Det här avsnittet innehåller följande avsnitt.

Typisk trädstruktur

I följande tabell visas en typisk kontroll- och innehållsvy över UI Automation-trädet som avser tumkontroller och beskriver vad som kan finnas i varje vy. Mer information om UI Automation-trädet finns i UI Automation Tree Overview.

Kontrollvy Innehållsvy
  • Tumme
 (Ej tillämpligt)

 

Tumkontroller visas aldrig i innehållsvyn eftersom de bara finns för att manipuleras med en mus. De exponeras genom ett annat kontrollmönster, till exempel kontrollmönstret Bläddra, Transformera kontrollmönster eller RangeValue kontrollmönster, som stöds i tumkontrollens container.

Relevanta egenskaper

I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för tumkontroller. Mer information om egenskaper för UI Automation finns i Hämta egenskaper från UI Automation-element.

UI Automation-egenskap Värde Anteckningar
UIA_AutomationIdPropertyId Se anteckningar. Värdet för den här egenskapen måste vara unikt bland alla peer-element i den råa vyn för UI Automation-trädet.
UIA_BoundingRectanglePropertyId Se anteckningar. Den yttersta rektangeln som innehåller hela kontrollen.
UIA_ClickablePointPropertyId Se anteckningar. En punkt inom det synliga klientområdet för tumkontrollen.
UIA_ControlTypePropertyId Tumme
UIA_IsContentElementPropertyId FALSK Tumkontrollen ingår aldrig i innehållsvyn i UI Automation-trädet.
UIA_IsControlElementPropertyId SANN Tumkontrollen ingår alltid i kontrollvyn för UI Automation-trädet.
UIA_IsKeyboardFocusablePropertyId Se anteckningar. Om kontrollen kan få tangentbordsfokus måste den ha stöd för den här egenskapen. En tumkontroll kan ta emot fokus om det används som ett "gripobjekt" för att ändra storlek på ett fönster eller en ruta. En tumkontroll i ett skjutreglage eller rullningslist bör aldrig få fokus.
UIA_LabeledByPropertyId NOLL Tumkontroller har aldrig en etikett.
UIA_LocalizedControlTypePropertyId Se anteckningar. Lokaliserad sträng som motsvarar kontrolltypen Tumme. Standardvärdet är "tumme" för en-US eller engelska (USA).
UIA_NamePropertyId NOLL Eftersom tumkontrollen inte är tillgänglig i innehållsvyn i UI Automation-trädet kräver den inget namn.

 

Nödvändiga kontrollmönster

I följande tabell visas de UI Automation-kontrollmönster som krävs för att stödjas av tumkontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.

Kontrollmönster Stöd Anteckningar
ITransformProvider Krävs Gör att tumkontrollen kan flyttas på skärmen. Eftersom tumkontrollen vanligtvis inte kan ändras eller roteras stöder Transformera kontrollmönstret främst funktionen Flytta.

 

Nödvändiga händelser

I följande tabell visas de UI Automation-händelser som tumkontroller krävs för att stödja. Mer information om händelser finns i UI Automation Events Overview.

UI Automation-händelse Anteckningar
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId händelse som ändrats av egenskapen.
UIA_IsEnabledPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder egenskapen IsEnabled måste den stödja den här händelsen.
UIA_IsOffscreenPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder egenskapen IsOffscreen måste den ha stöd för den här händelsen.
UIA_StructureChangedEventId

 

konceptuell

översikt över UI Automation-kontrolltyper

översikt över UI Automation