Поделиться через


макрос ListView_SetColumnWidth (commctrl.h)

Используется для изменения ширины столбца в представлении отчета или ширины всех столбцов в режиме представления списка. Этот макрос можно использовать или явно отправить сообщение LVM_SETCOLUMNWIDTH.

Синтаксис

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

Параметры

hwnd

Тип: HWND

Дескриптор элемента управления "Представление списка".

iCol

Тип: int

Отсчитываемый от нуля индекс допустимого столбца. Для режима представления списка этот параметр должен иметь значение нулю.

cx

Тип: int

Новая ширина столбца в пикселях. Для режима представления отчета поддерживаются следующие специальные значения:

Ценность Значение
LVSCW_AUTOSIZE
Автоматически размер столбца.
LVSCW_AUTOSIZE_USEHEADER
Автоматически размер столбца в соответствии с текстом заголовка. Если вы используете это значение с последним столбцом, его ширина задается для заполнения оставшейся ширины элемента управления представлением списка.

Возвращаемое значение

Тип: BOOL

Возвращает TRUE, если выполнено успешно или FALSE в противном случае.

Замечания

Предположим, что у вас есть элемент управления списка с 2 столбцами с шириной 500 пикселей. Если для ширины столбца нулю задано значение 200 пикселей, и выполните следующий вызов.

ListView_SetColumnWidth(hwnd, 1, LVSCW_AUTOSIZE_USEHEADER)

Второй (и последний) столбец будет иметь ширину 300 пикселей.

Обратите внимание, что ListView_SetColumnWidth преобразует параметр cx в 16-разрядное значение.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Vista [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
целевая платформа Виндоус
заголовка commctrl.h