WM_GETTEXT 메시지

창에 해당하는 텍스트를 호출자가 제공하는 버퍼에 복사합니다.

#define WM_GETTEXT                      0x000D

매개 변수

wParam

종료 null 문자를 포함하여 복사할 최대 문자 수입니다.

ANSI 애플리케이션은 ANSI에서 유니코드로의 변환으로 인해 버퍼의 문자열 크기( wParam 값의 절반 이상)를 줄일 수 있습니다.

lParam

텍스트를 받을 버퍼에 대한 포인터입니다.

반환 값

형식: LRESULT

반환 값은 종료되는 null 문자를 포함하지 않고 복사된 문자 수입니다.

설명

DefWindowProc 함수는 창과 연결된 텍스트를 지정된 버퍼에 복사하고 복사된 문자 수를 반환합니다. 텍스트가 아닌 정적 컨트롤의 경우 컨트롤이 원래 만들어진 텍스트, 즉 ID 번호를 제공합니다. 그러나 원래 만든 대로 텍스트가 아닌 정적 컨트롤의 ID를 제공합니다. 즉, 이후에 STM_SETIMAGE 사용하여 변경한 경우 원래 ID가 계속 반환됩니다.

편집 컨트롤의 경우 복사할 텍스트는 편집 컨트롤의 내용입니다. 콤보 상자의 경우 텍스트는 콤보 상자의 편집 컨트롤(또는 정적 텍스트) 부분의 내용입니다. 단추의 경우 텍스트는 단추 이름입니다. 다른 창의 경우 텍스트는 창 제목입니다. 목록 상자에서 항목의 텍스트를 복사하려면 애플리케이션에서 LB_GETTEXT 메시지를 사용할 수 있습니다.

WM_GETTEXT 메시지가 SS_ICON 스타일을 사용하여 정적 컨트롤로 전송되면 아이콘에 대한 핸들이 lParam이 가리키는 버퍼의 처음 4바이트에서 반환됩니다. WM_SETTEXT 메시지를 사용하여 아이콘을 설정한 경우에만 적용됩니다.

서식 있는 편집: 복사할 텍스트가 64K를 초과하는 경우 EM_STREAMOUT 또는 EM_GETSELTEXT 메시지를 사용합니다.

정적 비트맵 또는 정적 아이콘 컨트롤과 같은 텍스트가 아닌 정적 컨트롤에 WM_GETTEXT 메시지를 보내면 문자열 값이 반환되지 않습니다. 대신 0을 반환합니다. 또한 초기 버전의 Windows에서 애플리케이션은 텍스트가 아닌 정적 컨트롤에 WM_GETTEXT 메시지를 보내 컨트롤의 ID를 검색할 수 있습니다. 컨트롤의 ID를 검색하기 위해 애플리케이션은 GWLP_ID 사용하여 GetWindowLong 전달 GWL_ID 인덱스 값 또는 GetWindowLongPtr을 사용할 수 있습니다.

요구 사항

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

추가 정보

참조

DefWindowProc

GetWindowLong

GetWindowLongPtr

GetWindowText

GetWindowTextLength

WM_GETTEXTLENGTH

WM_SETTEXT

개념

Windows

기타 리소스

EM_GETSELTEXT

EM_STREAMOUT

LB_GETTEXT