Delen via

Ondersteuning voor UI Automation voor het type knopbesturing

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 knopbesturing. 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 knop is een object waarmee een gebruiker communiceert om een actie uit te voeren, zoals de knoppen OK en Annuleren in een dialoogvenster. Het besturingselement voor knoppen is een eenvoudig besturingselement dat kan worden weergegeven omdat het is toegewezen aan één opdracht die de gebruiker wil voltooien.

In de volgende secties wordt de vereiste structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type knopbesturingselement gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle knopbesturingselementen, 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 knopbesturingselementen en wordt beschreven wat in elke weergave kan worden opgenomen. Zie OVERZICHT van ui-automatiseringsstructuurvoor meer informatie over de UI Automation-structuur.

Controleweergave Inhoudsweergave
Knop

- Afbeelding (0 of meer)
- Tekst (0 of meer)		 Knop

Vereiste eigenschappen van UI Automation

De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor de besturingselementen die het type knopbesturingselement implementeren (zoals knopbesturingselementen). Voor meer informatie over UI Automation-eigenschappen, zie UI Automation-eigenschappen voor cliënten.

UI Automation-eigenschap Waarde Opmerkingen
AcceleratorKeyProperty Zie notities. Het besturingselement Knop moet doorgaans een sneltoets ondersteunen, zodat een eindgebruiker snel de corresponderende actie vanaf het toetsenbord kan uitvoeren.
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 Knop Deze waarde is hetzelfde voor alle UI-frameworks.
HelpTextProperty Zie notities. De Help-tekst kan aangeven wat het eindresultaat is van het activeren van de knop. Dit is doorgaans hetzelfde type informatie dat wordt weergegeven via een knopinfo.
IsContentElementProperty Klopt Het besturingselement Knop moet altijd inhoud zijn.
IsControlElementProperty Klopt Het Knop-besturingselement moet altijd een besturingselement blijven.
IsKeyboardFocusableProperty Zie notities. Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen.
LabeledByProperty Null Knopbesturingselementen worden zelf gelabeld door hun inhoud.
LocalizedControlTypeProperty knop Gelokaliseerde tekenreeks die overeenkomt met het knoptype.
NameProperty Zie notities. De naam van het knop besturingselement is de tekst die wordt gebruikt om het te labelen. Wanneer een afbeelding wordt gebruikt om een knop te labelen, moet alternatieve tekst worden opgegeven voor de eigenschap Naam van de knop.

Vereiste patronen voor ui-automatiseringsbeheer

De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door alle knopbesturingselementen. Zie Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen.

Besturingselementpatroon Ondersteuning Opmerkingen
IInvokeProvider Zie notities. Alle knoppen moeten het bedieningspatroon "Aanroepen" of het "Wisselknop" bedieningspatroon ondersteunen. Aanroepen wordt ondersteund wanneer de knop een opdracht uitvoert op verzoek van de gebruiker. Met deze opdracht wordt één bewerking toegewezen, zoals Knippen, Kopiëren, Plakken of Verwijderen.
IToggleProvider Zie notities. Alle knoppen moeten het bedieningspatroon "Aanroepen" of het "Wisselknop" bedieningspatroon ondersteunen. Wisselknop wordt ondersteund als de knop kan worden gecyclusd door een reeks van maximaal drie statussen. Dit wordt meestal gezien als een aan/uit-schakelaar voor specifieke functies.
IExpandCollapseProvider Zie notities. Wanneer een knop wordt gehost als kind van een splitsknop, kan de kindknop het ExpandCollapse-patroon ondersteunen in plaats van het Invoke- of Toggle-patroon. Het ExpandCollapse-patroon kan worden gebruikt voor het openen of sluiten van een menu of een andere substructuur die is gekoppeld aan het knopelement.

Vereiste UI Automation-gebeurtenissen

De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle knopbesturingselementen. 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
NameProperty eigenschapswijziging-evenement. Verplicht Geen
StructureChangedEvent Verplicht Geen
InvokedEvent Dat hangt ervan af. Als het besturingselement het besturingspatroon Aanroepen ondersteunt, moet het deze gebeurtenis ondersteunen.
ToggleStateProperty eigenschapswijziging-evenement. Dat hangt ervan af. Als het besturingselement het wisselknoppatroon ondersteunt, moet het deze gebeurtenis ondersteunen.

Zie ook

  • Last updated on