SB_GETTEXT 메시지

상태 창의 지정된 부분에서 텍스트를 검색합니다.

매개 변수

wParam

텍스트를 검색할 파트의 인덱스(0부터 시작)입니다.

lParam

텍스트를 null로 끝나는 문자열로 수신하는 버퍼에 대한 포인터입니다. SB_GETTEXTLENGTH 메시지를 사용하여 버퍼의 필요한 크기를 확인합니다.

반환 값

두 개의 16비트 값으로 구성된 32비트 값을 반환합니다. 하위 단어는 텍스트의 길이를 문자로 지정합니다. 높은 단어는 텍스트를 그리는 데 사용되는 작업 형식을 지정합니다. 형식은 다음 값 중 하나일 수 있습니다.

반환 코드	설명
0	텍스트가 창 평면보다 아래쪽에 표시되도록 테두리와 함께 그려집니다.
SBT_NOBORDERS	텍스트가 테두리 없이 그려집니다.
SBT_POPOUT	텍스트가 창의 평면보다 높게 표시되도록 테두리와 함께 그려집니다.
SBT_RTLREADING	텍스트는 부모 창에서 텍스트의 반대 방향으로 표시됩니다.

설명

보안 경고: 이 메시지를 잘못 사용하면 프로그램의 보안이 손상될 수 있습니다. 이 메시지는 버퍼 크기를 알 수 있는 방법을 제공하지 않습니다. 이 메시지를 사용하는 경우 먼저 SB_GETTEXTLENGTH를 호출하여 필요한 문자 수를 가져온 다음 메시지를 호출하여 문자열을 검색합니다. SB_GETTEXT를 호출하기 전에 기다리면 텍스트가 변경되어 SB_GETTEXTLENGTH의 반환 값이 무효화됩니다. 계속하기 전에 보안 고려 사항: Microsoft Windows 컨트롤을 검토해야 합니다.

이 메시지는 최대 65,535자를 반환합니다. 텍스트 문자열이 그보다 길면 잘립니다.

텍스트에 SBT_OWNERDRAW 그리기 형식이 있는 경우 이 메시지는 길이 및 작업 유형 대신 텍스트와 연결된 32비트 값을 반환합니다.

일반 창은 텍스트를 왼쪽에서 오른쪽(LTR)으로 표시합니다. 오른쪽에서 왼쪽으로 읽는(RTL) 히브리어 또는 아랍어와 같은 언어를 표시하도록 Windows를 미러링할 수 있습니다. SBT_RTLREADING이 설정되면 lParam 문자열은 부모 창의 텍스트와 반대 방향으로 읽힙니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Commctrl.h
유니코드 및 ANSI 이름	SB_GETTEXTW (유니코드) 및 SB_GETTEXTA(ANSI)

추가 정보

SB_SETTEXT