ListView_SetColumnWidth macro (commctrl.h)

Artigo
10/24/2024

Usado para alterar a largura de uma coluna no modo de exibição de relatório ou a largura de todas as colunas no modo de exibição de lista. Você pode usar essa macro ou enviar a mensagem LVM_SETCOLUMNWIDTH explicitamente.

Sintaxe

BOOL ListView_SetColumnWidth(
   HWND hwnd,
   int  iCol,
   int  cx
);

Parâmetros

hwnd

Tipo: HWND

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

iCol

Tipo: int

O índice baseado em zero de uma coluna válida. Para o modo de exibição de lista, esse parâmetro deve ser definido como zero.

cx

Tipo: int

A nova largura da coluna, em pixels. Para o modo de exibição de relatório, há suporte para os seguintes valores especiais:

Valor	Significado
LVSCW_AUTOSIZE	Dimensiona automaticamente a coluna.
LVSCW_AUTOSIZE_USEHEADER	Dimensiona automaticamente a coluna para ajustar o texto do cabeçalho. Se você usar esse valor com a última coluna, sua largura será definida para preencher a largura restante do controle de exibição de lista.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

Suponha que você tenha um controle de exibição de lista de 2 colunas com uma largura de 500 pixels. Se a largura da coluna zero estiver definida como 200 pixels e você fizer a chamada a seguir.

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

A segunda (e última) coluna terá 300 pixels de largura.

Observe que ListView_SetColumnWidth converte o parâmetro cx em um valor de 16 bits.

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