Delen via

UI Automation-ondersteuning voor het tree control type

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 Tree-besturingstype. 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 boomstructuur van UI Automation, UI Automation-eigenschapswaarden en controlepatronen.

Het type structuurbesturingselement wordt gebruikt voor containers waarvan de inhoud relevant is als een hiërarchie van knooppunten, net zoals bestanden en mappen worden weergegeven in het linkerdeelvenster van Microsoft Windows Verkenner. Elk knooppunt kan andere knooppunten bevatten, die onderliggende knooppunten worden genoemd. Bovenliggende knooppunten of knooppunten die onderliggende knooppunten bevatten, kunnen worden weergegeven als uitgevouwen of samengevouwen.

In de volgende secties wordt de vereiste UI Automation-boomstructuur, de bijbehorende eigenschappen, besturingspatronen en gebeurtenissen voor het type boomstructuurelement gedefinieerd. De vereisten voor UI Automation zijn van toepassing op alle structuurbesturingselementen, ongeacht of Windows Presentation Foundation (WPF), Win32 of Windows Forms.

Vereiste structuur voor UI-automatisering

In de volgende tabel ziet u de besturingselementweergave en de inhoudsweergave van de UI Automation-structuur die betrekking heeft op structuurbesturingselementen 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
Boom

  • DataItem (0 of meer)
  • TreeItem (0 of meer)

    • TreeItem (0 of meer)• ...
  • Schuifbalk (0, 1, 2)
 Boom

  • DataItem (0 of meer)
  • TreeItem (0 of meer)

    • TreeItem (0 of meer)• ...

De besturingsweergave van de UI Automation-structuur bestaat uit:

  • Nul tot veel items in de container (items kunnen worden gebaseerd op het structuuritem, gegevensitem of ander type besturingselement).

  • Nul, één of twee schuifbalken.

De inhoudsweergave van de UI Automation-structuur bestaat uit nul of veel items in de container (items kunnen zijn gebaseerd op het structuuritem, gegevensitem of ander type besturingselement).

Vereiste eigenschappen van UI Automation

De volgende tabel bevat de eigenschappen van UI Automation waarvan de waarde of definitie met name relevant is voor lijstbesturingselementen. 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.
ClickablePointProperty Zie notities. Besturingselementen voor structuur hebben een klikbare punt waar de focus wordt gelegd op de boomstructuur of een van de items in de structuurcontainer. U krijgt alleen een klikbaar punt voor een boom als u ergens kunt klikken waarbij geen van de items wordt geselecteerd of focus krijgt.
ControlTypeProperty Boom Deze waarde is hetzelfde voor alle UI-frameworks.
IsContentElementProperty Klopt Het structuurbesturingselement wordt altijd opgenomen in de inhoudsweergave van de UI Automation-structuur.
IsControlElementProperty Klopt Het structuurbesturingselement wordt altijd opgenomen in de besturingsweergave van de UI Automation-structuur.
IsKeyboardFocusableProperty Zie notities. Als het besturingselement de focus van het toetsenbord kan ontvangen, moet het deze eigenschap ondersteunen.
LabeledByProperty Zie notities. Als aan het structuurbesturingselement een label is gekoppeld, retourneert deze eigenschap een AutomationElement voor dat label. Anders retourneert de eigenschap een null-verwijzing (Nothing in Microsoft Visual Basic .NET).
LocalizedControlTypeProperty "boom" Gelokaliseerde tekenreeks die overeenkomt met het type lijstbesturingselement.
NameProperty Zie notities. De waarde van de naameigenschap van een structuurbesturingselement is meestal afkomstig van tekst die het besturingselement labelt. Als er geen tekstlabel is, moet de ontwikkelaar van de toepassing een waarde voor deze eigenschap opgeven.

Vereiste patronen voor ui-automatiseringsbeheer

De volgende tabel bevat de ui Automation-besturingspatronen die moeten worden ondersteund door lijstbesturingselementen. Zie Ui Automation Control Patterns Overviewvoor meer informatie over besturingspatronen.

Besturingselementpatroon/patrooneigenschap Ondersteuning/waarde Opmerkingen
ISelectionProvider Dat hangt ervan af. Boomstructuurelementen die een set selecteerbare items bevatten, moeten dit besturingspatroon implementeren. Dit besturingspatroon hoeft niet te worden geïmplementeerd als het selecteren van een item geen zinvolle informatie aan de gebruiker overdraagt.
CanSelectMultiple Zie notities. Implementeer deze eigenschap als het structuurbesturingselement meerdere selecties ondersteunt (de meeste structuurbesturingselementen bieden geen ondersteuning voor meerdere selecties).
IsSelectionRequired Zie notities. De waarde van deze eigenschap wordt weergegeven als voor het besturingselement een item moet worden geselecteerd.
IScrollProvider Dat hangt ervan af. Implementeer dit besturingspatroon als de inhoud van de structuurcontainer kan worden gebladerd.

Vereiste UI Automation-gebeurtenissen

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

Ui Automation-gebeurtenis Ondersteuning Opmerkingen
InvalidatedEvent Dat hangt ervan af. 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
AutomationFocusChangedEvent Verplicht Geen
StructureChangedEvent Verplicht Geen

Zie ook

  • Last updated on