Jak implementovat sledovací popisky

Popisy sledování zůstávají viditelné, dokud nejsou aplikací výslovně uzavřeny, a mohou dynamicky měnit polohu na obrazovce. Podporují je verze 4.70 a novější běžné ovládací prvky.

Chcete-li vytvořit popis sledování, přidejte příznak TTF_TRACK do člena uFlags struktury TOOLINFO při odesílání zprávy TTM_ADDTOOL.

Aplikace musí ručně aktivovat (zobrazit) a deaktivovat (skrýt) popis sledování odesláním zprávy TTM_TRACKACTIVATE. I když je sledovací tool-tip aktivní, aplikace musí určit umístění tool-tipu odesláním TTM_TRACKPOSITION zpráv do ovládacího prvku tool-tipu. Protože aplikace zpracovává úkoly, jako je umístění popisků, sledovací popisky nepoužívají příznak TTF_SUBCLASS ani zprávu TTM_RELAYEVENT.

Zpráva TTM_TRACKPOSITION způsobí, že ovládací prvek popisu zobrazí okno pomocí jednoho ze dvou stylů umístění:

• Ve výchozím nastavení se popisek zobrazí vedle odpovídajícího nástroje na pozici, kterou určí ovládací prvek. Zvolené umístění je relativní vzhledem ke souřadnicím, které zadáte pomocí této zprávy.
• Pokud zahrnete hodnotu TTF_ABSOLUTE do členu struktury TOOLINFO, nápověda se zobrazí na pixelové pozici zadané ve zprávě. V tomto případě se ovládací prvek nepokouší změnit umístění okna popisu podle souřadnic, které zadáte.

Co potřebujete vědět

Technologie

• ovládací prvky Windows

Požadavky

• C/C++
• Programování uživatelského rozhraní systému Windows

Instrukce

Implementujte popisky In-Place

uFlags člen struktury TOOLINFO, která se používá v příkladu, obsahuje příznak TTF_ABSOLUTE. Bez tohoto příznaku si ovládací prvek tooltipu vybere, kde se má tooltip zobrazovat, a jeho umístění vzhledem k dialogovému oknu se může náhle změnit při pohybu ukazatele myši.

Následující příklad ukazuje, jak vytvořit ovládací prvek sledovacího popisku. Příklad určuje celou klientskou oblast hlavního okna jako nástroj.

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;
}
            

Implementace procedury okna

Když se ukazatel myši nachází v klientské oblasti, tooltip je aktivní a zobrazuje souřadnice kurzoru, jak je znázorněno na následujícím obrázku.

Následující příklad kódu je z procedury okna dialogového okna, které zobrazuje sledovací popisek vytvořený v předchozím příkladu. Globální booleovská proměnná g_TrackingMouse slouží k určení, zda je nutné znovu aktivovat nástrojovou tip a resetovat sledování myši tak, aby aplikace byla notifikována, když ukazatel myši opustí klientskou oblast dialogového okna.

//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;

Související témata

Používání ovládacích prvků s popisky