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

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

  • Статья

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

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

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

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

снимок экрана с проверкой отчета о дереве элементов автоматизации пользовательского интерфейса

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

Рекомендации по реализации и соглашения

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

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

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

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

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

 

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

концептуальные