ListView_SetBkImage macro (commctrl.h)

Artigo
10/24/2024

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

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Consulte também

ListView_GetBkImage

Compartilhar via