Compartilhar via


LVM_SETBKIMAGE mensagem

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

Parâmetros

wParam

Deve ser zero.

lParam

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

Valor retornado

Retorna diferente de zero se tiver êxito; caso contrário, zero. Retornará zero se o membro ulFlags da estrutura LVBKIMAGE for LVBKIF_SOURCE_NONE.

Comentários

Como o controle list-view usa OLE COM para manipular as imagens em segundo plano, o aplicativo de chamada deve chamar CoInitialize ou OleInitialize antes de enviar essa mensagem. É melhor chamar uma dessas funções quando o aplicativo é inicializado e chamar CoUninitialize ou OleUninitialize quando o aplicativo está terminando.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Commctrl.h
Nomes Unicode e ANSI
LVM_SETBKIMAGEW (Unicode) e LVM_SETBKIMAGEA (ANSI)

Confira também

LVM_GETBKIMAGE