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 em segundo plano.
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 |
|---|---|
|
O controle de exibição de lista não tem nenhuma imagem de plano de fundo. |
|
Um bitmap em segundo plano é fornecido por meio do membro hbm de LVBKIMAGE. Se a mensagem LVM_SETBKIMAGE for bem-sucedida, a exibição de lista assumirá a propriedade do bitmap. |
|
O membro pszImage contém a URL da imagem de plano de fundo. |
|
A imagem de plano de fundo é exibida normalmente. |
|
A imagem de plano de fundo será lado a lado para preencher toda a tela de fundo do controle. |
|
Especifique as coordenadas do primeiro bloco. Esse sinalizador só será válido se o sinalizador 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. |
|
Um bitmap de fundo de marca d'água é fornecido por meio do membro hbm de LVBKIMAGE. Se a mensagem LVM_SETBKIMAGE for bem-sucedida, o controle de exibição de lista assumirá a propriedade do bitmap. |
|
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 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 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 para o controle, esse membro será ignorado.
xOffsetPercent
Tipo: int
Percentual da área de cliente do controle 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 de 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 especificará o pixel, não o deslocamento percentual, do primeiro bloco. Caso contrário, o valor será ignorado.
yOffsetPercent
Tipo: int
Percentual da área de cliente do controle 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 de cliente do controle. Em 100%, a imagem será exibida na borda inferior da área de 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 especificará o pixel, não o deslocamento percentual, do primeiro bloco. Caso contrário, o valor será ignorado.
Comentários
Essa estrutura é usada com as mensagens LVM_GETBKIMAGE e LVM_SETBKIMAGE .
Observação
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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | commctrl.h |