Estrutura LVBKIMAGEA (commctrl.h)

Contém informações sobre a imagem de plano de fundo de um controle de exibição de lista. Essa estrutura é usada para definir e recuperar informações de imagem de plano de fundo.

Sintaxe

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

Membros

ulFlags

Tipo: ULONG

Esse membro pode ser um ou mais dos sinalizadores a seguir. Você pode usar o valor LVBKIF_SOURCE_MASK para mascarar todos, exceto os sinalizadores de origem. Você pode usar o valor LVBKIF_STYLE_MASK para mascarar todos, exceto os sinalizadores de estilo.

Valor	Significado
LVBKIF_SOURCE_NONE	O controle de exibição de lista não tem nenhuma imagem de plano de fundo.
LVBKIF_SOURCE_HBITMAP	Um bitmap em segundo plano é fornecido por meio do hbm membro do LVBKIMAGE. Se a mensagem LVM_SETBKIMAGE bem-sucedida, o modo de exibição de lista assumirá a propriedade do bitmap.
LVBKIF_SOURCE_URL	O membro pszImage contém a URL da imagem de plano de fundo.
LVBKIF_STYLE_NORMAL	A imagem de plano de fundo é exibida normalmente.
LVBKIF_STYLE_TILE	A imagem de plano de fundo será lado a lado para preencher toda a tela de fundo do controle.
LVBKIF_FLAG_TILEOFFSET	Especifique as coordenadas do primeiro bloco. Esse sinalizador só será válido se o sinalizador de LVBKIF_STYLE_TILE também for especificado. Se esse sinalizador não for especificado, o primeiro bloco começará no canto superior esquerdo da área do cliente. Se você usar ComCtl32.dll versão 6.0 os campos xOffsetPercent e yOffsetPercent contêm pixels, não valores percentuais, para especificar as coordenadas do primeiro bloco. Comctl32.dll versão 6 não é redistribuível, mas está incluída no Windows ou posterior. Além disso, você deve especificar Comctl32.dll versão 6 em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.
LVBKIF_TYPE_WATERMARK	Um bitmap de fundo de marca d'água é fornecido por meio do hbm membro do LVBKIMAGE. Se a mensagem LVM_SETBKIMAGE for bem-sucedida, o controle de exibição de lista assumirá a propriedade do bitmap.
LVBKIF_FLAG_ALPHABLEND	Válido somente quando LVBKIF_TYPE_WATERMARK também é especificado. Esse sinalizador indica que o bitmap fornecido por meio de LVBKIF_TYPE_WATERMARK contém um canal alfa válido.

hbm

Tipo: HBITMAP

O identificador do bitmap em segundo plano. Esse membro só será válido se o sinalizador de LVBKIF_SOURCE_HBITMAP estiver definido em ulFlags.

pszImage

Tipo: LPTSTR

Endereço de uma cadeia de caracteres terminada em NULL que contém a URL da imagem de plano de fundo. Esse membro só será válido se o sinalizador de LVBKIF_SOURCE_URL estiver definido em ulFlags. Esse membro deve ser inicializado para apontar para o buffer que contém ou recebe o texto antes de enviar a mensagem.

cchImageMax

Tipo: UINT

Tamanho do buffer no endereço em pszImage. Se as informações estiverem sendo enviadas ao controle, esse membro será ignorado.

xOffsetPercent

Tipo: int

Porcentagem da área do cliente do controle de que a imagem deve ser deslocada horizontalmente. Por exemplo, em 0%, a imagem será exibida na borda esquerda da área do cliente do controle. Em 50%, a imagem será exibida horizontalmente centralizada na área do cliente do controle. Em 100%, a imagem será exibida na borda direita da área do cliente do controle. Esse membro só é válido quando LVBKIF_STYLE_NORMAL é especificado em ulFlags. Se LVBKIF_FLAG_TILEOFFSET e LVBKIF_STYLE_TILE forem especificados em ulFlags, o valor especifica o pixel, não o deslocamento percentual, do primeiro bloco. Caso contrário, o valor será ignorado.

yOffsetPercent

Tipo: int

Porcentagem da área do cliente do controle de que a imagem deve ser deslocada verticalmente. Por exemplo, em 0%, a imagem será exibida na borda superior da área do cliente do controle. Em 50%, a imagem será exibida verticalmente centralizada na área do cliente do controle. Em 100%, a imagem será exibida na borda inferior da área do cliente do controle. Esse membro só é válido quando LVBKIF_STYLE_NORMAL é especificado em ulFlags. Se LVBKIF_FLAG_TILEOFFSET e LVBKIF_STYLE_TILE forem especificados em ulFlags, o valor especifica o pixel, não o deslocamento percentual, do primeiro bloco. Caso contrário, o valor será ignorado.

Observações

Essa estrutura é usada com as mensagens LVM_GETBKIMAGE e LVM_SETBKIMAGE.

Nota

O cabeçalho commctrl.h define LVBKIMAGE como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho	commctrl.h