TTM_GETTOOLINFO 메시지

도구 설명 컨트롤이 도구에 대해 유지 관리하는 정보를 검색합니다.

매개 변수

wParam

0이어야 합니다.

lParam

TOOLINFO 구조체를 가리키는 포인터입니다. 메시지를 보낼 때 hwnd 및 uId 멤버는 도구를 식별하고, cbSize 멤버는 구조체의 크기를 지정해야 합니다. 이 메시지를 사용하여 도구 설명 텍스트를 검색하는 경우 TOOLINFO 구조체의 lpszText 멤버가 적절한 크기의 유효한 버퍼를 가리키는지 확인합니다.

반환 값

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

설명

도구 설명 컨트롤에 도구가 포함된 경우 TOOLINFO 구조체가 도구에 대한 정보를 받습니다.

예제

다음 예제에서는 도구 설명 컨트롤의 위치를 변경합니다.

HRESULT MyToolTipClass::OffsetTooltip(int xOffset, int yOffset)  
{  
    HRESULT hr = S_OK;   
    DWORD   dwError = 0;  
  
    if (NULL != m_hWndToolTip)  
    {  
        TOOLINFO ti = {0};  
  
        ti.cbSize = sizeof(TOOLINFO);  
        ti.hwnd   = m_hWndToolTipOwner;  
  
        // Get the current tooltip definition.          
        if( SendMessage(m_hWndToolTip, TTM_GETTOOLINFO, 0, (LPARAM)&ti))  
        {  
            // Offset the tooltip rectangle as specified.              
            OffsetRect(&ti.rect, xOffset, yOffset);  
  
            // Apply the new rectangle to the tooltip.
            SendMessage(m_hWndToolTip, TTM_NEWTOOLRECT, 0, (LPARAM)&ti);  
        }  
        else  
        {  
            dwError = GetLastError();  
            hr = HRESULT_FROM_WIN32(dwError);  
            MyErrorHandler(hr);
       }  
    }  
    return hr;  
}  

요구 사항

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