Delen via


Ondersteuning voor UI Automation voor het type SplitButton-besturingselement

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 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 voor UI-automatisering

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-automatiseringsstructuurvoor meer informatie over de UI Automation-structuur.

Controleweergave Inhoudsweergave
SplitButton

  • Afbeelding (0 of 1)
  • Tekst (0 of 1)
  • Knop (1 of 2)

    • Menu (0 of 1; wordt weergegeven als onderliggende knop die het patroon Uitvouwen/Samenvouwen ondersteunt)
    • MenuItem (1 tot veel)
SplitButton

- MenuItem (1 tot meerdere)

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. 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.
IsKeyboardFocusableProperty Zie notities. Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen.
NameProperty "Terug" De naam van de splitsknop wordt weergegeven op de knop.
LabeledByProperty Nul Besturingselementen voor gesplitste knoppen hebben geen statisch tekstlabel.
ControlTypeProperty SplitButton Deze waarde is hetzelfde voor alle UI-frameworks.
LocalizedControlTypeProperty gesplitste knop 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 Klopt Het besturingselement splitsknop bevat informatie voor de eindgebruiker.
IsControlElementProperty Klopt Het besturingselement splitsknop is zichtbaar voor de eindgebruiker.

Vereiste patronen voor ui-automatiseringsbeheer

De volgende tabel bevat de UI Automation-besturingspatronen die ondersteund moeten worden door gesplitste knoppen. Zie Overzicht van ui-automatiseringspatronenvoor meer informatie over besturingspatronen.

Besturingselementpatroon Ondersteuning Opmerkingen
IInvokeProvider Verplicht Split-knoppen hebben altijd een standaardactie die is gekoppeld aan Aanroepen.
IExpandCollapseProvider Verplicht 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 gesplitste knopbesturingselementen. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.

Ui Automation-gebeurtenis Ondersteuning Opmerkingen
InvokedEvent Verplicht Geen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
ExpandCollapseStateProperty eigenschapswijziging-evenement. Verplicht Geen
AutomationFocusChangedEvent Verplicht Geen
StructureChangedEvent Verplicht Geen

Voorbeeld van SplitButton-besturingselement

In de volgende afbeelding ziet u een SplitButton-controletype in een gegevensrastercontrole.

Splitknop

Hieronder ziet u de Control View en de Inhoudsweergave van de UI Automation-boom die betrekking heeft op de gegevensraster en gesplitste knopbesturingselementen. De besturingspatronen voor elk automatiseringselement worden tussen haakjes weergegeven.

Ui Automation-structuur - Besturingsweergave Ui Automation-structuur - Inhoudsweergave
  • SplitButton "Name" (Aanroepen, ExpandCollapse)
  • Knop 'Meer opties' (Aanroepen)

    • Menulijst
    • Menu-item
  • SplitButton "Name" (Aanroepen, ExpandCollapse)
  • Knop 'Meer opties' (Aanroepen)

    • Menulijst
    • Menu-item

Zie ook