Delen via

UI Automation-ondersteuning voor het controltype Voortgangsbalk

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.

In dit onderwerp vindt u informatie over de ondersteuning van UI Automation voor het ProgressBar-besturingselementtype. 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 voor UI-automatisering

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.

Controleweergave Inhoudsweergave
Voortgangsbalk Voortgangsbalk

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 UI Automation-eigenschappen voor cliënten voor meer informatie over UI Automation-eigenschappen.

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 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 Voortgangsbalk Deze waarde is hetzelfde voor alle UI-frameworks.
LocalizedControlTypeProperty "voortgangsbalk" Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype Voortgangsbalk.
IsContentElementProperty Klopt Het voortgangsbalkbesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur.
IsControlElementProperty Klopt 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 Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen.

Besturingselementpatroon/patrooneigenschap Ondersteuning/waarde Opmerkingen
IValueProvider Dat hangt ervan af. Voortgangsbalkbesturingen die een tekstuele indicatie van de voortgang geven, moeten IValueProvider implementeren.
IsReadOnly Klopt De waarde voor deze eigenschap is altijd waar.
Value Zie notities. Met deze eigenschap wordt tekstuele voortgang van een voortgangsbalkbesturingselement weergegeven.
IRangeValueProvider Dat hangt ervan af. Voortgangsbalkbesturingselementen die een numeriek bereik gebruiken, moeten IRangeValueProvider implementeren.
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 Nan Deze eigenschap is niet vereist omdat besturingselementen voor de voortgangsbalk alleen-lezen zijn.
LargeChange Nan 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 bedieningselementen voor voortgangsbalken. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.

Ui Automation-gebeurtenis Ondersteuning Opmerkingen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
NameProperty eigenschapswijziging-evenement. Verplicht Geen
ValueProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen
AutomationFocusChangedEvent Verplicht Geen
StructureChangedEvent Verplicht Geen

Zie ook

  • Last updated on