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

LVFINDINFOA

構造体
サイズ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 を指定した場合、他のすべてのフラグは無視されます。
pszLPSTR8/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 ヘッダーは LVFINDINFO をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に応じて、この関数の ANSI 版と Unicode 版が自動的に選択されます。エンコーディング中立のエイリアスと、エンコーディング中立でないコードを混在させて使用すると、不整合が生じてコンパイルエラーや実行時エラーの原因となる可能性があります。詳細については、Conventions for Function Prototypes を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は 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;

// LVFINDINFOA  (x64 40 / x86 24 バイト)
typedef struct LVFINDINFOA {
    LVFINDINFOW_FLAGS flags;
    LPSTR psz;
    LPARAM lParam;
    POINT pt;
    DWORD vkDirection;
} LVFINDINFOA;
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 LVFINDINFOA
{
    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 LVFINDINFOA
    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 LVFINDINFOA(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 LVFINDINFOA {
    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 LVFINDINFOA struct {
	flags uint32
	psz uintptr
	lParam uintptr
	pt POINT
	vkDirection uint32
}
type
  POINT = record
    x: Integer;
    y: Integer;
  end;

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

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

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

struct LVFINDINFOA
{
    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 レイアウト)
; LVFINDINFOA サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; flags : LVFINDINFOW_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; psz : LPSTR (+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 レイアウト)
; LVFINDINFOA サイズ: 40 バイト(x64)
dim st, 10    ; 4byte整数×10(構造体サイズ 40 / 4 切り上げ)
; flags : LVFINDINFOW_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; psz : LPSTR (+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 LVFINDINFOA
    #field int flags
    #field intptr psz
    #field intptr lParam
    #field POINT pt
    #field int vkDirection
#endstruct

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