Delen via

UI Automation-ondersteuning voor het besturingselement ComboBox

Opmerking

Deze documentatie is bedoeld voor .NET Framework-ontwikkelaars die de beheerde UI Automation-klassen willen gebruiken die zijn gedefinieerd in de System.Windows.Automation naamruimte. Zie Windows Automation-API: UI Automationvoor de meest recente informatie over UI Automation.

Dit onderwerp bevat informatie over UI Automation-ondersteuning voor het besturingselement type ComboBox. In UI Automation is een besturingselementtype een set voorwaarden waaraan een besturingselement moet voldoen om de ControlTypeProperty eigenschap te kunnen gebruiken. De voorwaarden omvatten specifieke richtlijnen voor de structuur van de UI Automation-structuur, eigenschapswaarden van UI Automation, besturingspatronen en UI Automation-gebeurtenissen.

Een keuzelijst met invoervak is een keuzelijst in combinatie met een statisch besturingselement of een besturingselement voor bewerken waarmee het momenteel geselecteerde item wordt weergegeven in het keuzelijstgedeelte van de keuzelijst met invoervak. Het keuzelijstgedeelte van het besturingselement wordt altijd weergegeven of wordt alleen weergegeven wanneer de gebruiker de vervolgkeuzepijl (een drukknop) naast het besturingselement selecteert. Als het selectieveld een besturingselement voor bewerken is, kan de gebruiker gegevens invoeren die zich niet in de lijst bevinden; anders kan de gebruiker alleen items in de lijst selecteren.

In de volgende secties worden de vereiste structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type ComboBox-besturingselement gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle keuzelijstbesturingselementen, ongeacht of het Windows Presentation Foundation (WPF), Win32, of Windows Forms betreft.

Vereiste structuur voor UI-automatisering

In de volgende tabel ziet u de besturingsweergave en de inhoudsweergave van de UI Automation-structuur die betrekking heeft op combobox-besturingselementen, en beschrijft wat in elke weergave kan worden opgenomen. Zie OVERZICHT van ui-automatiseringsstructuurvoor meer informatie over de UI Automation-structuur.

Controleweergave Inhoudsweergave
Keuzelijst met invoervak

- Bewerken (0 of 1)
- Lijst (1)
- Lijstitem (sub-item van de lijst; van 0 t/m meerdere)
- Knop (1)		 Keuzelijst met invoervak

- Lijstitem (0 tot meerdere)

Het bewerkelement in de besturingselementweergave van de keuzelijst is alleen nodig als de keuzelijst kan worden bewerkt om invoer te accepteren, zoals het geval is bij de keuzelijst in het dialoogvenster Uitvoeren.

Vereiste eigenschappen van UI Automation

De volgende tabel vermeldt de UI Automation-eigenschappen waarvan de waarde of definitie bijzonder relevant is voor keuzelijstbesturingselementen. Voor meer informatie over UI Automation-eigenschappen, zie UI Automation-eigenschappen voor cliënten.

UI Automation-eigenschap Waarde Opmerkingen
AutomationIdProperty Zie notities. De waarde van deze eigenschap moet uniek zijn voor alle besturingselementen in een toepassing.
BoundingRectangleProperty Zie notities. De buitenste rechthoek die het hele besturingselement bevat.
ClickablePointProperty Zie notities. Ondersteund als er een begrenzingsrechthoek is. Als niet elk punt in de begrenzingsrechthoek kan worden geklikt en u gespecialiseerde hittests uitvoert, moet u dit overschrijven en een klikbaar punt bieden.
ControlTypeProperty Keuzelijst met invoervak Deze waarde is hetzelfde voor alle UI-frameworks.
HelpTextProperty Zie notities. In de Help-tekst voor besturingselementen voor keuzelijsten met invoervak moet worden uitgelegd waarom de gebruiker wordt gevraagd een optie te kiezen in de keuzelijst met invoervak. De tekst is vergelijkbaar met informatie die wordt weergegeven via knopinfo. Bijvoorbeeld 'Selecteer een item om de weergaveresolutie van uw monitor in te stellen'.
IsContentElementProperty Klopt Besturingselementen voor keuzelijsten met invoervak worden altijd opgenomen in de inhoudsweergave van de UI Automation-structuur.
IsControlElementProperty Klopt Besturingselementen voor keuzelijsten met invoervak worden altijd opgenomen in de besturingsweergave van de UI Automation-structuur.
IsKeyboardFocusableProperty Klopt Besturingselementen voor keuzelijsten met invoervak maken een set items uit een selectiecontainer beschikbaar. Het besturingselement keuzelijst met invoervak kan de focus op het toetsenbord krijgen, hoewel wanneer een UI Automation-client de focus instelt op een keuzelijst met invoervak, alle items in de substructuur van de keuzelijst met invoervak mogelijk de focus krijgen.
LabeledByProperty Zie notities. Besturingselementen voor keuzelijsten met invoervak hebben meestal een statisch tekstlabel waarnaar deze eigenschap verwijst.
LocalizedControlTypeProperty "keuzelijst met invoervak" Gelokaliseerde tekenreeks voor het controle Keuzelijstvak-type.
NameProperty Zie notities. Het keuzelijst met invoervak krijgt doorgaans zijn naam van een statische tekst.

Vereiste patronen voor ui-automatiseringsbeheer

De volgende tabel bevat de UI Automation-besturingspatronen die moeten worden ondersteund door alle besturingselementen voor keuzelijsten met invoervak. Zie Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen.

Besturingselementpatroon Ondersteuning Opmerkingen
IExpandCollapseProvider Ja Het besturingselement keuzelijst met invoervak moet altijd de knop voor de vervolgkeuzelijst bevatten om een keuzelijst met invoervak te zijn.
ISelectionProvider Ja Hiermee wordt de huidige selectie weergegeven in de keuzelijst met invoervak. Deze ondersteuning wordt gedelegeerd aan de keuzelijst onder het keuzelijst met invoervak.
IValueProvider Dat hangt ervan af. Als de keuzelijst willekeurige tekstwaarden accepteert, moet het waardepatroon ondersteund worden. Dit patroon biedt de mogelijkheid om programmatisch de tekenreeksinhoud van de keuzelijst in te stellen. Als het waarde patroon niet wordt ondersteund, geeft dit aan dat de gebruiker een selectie moet maken uit de lijstitems binnen de substructuur van het keuzelijstvak.
IScrollProvider Nooit Het scrollpatroon wordt nooit rechtstreeks ondersteund op een keuzelijst met invoervak. Ondersteuning is beschikbaar als een keuzelijst binnen een keuzelijst met invoervak kan scrollen. Dit wordt mogelijk alleen ondersteund wanneer de keuzelijst zichtbaar is op het scherm.

Vereiste gebeurtenissen

De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen voor keuzelijsten met invoervak. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.

Ui Automation-gebeurtenis Ondersteuning Opmerkingen
AutomationFocusChangedEvent Verplicht Geen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
StructureChangedEvent Verplicht Geen
ExpandCollapseStateProperty eigenschapswijziging-evenement. Verplicht Geen
ValueProperty eigenschapswijziging-evenement. Dat hangt ervan af. Als het besturingselement het waardepatroon ondersteunt, moet het deze gebeurtenis ondersteunen.

Zie ook

  • Last updated on