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>
"object short type" は、リスト ボックスに完全に表示できる十分な短いオブジェクト名の形式を指します。 これらの識別文字列はオブジェクトの永続的な状態の一部として格納されないため、オブジェクトが読み込まれるか実行されるたびに IOleObject::SetHostNames を呼び出す必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | oleidl.h |