Ui Automation-ondersteuning voor het besturingselementtype menubalk
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 MenuBar type besturingselement. 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.
Besturingselementen op de menubalk zijn een voorbeeld van besturingselementen waarmee het type menubalkbesturingselement wordt geïmplementeerd. Menubalken bieden een middel voor gebruikers om opdrachten en opties in een toepassing te activeren.
In de volgende secties worden de vereiste structuur, eigenschappen, besturingspatronen en gebeurtenissen voor het type menubalkbesturingselement 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 menubalkbesturingselementen 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 |
|---|---|
| Menubalk - MenuItem (1 of meer) - Andere besturingselementen (0 of veel) |
Menubalk - MenuItem (1 of meer) - Andere besturingselementen (0 of veel) |
Menubalkbesturingselementen kunnen andere besturingselementen bevatten, zoals besturingselementen bewerken en keuzelijsten met invoervak in de structuur. Deze aanvullende besturingselementen komen overeen met de 'andere besturingselementen' die hierboven worden vermeld in de besturings- en inhoudsweergaven.
Vereiste eigenschappen van UI Automation
De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor de besturingselementen op de menubalk. Zie Eigenschappen van UI Automation voor clients voor meer informatie over eigenschappen van UI Automation.
| Ui Automation-eigenschap | Weergegeven als | Opmerkingen |
|---|---|---|
| BoundingRectangleProperty | Zie notities. | De waarde die door deze eigenschap wordt weergegeven, moet alle besturingselementen bevatten die erin zijn opgenomen. |
| NameProperty | Zie notities. | Het besturingselement voor de menubalk heeft geen naam nodig, tenzij een toepassing meer dan één menubalk heeft. Als er meer dan één menubalk in een toepassing is, moet deze eigenschap worden gebruikt om onderscheid te maken tussen namen, zoals 'Opmaak' of 'Overzicht'. |
| LabeledByProperty | Null |
Menubalkbesturingselementen hebben nooit een label. |
| ControlTypeProperty | Menubalk | Deze waarde is hetzelfde voor alle UI-frameworks. |
| LocalizedControlTypeProperty | "menubalk" | Gelokaliseerde tekenreeks die overeenkomt met het besturingselementtype Menubalk. |
| IsContentElementProperty | Waar | Het besturingselement van de menubalk is altijd opgenomen in de inhoudsweergave van de UI Automation-structuur. |
| IsControlElementProperty | Waar | Het menubalkbesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur. |
| IsOffscreenProperty | Zie notities. | De waarde van deze eigenschap is afhankelijk van of het besturingselement kan worden weergegeven op het scherm. |
| OrientationProperty | Hangt | Met deze eigenschap wordt weergegeven of het besturingselement van de menubalk horizontaal of verticaal is. |
| IsKeyboardFocusableProperty | Waar | Besturingselementen op de menubalk zijn toetsenbordfocussbaar omdat de besturingselementen die ze bevatten, de focus van het toetsenbord kunnen nemen. |
| HelpTextProperty | Zie notities. | Er zijn geen scenario's voor wanneer Help-tekst vereist is voor een menubalk. |
| AcceleratorKeyProperty | Null |
Menubalken hebben nooit acceleratortoetsen. |
| AccessKeyProperty | "Alt" | Als u op de Alt-toets drukt, moet de focus altijd naar de menubalk in de toepassing worden verplaatst. |
Vereiste patronen voor ui-automatiseringsbeheer
De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door menubalkbesturingselementen. Zie Overzicht van UI Automation-besturingspatronen voor meer informatie over besturingspatronen.
| Besturingselementpatroon | Ondersteuning | Opmerkingen |
|---|---|---|
| IExpandCollapseProvider | Hangt | Als het besturingselement kan worden uitgevouwen of samengevouwen, implementeert u IExpandCollapseProvider. |
| IDockProvider | Hangt | Als het besturingselement kan worden gedokt naar verschillende delen van het scherm, implementeert u IDockProvider. |
| ITransformProvider | Hangt | Als het besturingselement kan worden gewijzigd, moet het worden ITransformProvidergeroteerd of verplaatst. |
Vereiste UI Automation-gebeurtenissen
De volgende tabel bevat de UI Automation-gebeurtenissen die moeten worden ondersteund door alle besturingselementen op de menubalk. 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 |
| ExpandCollapseStateProperty eigenschap gewijzigd gebeurtenis. | Hangt | Geen |
| AutomationFocusChangedEvent | Vereist | Geen |
| StructureChangedEvent | Vereist | None |