CListCtrl::GetBkImage

Artigo
02/25/2013

Recupera uma imagem de plano de fundo atual de um controle de exibição de lista.

BOOL GetBkImage(
   LVBKIMAGE* plvbkImage 
) const;

Parâmetros

plvbkImage
Um ponteiro a estrutura de LVBKIMAGE que contém a imagem de plano de fundo atual de exibição de lista.

Valor de retorno

Retorna diferente de zero se com êxito, ou zero de outra forma.

Comentários

Este método implementa o comportamento de macro Win32, ListView_GetBkImage, como descrito em Windows SDK.

Exemplo

        LVBKIMAGE bki;

        // If no background image is set for the list view control use
        // the Microsoft homepage image as the background image.
        if (m_myListCtrl.GetBkImage(&bki) && (bki.ulFlags == LVBKIF_SOURCE_NONE))
        {
            m_myListCtrl.SetBkImage(
                _T("https://www.microsoft.com/library/images/gifs/homepage/microsoft.gif"),
                TRUE);
        }