Dela via


Typ av rubrikkontroll

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

Rubrikkontrollen innehåller en visuell container för etiketterna för rader eller kolumner med information.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för Rubrik kontrolltyp. Kraven för användargränssnittsautomatisering gäller för alla rubrikkontroller 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 gäller för rubrikkontroller 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
  • Rubrik
    • HeaderItem (1 eller mer)
(Ej tillämpligt)

 

Rubrikkontroller har alltid en eller flera underordnade objekt i kontrollvyn för UI Automation-trädet.

Rubrikkontroller har noll underordnade objekt i innehållsvyn för UI Automation-trädet.

Relevanta egenskaper

I följande tabell visas de UI Automation-egenskaper vars värde eller definition är särskilt relevant för rubrikkontroller. 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 för alla kontroller i ett program.
UIA_BoundingRectanglePropertyId Se anteckningar. Den yttersta rektangeln som innehåller hela kontrollen.
UIA_ClickablePointPropertyId Se anteckningar. Stöds om det finns en rektangel för avgränsning. Om inte varje punkt i avgränsningsrektangeln är klickbar och elementet utför specialiserad träfftestning åsidosätter och ger en klickbar punkt.
UIA_ControlTypePropertyId rubrik
UIA_IsContentElementPropertyId FALSK Rubrikkontrollen ingår inte i innehållsvyn i UI Automation-trädet.
UIA_IsControlElementPropertyId SANN Rubrikkontrollen 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.
UIA_LabeledByPropertyId NOLL Rubrikkontroller har ingen statisk etikett.
UIA_LocalizedControlTypePropertyId Se anteckningar. Standardvärdet är "header" för en-US eller engelska (USA).
UIA_NamePropertyId Se anteckningar. Rubrikkontrollen behöver ett namn om det finns fler än en radrubrik eller mer än en kolumnrubrik. Detta identifierar informationen i rubriken.
UIA_OrientationPropertyId OrientationType_Horizontal eller OrientationType_Vertical Värdet för den här egenskapen exponerar rubrikkontrollens position – oavsett om det är en radrubrik (OrientationType_Horizontal) eller kolumnrubrik (OrientationType_Vertical).

 

Nödvändiga kontrollmönster

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

Kontrollmönster Stöd Anteckningar
ITransformProvider Beror Implementera kontrollmönstret Transformera om rubrikkontrollen kan ändras.

 

Nödvändiga händelser

I följande tabell visas de UI Automation-händelser som rubrikkontroller 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