Compartir a través de


Estructura NMTTDISPINFOA (commctrl.h)

Contiene información utilizada para controlar el código de notificación de TTN_GETDISPINFO . Esta estructura sustituye a 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 NMHDR que contiene información adicional sobre la notificación.

lpszText

Tipo: LPTSTR

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 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 información sobre herramientas, este miembro debe ser NULL.

uFlags

Tipo: UINT

Marcas que indican cómo interpretar el miembro idFrom de la estructura 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 reflejar 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 al miembro uFlags 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

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

Comentarios

Debe apuntar la matriz 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 los símbolos de aceleración (&) 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado commctrl.h