共用方式為

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 參數。 如果未指定此值，且 cx 設為零，函式會將大小設定為資源中指定的大小。 如果資源包含多個影像，函式會將大小設定為第一個影像的大小。
LR_LOADFROMFILE
 從 lpbmp 參數所指定的檔案載入映像。
LR_LOADMAP3DCOLORS
 搜尋影像的色彩數據表，並以對應的三維色彩取代下列灰色陰影：

Dk Gray： RGB（128， 128， 128）COLOR_3DSHADOW

灰色：RGB（192,192,192）COLOR_3DFACE

灰色中尉： 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 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 commctrl.h
連結庫 Comctl32.lib
DLL Comctl32.dll

另請參閱

LoadImage