Come implementare le descrizioni comando per le icone della barra di stato

  • Articolo

Un modo non invasivo per visualizzare un messaggio esplicativo per un'icona della barra di stato consiste nell'implementare una descrizione comando. La descrizione comando scompare quando si fa clic, ma è anche possibile specificare un valore di timeout.

Informazioni importanti

Tecnologie

Prerequisiti

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

Istruzioni

Implementare le descrizioni comando per le icone della barra di stato

Il frammento di codice seguente illustra come aggiungere una descrizione comando a un'icona della barra di stato.

#define ARRAYSIZE(a) (sizeof(a)/sizeof(a[0]))

NOTIFYICONDATA IconData = {0};

IconData.cbSize = sizeof(IconData);
IconData.hWnd   = hwndNI;
IconData.uFlags = NIF_INFO;

HRESULT hr = StringCchCopy(IconData.szInfo, 
                           ARRAYSIZE(IconData.szInfo), 
                           TEXT("Your message text goes here."));

if(FAILED(hr))
{
  // TODO: Write an error handler in case the call to StringCchCopy fails.
}
IconData.uTimeout = 15000; // in milliseconds

Shell_NotifyIcon(NIM_MODIFY, &IconData);

Osservazioni:

Per una descrizione dettagliata della barra di stato, vedere Barra delle applicazioni.

Per visualizzare una descrizione comando balloon, è necessario impostare il flag NIF_INFO nella struttura NOTIFYICONDATA e usare i membri szInfo e uTimeout per specificare il testo della descrizione comando e la durata del timeout.

Uso dei controlli descrizione comando