Win32 API 日本語リファレンス
ホームUI.Controls › LVFINDINFOW

LVFINDINFOW

構造体
サイズx64: 40 バイト / x86: 24 バイト

サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。

フィールド

フィールドサイズx64x86説明
flagsLVFINDINFOW_FLAGS4+0+0

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

意味
LVFI_PARAM
この構造体の lParam メンバーと、項目の LVITEM 構造体の lParam メンバーが一致するものを検索します。
LVFI_PARTIAL
項目のテキストが psz メンバーが指す文字列で始まるかどうかを調べます。この値は LVFI_STRING の使用を暗黙的に含みます。
LVFI_STRING
項目のテキストに基づいて検索します。追加の値が指定されていない限り、一致する項目のテキストは psz メンバーが指す文字列と完全に一致しなければなりません。ただし、検索では大文字と小文字は区別されません。
LVFI_SUBSTRING
Windows Vista 以降。 LVFI_PARTIAL と同等です。
LVFI_WRAP
一致するものが見つからない場合、先頭に戻って検索を続行します。このフラグを単独で使用した場合は、文字列検索が要求されたものと見なされます。
LVFI_NEARESTXY
pt メンバーで指定された位置に最も近い項目を、vkDirection メンバーで指定された方向で検索します。このフラグは大アイコンモードと小アイコンモードでのみサポートされます。LVFI_NEARESTXY を指定した場合、他のすべてのフラグは無視されます。
pszLPWSTR8/4+8+4項目のテキストと比較する、null で終わる文字列のアドレスです。flags メンバーに LVFI_STRING または LVFI_PARTIAL が設定されている場合にのみ有効です。
lParamLPARAM8/4+16+8リストビュー項目の LVITEM 構造体の lParam メンバーと比較する値です。flags メンバーに LVFI_PARAM が設定されている場合にのみ有効です。
ptPOINT8+24+12検索の開始位置を示す POINT 構造体です。flags メンバーに LVFI_NEARESTXY が設定されている場合にのみ有効です。
vkDirectionDWORD4+32+20

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

このメンバーは、flags メンバーに LVFI_NEARESTXY が設定されている場合にのみ有効です。

公式ドキュメント

リストビュー項目を検索するときに使用される情報を格納します。この構造体は LV_FINDINFO と同一ですが、標準的な命名規則に合わせて名前が変更されています。

解説(Remarks)

メモ

commctrl.h ヘッダーは、UNICODE プリプロセッサ定数の定義に応じてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして LVFINDINFO を定義しています。エンコーディング中立のエイリアスを、エンコーディング中立でないコードと混在させて使用すると、不一致が生じてコンパイルエラーや実行時エラーの原因になることがあります。詳細については、関数プロトタイプの規則を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

各言語での定義

#include <windows.h>

// POINT  (x64 8 / x86 8 バイト)
typedef struct POINT {
    INT x;
    INT y;
} POINT;

// LVFINDINFOW  (x64 40 / x86 24 バイト)
typedef struct LVFINDINFOW {
    LVFINDINFOW_FLAGS flags;
    LPWSTR psz;
    LPARAM lParam;
    POINT pt;
    DWORD vkDirection;
} LVFINDINFOW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct POINT
{
    public int x;
    public int y;
}

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LVFINDINFOW
{
    public uint flags;
    public IntPtr psz;
    public IntPtr lParam;
    public POINT pt;
    public uint vkDirection;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure POINT
    Public x As Integer
    Public y As Integer
End Structure

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LVFINDINFOW
    Public flags As UInteger
    Public psz As IntPtr
    Public lParam As IntPtr
    Public pt As POINT
    Public vkDirection As UInteger
End Structure
import ctypes
from ctypes import wintypes

class POINT(ctypes.Structure):
    _fields_ = [
        ("x", ctypes.c_int),
        ("y", ctypes.c_int),
    ]

class LVFINDINFOW(ctypes.Structure):
    _fields_ = [
        ("flags", wintypes.DWORD),
        ("psz", ctypes.c_void_p),
        ("lParam", ctypes.c_ssize_t),
        ("pt", POINT),
        ("vkDirection", wintypes.DWORD),
    ]
#[repr(C)]
pub struct POINT {
    pub x: i32,
    pub y: i32,
}

#[repr(C)]
pub struct LVFINDINFOW {
    pub flags: u32,
    pub psz: *mut core::ffi::c_void,
    pub lParam: isize,
    pub pt: POINT,
    pub vkDirection: u32,
}
import "golang.org/x/sys/windows"

type POINT struct {
	x int32
	y int32
}

type LVFINDINFOW struct {
	flags uint32
	psz uintptr
	lParam uintptr
	pt POINT
	vkDirection uint32
}
type
  POINT = record
    x: Integer;
    y: Integer;
  end;

  LVFINDINFOW = record
    flags: DWORD;
    psz: Pointer;
    lParam: NativeInt;
    pt: POINT;
    vkDirection: DWORD;
  end;
const POINT = extern struct {
    x: i32,
    y: i32,
};

const LVFINDINFOW = extern struct {
    flags: u32,
    psz: ?*anyopaque,
    lParam: isize,
    pt: POINT,
    vkDirection: u32,
};
type
  POINT {.bycopy.} = object
    x: int32
    y: int32

  LVFINDINFOW {.bycopy.} = object
    flags: uint32
    psz: pointer
    lParam: int
    pt: POINT
    vkDirection: uint32
struct POINT
{
    int x;
    int y;
}

struct LVFINDINFOW
{
    uint flags;
    void* psz;
    ptrdiff_t lParam;
    POINT pt;
    uint vkDirection;
}

HSP用 定義

HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; LVFINDINFOW サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; flags : LVFINDINFOW_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; psz : LPWSTR (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; lParam : LPARAM (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; pt : POINT (+12, 8byte)  varptr(st)+12 を基点に操作(8byte:入れ子/配列)
; vkDirection : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; LVFINDINFOW サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; flags : LVFINDINFOW_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; psz : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; lParam : LPARAM (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; pt : POINT (+24, 8byte)  varptr(st)+24 を基点に操作(8byte:入れ子/配列)
; vkDirection : DWORD (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global POINT
    #field int x
    #field int y
#endstruct

#defstruct global LVFINDINFOW
    #field int flags
    #field intptr psz
    #field intptr lParam
    #field POINT pt
    #field int vkDirection
#endstruct

stdim st, LVFINDINFOW        ; NSTRUCT 変数を確保
st->flags = 100
mes "flags=" + st->flags