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 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | oleidl.h |