Ondersteuning voor UI Automation voor het type knopbesturing
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 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 van ui-automatiseringsstructuur
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-automatiseringsstructuur voor meer informatie over de UI Automation-structuur.
| Besturingselementweergave | 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). Zie Eigenschappen van UI Automation voor clients voor meer informatie over eigenschappen van UI Automation.
| Ui Automation-eigenschap | Weergegeven als | Opmerkingen |
|---|---|---|
| AcceleratorKeyProperty | Zie notities. | Het besturingselement Knop moet doorgaans een sneltoets ondersteunen om een eindgebruiker in staat te stellen de actie uit te voeren die deze snel weergeeft vanaf het toetsenbord. |
| 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 | 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 | Waar | Het besturingselement Knop moet altijd inhoud zijn. |
| IsControlElementProperty | Waar | Het besturingselement Knop moet altijd een besturingselement zijn. |
| 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 | "button" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype Knop. |
| 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 Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IInvokeProvider | Zie notities. | Alle knoppen moeten het besturingspatroon Aanroepen of het wisselknoppatroon 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 besturingspatroon Aanroepen of het wisselknoppatroon 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 onderliggend element van een splitsknop, kan de onderliggende knop het patroon ExpandCollapse ondersteunen in plaats van het patroon Aanroepen of In-/uitschakelen. 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-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 |
| NameProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| StructureChangedEvent | Vereist | Geen |
| InvokedEvent | Hangt | Als het besturingselement het patroon Aanroepen ondersteunt, moet het deze gebeurtenis ondersteunen. |
| ToggleStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | Als het besturingselement het wisselknoppatroon ondersteunt, moet het deze gebeurtenis ondersteunen. |