Estrutura NMTTDISPINFOA (commctrl.h)

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 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 hinst 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 TCHARs, consulte 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 membro idFrom da estrutura NMHDR incluída.

Valor	Significado
TTF_IDISHWND	Se esse sinalizador estiver definido, idFrom será o identificador da ferramenta. Caso contrário, ele será o identificador da ferramenta.
TTF_RTLREADING	O Windows pode ser espelhado 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 a uFlags durante o processamento da notificação, o controle de dica de ferramenta manterá as informações fornecidas e não as solicitará novamente.

lParam

Tipo: LPARAM

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

Comentários

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

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	commctrl.h