CListCtrl::SetBkImage

Artigo
08/25/2010

Configura a imagem de plano de fundo do controle de exibição de lista.

BOOL SetBkImage(
   LVBKIMAGE* plvbkImage 
);
BOOL SetBkImage(
   HBITMAP hbm,
   BOOL fTile = TRUE,
   int xOffsetPercent = 0,
   int yOffsetPercent = 0
);
BOOL SetBkImage(
   LPTSTR pszUrl,
   BOOL fTile = TRUE,
   int xOffsetPercent = 0,
   int yOffsetPercent = 0 
);

Parâmetros

plvbkImage
Endereço de um LVBKIMAGE estrutura, contendo as novas informações de imagem de plano de fundo.
hbm
Identificador para um bitmap.
pszUrl
A NULO-terminada a seqüência de caracteres que contém o URL da imagem de plano de fundo.
fTile
Diferente de zero se a imagem for ser lado a lado no plano de fundo de controle de modo de exibição de lista; caso contrário, 0.
xOffsetPercent
O deslocamento, em pixels, da borda esquerda da imagem, da origem do controle de exibição de lista.
yOffsetPercent
O deslocamento, em pixels, da borda superior da imagem, da origem do controle de exibição de lista.

Valor de retorno

Retorna diferente de zero se for bem-sucedido, ou zero caso contrário.

Comentários

Observação:
Porque CListCtrl::SetBkImage faz uso de funcionalidade OLE COM, as bibliotecas OLE devem ser inicializadas antes de usar SetBkImage. É melhor inicializar as bibliotecas COM quando o aplicativo é inicializado e não inicializar as bibliotecas quando o aplicativo é encerrado.Isso é concluído automaticamente no MFC aplicações que usam a tecnologia ActiveX, automação OLE, incorporação de OLE vinculação/objetos ou operações ODBC/DAO.

Porque CListCtrl::SetBkImage faz uso de funcionalidade OLE COM, as bibliotecas OLE devem ser inicializadas antes de usar SetBkImage. É melhor inicializar as bibliotecas COM quando o aplicativo é inicializado e não inicializar as bibliotecas quando o aplicativo é encerrado.Isso é concluído automaticamente no MFC aplicações que usam a tecnologia ActiveX, automação OLE, incorporação de OLE vinculação/objetos ou operações ODBC/DAO.