Dela via

Kontrolltyp för rullningslist

  • Artikel

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

Rullningslistkontroller gör det möjligt för en användare att rulla innehåll i ett fönster eller en objektcontainer. Kontrollen består av en uppsättning knappar och en tumkontroll.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaper, kontrollmönster och händelser för rullningslist kontrolltyp. Kraven för UI Automation gäller för alla rullningslistkontroller 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 rullningslistkontroller 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
  • Rullningslist
    • Knapp (0, 2 eller 4)
    • Tumme (0 eller 1)
 Inte tillämpligt. (Kontrollen för rullningslisten har inget innehåll.)

 

Rullningslistkontrollen kan ha noll till fem underordnade objekt. Eftersom underträdet har mer än en knappkontroll måste elementet ange ett specifikt UIA_AutomationIdPropertyId värde för varje objekt för att de ska kunna identifieras för automatiserade testverktyg.

Relevanta egenskaper

I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för rullningslistkontroller. Observera att en rullningslistkontroll aldrig har innehåll. dess funktioner exponeras via kontrollmönstret Scroll, som stöds på containern som rullas.

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 Nan Rullningslistkontrollen har inte klickbara punkter.
UIA_ControlTypePropertyId Rullningslist Det här värdet är detsamma för alla ramverk. Rullningslister som fungerar som skjutreglage måste använda skjutreglaget kontrolltyp.
UIA_IsContentElementPropertyId FALSK Rullningslistkontrollen är aldrig ett innehållselement. Om rullningslisten är en fristående kontroll måste den uppfylla kontrolltypen Slider och returnera UIA_SliderControlTypeId för egenskapen IUIAutomationElement::CurrentControlType (eller CachedControlType).
UIA_IsControlElementPropertyId SANN Rullningslistkontrollen 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 rullningslistkontroll tar sällan fokus, men när den gör det bör fokus ligga kvar på själva rullningslistkontrollen, inte på de underordnade knapparna eller tummen. Användaren bör kunna utföra alla rullningsåtgärder med hjälp av tangenterna UPPÅTPIL OCH NEDÅTPIL (eller HÖGERPIL och VÄNSTERPIL) eller TANGENTERNA PAGE UP och PAGE DOWN.
UIA_LabeledByPropertyId NOLL Rullningslister har inga etiketter.
UIA_LocalizedControlTypePropertyId Se anteckningar. Lokaliserad sträng som motsvarar rullningslist kontrolltyp. Standardvärdet är "rullningslist" för en-US eller engelska (USA).
UIA_NamePropertyId NOLL Kontrollen för rullningslisten har inga innehållselement och egenskapen UIA_NamePropertyId behöver inte anges.
UIA_OrientationPropertyId Se anteckningar. Rullningslistkontrollen måste alltid exponera dess vågräta eller lodräta orientering.

 

Nödvändiga kontrollmönster

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

Not

När en rullningslist endast används som kontroll för musmanipulering stöder den inte kontrollmönster. Om den används som skjutreglage i ett program måste den ges skjutreglaget kontrolltyp.

 

Kontrollmönster Stöd Anteckningar
IRangeValueProvider Beror Kontrollmönstret RangeValue måste endast stödjas om kontrollmönstret Scroll inte stöds i containern som har rullningslisten.
IScrollProvider Aldrig Kontrollmönstret Scroll stöds aldrig direkt i rullningslisten.

 

Nödvändiga händelser

I följande tabell visas de UI Automation-händelser som rullningslistkontroller 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
UIA_RangeValueValuePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder RangeValue- kontrollmönster måste den stödja den här händelsen.

 

konceptuell

översikt över UI Automation-kontrolltyper

översikt över UI Automation