TextChild-besturingselementpatroon

Introduceert richtlijnen en conventies voor het implementeren van ITextChildProvider, inclusief informatie over eigenschappen en methoden. Het TextChild-besturingspatroon wordt gebruikt voor toegang tot het dichtstbijzijnde bovenliggende element dat ondersteuning biedt voor het Text-besturingspatroon.

Stel dat tekst in een document een ingesloten afbeelding en een hyperlink bevat, zoals wordt weergegeven in de volgende afbeelding.

Als u Microsoft UI Automation-hulpprogramma's gebruikt om de UI Automation-structuur voor deze documentinhoud te onderzoeken, kan er een documentelement worden weergegeven met één onderliggend element dat de afbeelding vertegenwoordigt en een ander onderliggend element dat de hyperlink vertegenwoordigt. Bijvoorbeeld:

Normaal gesproken ondersteunt het documentelement in het vorige voorbeeld het Text besturingspatroon, maar de twee onderliggende elementen van het documentelement niet. Als een UI Automation-clienttoepassing een verwijzing heeft naar het element van de afbeelding of het hyperlinkelement, kan de client het TextChild--besturingspatroon gebruiken als een handige manier om toegang te krijgen tot het Textcontrol-patroon dat wordt weergegeven door het documentelement dat het bevat.

Implementatierichtlijnen en conventies

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

• De eigenschap ITextChildProvider::TextContainer moet het dichtstbijzijnde bovenliggende element opgeven dat ondersteuning biedt voor ITextProvider interface, ongeacht of elementen die hoger in de bovenliggende keten zijn, ook ondersteuning bieden voor ITextProvider-.
• Een element moet niet zowel deITextProvider- als de ITextChildProvider** interface ondersteunen.
• Een element dat ITextChildProvider implementeert, moet een onderliggend element zijn van een element dat ITextProviderimplementeert. Het is niet vereist dat dit element ook het patroon Tekstbeheer implementeert.
• De eigenschap ITextChildProvider::TextRange moet hetzelfde tekstbereik opgeven als het element met de tekstprovider dat wordt geretourneerd wanneer de functie ITextProvider::RangeFromChild wordt aangeroepen met het onderliggende tekstelement als het ingesloten onderliggende element.

Vereiste leden voor ITextChildProvider

Deze eigenschappen en methoden zijn vereist voor het implementeren van de ITextChildProvider interface.

Dit besturingspatroon heeft geen bijbehorende methoden of gebeurtenissen.

Verwante onderwerpen

conceptuele

• besturingstypen en de ondersteunde besturingspatronen
• Overzicht van UI Automation-besturingspatronen
• Overzicht van UI Automation Tree