EM_SETLIMITTEXT 메시지

  • 아티클

편집 컨트롤의 텍스트 제한을 설정합니다. 텍스트 제한은 사용자가 편집 컨트롤에 입력할 수 있는 TCHAR 단위의 최대 텍스트 양입니다. 이 메시지를 편집 컨트롤 또는 서식 있는 편집 컨트롤로 보낼 수 있습니다.

편집 컨트롤 및 Microsoft Rich Edit 1.0의 경우 바이트가 사용됩니다. Microsoft Rich Edit 2.0 이상의 경우 문자가 사용됩니다.

EM_SETLIMITTEXT 메시지는 EM_LIMITTEXT 메시지와 동일합니다.

매개 변수

wParam

사용자가 입력할 수 있는 최대 TCHAR 수입니다. ANSI 텍스트의 경우 바이트 수입니다. 유니코드 텍스트의 경우 문자 수입니다. 이 숫자에는 종료 Null 문자가 포함되지 않습니다.

서식 있는 편집 컨트롤: 이 매개 변수가 0이면 텍스트 길이가 64,000자로 설정됩니다.

이 매개 변수가 0이면 텍스트 길이는 한 줄 편집 컨트롤의 경우 0x7FFFFFFE 문자로 설정되고 여러 줄 편집 컨트롤의 경우 1로 설정됩니다.

lParam

이 매개 변수는 사용되지 않습니다.

반환 값

이 메시지는 값을 반환하지 않습니다.

설명

EM_SETLIMITTEXT 메시지는 사용자가 입력할 수 있는 텍스트만 제한합니다. 메시지가 전송될 때 편집 컨트롤에 이미 있는 텍스트에는 영향을 주지 않으며 WM_SETTEXT 메시지에 의해 편집 컨트롤에 복사된 텍스트의 길이에도 영향을 주지 않습니다. 애플리케이션이 WM_SETTEXT 메시지를 사용하여 EM_SETLIMITTEXT 메시지에 지정된 것보다 더 많은 텍스트를 편집 컨트롤에 배치하는 경우 사용자는 편집 컨트롤의 전체 콘텐츠를 편집할 수 있습니다.

EM_SETLIMITTEXT가 호출되기 전에 사용자가 편집 컨트롤에 입력할 수 있는 텍스트 양의 기본 제한은 32,767자입니다.

한 줄 편집 컨트롤의 경우 텍스트 제한은 0x7FFFFFFE 바이트 또는 wParam 매개 변수 값 중 더 작은 값입니다. 여러 줄 편집 컨트롤의 경우 이 값은 1바이트 또는 wParam 매개 변수 값 중 더 작은 값입니다.

서식 있는 편집: Microsoft Rich Edit 1.0 이상에서 지원됩니다. 64,000보다 큰 텍스트 길이 값에는 EM_EXLIMITTEXT 메시지를 사용합니다. Rich Edit 버전과 다양한 시스템 버전의 호환성에 대한 자세한 내용은 서식 있는 편집 컨트롤 정보를 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
헤더
Winuser.h(Windows.h 포함)

추가 정보

EM_GETLIMITTEXT