Ondersteuning voor UI Automation voor het type SplitButton-besturingselement
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 type SplitButton-besturingselement. 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, waarden voor UI Automation-eigenschappen en besturingspatronen.
Met het besturingselement splitsknop kunt u een actie uitvoeren op een besturingselement en het besturingselement uitvouwen om een lijst weer te geven met andere mogelijke acties die kunnen worden uitgevoerd.
In de volgende secties wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen gedefinieerd voor het type SplitButton-besturingselement. De vereisten voor UI Automation zijn van toepassing op alle besturingselementen voor gesplitste knoppen, 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 voor gesplitste knoppen 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 |
|---|---|
SplitButton
|
SplitButton - MenuItem (1 tot veel) |
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 splitsknoppen. 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. |
| IsKeyboardFocusableProperty | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
| NameProperty | 'Terug' | De naam van het besturingselement splitsknop wordt weergegeven op de knop. |
| LabeledByProperty | Null | Besturingselementen voor gesplitste knoppen hebben geen statisch tekstlabel. |
| ControlTypeProperty | SplitButton | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "split button" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementType SplitButton. |
| HelpTextProperty | Zie notities. | De Help-tekst kan het resultaat aangeven van het activeren van de splitsknop. Dit is meestal hetzelfde type informatie dat wordt weergegeven via knopinfo. |
| IsContentElementProperty | Waar | Het besturingselement splitsknop bevat informatie voor de eindgebruiker. |
| IsControlElementProperty | Waar | Het besturingselement splitsknop is zichtbaar voor de eindgebruiker. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door besturingselementen voor gesplitste knoppen. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IInvokeProvider | Vereist | Split-knoppen hebben altijd een standaardactie die is gekoppeld aan Aanroepen. |
| IExpandCollapseProvider | Vereist | Split-knoppen hebben altijd de mogelijkheid om een lijst met opties uit te vouwen. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen voor gesplitste knoppen. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| InvokedEvent | Vereist | Geen |
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| ExpandCollapseStateProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | Geen |
Voorbeeld van SplitButton-besturingselement
In de volgende afbeelding ziet u een SplitButton-besturingselementtype in een gegevensraster.
Hieronder ziet u de Besturingsweergave en de inhoudsweergave van de UI Automation-structuur die betrekking heeft op het gegevensraster en besturingselementen voor gesplitste knoppen. De besturingspatronen voor elk automatiseringselement worden tussen haakjes weergegeven.
| Ui Automation-structuur - Besturingsweergave | Ui Automation-structuur - Inhoudsweergave |
|---|---|
|
|