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 |
程式庫 | Ole32.lib |
Dll | Ole32.dll |