NMLVGETINFOTIP structure

Contains and receives list-view item information needed to display a tooltip for an item. This structure is used with the LVN_GETINFOTIP notification code.

Syntax


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

Members

hdr

Type: NMHDR

NMHDR structure that contains information on this notification code.

dwFlags

Type: DWORD

Either zero or LVGIT_UNFOLDED. See Remarks.

pszText

Type: LPTSTR

Address of a string buffer that receives any additional text information. If dwFlags is zero, this member will contain the existing item text. In this case, you should append any additional text onto the end of this string. The size of this buffer is specified by the cchTextMax structure.

cchTextMax

Type: int

Size, in characters, of the buffer pointed to by pszText. Although you should never assume that this buffer will be of any particular size, the INFOTIPSIZE value can be used for design purposes.

iItem

Type: int

Zero-based index of the item to which this structure refers.

iSubItem

Type: int

One-based index of the subitem to which this structure refers. If this member is zero, the structure is referring to the item and not a subitem. This member is not currently used and will always be zero.

lParam

Type: LPARAM

Application-defined value associated with the item. This member is not currently used and will always be zero.

Remarks

An item is said to be folded when the currently displayed text is truncated. If LVGIT_UNFOLDED is returned in dwFlags, the full text of the item is already displayed, so there is no need to display it in the tooltip.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Commctrl.h

Unicode and ANSI names

NMLVGETINFOTIPW (Unicode) and NMLVGETINFOTIPA (ANSI)

 

 

Show: