Patroon waardebeheer

Beschrijft richtlijnen en conventies voor het implementeren van IValueProvider, inclusief informatie over eigenschappen en methoden. Het waarde besturingspatroon wordt gebruikt ter ondersteuning van besturingselementen die een intrinsieke waarde hebben die geen bereik beslaat en die als een tekenreeks kunnen worden weergegeven.

De waardetekenreeks kan worden bewerkt, afhankelijk van het besturingselement en de bijbehorende instellingen. Zie Besturingstypen en de ondersteunde besturingspatronenvoor voorbeelden van besturingselementen die dit besturingspatroon implementeren.

Dit onderwerp bevat de volgende secties.

• richtlijnen en conventies voor de tenuitvoerlegging
• Vereiste leden voor IValueProvider-
• Verwante onderwerpen

Implementatierichtlijnen en conventies

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

• Besturingselementen zoals een lijstitem of structuuritem moeten het waarde- besturingspatroon ondersteunen als de waarde van een van de items kan worden bewerkt, ongeacht de huidige bewerkingsmodus van het besturingselement. Het bovenliggende besturingselement moet ook het patroon Waarde ondersteunen als de onderliggende items kunnen worden bewerkt. In de volgende afbeelding ziet u een voorbeeld van een bewerkbaar lijstitem.

  

• Besturingselementen voor bewerken met één regel moeten ITextProvider- implementeren om hun alleen-lezen inhoud beschikbaar te maken.

• Besturingselementen voor bewerken met meerdere regels moeten IValueProvider implementeren als de inhoud ervan kan worden gewijzigd.

• 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 besturingselement kleurkiezer in Microsoft Word (zie de volgende afbeelding), dat tekenreekstoewijzing tussen een kleurwaarde (bijvoorbeeld 'geel') en een equivalente interne RGB--waarde ondersteunt.

  

• Voor een besturingselement moet de eigenschap IsEnabled zijn ingesteld op TRUE- en de bijbehorende eigenschap ITextProvider::IsReadOnly ingesteld op FALSE- voordat een aanroep naar ITextProvider::SetValuewordt toegestaan.

Vereiste leden voor IValueProvider-

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

Vereiste leden	Type lid	Notities
IsReadOnly-	Eigenschap	Geen
waarde	Eigenschap	Geen
SetValue	Methode	Geen

 

Dit besturingspatroon heeft geen gekoppelde gebeurtenissen.

Verwante onderwerpen

besturingstypen en de ondersteunde besturingspatronen

Overzicht van UI Automation-besturingspatronen

Overzicht van UI Automation Tree

tekst- en tekstbereikpatronen