通过

如何添加列表视图图像列表

  • 项目

本主题演示如何在列表视图控件中添加图像列表。

仅创建控件使用的图像列表。 例如，如果应用程序不允许用户切换到图标视图，则无需创建并分配大型图标列表。 如果同时创建大型和小型图像列表，它们必须按相同顺序包含相同的图像，因为单个值用于标识两个图像列表中的列表视图项的图标。

需要了解的事项

技术

先决条件

  • C/C++
  • Windows 用户界面编程

说明

若要显示项图像，必须将图像列表分配给列表视图控件。 为此，请使用 LVM_SETIMAGELIST 消息或相应的宏ListView_SetImageList，指定图像列表是否包含全尺寸图标、小图标或状态图像。 若要检索当前分配给列表视图控件的图像列表的句柄，请使用 LVM_GETIMAGELIST 消息。 可以使用 GetSystemMetrics 函数确定全尺寸和小图标的适当尺寸。

在以下 C++ 代码示例中，应用程序定义的函数首先创建图像列表，然后将其分配给列表视图控件。

// InitListViewImageLists: Creates image lists for a list-view control.
// This function only creates image lists. It does not insert the items into
// the control, which is necessary for the control to be visible.   
//
// Returns TRUE if successful, or FALSE otherwise. 
//
// hWndListView: Handle to the list-view control. 
// global variable g_hInst: The handle to the module of either a 
// dynamic-link library (DLL) or executable (.exe) that contains
// the image to be loaded. If loading a standard or system
// icon, set g_hInst to NULL.
//
BOOL InitListViewImageLists(HWND hWndListView) 
{ 
    HICON hiconItem;     // Icon for list-view items.
    HIMAGELIST hLarge;   // Image list for icon view.
    HIMAGELIST hSmall;   // Image list for other views.

    // Create the full-sized icon image lists. 
    hLarge = ImageList_Create(GetSystemMetrics(SM_CXICON), 
                              GetSystemMetrics(SM_CYICON), 
                              ILC_MASK, 1, 1); 

    hSmall = ImageList_Create(GetSystemMetrics(SM_CXSMICON), 
                              GetSystemMetrics(SM_CYSMICON), 
                              ILC_MASK, 1, 1); 
    
    // Add an icon to each image list.  
    hiconItem = LoadIcon(g_hInst, MAKEINTRESOURCE(IDI_ITEM));

    ImageList_AddIcon(hLarge, hiconItem);
    ImageList_AddIcon(hSmall, hiconItem);

    DestroyIcon(hiconItem);
 
// When you are dealing with multiple icons, you can use the previous four lines of 
// code inside a loop. The following code shows such a loop. The 
// icons are defined in the application's header file as resources, which 
// are numbered consecutively starting with IDS_FIRSTICON. The number of 
// icons is defined in the header file as C_ICONS.
/*    
    for(index = 0; index < C_ICONS; index++)
    {
        hIconItem = LoadIcon (g_hinst, MAKEINTRESOURCE(IDS_FIRSTICON + index));
        ImageList_AddIcon(hSmall, hIconItem);
        ImageList_AddIcon(hLarge, hIconItem);
        Destroy(hIconItem);
    }
*/
    
    // Assign the image lists to the list-view control. 
    ListView_SetImageList(hWndListView, hLarge, LVSIL_NORMAL); 
    ListView_SetImageList(hWndListView, hSmall, LVSIL_SMALL); 
    
    return TRUE; 
}

列表视图控件参考

关于列表视图控件

使用列表视图控件