ImageList_Create 函式 (commctrl.h)

建立新的映射清單。

語法

HIMAGELIST ImageList_Create(
  int  cx,
  int  cy,
  UINT flags,
  int  cInitial,
  int  cGrow
);

參數

cx

類型： int

每個影像的寬度，以圖元為單位。

cy

類型： int

每個影像的高度，以圖元為單位。

flags

類型： UINT

一組位旗標，指定要建立的映射清單類型。 此參數可以是 影像清單建立旗標的組合。

cInitial

類型： int

映射清單一開始包含的影像數目。

cGrow

類型： int

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

傳回值

類型： HIMAGELIST

如果成功，則傳回影像清單的控制碼，否則傳回 Null 。

備註

當您完成使用映射清單時，請呼叫 ImageList_Destroy 函式來終結它。

注意 Comctl32.dll 第 6 版無法轉散發，但包含在 Windows 或更新版本中。 若要使用第 6 版 Comctl32.dll，請在資訊清單中指定它。 如需資訊清單的詳細資訊，請參閱 啟用視覺樣式。

 

規格需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	commctrl.h
程式庫	Comctl32.lib
Dll	Comctl32.dll
API 集合	ext-ms-win-shell-comctl32-init-l1-1-1 (于 Windows 10 10.0.14393 版)