Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
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.
Dit onderwerp bevat informatie over UI Automation-ondersteuning voor het Panee-type. 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.
Het besturingselementtype Deelvenster wordt gebruikt om een object in een frame of documentvenster weer te geven. Gebruikers kunnen navigeren tussen deelvensterbesturingselementen en binnen de inhoud van het huidige deelvenster, maar kunnen niet navigeren tussen items in verschillende deelvensters. Deelvensterbesturingselementen vertegenwoordigen dus een niveau van groeperen lager dan vensters of documenten, maar boven afzonderlijke besturingselementen. De gebruiker navigeert tussen deelvensters door op Tab, F6 of Ctrl+Tab te drukken, afhankelijk van de context. Voor het type besturingselement Pane is geen specifieke toetsenbordnavigatie vereist.
In de volgende secties wordt de vereiste structuur van de UI Automation-boom, eigenschappen, besturingspatronen en gebeurtenissen voor het Pane-typebesturingselement 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 deelvensterbesturingselementen 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 |
|---|---|
| Paneel | Paneel |
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor deelvensterbesturingselementen. 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. |
| IsKeyboardFocusableProperty | Zie notities. | Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen. |
| NameProperty | Zie notities. | De waarde voor deze eigenschap moet altijd een duidelijke, beknopte en zinvolle titel zijn. |
| ClickablePointProperty | Zie notities. | Met deze eigenschap wordt een klikbaar punt van het deelvensterbesturingselement weergegeven waardoor het deelvenster wordt gericht wanneer erop wordt geklikt. |
| LabeledByProperty | Zie notities. | Deelvensterbesturingselementen hebben doorgaans geen statisch label. Als er een statisch tekstlabel is, moet deze worden weergegeven via deze eigenschap. |
| ControlTypeProperty | Paneel | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "deelvenster" | Gelokaliseerde tekenreeks die overeenkomt met het paneelbesturingstype. |
| IsContentElementProperty | Klopt | Deelvensterbesturingselementen worden altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Klopt | Deelvensterbesturingselementen worden altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
| HelpTextProperty | "" | In de Help-tekst voor deelvensterbesturingselementen moet worden uitgelegd waarom het doel van het frame en hoe het zich verhoudt tot andere frames. Een beschrijving is noodzakelijk als het doel en de relatie van frames niet duidelijk is uit de waarde van de NameProperty. " |
| AccessKeyProperty | Zie notities. | Als een specifieke toetsencombinatie de focus geeft op het deelvenster, moet deze informatie worden weergegeven via deze eigenschap. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de UI Automation-besturingspatronen die ondersteund moeten worden door alle deelvensterbesturingselementen. Zie Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| ITransformProvider | Dat hangt ervan af. | Implementeer dit patroon als op het scherm het deelvenster verplaatst, verkleind of vergroot, of gedraaid kan worden. |
| IWindowProvider | Nooit | Als u dit besturingspatroon wilt implementeren, moet uw besturingselement zijn gebaseerd op het Window type besturingselement. |
| IDockProvider | Dat hangt ervan af. | Implementeer dit besturingspatroon als het deelvenster-besturingselement kan worden gedokt. |
| IScrollProvider | Dat hangt ervan af. | Implementeer dit controlepatroon als het deelvenster kan worden gescrold. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle deelvensterbesturingselementen. Zie Overzicht van UI Automation-gebeurtenissenvoor meer informatie over gebeurtenissen.
| Ui Automation-gebeurtenis | Ondersteuning/waarde | Opmerkingen |
|---|---|---|
| WindowClosedEvent | Nooit | Geen |
| WindowOpenedEvent | Nooit | Geen |
| AsyncContentLoadedEvent | Verplicht | Geen |
| BoundingRectangleProperty eigenschapswijziging-evenement. | Verplicht | Geen |
| IsOffscreenProperty eigenschapswijziging-evenement. | Verplicht | Geen |
| IsEnabledProperty eigenschapswijziging-evenement. | Verplicht | Geen |
| HorizontallyScrollableProperty eigenschapswijziging-evenement. | Dat hangt ervan af. | Geen |
| HorizontalScrollPercentProperty eigenschapswijziging-evenement. | Dat hangt ervan af. | Geen |
| HorizontalViewSizeProperty eigenschapswijziging-evenement. | Dat hangt ervan af. | Geen |
| VerticalScrollPercentProperty eigenschapswijziging-evenement. | Dat hangt ervan af. | Geen |
| VerticallyScrollableProperty eigenschapswijziging-evenement. | Dat hangt ervan af. | Geen |
| VerticalViewSizeProperty eigenschapswijziging-evenement. | Dat hangt ervan af. | Geen |
| WindowVisualStateProperty eigenschapswijziging-evenement. | Nooit | Geen |
| AutomationFocusChangedEvent | Verplicht | Geen |
| StructureChangedEvent | Verplicht | Geen |
Voorbeeld van besturingselementtype deelvenster
De volgende afbeelding illustreert een aansturingsmechanisme dat het Deelvenster-besturingstype implementeert.
| Ui Automation-structuur - Besturingsweergave | Ui Automation-structuur - Inhoudsweergave |
|---|---|
|
-Paneel - Structuur (schuifpatroon) - TreeItem - …Paneel -Bewerken - (Schuifpatroon) |
Zie ook
- Pane
- Overzicht van UI Automation-besturingstypen
- Overzicht van UI Automation