macro ListView_SetColumnWidth (commctrl.h)

  • Artigo

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

void ListView_SetColumnWidth(
   hwnd,
   iCol,
   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.

Retornar valor

Nenhum

Comentários

Suponha que você tenha um controle de exibição de lista de duas 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
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]
Plataforma de Destino Windows
Cabeçalho commctrl.h