commctrl.h

Macro ListView_SetColumnWidth

Usada para modificar la anchura de una columna en vista de reporte o la anchura de todas las columnas en modo list-view. Se puede usar esta macro o enviar el mensaje LVM_SETCOLUMNWIDTH explícitamente.

Definición

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

Descripción

hwnd
Un manipulador del control list-view.
iCol
El índice basado en cero de una columna válida. Para el modo list-view, este parámetro debe ser puesto a cero.
cx

La nueva anchura de la columna, en pixels. Para el modo reporte están soportados los siguientes valores especiales:

ValorSignificado
LVSCW_AUTOSIZEAsigna la anchura de la columna automáticamente.
LVSCW_AUTOSIZE_USEHEADERAsigna la anchura de la columna automáticamente para la anchura del texto de la cabecera. Si se usa este valor con la última columna, su anchura es asignada para llenar la anchura restante en el control list-view.

Valor de retorno

Devuelve TRUE si tiene éxito, o FALSE en caso contrario.

Observaciones

Asumiendo que tenemos un control list-view con una anchura de 500 pixels y dos columnas, si asignamos 200 pixels de anchura a la columna cero, y se hace la siguiente llamada:

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

La segunda (y última) columna tendrá 300 pixels de anchura.

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