Share via

NMLVGETINFOTIPW 構造体 (commctrl.h)

  • [アーティクル]

アイテムのツールヒントを表示するために必要なリスト ビューアイテム情報を格納および受信します。 この構造体は、 LVN_GETINFOTIP 通知コードと共に使用されます。

構文

typedef struct tagNMLVGETINFOTIPW {
  NMHDR  hdr;
  DWORD  dwFlags;
  LPWSTR pszText;
  int    cchTextMax;
  int    iItem;
  int    iSubItem;
  LPARAM lParam;
} NMLVGETINFOTIPW, *LPNMLVGETINFOTIPW;

メンバー

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 になります。

注釈

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

注意

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

要件

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