Compartilhar via


CFrameWnd::SetTaskbarOverlayIcon

Sobrecarregado. Aplica uma sobreposição a um botão da barra de tarefas para indicar o status do aplicativo ou para notificar o usuário.

BOOL SetTaskbarOverlayIcon(
   UINT nIDResource,
   LPCTSTR lpcszDescr
);
BOOL SetTaskbarOverlayIcon(
   HICON hIcon,
   LPCTSTR lpcszDescr
);

Parâmetros

  • nIDResource
    Especifica a identificação de recurso do ícone para usar como a sobreposição. Consulte a descrição para hIcon para obter detalhes.

  • lpcszDescr
    Um ponteiro para uma cadeia de caracteres que fornecesse uma versão de texto alternativo de informações transportou pela sobreposição, para fins de acessibilidade.

  • hIcon
    A alça de um ícone para usar como a sobreposição. Isso deve ser um ícone pequeno, medindo 16x16 pixels em 96 pontos por polegada (dpi). Se um ícone de sobreposição é aplicado ainda para o botão da barra de tarefas, a sobreposição existente é substituída. Esse valor pode ser NULL. Como um valor de NULL é tratado depende se o botão da barra de tarefas representa uma única janela ou um grupo do windows. É responsabilidade do aplicativo de chamada liberar hIcon quando ele não for necessário.

Valor de retorno

SeTRUE com êxito; FALSE se a versão do sistema operacional Windows é menor que 7 ou se ocorrer um erro definindo o ícone.

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

Classe CFrameWnd