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

0 またはLVGIT_UNFOLDED。 「解説」を参照してください。

pszText

型: LPTSTR

追加のテキスト情報を受け取る文字列バッファーのアドレス。 dwFlags が 0 の場合、このメンバーには既存の項目テキストが含まれます。 この場合、この文字列の末尾に追加のテキストを追加する必要があります。 このバッファーのサイズは、cchTextMax 構造体によって指定されます。

cchTextMax

型: int

pszTextが指すバッファー サイズ (文字単位)。 このバッファーが特定のサイズになるとは決して想定しないでくださいが、INFOTIPSIZE 値は設計目的で使用できます。

iItem

型: int

この構造体が参照する項目の 0 から始まるインデックス。

iSubItem

型: int

この構造体が参照するサブ項目の 1 から始まるインデックス。 このメンバーが 0 の場合、構造体はサブ項目ではなく項目を参照します。 このメンバーは現在使用されておらず、常に 0 になります。

lParam

型: LPARAM

項目に関連付けられているアプリケーション定義の値。 このメンバーは現在使用されておらず、常に 0 になります。

備考

現在表示されているテキストが切り捨てられると、アイテムが折りたたまれると言われます。 dwFlagsでLVGIT_UNFOLDEDが返された場合、項目のフルテキストは既に表示されているため、ツールヒントに表示する必要はありません。

手記

commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして NMLVGETINFOTIP を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ヘッダー	commctrl.h