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	Un mapa de bits de fondo se proporciona a través del miembro hbm de LVBKIMAGE. Si el mensaje LVM_SETBKIMAGE se realiza correctamente, la vista de lista toma la propiedad 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 , los campos xOffsetPercent e yOffsetPercent contienen píxeles, no valores porcentuales, para especificar las coordenadas del primer icono. Comctl32.dll versión 6 no se puede redistribuir, 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, consulte 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 hbm de LVBKIMAGE. Si el mensaje de LVM_SETBKIMAGE se realiza correctamente, el control de vista de lista toma la propiedad del mapa de bits.
LVBKIF_FLAG_ALPHABLEND	Válido solo 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

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

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 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

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 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 cliente del control. Este miembro solo es válido cuando se especifica LVBKIF_STYLE_NORMAL en ulFlags. Si se especifican tanto LVBKIF_FLAG_TILEOFFSET como LVBKIF_STYLE_TILE 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 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 cliente del control. Al 50 por ciento, la imagen se mostrará verticalmente centrada en el área 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 se especifican tanto LVBKIF_FLAG_TILEOFFSET como LVBKIF_STYLE_TILE en ulFlags, el valor especifica el píxel, no el desplazamiento porcentual, del primer icono. De lo contrario, se omite el valor.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	commctrl.h