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が返された場合、アイテムのフルテキストは既に表示されているため、ツールヒントに表示する必要はありません。

Note

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

要件

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