次の方法で共有

LVFINDINFOA 構造体 (commctrl.h)

  • [アーティクル]

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

構文

typedef struct tagLVFINDINFOA {
  UINT   flags;
  LPCSTR psz;
  LPARAM lParam;
  POINT  pt;
  UINT   vkDirection;
} LVFINDINFOA, *LPFINDINFOA;

メンバーズ

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 [デスクトップ アプリのみ]
ヘッダー commctrl.h