macro ListView_SetColumnWidth (commctrl.h)

Se usa para cambiar el ancho de una columna en la vista de informe o el ancho de todas las columnas en modo de vista de lista. Puede usar esta macro o enviar el mensaje LVM_SETCOLUMNWIDTH explícitamente.

Sintaxis

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

Parámetros

hwnd

Tipo: HWND

Identificador del control list-view.

iCol

Tipo: int

Índice de base cero de una columna válida. Para el modo de vista de lista, este parámetro debe establecerse en cero.

cx

Tipo: int

Nuevo ancho de la columna, en píxeles. Para el modo de vista de informes, se admiten los siguientes valores especiales:

Valor Significado
LVSCW_AUTOSIZE
Cambia automáticamente el tamaño de la columna.
LVSCW_AUTOSIZE_USEHEADER
Ajusta automáticamente el tamaño de la columna para ajustar el texto del encabezado. Si usa este valor con la última columna, su ancho se establece para rellenar el ancho restante del control list-view.

Valor devuelto

Tipo: BOOL de

Devuelve TRUE si se ejecuta correctamente o FALSE de lo contrario.

Observaciones

Supongamos que tiene un control de vista de lista de 2 columnas con un ancho de 500 píxeles. Si el ancho de la columna cero se establece en 200 píxeles y realiza la siguiente llamada.

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

La segunda columna (y la última) tendrá un ancho de 300 píxeles.

Tenga en cuenta que ListView_SetColumnWidth convierte el parámetro cx en un valor de 16 bits.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de commctrl.h