Come implementare descrizioni comandi balloon

  • Articolo

Le descrizioni comando balloon sono simili alle descrizioni comando standard, ma vengono visualizzate in un fumetto "balloon" con un gambo che punta allo strumento. Le descrizioni comando balloon possono essere a riga singola o su più righe. Vengono creati e gestiti in modo analogo alle descrizioni comando standard.

La posizione predefinita dello stelo e del rettangolo è illustrata nella figura seguente. Se lo strumento è troppo vicino alla parte superiore dello schermo, la descrizione comando viene visualizzata sotto e a destra del rettangolo dello strumento. Se lo strumento è troppo vicino al lato destro dello schermo, si applicano principi simili, ma la descrizione comando appare a sinistra del rettangolo dello strumento.

screen shot of a dialog box; a balloon tooltip with one line of text appears above and to the right of the target

È possibile modificare il posizionamento predefinito impostando il flag TTF_CENTERTIP nel membro uFlags della struttura TOOLINFO della descrizione comando. In tal caso, lo stelo punta normalmente al centro del bordo inferiore del rettangolo dello strumento e il rettangolo di testo viene visualizzato direttamente sotto lo strumento. Lo stelo si collega al rettangolo di testo al centro del bordo superiore. Se lo strumento è troppo vicino alla parte inferiore dello schermo, il rettangolo di testo viene centrato sopra lo strumento e lo stelo si collega al centro del bordo inferiore.

La figura seguente mostra una descrizione comando centrata sullo strumento.

screen shot of a dialog box; a balloon tooltip with one line of text appears centered below the target

Se si desidera specificare dove punta lo stelo, impostare il flag TTF_TRACK nel membro uFlags della struttura TOOLINFO della descrizione comando. Specificare quindi la coordinata inviando un messaggio di TTM_TRACKPOSITION , con le coordinate x e y nel valore lParam . Se viene impostata anche TTF_CENTERTIP , lo stelo punta ancora alla posizione specificata dal messaggio TTM_TRACKPOSITION .

Informazioni importanti

Tecnologie

Prerequisiti

  • C/C++
  • Programmazione dell'interfaccia utente di Windows

Istruzioni

Implementare descrizioni comando balloon

Nel codice di esempio seguente viene illustrato come implementare una descrizione comando per il fumetto centrato usando lo stile di controllo della descrizione comando TTS_BALLOON .

hwndToolTips = CreateWindow(TOOLTIPS_CLASS, NULL, 
                            WS_POPUP | TTS_NOPREFIX | TTS_BALLOON, 
                            0, 0, 0, 0, NULL, NULL, g_hinst, NULL);

if (hwndTooltip)
{
    TOOLINFO ti;

    ti.cbSize   = sizeof(ti);
    ti.uFlags   = TTF_TRANSPARENT | TTF_CENTERTIP;
    ti.hwnd     = hwnd;
    ti.uId      = 0;
    ti.hinst    = NULL;
    ti.lpszText = LPSTR_TEXTCALLBACK;

    GetClientRect(hwnd, &ti.rect);

    SendMessage(hwndToolTips, TTM_ADDTOOL, 0, (LPARAM) &ti );

}

Uso dei controlli descrizione comando

Stili descrizione comando