Compartilhar via

Estrutura NMTTDISPINFOA (commctrl.h)

  • Artigo

Contém informações usadas no tratamento do código de notificação TTN_GETDISPINFO. Essa estrutura substitui a estrutura TOOLTIPTEXT.

Sintaxe

typedef struct tagNMTTDISPINFOA {
  NMHDR     hdr;
  LPSTR     lpszText;
  char      szText[80];
  HINSTANCE hinst;
  UINT      uFlags;
  LPARAM    lParam;
} NMTTDISPINFOA, *LPNMTTDISPINFOA;

Membros

hdr

Tipo: NMHDR

estrutura de NMHDR que contém informações adicionais sobre a notificação.

lpszText

Tipo: LPTSTR

Ponteiro para uma cadeia de caracteres terminada em nulo que será exibida como o texto da dica de ferramenta. Se especificar um identificador de instância, esse membro deverá ser o identificador de um recurso de cadeia de caracteres.

szText[80]

Tipo: TCHAR

Buffer que recebe o texto da dica de ferramenta. Um aplicativo pode copiar o texto para esse buffer em vez de especificar um endereço de cadeia de caracteres ou um recurso de cadeia de caracteres. Para obter um texto de dica de ferramenta que exceda 80 deTCHAR, consulte os comentários na seção de comentários deste documento.

hinst

Tipo: HINSTANCE

Manipule para a instância que contém um recurso de cadeia de caracteres a ser usado como o texto da dica de ferramenta. Se lpszText for o endereço da cadeia de caracteres de texto da dica de ferramenta, esse membro deverá ser NULL.

uFlags

Tipo: UINT

Sinalizadores que indicam como interpretar o idFrom membro da estrutura de NMHDR de incluída.

Valor Significado
TTF_IDISHWND
 Se esse sinalizador estiver definido, idFrom será o identificador da ferramenta. Caso contrário, ele é o identificador da ferramenta.
TTF_RTLREADING
 As janelas podem ser espelhadas para exibir idiomas como hebraico ou árabe que leem da direita para a esquerda (RTL). Normalmente, o texto da dica de ferramenta é lido na mesma direção que o texto em sua janela pai. Para que uma dica de ferramenta seja lida na direção oposta da janela pai, adicione o sinalizador TTF_RTLREADING ao membro uFlags ao processar a notificação.
TTF_DI_SETITEM

versão 4.70. Se você adicionar esse sinalizador ao uFlags durante o processamento da notificação, o controle de dica de ferramenta manterá as informações fornecidas e não a solicitará novamente.

lParam

Tipo: LPARAM

versão 4.70. Dados definidos pelo aplicativo associados à ferramenta.

Observações

Você precisa apontar a matriz lpszText para seu próprio buffer privado quando o texto usado na dica de ferramenta exceder 80 TCHAR de comprimento. O sistema remove automaticamente o acelerador de e comercial (&) deTCHAR de todas as cadeias de caracteres passadas para um controle de dica de ferramenta, a menos que o controle tenha o estilo TTS_NOPREFIX.

Nota

O cabeçalho commctrl.h define NMTTDISPINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
cabeçalho commctrl.h