Dela via

Kontrolltyp för kombinationsruta

  • Artikel

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

En kombinationsruta är en listruta som kombineras med en statisk kontroll eller en redigeringskontroll som visar det markerade objektet i listrutan i kombinationsrutan. Listrutedelen av kontrollen visas hela tiden eller visas bara när användaren väljer listrutepilen (som är en push-knapp) bredvid kontrollen. Om markeringsfältet är en redigeringskontroll kan användaren ange information som inte finns i listan. Annars kan användaren bara välja objekt i listan.

I följande avsnitt definieras den nödvändiga UI Automation-trädstrukturen, egenskaperna, kontrollmönstren och händelserna för ComboBox kontrolltyp. Kraven för UI Automation gäller för alla kombinationsrutekontroller 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 kombinationsrutekontroller 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
  • Kombinationsruta
    • Redigera (0 eller 1)
    • Lista (0 eller 1)
    • Listobjekt (underordnad lista; 0 till många)
    • Knapp (1)
  • Kombinationsruta
    • Listobjekt (0 till många)

 

Redigeringskontrollen i kombinationsrutans kontrollvy är bara nödvändig om kombinationsrutan kan redigeras för att ta några indata, vilket är fallet med kombinationsrutan i dialogrutan Kör.

Relevanta egenskaper

I följande tabell visas UI Automation-egenskaper vars värde eller definition är särskilt relevant för ComboBox- 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 Kombinationsruta
UIA_HelpTextPropertyId Se anteckningar. Hjälptexten för kombinationsrutekontroller bör förklara varför användaren uppmanas att välja ett alternativ i kombinationsrutan. Texten liknar information som presenteras via en knappbeskrivning. Till exempel "Välj ett objekt för att ange bildskärmens bildskärmsupplösning".
UIA_IsContentElementPropertyId SANN Kombinationsrutekontroller ingår alltid i innehållsvyn i UI Automation-trädet.
UIA_IsControlElementPropertyId SANN Kombinationsrutekontroller ingår alltid i kontrollvyn för UI Automation-trädet.
UIA_IsKeyboardFocusablePropertyId SANN Kombinationsrutekontroller kan få tangentbordsfokus; Men när en UI Automation-klient fokuserar på en kombinationsruta kan alla objekt i kombinationsrutans underträd få fokus.
UIA_LabeledByPropertyId Se anteckningar. Kombinationsrutekontroller har vanligtvis en statisk textetikett som den här egenskapen refererar till.
UIA_LocalizedControlTypePropertyId Se anteckningar. Lokaliserad sträng som motsvarar ComboBox kontrolltyp. Standardvärdet är "kombinationsruta" för en-US eller engelska (USA).
UIA_NamePropertyId Se anteckningar. Namnet på kombinationsrutekontrollen genereras vanligtvis från en statisk textetikett. Om det inte finns en statisk textetikett måste du tilldela ett värde för egenskapen Name. Egenskapen Name får aldrig innehålla det aktuella innehållet i kombinationsrutan eller ändras när innehållet i kombinationsrutan ändras.

 

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

Kontrollmönster Stöd Anteckningar
IExpandCollapseProvider Krävs Kontrollmönstret ExpandCollapse måste stödjas eftersom en kombinationsrutekontroll alltid måste innehålla en nedrullningsbara knapp.
ISelectionProvider Beror Visar den aktuella markeringen i kombinationsrutan. Stöd för markering kontrollmönstret delegeras till listrutan under kombinationsrutan, men kanske inte alltid är möjligt.
IValueProvider Beror Om kombinationsrutan kan ta godtyckliga textvärden måste kontrollmönstret Value stödjas. Det här mönstret gör att stränginnehållet i kombinationsrutan kan anges programmatiskt. Om mönstret Värdekontroll inte stöds måste användaren välja från listobjekten i underträdet i kombinationsrutan.
IScrollProvider Aldrig Kontrollmönstret Bläddra stöds aldrig direkt i en kombinationsruta. Det stöds om en listruta som finns i en kombinationsruta kan rulla och endast när listrutan visas på skärmen.

 

Nödvändiga händelser

I följande tabell visas de UI Automation-händelser som kombinationsrutekontroller 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_ExpandCollapseExpandCollapseStatePropertyId händelse som ändrats av egenskapen.
UIA_ValueValuePropertyId händelse som ändrats av egenskapen. Om kontrollen stöder kontrollmönstret Value måste den ha stöd för den här händelsen.

 

konceptuell

översikt över UI Automation-kontrolltyper

översikt över UI Automation