共用方式為

ImageList_LoadImageW函式 (commctrl.h)

  • 發行項

從指定的點陣圖建立影像清單。

語法

HIMAGELIST ImageList_LoadImageW(
  HINSTANCE hi,
  LPCWSTR   lpbmp,
  int       cx,
  int       cGrow,
  COLORREF  crMask,
  UINT      uType,
  UINT      uFlags
);

參數

hi

類型： HINSTANCE

包含資源的實例句柄。 如果您要從檔案載入影像或載入 OEM 資源，這個參數可以是 NULL 。

lpbmp

類型： LPCTSTR

要載入的映像。

如果 uFlags 參數包含LR_LOADFROMFILE， 則 lpbmp 是以 Null 終止的字串位址，將包含要載入之影像的檔案命名為 。

如果 hi 參數為非NULL 且未指定LR_LOADFROMFILE， 則 lpbmp 是 null 終止字串的位址，其中包含 hi 模組中的影像資源名稱。

如果 hi 為 NULL 且未指定LR_LOADFROMFILE，則此參數的 LOWORD 必須是要載入的 OEM 映像識別碼。 若要建立此值，請使用 MAKEINTRESOURCE 宏搭配Winuser.h 中定義的其中一個 OEM 映像識別符。 這些標識碼具有下列前置詞。

值 意義
OEM 位陣圖的OBM_
OEM 圖示的OIC_
OEM 數據指標的OCR_

cx

類型： int

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

cGrow

類型： int

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

crMask

類型： COLORREF

用來產生遮罩的色彩。 指定位圖、游標或圖示中這個色彩的每個像素都會變更為黑色，且遮罩中的對應位會設定為1。 如果此參數是CLR_NONE值，則不會產生遮罩。 如果此參數是CLR_DEFAULT值，則會將影像左上角的圖元色彩視為遮罩色彩。

uType

類型： UINT

旗標，指定要載入的影像類型。 這個參數必須IMAGE_BITMAP，才能指出正在載入點陣圖。

請注意，ImageList_LoadImage 僅適用於位圖檔案。 不支援其他映像類型。
 
值 意義
IMAGE_BITMAP
 載入點圖。

uFlags

類型： UINT

指定如何載入影像的旗標。 此參數可以是下列值的組合。

值 意義
LR_CREATEDIBSECTION
 當 uType 參數指定IMAGE_BITMAP時，會導致函式傳回 DIB 區段位圖，而不是相容的位圖。 LR_CREATEDIBSECTION適用於載入點陣圖，而不將其對應至顯示裝置的色彩。
LR_DEFAULTCOLOR
 使用顯示器的色彩格式。
LR_DEFAULTSIZE
 如果 cx 參數設定為零，則會使用系統計量值針對游標和圖示指定的寬度或高度。 如果未指定此值， 而且 cx 設定為零，函式會將大小設定為資源中指定的大小。 如果資源包含多個影像，函式會將大小設定為第一個影像的大小。
LR_LOADFROMFILE
 從 lpbmp 參數指定的檔案載入映像。
LR_LOADMAP3DCOLORS
 搜尋影像的色彩表格，並以對應的三維色彩取代下列灰色底紋：

Dk 灰色：RGB (128、128、128) COLOR_3DSHADOW

灰色：RGB (192、192、192) COLOR_3DFACE

Lt Gray：RGB (223、223、223) COLOR_3DLIGHT

如需詳細資訊，請參閱＜備註＞一節。
LR_LOADTRANSPARENT
 擷取影像中第一個圖元的色彩值，並以預設視窗色彩取代色彩表格中的對應專案， (COLOR_WINDOW 顯示色彩) 。 使用該色彩之影像中的所有像素都會變成預設視窗值色彩。 這個值只適用於具有對應色彩表格的影像。 如需詳細資訊，請參閱＜備註＞一節。
LR_MONOCHROME
 以黑白載入影像。
LR_SHARED
 如果多次載入映像，請共用映像句柄。 請勿將此值用於在載入之後可能會變更的非傳統大小，或針對從檔案載入的影像使用此值。

傳回值

類型： HIMAGELIST

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

備註

LR_LOADTRANSPARENT不會以透明方式載入影像。 它會建立只顯示為透明的不透明影像清單，因為所有背景圖元都已變更為COLOR_WINDOW。 如果影像是透過不是色彩的背景繪製COLOR_WINDOW，影像就不會正確繪製。 此外，LR_LOADTRANSPARENT和LR_LOADMAP3DCOLORS使用呼叫 ImageList_LoadImage 時生效的系統色彩。 如果系統色彩隨後變更，應用程式必須重載影像以重新對應色彩。

注意

commctrl.h 標頭會將ImageList_LoadImage定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 commctrl.h
程式庫 Comctl32.lib
Dll Comctl32.dll

另請參閱

LoadImage