SB_SETTEXT 메시지

상태 창의 지정된 파트에 텍스트를 설정합니다.

매개 변수

wParam

하위 단어의 LOBYTE는 설정할 파트의 인덱스(0부터 시작)를 지정합니다. LOBYTE가 SB_SIMPLEID로 설정된 경우 상태 창은 단순 모드 상태 표시줄로 간주됩니다. 즉, 한 파트만 있는 상태 표시줄입니다.

하위 단어의 HIBYTE는 그리기 작업의 형식을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

wParam의 상위 단어는 무시됩니다.

값	의미
0	텍스트가 창 평면보다 아래쪽에 표시되도록 테두리와 함께 그려집니다.
SBT_NOBORDERS	텍스트가 테두리 없이 그려집니다.
SBT_OWNERDRAW	텍스트가 부모 창에서 그려집니다. 참고: 단순 모드 상태 막대는 소유자 그리기를 지원하지 않습니다.
SBT_POPOUT	텍스트가 창의 평면보다 높게 표시되도록 테두리와 함께 그려집니다.
SBT_RTLREADING	텍스트가 부모 창의 텍스트와 반대 방향으로 표시됩니다.
SBT_NOTABPARSING	탭 문자는 무시됩니다.

lParam

설정할 텍스트를 지정하는 null 종료 문자열에 대한 포인터입니다. wParam이 SBT_OWNERDRAW인 경우 이 매개 변수는 32비트 데이터를 나타냅니다. 부모 창은 WM_DRAWITEM 메시지를 수신하면 데이터를 해석하고 텍스트를 그려야 합니다.

반환 값

성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다.

설명

이 메시지는 변경된 창 부분을 무효화하여 다음에 창이 WM_PAINT 메시지를 수신할 때 새 텍스트를 표시하도록 합니다.

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

요구 사항

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

추가 정보

SB_GETTEXT