NMLVGETINFOTIPA 結構 （commctrl.h）

包含和接收顯示專案工具提示所需的清單檢視項目資訊。 此結構會與 LVN_GETINFOTIP 通知程式代碼搭配使用。

語法

typedef struct tagNMLVGETINFOTIPA {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPSTR  pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIPA, *LPNMLVGETINFOTIPA;

成員

hdr

類型：NMHDR

NMHDR 結構，其中包含此通知程式代碼的相關信息。

dwFlags

類型：DWORD

零或LVGIT_UNFOLDED。 請參閱。

pszText

類型：LPTSTR

接收任何其他文字資訊的字串緩衝區位址。 如果 dwFlags 為零，則此成員會包含現有的專案文字。 在此情況下，您應該將任何其他文字附加至此字串的結尾。 這個緩衝區的大小是由 cchTextMax 結構 指定。

cchTextMax

類型：int

pszText 所指向之緩衝區的大小，以字元為單位，。 雖然您不應該假設此緩衝區會是任何特定大小，但 INFOTIPSIZE 值可用於設計目的。

iItem

類型：int

這個結構所參考之專案之以零起始的索引。

iSubItem

類型：int

這個結構所參考之子專案的單一型索引。 如果這個成員為零，結構會參考專案，而不是子專案。 此成員目前未使用，且一律為零。

lParam

類型：LPARAM

與專案相關聯的應用程式定義值。 此成員目前未使用，且一律為零。

言論

當目前顯示的文字被截斷時，即會折疊專案。 如果在 dwFlags中傳回LVGIT_UNFOLDED，則專案的完整文字已經顯示，因此不需要在工具提示中顯示它。

注意

commctrl.h 標頭會根據 UNICODE 預處理器常數的定義，將 NMLVGETINFOTIP 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	commctrl.h