影像清單
本節包含與影像清單搭配使用之程序設計專案的相關信息。
概觀
| 主題 | 目錄 |
|---|---|
| 影像清單 | 影像清單是相同大小的影像集合，每個影像都可以由其索引參考。 |
函式
| 主題 | 目錄 |
|---|---|
| HIMAGELIST_QueryInterface | 擷取對應至影像清單之HIMAGELIST句柄的ImageList或ImageList2物件的指標。 |
| ImageList_Add | 將影像或影像新增至影像清單。 |
| ImageList_AddMasked | 將影像或影像新增至影像清單，從指定的點陣圖產生遮罩。 |
| ImageList_BeginDrag | 開始拖曳影像。 |
| ImageList_CoCreateInstance | 建立 imagelist 的單一實例，並傳回它的介面指標。 |
| ImageList_Copy | 複製指定影像清單中的影像。 |
| ImageList_Create | 建立新的映像清單。 |
| ImageList_Destroy | 終結影像清單。 |
| ImageList_DragEnter | 在視窗內的指定位置顯示拖曳影像。 |
| ImageList_DragLeave | 解除鎖定指定的視窗並隱藏拖曳影像，讓視窗得以更新。 |
| ImageList_DragMove | 移動拖放作業期間所拖曳的影像。 此函式通常會呼叫，以回應 WM_MOUSEMOVE 訊息。 |
| ImageList_DragShowNolock | 顯示或隱藏正在拖曳的影像。 |
| ImageList_Draw | 在指定的裝置內容中繪製影像清單專案。 |
| ImageList_DrawEx | 在指定的裝置內容中繪製影像清單專案。 函式會使用指定的繪圖樣式，並將影像與指定的色彩混合。 |
| ImageList_DrawIndirect | 根據 IMAGELISTDRAWPARAMS 結構繪製影像清單影像。 |
| ImageList_Duplicate | 建立現有映像清單的複本。 |
| ImageList_EndDrag | 結束拖曳作業。 |
| ImageList_GetBkColor | 擷取影像清單目前的背景色彩。 |
| ImageList_GetDragImage | 擷取用於拖曳影像的暫存影像清單。 函式也會擷取目前拖曳位置以及拖曳影像相對於拖曳位置的位移。 |
| ImageList_GetIcon | 從影像清單中的影像和遮罩建立圖示。 |
| ImageList_GetIconSize | 擷取影像清單中的影像維度。 影像清單中的所有影像都有相同的維度。 |
| ImageList_GetImageCount | 擷取影像清單中的影像數目。 |
| ImageList_GetImageInfo | 擷取映像的相關信息。 |
| ImageList_LoadImage | 從指定的點陣圖建立影像清單。 |
| ImageList_Merge | 結合兩個現有的映像來建立新的映像。 函式也會建立新的映射清單，以在其中儲存映像。 |
| ImageList_Read | 從數據流讀取影像清單。 |
| ImageList_ReadEx | 從數據流讀取影像清單，並將介面傳回影像清單。 |
| ImageList_Remove | 從映像清單中移除影像。 |
| ImageList_Replace | 以新的映像取代映像清單中的影像。 |
| ImageList_ReplaceIcon | 以圖示或游標取代影像。 |
| ImageList_SetBkColor | 設定影像清單的背景色彩。 只有在您新增圖示或使用 ImageList_AddMasked搭配黑白位圖時，此函式 才能運作。 如果沒有遮罩，則會繪製整個影像;因此背景色彩不可見。 |
| ImageList_SetColorTable | 設定影像清單的色彩數據表。 |
| ImageList_SetDragCursorImage | 藉由結合指定的影像（通常是滑鼠游標影像）與目前的拖曳影像，建立新的拖曳影像。 |
| ImageList_SetIconSize | 設定影像清單中的影像維度，並從清單中移除所有影像。 |
| ImageList_SetImageCount | 調整現有影像清單的大小。 |
| ImageList_SetOverlayImage | 將指定的影像加入要做為重迭遮罩的影像清單。 映射清單在 4.70 版和更早版本中最多可以有四個重疊遮罩，4.71 版最多可以有 15 個。 函式會將重迭遮罩索引指派給指定的影像。 |
| ImageList_Write | 將影像清單寫入數據流。 |
| ImageList_WriteEx | 將影像清單寫入數據流。 |
巨集
| 主題 | 目錄 |
|---|---|
| ImageList_AddIcon | 將圖示或游標新增至影像清單。 ImageList_AddIcon會呼叫 ImageList_ReplaceIcon 函式。 |
| ImageList_ExtractIcon | 呼叫 ImageList_GetIcon 函式，根據影像清單中的影像和遮罩來建立圖示或游標。 |
| ImageList_LoadBitmap | 呼叫 ImageList_LoadImage 函式，從指定的位圖資源建立影像清單。 |
| ImageList_RemoveAll | 呼叫 ImageList_Remove 函式，以從影像清單中移除所有影像。 |
| INDEXTOOVERLAYMASK | 準備覆迭遮罩的索引，讓 ImageList_Draw 函式可以使用它。 |
介面
| 主題 | 目錄 |
|---|---|
| IImageList | 公開操作和與影像清單互動的方法。 若要使用 IImageList，請在指令清單中指定Comctl32.dll第 6 版。 如果您未這麼做，預設會使用第 5 版Comctl32.dll，IImageList 可能會顯示無法預期的行為。 如需指令清單的詳細資訊，請參閱 啟用可視化樣式。 |
方法
| 主題 | 目錄 |
|---|---|
| 加入 | 將影像或影像新增至影像清單。 |
| AddMasked | 將影像或影像新增至影像清單，從指定的點陣圖產生遮罩。 |
| BeginDrag | 開始拖曳影像。 |
| 複製 | 複製現有的映像清單。 |
| 複製 | 從指定的映像清單複製映像。 |
| DragEnter | 鎖定在拖曳作業期間更新指定的視窗，並在視窗內的指定位置顯示拖曳影像。 |
| DragLeave | 解除鎖定指定的視窗並隱藏拖曳影像，讓視窗能夠更新。 |
| DragMove | 移動拖放作業期間所拖曳的影像。 此函式通常會呼叫，以回應 WM_MOUSEMOVE 訊息。 |
| DragShowNolock | 顯示或隱藏正在拖曳的影像。 |
| 畫 | 在指定的裝置內容中繪製影像清單專案。 |
| EndDrag | 結束拖曳作業。 |
| GetBkColor | 取得影像清單的目前背景色彩。 |
| GetDragImage | 取得用於拖曳影像的暫存影像清單。 函式也會擷取目前拖曳位置以及拖曳影像相對於拖曳位置的位移。 |
| GetIcon | 從影像和影像清單中的遮罩建立圖示。 |
| GetIconSize | 取得影像清單中的影像維度。 影像清單中的所有影像都有相同的維度。 |
| GetImageCount | 取得影像清單中的影像數目。 |
| GetImageInfo | 取得影像的相關信息。 |
| GetImageRect | 取得影像的周框。 |
| GetItemFlags | 取得影像的旗標。 |
| GetOverlayImage | 從做為重迭遮罩的影像清單中擷取指定的影像。 |
| 合併 | 結合兩個現有的映像來建立新的映像。 這個方法也會建立新的映射清單，以在其中儲存映像。 |
| 移除 | 從映像清單中移除影像。 |
| Replace | 以新的映像取代映像清單中的影像。 |
| ReplaceIcon | 以圖示或游標取代影像。 |
| SetBkColor | 設定影像清單的背景色彩。 只有在您將圖示新增至影像清單，或使用 ImageList：：AddMasked 方法來新增黑白點陣圖時，這個方法才會運作。 如果沒有遮罩，整個影像就會繪製，而且背景色彩不可見。 |
| SetDragCursorImage | 藉由結合指定的影像，也就是滑鼠游標影像與目前拖曳影像，以建立新的拖曳影像。 |
| SetIconSize | 設定影像清單中的影像維度，並從清單中移除所有影像。 |
| SetImageCount | 調整現有影像清單的大小。 |
| SetOverlayImage | 將指定的影像新增至做為重迭遮罩的影像清單。 映射清單在 Common Controls 4.70 版和更早版本中最多可以有四個重疊遮罩，4.71 版或更新版本中最多可以有 15 個重疊遮罩。 方法會將重迭遮罩索引指派給指定的影像。 |
結構
| 主題 | 目錄 |
|---|---|
| IMAGEINFO | 包含影像清單中影像的相關信息。 此結構與 IImageList：：GetImageInfo 函式搭配使用。 |
| IMAGELISTDRAWPARAMS | 包含影像清單繪製作業的相關信息，並與ImageList：:D raw函式搭配使用。 |