추적 도구 설명을 구현하는 방법

  • 아티클

추적 도구 설명은 애플리케이션에서 명시적으로 닫을 때까지 계속 표시되며 화면에서 위치를 동적으로 변경할 수 있습니다. 공용 컨트롤의 버전 4.70 이상에서 지원됩니다.

추적 도구 설명을 만들려면 TTM_ADDTOOL 메시지를 보낼 때 TOOLINFO 구조체의 uFlags 멤버에 TTF_TRACK 플래그를 포함합니다.

애플리케이션은 TTM_TRACKACTIVATE 메시지를 전송하여 추적 도구 설명을 수동으로 활성화(표시) 및 비활성화(숨기기)해야 합니다. 추적 도구 설명이 활성화되어 있는 동안 애플리케이션은 도구 설명 컨트롤에 TTM_TRACKPOSITION 메시지를 전송하여 도구 설명의 위치를 지정해야 합니다. 애플리케이션이 도구 설명 배치와 같은 작업을 처리하기 때문에 추적 도구 설명은 TTF_SUBCLASS 플래그 또는 TTM_RELAYEVENT 메시지를 사용하지 않습니다.

TTM_TRACKPOSITION 메시지는 도구 설명 컨트롤이 두 가지 배치 스타일 중 하나를 사용하여 창을 표시하도록 합니다.

  • 기본적으로 도구 설명은 컨트롤이 선택한 위치에서 해당 도구 옆에 표시됩니다. 선택한 위치는 이 메시지를 사용하여 제공한 좌표를 기준으로 합니다.
  • TOOLINFO 구조체의 멤버에 TTF_ABSOLUTE 값을 포함하면 메시지에 지정된 픽셀 위치에 도구 설명이 표시됩니다. 이 경우 컨트롤은 제공한 좌표에서 도구 설명 창의 위치를 변경하려고 시도하지 않습니다.

알아야 하는 작업

기술

필수 구성 요소

  • C/C++
  • Windows 사용자 인터페이스 프로그래밍

지침

현재 위치 도구 설명 구현

예에서 사용된 TOOLINFO 구조체의 uFlags 멤버에는 TTF_ABSOLUTE 플래그가 포함되어 있습니다. 이 플래그가 없으면 도구 설명 컨트롤은 도구 설명을 표시할 위치를 선택하고 대화 상자에 상대적인 위치는 마우스 포인터가 움직일 때 갑자기 변경될 수 있습니다.

참고

g_toolItem은 글로벌 TOOLINFO 구조체입니다.

 

다음 예에서는 추적 도구 설명 컨트롤을 만드는 방법을 보여 줍니다. 이 예에서는 주 창의 전체 클라이언트 영역을 도구로 지정합니다.

HWND CreateTrackingToolTip(int toolID, HWND hDlg, WCHAR* pText)
{
    // Create a tooltip.
    HWND hwndTT = CreateWindowEx(WS_EX_TOPMOST, TOOLTIPS_CLASS, NULL, 
                                 WS_POPUP | TTS_NOPREFIX | TTS_ALWAYSTIP, 
                                 CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, CW_USEDEFAULT, 
                                 hDlg, NULL, g_hInst,NULL);

    if (!hwndTT)
    {
      return NULL;
    }

    // Set up the tool information. In this case, the "tool" is the entire parent window.
    
    g_toolItem.cbSize   = sizeof(TOOLINFO);
    g_toolItem.uFlags   = TTF_IDISHWND | TTF_TRACK | TTF_ABSOLUTE;
    g_toolItem.hwnd     = hDlg;
    g_toolItem.hinst    = g_hInst;
    g_toolItem.lpszText = pText;
    g_toolItem.uId      = (UINT_PTR)hDlg;
    
    GetClientRect (hDlg, &g_toolItem.rect);

    // Associate the tooltip with the tool window.
    
    SendMessage(hwndTT, TTM_ADDTOOL, 0, (LPARAM) (LPTOOLINFO) &g_toolItem); 
    
    return hwndTT;
}

창 프로시저 구현

마우스 포인터가 클라이언트 영역 내에 있으면 다음 그림과 같이 도구 설명이 활성화되고 커서 좌표가 표시됩니다.

screen shot of a dialog box; a tooltip shows the x and y coordinates of the mouse pointer

다음 코드 예는 이전 예에서 만든 추적 도구 설명을 표시하는 대화 상자의 창 프로시저에서 가져온 것입니다. 전역 부울 변수 g_TrackingMouse는 도구 설명을 다시 활성화하고 마우스 추적을 초기화해야 마우스 포인터가 대화 상자의 클라이언트 영역을 벗어날 때 애플리케이션에 알릴지 여부를 결정하는 데 사용됩니다.

//g_hwndTrackingTT is a global HWND variable

case WM_INITDIALOG:

        InitCommonControls();
        g_hwndTrackingTT = CreateTrackingToolTip(IDC_BUTTON1, hDlg, L"");
        return TRUE;

case WM_MOUSELEAVE: // The mouse pointer has left our window. Deactivate the tooltip.
    
    SendMessage(g_hwndTrackingTT, TTM_TRACKACTIVATE, (WPARAM)FALSE, (LPARAM)&g_toolItem);
    g_TrackingMouse = FALSE;
    return FALSE;

case WM_MOUSEMOVE:

    static int oldX, oldY;
    int newX, newY;

    if (!g_TrackingMouse)   // The mouse has just entered the window.
    {                       // Request notification when the mouse leaves.
    
        TRACKMOUSEEVENT tme = { sizeof(TRACKMOUSEEVENT) };
        tme.hwndTrack       = hDlg;
        tme.dwFlags         = TME_LEAVE;
        
        TrackMouseEvent(&tme);

        // Activate the tooltip.
        SendMessage(g_hwndTrackingTT, TTM_TRACKACTIVATE, (WPARAM)TRUE, (LPARAM)&g_toolItem);
        
        g_TrackingMouse = TRUE;
    }

    newX = GET_X_LPARAM(lParam);
    newY = GET_Y_LPARAM(lParam);

    // Make sure the mouse has actually moved. The presence of the tooltip 
    // causes Windows to send the message continuously.
    
    if ((newX != oldX) || (newY != oldY))
    {
        oldX = newX;
        oldY = newY;
            
        // Update the text.
        WCHAR coords[12];
        swprintf_s(coords, ARRAYSIZE(coords), L"%d, %d", newX, newY);
        
        g_toolItem.lpszText = coords;
        SendMessage(g_hwndTrackingTT, TTM_SETTOOLINFO, 0, (LPARAM)&g_toolItem);

        // Position the tooltip. The coordinates are adjusted so that the tooltip does not overlap the mouse pointer.
        
        POINT pt = { newX, newY }; 
        ClientToScreen(hDlg, &pt);
        SendMessage(g_hwndTrackingTT, TTM_TRACKPOSITION, 0, (LPARAM)MAKELONG(pt.x + 10, pt.y - 20));
    }
    return FALSE;

도구 설명 컨트롤 사용