Compartir a través de


CListCtrl::SetBkImage

Establece la imagen de fondo de un control de vista 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
    Dirección de una estructura de LVBKIMAGE , que contiene la nueva información de la imagen de fondo.

  • hbm
    Identificador a un mapa de bits.

  • pszUrl
    NULL- Cadena finalizada que contiene la dirección URL de la imagen de fondo.

  • fTile
    Distinto de cero si la imagen a ser en mosaico en segundo plano del control de vista de lista; si no 0.

  • xOffsetPercent
    El desplazamiento, en píxeles, del borde izquierdo de la imagen, el origen del control de vista de lista.

  • yOffsetPercent
    El desplazamiento, en píxeles, del borde superior de la imagen, el origen del control de vista de lista.

Valor devuelto

Devuelve cero si es correcto, o cero de otra manera.

Comentarios

Nota

Dado que CListCtrl::SetBkImage hace uso de funcionalidad COM), bibliotecas VIEJAS deben inicializar antes de utilizar SetBkImage.Es mejor inicializar las bibliotecas COM cuando se inicializa la aplicación y desinicializar bibliotecas cuando la aplicación finaliza.Esto se hace en aplicaciones MFC que hacen uso de la tecnología de ActiveX, de OLE Automation, de OLE Linking /Embedding, u operaciones de ODBC/DAO.

Ejemplo

Vea el ejemplo para CListCtrl::GetBkImage.

Requisitos

encabezado: afxcmn.h

Vea también

Referencia

CListCtrl Class

Gráfico de jerarquías

CListCtrl::GetBkImage