Shell_NotifyIcon

9/9/2008

Essa função envia uma mensagem para o sistema para adicionar, modificar ou excluir um ícone Application-specific de área de status barra de tarefas. Ela não afeta os ícones aparecendo na Tela doméstica.

Observação

Os ícones criados usando Shell_NotifyIcon desaparecerá após o processo de chamada é encerrado.Para um ícone para sobreviver além de cronograma do processo de chamada, ele deve ser criado através de SHNotificationAdd.

Syntax

WINSHELLAPI BOOL WINAPI Shell_NotifyIcon(
  DWORD dwMessage, 
  PNOTIFYICONDATA pnid 
);

Parameters

• dwMessage
  [no] Especifica o valor para enviar mensagem. A seguinte tabela mostra os valores possíveis.

  Valor	Descrição
  NIM_ADD	Adiciona um ícone à área de status.
  NIM_DELETE	Exclui um ícone da área de status.
  NIM_MODIFY	Modifica um ícone na área de status.

• pnid
  [no] Ponteiro para um NOTIFYICONDATA estrutura. O de conteúdo da estrutura depende de como o valor de dwMessage.

Return Value

Nonzero indica sucesso. Zero indica falha.

Exemplo de código

O seguinte exemplo de código demonstra como usar Shell_NotifyIcon.

Observação

Para fazer o seguinte exemplo de código mais fácil de ler, verificação de segurança e manipulação de erro não estão incluídos.Esta exemplo de código não deve ser usado em uma configuração versão a menos que ele foi modificado para incluí-las.

void Shell_NotifyIconExample()
{
    // Add a Shell_NotifyIcon notificaion
    NOTIFYICONDATA nid = {0};
    nid.cbSize         = sizeof(nid);
    nid.uID            = 100;      // Per Windows Embedded CE docs, values from 0 to 12 are reserved and should not be used.
    nid.uFlags         = NIF_ICON;
    nid.hIcon          = LoadIcon(g_hInstance, MAKEINTRESOURCE(IDI_SAMPLEICON));
    // Add the notification to the tray.
    Shell_NotifyIcon(NIM_ADD, &nid);
    // Update the notification icon.
    nid.uFlags         = NIF_ICON;
    nid.hIcon          = LoadIcon(g_hInstance, MAKEINTRESOURCE(IDI_SAMPLEICON2));
    Shell_NotifyIcon(NIM_MODIFY, &nid);
    // Remove the notification from the tray.
    Shell_NotifyIcon(NIM_DELETE, &nid);
    return;
}

Requirements

Header	shellapi.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

Shell Functions
NOTIFYICONDATA