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 によって渡されたインデックスが、作成されたメタファイルにコメント レコードとして追加されます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ole2.h |
| Library | Ole32.lib |
| [DLL] | Ole32.dll |