LB_GETTEXTLEN сообщение

  • Статья

Возвращает длину строки в списке.

Параметры

wParam

Отсчитываемый от нуля индекс строки.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): параметр wParam ограничен 16-разрядными значениями. Это означает, что списки не могут содержать более 32 767 элементов. Хотя количество элементов ограничено, общий размер элементов в байтах в списке ограничен только доступной памятью.

lParam

Этот параметр не используется.

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

Возвращаемое значение — это длина строки в TCHAR, за исключением завершающего символа NULL. При определенных условиях это значение может быть больше длины текста. Дополнительные сведения см. в разделе "Примечания".

Если параметр wParam не указывает допустимый индекс, возвращаемое значение будет LB_ERR.

Комментарии

При определенных условиях возвращаемое значение больше фактической длины текста. Это происходит с определенными сочетаниями ANSI и Юникода и связано с тем, что операционная система допускает возможное существование двухбайтовых символов (DBCS) в тексте. Однако возвращаемое значение всегда будет по меньшей мере равно фактической длине текста; Таким образом, вы всегда можете использовать его для распределения буфера. Это может произойти, когда приложение использует как функции ANSI, так и общие диалоги, использующие Юникод.

Чтобы получить точную длину текста, используйте сообщения WM_GETTEXT, LB_GETTEXT или CB_GETLBTEXT или функцию GetWindowText .

Если список имеет стиль, нарисованный владельцем, но не стиль LBS_HASSTRINGS , возвращаемое значение всегда будет иметь размер DWORD в байтах.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2003 [только классические приложения]
Заголовок
Winuser.h (включая Windows.h)

См. также раздел

Справочные материалы

CB_GETLBTEXT

LB_GETTEXT

Другие ресурсы

GetWindowText

WM_GETTEXT