Het implementeren van het UI Automation Grid Control-patroon

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.

In dit onderwerp worden richtlijnen en conventies geïntroduceerd voor het implementeren van IGridProvider, waaronder informatie over eigenschappen, methoden en gebeurtenissen. Koppelingen naar aanvullende verwijzingen worden weergegeven aan het einde van het overzicht.

Het GridPattern besturingspatroon wordt gebruikt om besturingselementen die fungeren als containers voor een verzameling onderliggende elementen te ondersteunen. Kind-elementen van dit element moeten IGridItemProvider implementeren en ingedeeld zijn in een tweedimensionaal logisch coördinatensysteem dat kan worden doorkruist door rijen en kolommen. Zie Toewijzing van besturingspatronen voor UI Automation-clientsvoor voorbeelden van besturingselementen die dit besturingspatroon implementeren.

Implementatierichtlijnen en conventies

Let bij het implementeren van het rasterbeheerpatroon op de volgende richtlijnen en conventies:

• Rastercoördinaten zijn op nul gebaseerd, waarbij de cel linksboven (of rechtsboven, afhankelijk van de landinstelling) de coördinaten (0, 0) heeft.

• Als een cel leeg is, moet er nog steeds een UI Automation-element worden geretourneerd om de ContainingGrid eigenschap voor die cel te ondersteunen. Dit is mogelijk wanneer de indeling van onderliggende elementen in het raster vergelijkbaar is met een onregelmatige matrix (zie het onderstaande voorbeeld).

Voorbeeld van een rastercontrole met lege coördinaten

• Een raster met één item is nog steeds vereist om te implementeren IGridProvider als het logisch wordt beschouwd als een raster. Het aantal onderliggende items in het raster is immateriële.

• Verborgen rijen en kolommen, afhankelijk van de implementatie van de provider, kunnen worden geladen in de UI Automation-structuur en worden daarom weergegeven in de RowCount en ColumnCount eigenschappen. Als de verborgen rijen en kolommen nog niet zijn geladen, moeten ze niet worden geteld.

• IGridProvider maakt actieve manipulatie van een raster niet mogelijk; ITransformProvider moet worden geïmplementeerd om deze functionaliteit in te schakelen.

• Gebruik een StructureChangedEventHandler indeling om te luisteren naar structurele wijzigingen in het raster, zoals cellen die zijn toegevoegd, verwijderd of samengevoegd.

• Gebruik een AutomationFocusChangedEventHandler om de navigatie door de items of cellen in een raster bij te houden.

Vereiste leden voor IGridProvider

De volgende eigenschappen en methoden zijn vereist voor het implementeren van de IGridProvider-interface.

Vereiste leden	Typologie	Opmerkingen
RowCount	Vastgoed	Geen
ColumnCount	Vastgoed	Geen
GetItem	Methode	Geen

Dit besturingspatroon heeft geen gekoppelde gebeurtenissen.

Uitzonderingen

Providers moeten de volgende uitzonderingen genereren.

Uitzonderingstype	Conditie
ArgumentOutOfRangeException	GetItem - Als de aangevraagde rijcoördinaat groter is dan de RowCount of de kolomcoördinaat groter is dan de ColumnCount.
ArgumentOutOfRangeException	GetItem - Als een van de aangevraagde rij- of kolomcoördinaten kleiner is dan nul.

Zie ook

• Overzicht van UI-automatiseringsbesturingspatronen
• Ondersteuning van bedieningspatronen in een UI Automation Provider
• UI Automation-besturingspatronen voor clients
• Het ui Automation GridItem-besturingselementpatroon implementeren
• Overzicht van de UI Automation Tree
• Caching gebruiken in de UI-automatisering van de gebruikersinterface