Ui Automation-ondersteuning voor het type schuifbalkbesturing
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 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 structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type Schuifbalk gedefinieerd. 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 schuifbalkbesturingselementen 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 |
|---|---|
| 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.
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. |
| 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 besturingselementtype Knop. |
| 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 terugkeren ControlType.Slider naar de ControlType eigenschap. |
| IsControlElementProperty | Waar | De schuifbalk moet altijd een besturingselement zijn. |
| OrientationProperty | Waar | 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 Overzicht van UI Automation-besturingspatronen voor 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 schuifbesturingspatroon wordt nooit rechtstreeks ondersteund op de schuifbalk. |
| IRangeValueProvider | Hangt | 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-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning/waarde | Opmerkingen |
|---|---|---|
| BoundingRectangleProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsOffscreenProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| IsEnabledProperty eigenschap gewijzigd gebeurtenis. | Vereist | Geen |
| HorizontallyScrollableProperty eigenschap gewijzigd gebeurtenis. | Nooit | Geen |
| HorizontalScrollPercentProperty eigenschap gewijzigd gebeurtenis. | Nooit | Geen |
| HorizontalViewSizeProperty eigenschap gewijzigd gebeurtenis. | Nooit | Geen |
| VerticalScrollPercentProperty eigenschap gewijzigd gebeurtenis. | Nooit | Geen |
| VerticallyScrollableProperty eigenschap gewijzigd gebeurtenis. | Nooit | Geen |
| VerticalViewSizeProperty eigenschap gewijzigd gebeurtenis. | Nooit | Geen |
| ValueProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |