Метод ITextHost::TxGetMaxLength (textserv.h)

Статья
08/26/2023

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

Синтаксис

HRESULT TxGetMaxLength(
  DWORD *plength
);

Параметры

plength

Тип: DWORD*

Максимально допустимая длина текста в количестве символов. Если возвращается infinite, объект текстовых служб может использовать столько памяти, сколько необходимо для хранения любого указанного текста.

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

Тип: HRESULT

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

При достижении этого максимального значения объект текстовых служб должен отклонять любые дальнейшие вставки символов и вставленный текст. Однако TxSetText по-прежнему должен принимать (и задавать) текст, превышающий максимальную длину. Это связано с тем, что этот метод используется для привязки и имеет решающее значение для поддержания целостности данных, к которым привязан элемент управления.

Этот метод выполняет параллель с EM_LIMITTEXT сообщением.

Если возвращаемое ограничение меньше числа символов в объекте служб текста, данные не теряются. Вместо этого редактирование текста, кроме удаления, не допускается до тех пор, пока текст не будет меньше предела.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	textserv.h
DLL	Msftedit.dll