Wzorzec kontrolki TextChild

Wprowadza wytyczne i konwencje implementowania ITextChildProvider, w tym informacje o właściwościach i metodach. Wzorzec kontrolki textChild służy do uzyskiwania dostępu do najbliższego obiektu będącego elementem obsługującym wzorzec kontrolki Text.

Załóżmy na przykład, że tekst w dokumencie zawiera obraz osadzony i hiperlink, jak pokazano na poniższej ilustracji.

Jeśli używasz narzędzi automatyzacji interfejsu użytkownika firmy Microsoft do badania drzewa automatyzacji interfejsu użytkownika dla tej zawartości dokumentu, może to spowodować wyświetlenie elementu dokumentu z jednym elementem podrzędnym reprezentującym obraz, a innym elementem podrzędnym reprezentującym hiperlink. Na przykład:

Zazwyczaj element dokumentu w poprzednim przykładzie obsługuje wzorzec kontrolki Text, ale dwa elementy podrzędne elementu dokumentu nie. Jeśli aplikacja kliencka automatyzacji interfejsu użytkownika ma odwołanie do elementu obrazu lub elementu hiperłącza, klient może użyć wzorca kontrolki TextChild jako wygodnego sposobu uzyskiwania dostępu do wzorca Kontrolka tekstu uwidocznionego przez element zawierający dokument.

Wytyczne i konwencje implementacji

Podczas implementowania interfejsu ITextChildProvider należy pamiętać o następujących wytycznych i konwencjach:

• Właściwość ITextChildProvider::TextContainer powinna określać najbliższy element nadrzędny obsługujący interfejs ITextProvider, niezależnie od tego, czy elementy wyższe w łańcuchu obiektów nadrzędnych obsługują również ITextProvider.
• Element nie powinien obsługiwać zarównoITextProvider, jak i interfejsu ITextChildProvider**.
• Element implementujący ITextChildProvider musi być elementem podrzędnym lub malejącym elementu implementującego ITextProvider. Nie jest wymagane, aby ten element zaimplementował również wzorzec kontrolki Text.
• Właściwość ITextChildProvider::TextRange powinna określać ten sam zakres tekstu, który element dostawcy tekstu zwraca, gdy jego ITextProvider::RangeFromChild jest wywoływana z elementem podrzędnym text jako dołączony element podrzędny podrzędny.

Wymagane elementy członkowskie ITextChildProvider

Te właściwości i metody są wymagane do zaimplementowania interfejsu ITextChildProvider.

Ten wzorzec kontrolki nie ma skojarzonych metod ani zdarzeń.

Tematy pokrewne

koncepcyjne

• typów kontrolek i ich obsługiwanych wzorców kontrolek
• Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie
• Omówienie drzewa automatyzacji interfejsu użytkownika