UI Automation-ondersteuning voor het besturingselement type keuzelijst met invoervak
Notitie
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 Automation voor de meest recente informatie over UI Automation.
Dit onderwerp bevat informatie over ui Automation-ondersteuning voor het besturingselement type Keuzelijst met invoervak. 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 besturingselementen voor keuzelijsten met invoervak, ongeacht of Windows Presentation Foundation (WPF), Win32 of Windows Forms.
Vereiste structuur van ui-automatiseringsstructuur
In de volgende tabel ziet u de besturingsweergave en de inhoudsweergave van de UI Automation-structuur die betrekking heeft op besturingselementen met invoervak en wordt beschreven wat in elke weergave kan worden opgenomen. Zie Overzicht van ui-automatiseringsstructuur voor meer informatie over de UI Automation-structuur.
| Besturingselementweergave | Inhoudsweergave |
|---|---|
| ComboBox - Bewerken (0 of 1) - Lijst (1) - Lijstitem (onderliggend item van lijst; 0 tot veel) - Knop (1) |
ComboBox - Lijstitem (0 tot veel) |
Het besturingselement bewerken in de besturingselementweergave van de keuzelijst met invoervak is alleen nodig als de keuzelijst met invoer kan worden bewerkt om invoer te maken, zoals het geval is bij de keuzelijst met invoervak in het dialoogvenster Uitvoeren.
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor besturingselementen voor keuzelijsten met invoervak. Zie Eigenschappen van UI Automation voor clients voor meer informatie over eigenschappen van UI Automation.
| Ui Automation-eigenschap | Weergegeven als | 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, overschrijft en geeft u een klikbaar punt op. |
| ControlTypeProperty | ComboBox | 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 | Waar | Besturingselementen voor keuzelijsten met invoervak worden altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Waar | Besturingselementen voor keuzelijsten met invoervak worden altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
| IsKeyboardFocusableProperty | Waar | 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 die overeenkomt met het besturingselementtype Keuzelijst met invoervak. |
| NameProperty | Zie notities. | Het besturingselement keuzelijst met invoervak krijgt doorgaans de naam van een statisch tekst besturingselement. |
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 Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IExpandCollapseProvider | Ja | Het besturingselement keuzelijst met invoervak moet altijd 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 de keuzelijst met invoervak. |
| IValueProvider | Hangt | Als de keuzelijst met invoervak willekeurige tekstwaarden kan gebruiken, moet het waardepatroon worden ondersteund. Dit patroon biedt de mogelijkheid om programmatisch de inhoud van de tekenreeks van de keuzelijst met invoervak in te stellen. Als het waardepatroon niet wordt ondersteund, geeft dit aan dat de gebruiker een selectie moet maken uit de lijstitems in de substructuur van de keuzelijst met invoervak. |
| IScrollProvider | Nooit | Het scrollpatroon wordt nooit rechtstreeks ondersteund op een keuzelijst met invoervak. Dit wordt ondersteund als een keuzelijst in een keuzelijst met invoervak kan schuiven. 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-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| AutomationFocusChangedEvent | Vereist | Geen |
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| StructureChangedEvent | Vereist | Geen |
| ExpandCollapseStateProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| ValueProperty eigenschap gewijzigd gebeurtenis. | Hangt | Als het besturingselement het waardepatroon ondersteunt, moet het deze gebeurtenis ondersteunen. |