Dela via

Kalenderkontrolltyp

  • Artikel

Det här avsnittet innehåller information om Microsoft UI Automation-stöd för kontrolltypen Calendar. Med en kalenderkontroll kan användaren enkelt fastställa datumet och välja andra datum.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för Kalender kontrolltyp. Kraven för användargränssnittsautomatisering gäller för alla kalenderkontroller 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 kalenderkontroller 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
  • Kalender
    • DataGrid
      • Rubrik (0 eller 1)
        • HeaderItem (0 eller 7, kvantitet beror på hur många dagar som visas i kolumner)
      • ListItem (kvantitet beror på hur många dagar som visas)
      • Knapp (0 eller 2; för växling av kalendervy)
  • Kalender
    • ListItem (kvantitet beror på hur många dagar som visas)

 

Kalenderkontroller kan representeras i många olika former i användargränssnittet. De enda kontroller som garanterat finns i kontrollvyn i UI Automation-trädet är kontrollerna för datarutnät, sidhuvud, rubrikobjekt och listobjekt.

Relevanta egenskaper

I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för Kalender kontrolltyp. 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. 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 kalender Det här värdet är detsamma för alla gränssnittsramverk.
UIA_IsContentElementPropertyId SANN Kalenderkontrollen ingår alltid i innehållsvyn i UI Automation-trädet.
UIA_IsControlElementPropertyId SANN Kalenderkontrollen 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 Se anteckningar. Värdet för den här egenskapen ska vara dokumentkontrollens etikett. Vanligtvis används dokumentets rubrik.
UIA_LocalizedControlTypePropertyId Se anteckningar. Lokaliserad sträng som motsvarar kalender kontrolltyp. Standardvärdet är "kalender" för en-US eller engelska (USA).
UIA_NamePropertyId Se anteckningar. Kalenderkontrollen hämtar vanligtvis sitt namn från det aktuella datumet.

 

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 kalenderkontroller. Mer information om kontrollmönster finns i UI Automation Control Patterns Overview.

Kontrollmönster/mönsteregenskap Support/värde Anteckningar
IGridProvider Krävs Kalenderkontrollen stöder alltid Grid kontrollmönster eftersom dagarna inom en månad är objekt som kan navigeras rumsligt.
IScrollProvider Beror De flesta kalenderkontroller har stöd för att vända vyn efter sida. Kontrollmönstret Bläddra rekommenderas för att stödja växlingsnavigering.
ISelectionProvider Beror De flesta kalenderkontroller behåller en viss dag, månad eller år som ett val av underelementet. Vissa kalendrar kan väljas flera och andra kan bara väljas. Kalenderkontroll med valbara underelement bör ha stöd för markering kontrollmönstret.
ITableProvider Krävs Eftersom kalenderkontrollen alltid har en rubrik i underträdet för veckodagarna måste kontrollmönstret Table stödjas.
IValueProvider Nej Kontrollmönstret value är inte nödvändigt för kalenderkontroller eftersom elementet inte kan ange värdet direkt på kontrollen. Om ett visst datum är associerat med kontrollen ska informationen anges av markering kontrollmönstret.

 

Nödvändiga händelser

I följande tabell visas de UI Automation-händelser som kalenderkontroller 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_LayoutInvalidatedEventId
UIA_MultipleViewCurrentViewPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder egenskapen CurrentView för kontrollmönstret MultipleView måste den ha stöd för den här händelsen.
UIA_StructureChangedEventId
UIA_ScrollHorizontallyScrollablePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_ScrollHorizontalScrollPercentPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_ScrollHorizontalViewSizePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_ScrollVerticalScrollPercentPropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_ScrollVerticallyScrollablePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_ScrollVerticalViewSizePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Bläddra måste den ha stöd för den här händelsen.
UIA_Selection_InvalidatedEventId

 

konceptuell

översikt över UI Automation-kontrolltyper

översikt över UI Automation