共用方式為


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 模組中映射資源的名稱。

如果未指定 hiNull ,且未指定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