Estructura NMTTDISPINFO

Definición

typedef struct {
  NMHDR     hdr;
  LPTSTR    lpszText;
  TCHAR     szText;
  HINSTANCE hinst;
  UINT      uFlags;
#if (_WIN32_IE >= 0x0300)
  LPARAM    lParam;
#endif 
} NMTTDISPINFO, *LPNMTTDISPINFO;

Contiene información usada para manipular el código de notificación TTN_GETDISPINFO. Esta estructura sustituye a la estructura TOOLTIPTEXT.

Descripción

hdr

Una estructura NMHDR que contiene información adicional sobre el código de notificación.

lpszText

Puntero a una cadena terminada en cero que será mostrada como el texto del tooltip. Si se hinst especifica un manipulador de instancia, este miembro debe ser el identificador de un recurso de cadena.

szText

Buffer que recibe el texto del tooltip. Una aplicación puede copiar el texto a este buffer en lugar de especificar una dirección de cadena o un recurso de cadena. Para textos de tooltip que excedan los 80 TCHARs, ver los comentarios en la sección de observaciones al final.

hinst

Manipulador de la instancia que contiene un recurso de cadena para ser usado como texto tooltip. Si lpszText es la dirección de una cadena de texto tooltip, este miembro debe ser NULL.

uFlags

Banderas que indican cómo interpretar el miembro idFrom de la estructura NMHDR.

Valor	Significado
TTF_IDISHWND	Si esta bandera está asignada, idFrom es el manipulador de la herramienta. En caso contrario, es el identificador de la herramienta.
TTF_RTLREADING	las ventanas pueden ser reflejadas para mostrar lenguajes como Hebreo o Árabe qie se lee de derecha a izquierda (RTL). Normalmente, el texto del tooltip se lee en la misma dirección que le texto en la ventana padre. Para tener un tooltip que se lea en la dirección opuesta de su ventana padre, añadir la bandera TTF_RTLREADING al miembro uFlags cuendo se procese la notificación.
TTF_DI_SETITEM	Versión 4.70. Si se añade esta bandera mientras se procesa la notificación, el control tooltip retendrá la información suministrada y no la pedirá de nuevo.

lParam

Versión 4.70. Dato definido por la aplicación asociado con la herramienta.

Observaciones

Es necesario apuntar el array lpszText a un buffer privado cuando el texto usado en el tooltip exceda de los 80 TCHARs de longitud. El sistema elimina automáticamente los caracteres aceleradore '&' de todas las cadenas pasadas a un control tooltip, a no ser que el control tenga el estilo TTS_NOPREFIX.