共用方式為

ImageList_LoadBitmap巨集 （commctrl.h）

  • 發行項

呼叫 ImageList_LoadImage 函式，從指定的點陣圖資源建立影像清單。

語法

HIMAGELIST ImageList_LoadBitmap(
   HINSTANCE hi,
   LPCTSTR   lpbmp,
   int       cx,
   int       cGrow,
   COLORREF  crMask
);

參數

hi

類型：HINSTANCE

包含位圖資源的 實例句柄。 如果您要載入 OEM 位圖，此參數 NULL。

lpbmp

類型：LPCTSTR

要載入的影像。 如果 hi 參數是非NULL，lpbmp 是 null 終止字串的位址，其中包含 hi 模組中的影像資源名稱。 如果 hiNULL，此參數 LOWORD 必須是要載入的 OEM 位圖標識符。 若要建立此值，請使用 MAKEINTRESOURCE 巨集搭配 WINUSER.H 中定義的其中一個 OEM 位圖標識符。 這些標識碼具有OBM_前置詞。

cx

類型：int

每個影像的寬度。 每個影像的高度和初始影像數目是由指定位圖的維度推斷。

cGrow

類型：int

當系統需要為新映射騰出空間時，映像清單可以成長的影像數目。 此參數代表重設大小影像清單可以包含的新影像數目。

crMask

類型：COLORREF

用來產生遮罩的色彩。 指定位圖中此色彩的每個像素都會變更為黑色，且遮罩中的對應位設為 1。 如果此參數是CLR_NONE值，則不會產生遮罩。

傳回值

類型：HIMAGELIST

如果成功，則傳回影像清單的句柄，否則 NULL。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 commctrl.h