Ui Automation-ondersteuning voor het type schuifregelaar
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 schuifregelaar. 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 besturingstypen.
Het besturingselement Schuifregelaar is een samengesteld besturingselement met knoppen waarmee een gebruiker met een muis een numeriek bereik kan instellen of een selectie kan maken uit een set items.
In de volgende secties wordt de vereiste structuur van de UI Automation-structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type schuifregelaar gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle schuifregelaars, 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 schuifregelaars en beschrijft wat in elke weergave kan worden opgenomen. Zie Overzicht van ui-automatiseringsstructuur voor meer informatie over de UI Automation-structuur.
| Besturingselementweergave | Inhoudsweergave |
|---|---|
| Schuifregelaar - Knop (2 of 4) - Duim (slechts 1) - Lijstitem (0 of meer) |
Schuifregelaar - Lijstitem (0 of meer) |
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor het type schuifregelaar. 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 | Notities bekijken | Het merendeel van de schuifregelaars moet de NoClickablePointException heffen omdat de volledige begrenzingsrechthoek van het schuifregelaarbesturingselement wordt bezet door onderliggende besturingselementen. |
| IsKeyboardFocusableProperty | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
| NameProperty | Zie notities. | De naam van het besturingselement bewerken wordt meestal gegenereerd op basis van een statisch tekstlabel. Als er geen statisch tekstlabel is, moet een eigenschapswaarde Name worden toegewezen door de ontwikkelaar van de toepassing. De Name eigenschap mag nooit de tekstuele inhoud van het besturingselement bewerken bevatten. |
| LabeledByProperty | Zie notities. | Als er een statisch tekstlabel is gekoppeld aan het besturingselement, moet deze eigenschap een verwijzing naar dat besturingselement weergeven. Als het tekstbesturingselement een subcomponent van een ander besturingselement is, is LabeledBy er geen eigenschap ingesteld. |
| ControlTypeProperty | Schuifregelaar | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "schuifregelaar" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype Bewerken. |
| IsContentElementProperty | Waar | Het bewerkingsbesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Waar | Het bewerkingsbesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de UI Automation-besturingspatronen die moeten worden ondersteund door alle schuifregelaars. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| ISelectionProvider | Hangt | Een schuifregelaar moet het selectiebeheerpatroon ondersteunen als de inhoud één waarde vertegenwoordigt tussen een discrete set opties. Wanneer het selectiebesturingselementpatroon wordt ondersteund, moet de bijbehorende selectie worden weergegeven als een of meer onderliggende lijstitems van de schuifregelaar. |
| IRangeValueProvider | Hangt | Een schuifregelaar moet het bereikwaardebeheerpatroon ondersteunen als de inhoud kan worden ingesteld op een waarde binnen een numeriek bereik. |
| IValueProvider | Hangt | Een schuifregelaar moet het waardebeheerpatroon ondersteunen als de inhoud één waarde vertegenwoordigt tussen een discrete set opties. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle schuifregelaars.
Zie Overzicht van UI Automation-gebeurtenissen voor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning | Opmerkingen |
|---|---|---|
| InvalidatedEvent | Hangt | Geen |
| BoundingRectangleProperty gebeurtenis gewijzigd door eigenschap | Vereist | Geen |
| IsOffscreenProperty gebeurtenis gewijzigd door eigenschap | Vereist | Geen |
| IsEnabledProperty gebeurtenis gewijzigd door eigenschap | Vereist | Geen |
| ValueProperty gebeurtenis gewijzigd door eigenschap | Hangt | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |