Delen via


UI Automation-ondersteuning voor het ScrollBar-besturingstype

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 besturingselementtype Schuifbalk. 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 besturingselementen voor schuifbalken kan een gebruiker inhoud binnen een venster of itemcontainer schuiven. Het besturingselement bestaat uit een set knoppen en een duimbediening.

In de volgende secties worden de vereiste UI Automation structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het ScrollBar-besturingstype gedefinieerd. 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 schuifbalkbesturingselementen 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
Schuifbalk

- Knop (2 of 4)
- Duim (0 of 1)
Niet van toepassing. Het besturingselement schuifbalk bevat geen inhoud.

Het besturingselement voor de schuifbalk heeft altijd drie tot vijf kinderen. Omdat de substructuur meer dan één knop heeft, moet u een specifieke AutomationIdProperty waarde instellen op elk item om ze te detecteren voor testautomatiseringshulpprogramma's.

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 van de schuifbalk. Houd er rekening mee dat een besturingselement voor een schuifbalk nooit inhoud heeft; de functionaliteit wordt weergegeven via het schuifbesturingselementpatroon, dat wordt ondersteund in de container die wordt gescrold.

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.
IsKeyboardFocusableProperty Zie notities. Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen.
NameProperty Null Het besturingselement voor de schuifbalk bevat geen inhoudselementen en hoeft NameProperty niet te worden ingesteld.
ClickablePointProperty Geen getal. Het besturingselement voor de schuifbalk heeft geen klikbare punten.
LabeledByProperty Null Schuifbalken hebben geen labels.
ControlTypeProperty Schuifbalk Deze waarde is hetzelfde voor alle frameworks. Schuifbalken die als schuifregelaars werken, moeten het type schuifregelaar gebruiken.
LocalizedControlTypeProperty "schuifbalk" Gelokaliseerde tekenreeks die overeenkomt met het knopbesturingselement.
IsContentElementProperty Onwaar Het besturingselement voor de schuifbalk is nooit een inhoudselement. Als de schuifbalk een zelfstandig besturingselement is, moet deze voldoen aan het besturingselementtype Schuifregelaar en moet ControlType.Slider voor de ControlType eigenschap teruggegeven worden.
IsControlElementProperty Klopt De schuifbalk moet altijd een besturingselement zijn.
OrientationProperty Klopt Het schuifbalk besturingselement moet altijd de horizontale of verticale afdrukstand weergeven.

Vereiste patronen voor ui-automatiseringsbeheer

De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door schuifbalkbesturingselementen. Zie Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen. Houd er rekening mee dat wanneer een schuifbalk alleen wordt gebruikt als een besturingselement voor het bewerken van de muis, het geen ondersteuning biedt voor besturingspatronen. Als het wordt gebruikt als een schuifregelaar binnen een toepassing, moet het type schuifregelaar worden opgegeven.

Besturingselementpatroon Ondersteuning Opmerkingen
IScrollProvider Nooit Het scrollbesturingspatroon wordt nooit rechtstreeks ondersteund op de scrollbalk.
IRangeValueProvider Dat hangt ervan af. Deze functionaliteit is alleen vereist om te worden ondersteund als het schuifregelaarpatroon niet wordt ondersteund in de container met de schuifbalk.

Vereiste UI Automation-gebeurtenissen

De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen van de schuifbalk. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.

Ui Automation-gebeurtenis Ondersteuning/waarde Opmerkingen
BoundingRectangleProperty eigenschapswijziging-evenement. Verplicht Geen
IsOffscreenProperty eigenschapswijziging-evenement. Verplicht Geen
IsEnabledProperty eigenschapswijziging-evenement. Verplicht Geen
HorizontallyScrollableProperty eigenschapswijziging-evenement. Nooit Geen
HorizontalScrollPercentProperty eigenschapswijziging-evenement. Nooit Geen
HorizontalViewSizeProperty eigenschapswijziging-evenement. Nooit Geen
VerticalScrollPercentProperty eigenschapswijziging-evenement. Nooit Geen
VerticallyScrollableProperty eigenschapswijziging-evenement. Nooit Geen
VerticalViewSizeProperty eigenschapswijziging-evenement. Nooit Geen
ValueProperty eigenschapswijziging-evenement. Dat hangt ervan af. Geen
AutomationFocusChangedEvent Verplicht Geen
StructureChangedEvent Verplicht Geen

Zie ook