Ui Automation-ondersteuning voor het besturingselementtype Voortgangsbalk
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.
In dit onderwerp vindt u informatie over de ondersteuning van UI Automation voor het besturingselementtype ProgressBar. 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.
Besturingselementen voor de voortgangsbalk zijn een voorbeeld van besturingselementen waarmee het besturingselementtype Voortgangsbalk wordt geïmplementeerd. Besturingselementen voor de voortgangsbalk worden gebruikt om de voortgang van een langdurige bewerking aan te geven. Het besturingselement bestaat uit een rechthoek die geleidelijk wordt gevuld met de kleur van de systeemmarkering wanneer een bewerking vordert.
In de volgende secties wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen gedefinieerd voor het type ProgressBar-besturingselement. De vereisten voor UI Automation zijn van toepassing op alle lijstbesturingselementen, 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 op de voortgangsbalk 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 |
|---|---|
| Progressbar | Progressbar |
De besturingselementen voor de voortgangsbalk hebben geen onderliggende elementen in de besturings- of inhoudsweergave van de UI Automation-structuur.
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 op de voortgangsbalk. 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 | Zie notities. | Het besturingselement voor de voortgangsbalk haalt doorgaans de naam op van een statisch tekstlabel. Als er geen statisch tekstlabel is, moet de ontwikkelaar van de toepassing een waarde voor de Name eigenschap beschikbaar maken. |
| LabeledByProperty | Zie notities. | Als er een statisch tekstlabel is, moet deze eigenschap een verwijzing naar dat besturingselement weergeven. |
| ControlTypeProperty | Progressbar | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "voortgangsbalk" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype Voortgangsbalk. |
| IsContentElementProperty | Waar | Het voortgangsbalkbesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Waar | Het voortgangsbalkbesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
Vereiste patronen en eigenschappen van ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door besturingselementen op de voortgangsbalk. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon/patrooneigenschap | Ondersteuning/waarde | Opmerkingen |
|---|---|---|
| IValueProvider | Hangt | Besturingselementen voor de voortgangsbalk die een tekstuele indicatie van de voortgang geven, moeten worden geïmplementeerd IValueProvider. |
| IsReadOnly | Waar | De waarde voor deze eigenschap is altijd waar. |
| Value | Zie notities. | Met deze eigenschap wordt tekstuele voortgang van een voortgangsbalkbesturingselement weergegeven. |
| IRangeValueProvider | Hangt | Besturingselementen voor de voortgangsbalk die een numeriek bereik nemen, moeten worden geïmplementeerd IRangeValueProvider |
| Minimum | 0,0 | De waarde van deze eigenschap is de kleinste waarde waarop het besturingselement kan worden ingesteld. |
| Maximum | 100,0 | De waarde van deze eigenschap is de grootste waarde waarop het besturingselement kan worden ingesteld. |
| SmallChange | Geen getal | Deze eigenschap is niet vereist omdat besturingselementen voor de voortgangsbalk alleen-lezen zijn. |
| LargeChange | Geen getal | Deze eigenschap is niet vereist omdat besturingselementen voor de voortgangsbalk alleen-lezen zijn. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen op de voortgangsbalk. Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| NameProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| ValueProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |