OleMetafilePictFromIconAndLabel 関数 (ole2.h)

指定したアイコンとラベルを描画するメタファイルを作成します。

構文

HGLOBAL OleMetafilePictFromIconAndLabel(
  [in] HICON    hIcon,
  [in] LPOLESTR lpszLabel,
  [in] LPOLESTR lpszSourceFile,
  [in] UINT     iIconIndex
);

パラメーター

[in] hIcon

メタファイルに描画されるアイコンを処理します。 このパラメーターは、NULL でもかまいません。 hIcon が NULL の場合、この関数はメタファイルを作成せずに NULL を返します。

[in] lpszLabel

アイコン ラベル。 このパラメーターは、NULL でもかまいません。 lpszLabel が NULL の場合、結果のメタファイルにはラベルは含まれません。

[in] lpszSourceFile

アイコン ファイルのパスとファイル名。 この文字列は、ユーザー インターフェイスまたは登録データベースから取得できます。 このパラメーターは、NULL でもかまいません。

[in] iIconIndex

lpszSourceFile という名前のファイル内のアイコンの場所。ファイルの先頭からのオフセット (バイト単位) で表されます。

戻り値

アイコンとラベルを含む METAFILEPICT 構造体へのグローバル ハンドル。 メタファイルは、MM_ANISOTROPIC マッピング モードを使用します。

エラーが発生した場合、返されるハンドルは NULL です。 この場合、呼び出し元は GetLastError を 呼び出して詳細情報を取得できます。

注釈

この関数は、 OleGetIconOfFile と OleGetIconOfClass によって呼び出されます。

lpszSourceFile が NULL ではなく、iIconIndex が 0 でない場合、lpszSourceFile で渡されたソース ファイルの名前と、iIconIndex によって渡されたインデックスが、作成されたメタファイルにコメント レコードとして追加されます。

要件

こちらもご覧ください

OleGetIconOfClass

OleGetIconOfFile