Share via

ImageList_LoadImageA函式 (commctrl.h)

  • 發行項

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

語法

HIMAGELIST ImageList_LoadImageA(
  HINSTANCE hi,
  LPCSTR    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