ListView_SetBkImage macro (commctrl.h)

Define a imagem de plano de fundo em um controle de exibição de lista. Você pode usar essa macro ou enviar a mensagem LVM_SETBKIMAGE explicitamente.

Sintaxe

BOOL ListView_SetBkImage(
   HWND        hwnd,
   LPLVBKIMAGE plvbki
);

Parâmetros

hwnd

Tipo: HWND

Um identificador para o controle de exibição de lista.

plvbki

Tipo: LPLVBKIMAGE

Um ponteiro para uma estrutura de LVBKIMAGE que contém as novas informações de imagem de plano de fundo.

Valor de retorno

Tipo: BOOL

Retornará diferente de zero se tiver êxito ou zero de outra forma. Retornará zero se o membro ulFlags da estrutura de LVBKIMAGE for LVBKIF_SOURCE_NONE.

Observações

Como o controle de exibição de lista usa OLE COM para manipular as imagens em segundo plano, o aplicativo de chamada deve chamar CoInitialize ou OleInitialize antes de usar essa macro. É melhor chamar uma dessas funções quando o aplicativo é inicializado e chamar CoUninitialize ou OleUninitialize quando o aplicativo está sendo encerrado.

Requisitos

Consulte também

ListView_GetBkImage