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

規格需求

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