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 [데스크톱 앱만 해당] |
헤더 |
|