Compartilhar via


CListCtrl::SetBkImage

Define a imagem de plano de fundo de um 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 uma estrutura de LVBKIMAGE , que contém as novas informações de imagem de plano de fundo.

  • hbm
    Identificador para um bitmap.

  • pszUrl
    NULO- Cadeia de caracteres finalizada que contém a URL da imagem de plano de fundo.

  • fTile
    Diferente de zero se a imagem deve ser lado-a-lado no plano de fundo do controle de exibição de lista; se não 0.

  • xOffsetPercent
    O deslocamento, em pixels, da borda esquerda de imagem, de origem do controle de exibição de lista.

  • yOffsetPercent
    O deslocamento, em pixels, da borda superior de, imagem de origem do controle de exibição de lista.

Valor de retorno

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

Comentários

ObservaçãoObservação

Porque CListCtrl::SetBkImage utiliza a funcionalidade OLE COM, as bibliotecas VELHOS devem ser inicializadas antes de usar SetBkImage.É melhor inicializar as bibliotecas COM quando o aplicativo é inicializado e para uninitialize as bibliotecas quando o aplicativo finaliza.Isso é feito automaticamente em aplicativos MFC que utilizam a tecnologia ActiveX, a automação OLE, vincule do OLE/inserida, ou operações de ODBC/DAO.

Exemplo

Consulte o exemplo para CListCtrl::GetBkImage.

Requisitos

Cabeçalho: afxcmn.h

Consulte também

Referência

Classe de CListCtrl

Gráfico de hierarquia

CListCtrl::GetBkImage