commctrl.h

Estructura NMLVGETINFOTIP

Definición

typedef struct tagNMLVGETINFOTIP {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPSTR  pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIP, *PNMLVGETINFOTIP;

Contiene y recibe información de ítem de list-view item information necesaria para mostrar un tooltip para un ítem. Esta estructura es usada con el código de notificación LVN_GETINFOTIP.

Descripción

hdr: Estructura NMHDR que contiene información de este código de notificación.
dwFlags: Puede ser cero o LVGIT_UNFOLDED. Ver observaciones.
pszText: Dirección de un buffer de cadena que recibe cualquier información de texto adicional. Si dwFlags es cero, este miembro contendrá el texto del ítem existente. En este caso, se debe añadir cualquier texto adicional al final de esta cadena. El tamaño de este buffer está especificado en el miembro cchTextMax de esta estructura.
cchTextMax: Tamaño, en caracteres, del buffer apuntado por pszText. Aunque nunca hay que dar por hecho que este buffer tendrá un tamaño determinado, el valor INFOTIPSIZE puede ser usado con fines de diseño.
iItem: Índice basado en cero del ítem al que se refiere esta estructura.
iSubItem: Índice basado en uno deñ subítem al que se refiere esta estructura. Si este miembro es cero, la estructura se refiere al ítem y no al subítem. Este miembro no es usado actualmente y siempre será cero.
lParam: Valor definido por la aplicación asociado con el ítem. Este miembro no es usado actualmente y siempre será cero.

Observaciones

Se dice que un ítem está plegado cuando el texto mostrado actualmente está truncado. Si se retorna LVGIT_UNFOLDED en dwFlags, se está mostrando el texto completo del ítem, así que no es necesario mostrarlo en el tooltip.

Nota: El fichero de cabecera commctrl.h define NMLVGETINFOTIP como un alias que selecciona automáticamente la versión ANSI o Unicode de esta estructura basándose en la constante del preprocesador UNICODE. Mezclar el uso de alias de codificación neutral con código que no use esa codificación puede producir desajustes que resulten en errores de compilación o de ejecución.