Estructura LVBKIMAGEA (commctrl.h)

Contiene información sobre la imagen de fondo de un control de vista de lista. Esta estructura se usa para establecer y recuperar información de imagen de fondo.

Sintaxis

typedef struct tagLVBKIMAGEA {
  ULONG   ulFlags;
  HBITMAP hbm;
  LPSTR   pszImage;
  UINT    cchImageMax;
  int     xOffsetPercent;
  int     yOffsetPercent;
} LVBKIMAGEA, *LPLVBKIMAGEA;

Miembros

ulFlags

Tipo: ULONG

Este miembro puede ser una o varias de las marcas siguientes. Puede usar el valor de LVBKIF_SOURCE_MASK para enmascarar todas las marcas de origen, excepto las marcas de origen. Puede usar el valor de LVBKIF_STYLE_MASK para enmascarar todas las marcas de estilo, excepto las marcas de estilo.

Valor	Significado
LVBKIF_SOURCE_NONE	El control de vista de lista no tiene ninguna imagen de fondo.
LVBKIF_SOURCE_HBITMAP	Se proporciona un mapa de bits en segundo plano a través del miembro hbm de LVBKIMAGE. Si el mensaje LVM_SETBKIMAGE se realiza correctamente, la vista de lista toma posesión del mapa de bits.
LVBKIF_SOURCE_URL	El miembro pszImage contiene la dirección URL de la imagen de fondo.
LVBKIF_STYLE_NORMAL	La imagen de fondo se muestra normalmente.
LVBKIF_STYLE_TILE	La imagen de fondo se mostrará en mosaico para rellenar todo el fondo del control.
LVBKIF_FLAG_TILEOFFSET	Especifique las coordenadas del primer icono. Esta marca solo es válida si también se especifica la marca LVBKIF_STYLE_TILE. Si no se especifica esta marca, el primer icono comienza en la esquina superior izquierda del área de cliente. Si usa ComCtl32.dll versión 6.0 el xOffsetPercent de y yOffsetPercent campos contienen píxeles, no valores porcentuales, para especificar las coordenadas del primer icono. Comctl32.dll versión 6 no es redistribuible, pero se incluye en Windows o versiones posteriores. Además, debe especificar Comctl32.dll versión 6 en un manifiesto. Para obtener más información sobre los manifiestos, vea Habilitación de estilos visuales.
LVBKIF_TYPE_WATERMARK	Se proporciona un mapa de bits de fondo de marca de agua a través del miembro de hbm de LVBKIMAGE. Si el mensaje LVM_SETBKIMAGE se realiza correctamente, el control list-view toma posesión del mapa de bits.
LVBKIF_FLAG_ALPHABLEND	Solo es válido cuando también se especifica LVBKIF_TYPE_WATERMARK. Esta marca indica que el mapa de bits proporcionado a través de LVBKIF_TYPE_WATERMARK contiene un canal alfa válido.

hbm

Tipo: HBITMAP de

Identificador del mapa de bits de fondo. Este miembro solo es válido si la marca de LVBKIF_SOURCE_HBITMAP está establecida en ulFlags.

pszImage

Tipo: LPTSTR de

Dirección de una cadena terminada en NULL que contiene la dirección URL de la imagen de fondo. Este miembro solo es válido si la marca de LVBKIF_SOURCE_URL está establecida en ulFlags. Este miembro debe inicializarse para que apunte al búfer que contiene o recibe el texto antes de enviar el mensaje.

cchImageMax

Tipo: UINT de

Tamaño del búfer en la dirección de pszImage. Si se envía información al control, se omite este miembro.

xOffsetPercent

Tipo: int

Porcentaje del área de cliente del control que la imagen debe desplazarse horizontalmente. Por ejemplo, al 0 por ciento, la imagen se mostrará en el borde izquierdo del área cliente del control. Al 50 por ciento, la imagen se mostrará horizontalmente centrada en el área de cliente del control. Al 100 por ciento, la imagen se mostrará en el borde derecho del área de cliente del control. Este miembro solo es válido cuando se especifica LVBKIF_STYLE_NORMAL en ulFlags. Si tanto LVBKIF_FLAG_TILEOFFSET como LVBKIF_STYLE_TILE se especifican en ulFlags, el valor especifica el píxel, no el desplazamiento porcentual, del primer icono. De lo contrario, se omite el valor.

yOffsetPercent

Tipo: int

Porcentaje del área de cliente del control que la imagen debe desplazarse verticalmente. Por ejemplo, al 0 por ciento, la imagen se mostrará en el borde superior del área de cliente del control. Al 50 por ciento, la imagen se mostrará verticalmente centrada en el área de cliente del control. Al 100 por ciento, la imagen se mostrará en el borde inferior del área de cliente del control. Este miembro solo es válido cuando se especifica LVBKIF_STYLE_NORMAL en ulFlags. Si tanto LVBKIF_FLAG_TILEOFFSET como LVBKIF_STYLE_TILE se especifican en ulFlags, el valor especifica el píxel, no el desplazamiento porcentual, del primer icono. De lo contrario, se omite el valor.

Observaciones

Esta estructura se usa con los mensajes LVM_GETBKIMAGE y LVM_SETBKIMAGE.

Nota

El encabezado commctrl.h define LVBKIMAGE como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	commctrl.h