LVFINDINFOA 構造体 (commctrl.h)
リスト ビュー アイテムを検索するときに使用される情報が含まれます。 この構造体はLV_FINDINFOと同じですが、標準の名前付け規則に合わせて名前が変更されました。
構文
typedef struct tagLVFINDINFOA {
UINT flags;
LPCSTR psz;
LPARAM lParam;
POINT pt;
UINT vkDirection;
} LVFINDINFOA, *LPFINDINFOA;
メンバー
flags
型: UINT
実行する検索の種類。 このメンバーは、次の値の 1 つ以上に設定できます。
値 | 意味 |
---|---|
|
この構造体の lParam メンバーと項目の LVITEM 構造体の lParam メンバーの一致を検索します。 |
|
psz メンバーが指す文字列で項目のテキストが始まるかどうかを確認します。 この値は、LVFI_STRINGの使用を意味します。 |
|
項目のテキストに基づいて検索します。 追加の値が指定されていない限り、一致する項目の項目テキストは 、psz メンバーが指す文字列と完全に一致する必要があります。 ただし、検索では大文字と小文字が区別されません。 |
|
Windows Vista 以降。 LVFI_PARTIALと同じです。 |
|
一致するものが見つからない場合は、最初に検索を続行します。 このフラグを単独で使用する場合は、文字列検索が必要であると見なされます。 |
|
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
解説
Note
commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして LVFINDINFO を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
Header | commctrl.h |