Como implementar dicas de ferramentas para ícones da barra de status

  • Artigo

Uma maneira não intrusiva de exibir uma mensagem explicativa para um ícone da barra de status é implementar uma dica de ferramenta. A dica de ferramenta desaparece quando clicada, mas você também pode especificar um valor de tempo limite.

O que você precisa saber

Tecnologias

Pré-requisitos

  • C/C++
  • Programação da interface do usuário do Windows

Instruções

Implementar dicas de ferramentas para ícones da barra de status

O fragmento de código a seguir ilustra como adicionar uma dica de ferramenta de balão a um ícone da barra de status.

#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);

Comentários

Para obter uma discussão detalhada da barra de status, consulte A barra de tarefas.

Para exibir uma dica de ferramenta de balão, você precisa definir o sinalizador NIF_INFO na estrutura NOTIFYICONDATA e usar os membros szInfo e uTimeout para especificar o texto da dica de ferramenta e a duração do tempo limite.

Usando controles de dica de ferramenta