TTM_ADJUSTRECT 메시지

해당 창 사각형 또는 지정된 텍스트 표시 사각형을 표시하는 데 필요한 도구 설명 창 사각형에서 도구 설명 컨트롤의 텍스트 표시 사각형을 계산합니다.

매개 변수

wParam

수행할 작업을 지정하는 값입니다. TRUE면 lParam을 사용하여 텍스트 표시 사각형을 지정하고 해당 창 사각형을 받습니다. FALSE면 lParam을 사용하여 창 사각형을 지정하고 해당 텍스트 표시 사각형을 받습니다.

lParam

도구 설명 창 사각형 또는 텍스트 표시 사각형을 저장할 RECT 구조체입니다.

반환 값

사각형이 성공적으로 조정되면 0이 아닌 값을 반환하고 오류가 발생하면 0을 반환합니다.

설명

이 메시지는 도구 설명 컨트롤을 사용하여 일반적으로 잘린 문자열의 전체 텍스트를 표시하려는 경우에 특히 유용합니다. 일반적으로 listview 및 treeview 컨트롤과 함께 사용됩니다. 일반적으로 도구 설명 컨트롤을 제대로 배치할 수 있도록 TTN_SHOW 알림 코드에 대한 응답으로 이 메시지를 보냅니다.

도구 설명 창 사각형은 도구 설명 문자열을 경계로 하는 텍스트 표시 사각형보다 약간 큽니다. 창 원점도 텍스트 표시 사각형의 원점에서 위쪽 및 왼쪽으로 오프셋됩니다. 텍스트 표시 사각형을 배치하려면 해당 창 사각형을 계산하고 해당 사각형을 사용하여 도구 설명의 위치를 지정해야 합니다. TTM_ADJUSTRECT이 계산을 처리합니다.

wParam을 TRUE로 설정하면 TTM_ADJUSTRECT는 원하는 도구 설명 텍스트 표시 사각형의 크기와 위치를 사용하고 지정된 위치에 텍스트를 표시하는 데 필요한 도구 설명 창의 크기와 위치를 다시 전달합니다. wParam을 FALSE로 설정하면 도구 설명 창 사각형을 지정할 수 있으며 TTM_ADJUSTRECT가 텍스트 사각형의 크기와 위치를 반환합니다.

다음 코드 조각에서는 TTM_ADJUSTRECT 메시지를 사용하여 잘린 문자열 대신 컨트롤 문자열의 전체 텍스트를 표시하는 도구 설명 컨트롤을 배치하는 방법을 보여 줍니다. 애플리케이션 정의 GetMyItemRect 함수는 잘린 문자열에 직접 도구 설명 텍스트를 표시하는 데 필요한 텍스트 사각형을 반환합니다. 이 함수를 구현하는 방법에 대한 세부 정보는 특정 컨트롤에 따라 달라집니다. TTM_ADJUSTRECT는 이 텍스트 사각형을 도구 설명 컨트롤로 보내는 데 사용됩니다. 적절한 크기 및 배치된 창 사각형을 반환한 다음 도구 설명 창을 배치하는 데 사용됩니다.

case TTN_SHOW:

if (MyStringIsTruncated) {
    RECT rc;
    
    GetMyItemRect(&rc);
    SendMessage(hwndToolTip, TTM_ADJUSTRECT, TRUE, (LPARAM)&rc);
    SetWindowPos(hwndToolTip,
                 NULL,
                 rc.left, rc.top,
                 0, 0,
                 SWP_NOSIZE|SWP_NOZORDER|SWP_NOACTIVATE);
} 

요구 사항

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