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 |
|---|---|
|
El control de vista de lista no tiene ninguna imagen de fondo. |
|
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. |
|
El miembro pszImage contiene la dirección URL de la imagen de fondo. |
|
La imagen de fondo se muestra normalmente. |
|
La imagen de fondo se mostrará en mosaico para rellenar todo el fondo del control. |
|
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. |
|
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. |
|
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 |