Поделиться через

Шаблон элемента управления 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 Свойство Нет

 

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

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