Метод IOleObject::SetHostNames (oleidl.h)
Предоставляет объекту имена его контейнерного приложения и составного документа, в который он внедрен.
Синтаксис
HRESULT SetHostNames(
[in] LPCOLESTR szContainerApp,
[in] LPCOLESTR szContainerObj
);
Параметры
[in] szContainerApp
Указатель на имя приложения-контейнера, в котором выполняется объект.
[in] szContainerObj
Указатель на имя составного документа, содержащего объект. Если вы не хотите отображать имя составного документа, можно задать для этого параметра значение NULL.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении.
Комментарии
Примечания для вызывающих абонентов
Вызывайте IOleObject::SetHostNames только для внедренных объектов, так как для связанных объектов источник ссылки предоставляет собственные отдельные сведения о окне редактирования и строке заголовка.Примечания для разработчиков
Приложение объекта IOleObject::SetHostNames должно включать любые изменения в пользовательском интерфейсе, которые могут быть подходящими для внедренного состояния объекта. Такие изменения обычно включают добавление и удаление команд меню, а также изменение текста, отображаемого в заголовке окна редактирования.Полный заголовок окна для внедренного объекта в контейнерном приложении SDI или приложении MDI с развернутым дочерним окном должен выглядеть следующим образом:
<object application name> - <object short type> in <container document>
В противном случае заголовок должен быть следующим:
<object application name> - <container document>
Тип "короткий объект" относится к форме имени объекта, достаточно короткой, чтобы его можно было полностью отобразить в списке. Так как эти идентифицирующие строки не хранятся в постоянном состоянии объекта, IOleObject::SetHostNames необходимо вызывать при каждой загрузке или запуске объекта.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | oleidl.h |