Compartilhar via


Tratamento de notificação de TTN_NEEDTEXT de dicas de ferramenta

Como parte do Ativar dicas de ferramenta, lidar com o TTN_NEEDTEXT mensagem, adicionando a seguinte entrada ao mapa da mensagem da janela do proprietário:

ON_NOTIFY_EX(TTN_NEEDTEXT, 0, &CMyDialog::OnTtnNeedText)
  • memberFxn
    A função de membro a ser chamado quando o texto é necessário para este botão.

Observe que a identificação de uma dica de ferramenta é sempre 0.

Declare a função do manipulador na definição de classe da seguinte maneira:

afx_msg BOOL OnTtnNeedText(UINT id, NMHDR *pNMHDR, LRESULT *pResult);

onde os parâmetros em itálico são:

  • id
    Identificador do controle que enviou a notificação.Não usado.A id do controle é tirada do NMHDR estrutura.

  • pNMHDR
    Um ponteiro para o NMTTDISPINFO estrutura.Essa estrutura também é discutida mais na A estrutura TOOLTIPTEXT.

  • pResult
    Um ponteiro para o código de resultado que você pode definir antes de retornar.TTN_NEEDTEXT manipuladores podem ignorar o pResult parâmetro.

Como um exemplo de um manipulador de notificação do modo de formulário:

BOOL CMyDialog::OnTtnNeedText(UINT id, NMHDR *pNMHDR, LRESULT *pResult)
{
   UNREFERENCED_PARAMETER(id);

   NMTTDISPINFO *pTTT = (NMTTDISPINFO *) pNMHDR;
   UINT_PTR nID = pNMHDR->idFrom;
   BOOL bRet = FALSE;

   if (pTTT->uFlags & TTF_IDISHWND)
   {
      // idFrom is actually the HWND of the tool
      nID = ::GetDlgCtrlID((HWND)nID);
      if(nID)
      {
         _stprintf_s(pTTT->szText, sizeof(pTTT->szText) / sizeof(TCHAR), 
            _T("Control ID = %d"), nID);
         pTTT->hinst = AfxGetResourceHandle();
         bRet = TRUE;
      }
   }

   *pResult = 0;

   return bRet;
}

Chamar EnableToolTips (este fragmento extraído do OnInitDialog):

EnableToolTips(TRUE);

Consulte também

Conceitos

Dicas de ferramenta no Windows não derivada de CFrameWnd