LVFINDINFOW 構造体 (commctrl.h)

  • [アーティクル]

リスト ビュー アイテムを検索するときに使用される情報が含まれます。 この構造体はLV_FINDINFOと同じですが、標準の名前付け規則に合わせて名前が変更されました。

構文

typedef struct tagLVFINDINFOW {
  UINT    flags;
  LPCWSTR psz;
  LPARAM  lParam;
  POINT   pt;
  UINT    vkDirection;
} LVFINDINFOW, *LPFINDINFOW;

メンバー

flags

型: UINT

実行する検索の種類。 このメンバーは、次の値の 1 つ以上に設定できます。

値 意味
LVFI_PARAM
 この構造体の lParam メンバーと項目の LVITEM 構造体の lParam メンバーの一致を検索します。
LVFI_PARTIAL
 psz メンバーが指す文字列で項目のテキストが始まるかどうかを確認します。 この値は、LVFI_STRINGの使用を意味します。
LVFI_STRING
 項目のテキストに基づいて検索します。 追加の値が指定されていない限り、一致する項目の項目テキストは 、psz メンバーが指す文字列と完全に一致する必要があります。 ただし、検索では大文字と小文字が区別されません。
LVFI_SUBSTRING
 Windows Vista 以降。 LVFI_PARTIALと同じです。
LVFI_WRAP
 一致するものが見つからない場合は、最初に検索を続行します。 このフラグを単独で使用する場合は、文字列検索が必要であると見なされます。
LVFI_NEARESTXY
 vkDirection メンバーで指定された方向で、pt メンバーで指定された位置に最も近い項目を検索します。 このフラグは、大きなアイコン モードと小さいアイコン モードでのみサポートされます。 LVFI_NEARESTXYを指定すると、他のすべてのフラグは無視されます。

psz

種類: LPCTSTR

項目テキストと比較する null で終わる文字列のアドレス。 これは、 フラグ メンバーでLVFI_STRINGまたはLVFI_PARTIALが設定されている場合にのみ有効です。

lParam

種類: LPARAM

リスト ビュー アイテムの LVITEM 構造体の lParam メンバーと比較する値。 これは、 フラグ メンバーにLVFI_PARAMが設定されている場合にのみ有効です。

pt

種類: POINT

最初の検索位置を持つ POINT 構造体。 これは、 フラグ メンバーでLVFI_NEARESTXYが設定されている場合にのみ有効です。

vkDirection

型: UINT

検索する方向を指定する仮想キー コード。 次のコードがサポートされています。

  • VK_LEFT
  • VK_RIGHT
  • VK_UP
  • VK_DOWN
  • VK_HOME
  • VK_END
  • VK_PRIOR
  • VK_NEXT
このメンバーは、 フラグ メンバーにLVFI_NEARESTXYが設定されている場合にのみ有効です。

解説

注意

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

要件

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