Estructura NMTTDISPINFOA (commctrl.h)

Contiene información que se usa para controlar el código de notificación de TTN_GETDISPINFO. Esta estructura reemplaza la estructura TOOLTIPTEXT.

Sintaxis

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

Miembros

hdr

Tipo: NMHDR

estructura de NMHDR que contiene información adicional sobre la notificación.

lpszText

Tipo: LPTSTR de

Puntero a una cadena terminada en null que se mostrará como texto de información sobre herramientas. Si hinst especifica un identificador de instancia, este miembro debe ser el identificador de un recurso de cadena.

szText[80]

Tipo: TCHAR

Búfer que recibe el texto de la información sobre herramientas. Una aplicación puede copiar el texto en este búfer en lugar de especificar una dirección de cadena o un recurso de cadena. Para obtener texto de información sobre herramientas que supere los 80 TCHAR, vea los comentarios en la sección de comentarios de este documento.

hinst

Tipo: HINSTANCE

Identificador de la instancia que contiene un recurso de cadena que se va a usar como texto de información sobre herramientas. Si lpszText es la dirección de la cadena de texto de la información sobre herramientas, este miembro debe ser NULL.

uFlags

Tipo: UINT de

Marcas que indican cómo interpretar el miembro idFrom del nmHDR incluida.

Valor	Significado
TTF_IDISHWND	Si se establece esta marca, idFrom es el identificador de la herramienta. De lo contrario, es el identificador de la herramienta.
TTF_RTLREADING	Windows se puede reflejado para mostrar idiomas como hebreo o árabe que leen de derecha a izquierda (RTL). Normalmente, el texto de la información sobre herramientas se lee en la misma dirección que el texto de su ventana primaria. Para que una información sobre herramientas se lea en la dirección opuesta de su ventana primaria, agregue la marca TTF_RTLREADING a la uFlags miembro al procesar la notificación.
TTF_DI_SETITEM	versión 4.70. Si agrega esta marca a uFlags mientras procesa la notificación, el control de información sobre herramientas conservará la información proporcionada y no la solicitará de nuevo.

lParam

Tipo: LPARAM de

versión 4.70. Datos definidos por la aplicación asociados a la herramienta.

Observaciones

Debe apuntar la matriz de lpszText a su propio búfer privado cuando el texto usado en la información sobre herramientas supera los 80 TCHARde longitud. El sistema quita automáticamente el acelerador (&) TCHARs de todas las cadenas que se pasan a un control de información sobre herramientas, a menos que el control tenga el estilo TTS_NOPREFIX.

Nota

El encabezado commctrl.h define NMTTDISPINFO como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	commctrl.h