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