ListView_SetIconSpacing macro (commctrl.h)

Artigo
10/24/2024

Define o espaçamento entre ícones em controles de exibição de lista definidos como o estilo LVS_ICON. Você pode usar essa macro ou enviar a mensagem LVM_SETICONSPACING explicitamente.

Sintaxe

DWORD ListView_SetIconSpacing(
   HWND hwndLV,
   int  cx,
   int  cy
);

Parâmetros

hwndLV

Tipo: HWND

Um identificador para um controle de exibição de lista.

cx

Tipo: int

A distância, em pixels, a ser definida entre ícones no eixo x.

cy

Tipo: int

A distância, em pixels, para definir entre ícones no eixo y.

Valor de retorno

Tipo: DWORD

Retorna um valor DWORD que contém o valor anterior

Observações

Os parâmetros cx e cy são relativos ao canto superior esquerdo de um bitmap de ícone. Portanto, para definir o espaçamento entre ícones que não se sobrepõem, os valores cx ou cy devem incluir o tamanho do ícone, além da quantidade de espaço vazio desejado entre ícones. Valores que não incluem a largura do ícone resultarão em sobreposições.

Ao definir o espaçamento do ícone, cx e cy devem ser definidos como 4 ou maiores. Valores menores não produzirão o layout desejado. Você pode redefinir cx e cy para o espaçamento padrão definindo ambos os valores como -1. Essa abordagem só permite que você redefina ambas as configurações padrão. Você não pode redefinir apenas cx ou cy para a configuração padrão definindo um deles como -1.

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]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h

Compartilhar via