Delen via

De implementatie van het UI Automation Value Control Pattern

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 voor implementatie IValueProvidergeïntroduceerd, inclusief informatie over gebeurtenissen en eigenschappen. Koppelingen naar aanvullende verwijzingen worden aan het einde van het onderwerp weergegeven.

Het ValuePattern besturingspatroon wordt gebruikt ter ondersteuning van besturingselementen met een intrinsieke waarde die geen bereik beslaat en die als een tekenreeks kan worden weergegeven. Deze tekenreeks kan worden bewerkt, afhankelijk van het besturingselement en de bijbehorende instellingen. Voor voorbeelden van besturingselementen die dit patroon implementeren, zie Beheerpatroontoewijzing voor UI Automation-clients.

Implementatierichtlijnen en conventies

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

  • Besturingselementen zoals ListItem en TreeItem moeten ValuePattern ondersteunen als de waarde van een van de items kan worden bewerkt, ongeacht de bewerkingsmodus van het besturingselement. Het bovenliggende besturingselement moet ook ValuePattern ondersteunen als de onderliggende items bewerkbaar zijn.

Bewerkbaar lijstitem. Voorbeeld van een bewerkbaar lijstitem

  • Besturingselementen voor bewerkingen met één regel bieden ondersteuning voor programmatische toegang tot hun inhoud door te implementeren IValueProvider. Besturingselementen voor bewerken met meerdere regels implementeren echter niet IValueProvider; in plaats daarvan bieden ze toegang tot hun inhoud door ITextProvider te implementeren.

  • Om de tekstuele inhoud van een besturingselement met meerdere regels op te halen, moet het besturingselement de functie ITextProvider implementeren. ITextProvider ondersteunt echter niet het instellen van de waarde van een bedieningselement.

  • IValueProvider biedt geen ondersteuning voor het ophalen van opmaakgegevens of subtekenreekswaarden. Implementeer ITextProvider in deze scenario's.

  • IValueProvider moet worden geïmplementeerd door besturingselementen zoals het selectiebesturingselement Kleurkiezer uit Microsoft Word (hieronder geïllustreerd), dat ondersteuning biedt voor tekenreekstoewijzing tussen een kleurwaarde (bijvoorbeeld 'geel') en een equivalente interne RGB-structuur.

Kleurkiezer met geel gemarkeerd. Voorbeeld van tekenreekstoewijzing van kleurstalen

Vereiste leden voor IValueProvider

De volgende eigenschappen en methoden zijn vereist voor de implementatie IValueProvider.

Vereiste leden Ledentype Opmerkingen
IsReadOnlyProperty Vastgoed Geen
ValueProperty Vastgoed Geen
SetValue Methode Geen

Uitzonderingen

Providers moeten de volgende uitzonderingen genereren.

Uitzonderingstype Conditie
InvalidOperationException SetValue

- Als landinstellingenspecifieke informatie wordt doorgegeven aan een besturingselement in een onjuiste indeling, zoals een onjuist opgemaakte datum.
ArgumentException SetValue

- Als een nieuwe waarde niet kan worden geconverteerd van een tekenreeks naar een indeling die door het besturingselement wordt herkend.
ElementNotEnabledException SetValue

- Wanneer er geprobeerd wordt een besturingselement te manipuleren dat niet actief is.

Zie ook

  • Last updated on