Compartilhar via

Como adicionar listas de imagens de exibição de lista

  • Artigo

Este tópico demonstra como adicionar listas de imagens a um controle de exibição de lista.

Você cria somente as listas de imagens que o controle usa. Por exemplo, se o aplicativo não permitir que o usuário alterne para a exibição de ícones, você não precisará criar e atribuir uma lista de ícones grande. Se você criar listas de imagens grandes e pequenas, elas deverão conter as mesmas imagens na mesma ordem, pois um único valor será usado para identificar o ícone de um item de exibição de lista em ambas as listas de imagens.

O que você precisa saber

Tecnologias

Pré-requisitos

  • C/C++
  • Programação da interface do usuário do Windows

Instruções

Para exibir imagens de item, você deve atribuir uma lista de imagens ao controle list-view. Para fazer isso, use a mensagem LVM_SETIMAGELIST ou o ListView_SetImageList de macro correspondente, especificando se a lista de imagens contém ícones de tamanho completo, ícones pequenos ou imagens de estado. Para recuperar o identificador para uma lista de imagens que está atualmente atribuída a um controle de exibição de lista, use a mensagem LVM_GETIMAGELIST. Você pode usar a função GetSystemMetrics para determinar as dimensões apropriadas para os ícones de tamanho completo e pequeno.

No exemplo de código C++ a seguir, a função definida pelo aplicativo primeiro cria listas de imagens e, em seguida, as atribui a um controle de exibição de lista.

// 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; 
}

Referência de controle List-View

Sobre controles de exibição de lista

Usando controles de exibição de lista