Шаблон элемента управления TextChild

Содержит рекомендации и соглашения по реализации ITextChildProvider, включая сведения о свойствах и методах. Шаблон элемента управления TextChild используется для доступа к ближайшему предку элемента, который поддерживает шаблон элемента управления Текст .

Например, предположим, что текст в документе содержит внедренное изображение и гиперссылку, как показано на следующем рисунке.

Если вы используете средства Microsoft модель автоматизации пользовательского интерфейса для просмотра дерева модель автоматизации пользовательского интерфейса для этого содержимого документа, в нем может отображаться элемент документа с одним дочерним элементом, который представляет изображение, и другим дочерним элементом, представляющим гиперссылку. Пример:

Как правило, элемент document в предыдущем примере поддерживает шаблон элемента управления Текст , но два дочерних элемента элемента документа не поддерживают его. Если клиентское приложение модель автоматизации пользовательского интерфейса имеет ссылку на элемент image или элемент гиперссылки, клиент может использовать шаблон элемента управления TextChild в качестве удобного способа доступа к шаблону Textcontrol, предоставляемому содержащим элементом документа.

Правила и соглашения реализации

При реализации интерфейса ITextChildProvider обратите внимание на следующие рекомендации и соглашения.

• Свойство ITextChildProvider::TextContainer должно указывать ближайший элемент-предок, поддерживающий интерфейс ITextProvider , независимо от того, поддерживают ли элементы выше в цепочке предков ITextProvider.
• Элемент не должен поддерживать интерфейсITextProvider и ITextChildProvider** .
• Элемент, реализующий ITextChildProvider , должен быть дочерним элементом или потомком элемента, реализующего ITextProvider. Необязательно, чтобы этот элемент также реализовыв шаблон элемента управления "Текст".
• Свойство ITextChildProvider::TextRange должно указывать тот же текстовый диапазон, который возвращается содержащим элементом поставщика текста при вызове функции ITextProvider::RangeFromChild с текстовым дочерним элементом в качестве заключенного дочернего элемента.

Обязательные члены для ITextChildProvider

Эти свойства и методы необходимы для реализации интерфейса ITextChildProvider .

Обязательные члены	Тип члена	Примечания
TextContainer	Свойство	Нет
TextRange	Свойство	Нет

 

Этот шаблон элемента управления не имеет связанных методов или событий.

Связанные темы

Основные понятия

• Типы элементов управления и поддерживаемые ими шаблоны элементов управления
• Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса
• Общие сведения о дереве модели автоматизации пользовательского интерфейса