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

  • Статья

Описывает рекомендации и соглашения по реализации IObjectModelProvider, включая сведения о методах. Шаблон элемента управления ObjectModel используется для предоставления указателя на базовую объектную модель документа.

Во многих приложениях реализованы многофункциональные объектные модели, которые добавляют ценность за пределы возможностей Microsoft модель автоматизации пользовательского интерфейса. Этот шаблон элемента управления позволяет клиенту переходить от элемента модель автоматизации пользовательского интерфейса к базовой объектной модели.

В этом разделе содержатся следующие подразделы.

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

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

  • Метод IObjectModelProvider::GetUnderlyingObjectModel должен возвращать указатель на объект, который максимально близок к исходному элементу пользовательского интерфейса. Например, в веб-браузере поставщик модель автоматизации пользовательского интерфейса для одного элемента должен возвращать указатель объектной модели для элемента . Возврат указателя объектной модели для корневого каталога документа будет гораздо менее полезным.
  • Ожидается, что клиент шаблона элемента управления ObjectModel будет иметь идентификатор IID для искомого интерфейса, поэтому достаточно вернуть простой указатель IUnknown .
  • Так как модель автоматизации пользовательского интерфейса маршалирует указатель на клиентский процесс, поставщик должен ожидать, что клиент будет обращаться к объектной модели с помощью стандартных методов COM.

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

Для реализации интерфейса IObjectModelProvider требуется следующий метод.

Обязательные члены Тип члена Примечания
GetUnderlyingObjectModel Метод Возвращает com-указатель на базовую объектную модель. Ожидается, что клиент вызовет метод IUnknown::QueryInterface для получения определенных указателей объектной модели.

 

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

Типы элементов управления и поддерживаемые ими шаблоны элементов управления

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

Общие сведения о дереве модели автоматизации пользовательского интерфейса