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

LVITEMW

構造体
サイズx64: 88 バイト / x86: 60 バイト

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

フィールド

フィールドサイズx64x86説明
maskLIST_VIEW_ITEM_FLAGS4+0+0有効なメンバーを示すLVIF_系マスクフラグの組み合わせ。
iItemINT4+4+4項目(行)のインデックス。
iSubItemINT4+8+8サブ項目(列)のインデックス。0は項目自体を表す。
stateLIST_VIEW_ITEM_STATE_FLAGS4+12+12項目の状態を示すLVIS_系フラグ。選択/フォーカス等を表す。
stateMaskLIST_VIEW_ITEM_STATE_FLAGS4+16+16stateのうち有効なビットを示すマスク。
pszTextLPWSTR8/4+24+20項目のテキストを保持するバッファへのポインタ。LPSTR_TEXTCALLBACK可。
cchTextMaxINT4+32+24pszTextバッファの最大文字数。
iImageINT4+36+28項目のイメージリスト内アイコンインデックス。
lParamLPARAM8/4+40+32項目に関連付けるアプリケーション定義データ。
iIndentINT4+48+36項目のインデント量。アイコン幅の倍数で指定する。
iGroupIdINT4+52+40項目が属するグループの識別子。I_GROUPIDCALLBACK等の特殊値可。
cColumnsDWORD4+56+44タイルビューでのサブ項目列数。
puColumnsDWORD*8/4+64+48タイルビューに表示する列のインデックス配列へのポインタ。
piColFmtLIST_VIEW_ITEM_COLUMN_FORMAT_FLAGS*8/4+72+52各列の書式を示すフラグ配列へのポインタ。
iGroupINT4+80+56項目が属するグループのインデックス。

各言語での定義

#include <windows.h>

// LVITEMW  (x64 88 / x86 60 バイト)
typedef struct LVITEMW {
    LIST_VIEW_ITEM_FLAGS mask;
    INT iItem;
    INT iSubItem;
    LIST_VIEW_ITEM_STATE_FLAGS state;
    LIST_VIEW_ITEM_STATE_FLAGS stateMask;
    LPWSTR pszText;
    INT cchTextMax;
    INT iImage;
    LPARAM lParam;
    INT iIndent;
    INT iGroupId;
    DWORD cColumns;
    DWORD* puColumns;
    LIST_VIEW_ITEM_COLUMN_FORMAT_FLAGS* piColFmt;
    INT iGroup;
} LVITEMW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LVITEMW
{
    public uint mask;
    public int iItem;
    public int iSubItem;
    public uint state;
    public uint stateMask;
    public IntPtr pszText;
    public int cchTextMax;
    public int iImage;
    public IntPtr lParam;
    public int iIndent;
    public int iGroupId;
    public uint cColumns;
    public IntPtr puColumns;
    public IntPtr piColFmt;
    public int iGroup;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LVITEMW
    Public mask As UInteger
    Public iItem As Integer
    Public iSubItem As Integer
    Public state As UInteger
    Public stateMask As UInteger
    Public pszText As IntPtr
    Public cchTextMax As Integer
    Public iImage As Integer
    Public lParam As IntPtr
    Public iIndent As Integer
    Public iGroupId As Integer
    Public cColumns As UInteger
    Public puColumns As IntPtr
    Public piColFmt As IntPtr
    Public iGroup As Integer
End Structure
import ctypes
from ctypes import wintypes

class LVITEMW(ctypes.Structure):
    _fields_ = [
        ("mask", wintypes.DWORD),
        ("iItem", ctypes.c_int),
        ("iSubItem", ctypes.c_int),
        ("state", wintypes.DWORD),
        ("stateMask", wintypes.DWORD),
        ("pszText", ctypes.c_void_p),
        ("cchTextMax", ctypes.c_int),
        ("iImage", ctypes.c_int),
        ("lParam", ctypes.c_ssize_t),
        ("iIndent", ctypes.c_int),
        ("iGroupId", ctypes.c_int),
        ("cColumns", wintypes.DWORD),
        ("puColumns", ctypes.c_void_p),
        ("piColFmt", ctypes.c_void_p),
        ("iGroup", ctypes.c_int),
    ]
#[repr(C)]
pub struct LVITEMW {
    pub mask: u32,
    pub iItem: i32,
    pub iSubItem: i32,
    pub state: u32,
    pub stateMask: u32,
    pub pszText: *mut core::ffi::c_void,
    pub cchTextMax: i32,
    pub iImage: i32,
    pub lParam: isize,
    pub iIndent: i32,
    pub iGroupId: i32,
    pub cColumns: u32,
    pub puColumns: *mut core::ffi::c_void,
    pub piColFmt: *mut core::ffi::c_void,
    pub iGroup: i32,
}
import "golang.org/x/sys/windows"

type LVITEMW struct {
	mask uint32
	iItem int32
	iSubItem int32
	state uint32
	stateMask uint32
	pszText uintptr
	cchTextMax int32
	iImage int32
	lParam uintptr
	iIndent int32
	iGroupId int32
	cColumns uint32
	puColumns uintptr
	piColFmt uintptr
	iGroup int32
}
type
  LVITEMW = record
    mask: DWORD;
    iItem: Integer;
    iSubItem: Integer;
    state: DWORD;
    stateMask: DWORD;
    pszText: Pointer;
    cchTextMax: Integer;
    iImage: Integer;
    lParam: NativeInt;
    iIndent: Integer;
    iGroupId: Integer;
    cColumns: DWORD;
    puColumns: Pointer;
    piColFmt: Pointer;
    iGroup: Integer;
  end;
const LVITEMW = extern struct {
    mask: u32,
    iItem: i32,
    iSubItem: i32,
    state: u32,
    stateMask: u32,
    pszText: ?*anyopaque,
    cchTextMax: i32,
    iImage: i32,
    lParam: isize,
    iIndent: i32,
    iGroupId: i32,
    cColumns: u32,
    puColumns: ?*anyopaque,
    piColFmt: ?*anyopaque,
    iGroup: i32,
};
type
  LVITEMW {.bycopy.} = object
    mask: uint32
    iItem: int32
    iSubItem: int32
    state: uint32
    stateMask: uint32
    pszText: pointer
    cchTextMax: int32
    iImage: int32
    lParam: int
    iIndent: int32
    iGroupId: int32
    cColumns: uint32
    puColumns: pointer
    piColFmt: pointer
    iGroup: int32
struct LVITEMW
{
    uint mask;
    int iItem;
    int iSubItem;
    uint state;
    uint stateMask;
    void* pszText;
    int cchTextMax;
    int iImage;
    ptrdiff_t lParam;
    int iIndent;
    int iGroupId;
    uint cColumns;
    void* puColumns;
    void* piColFmt;
    int iGroup;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; LVITEMW サイズ: 60 バイト(x86)
dim st, 15    ; 4byte整数×15(構造体サイズ 60 / 4 切り上げ)
; mask : LIST_VIEW_ITEM_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; iItem : INT (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; iSubItem : INT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; state : LIST_VIEW_ITEM_STATE_FLAGS (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; stateMask : LIST_VIEW_ITEM_STATE_FLAGS (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pszText : LPWSTR (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; cchTextMax : INT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; iImage : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; lParam : LPARAM (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; iIndent : INT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; iGroupId : INT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; cColumns : DWORD (+44, 4byte)  st.11 = 値  /  値 = st.11   (lpoke/lpeek も可)
; puColumns : DWORD* (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; piColFmt : LIST_VIEW_ITEM_COLUMN_FORMAT_FLAGS* (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; iGroup : INT (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; LVITEMW サイズ: 88 バイト(x64)
dim st, 22    ; 4byte整数×22(構造体サイズ 88 / 4 切り上げ)
; mask : LIST_VIEW_ITEM_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; iItem : INT (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; iSubItem : INT (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; state : LIST_VIEW_ITEM_STATE_FLAGS (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; stateMask : LIST_VIEW_ITEM_STATE_FLAGS (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; pszText : LPWSTR (+24, 8byte)  qpoke st,24,値 / qpeek(st,24)  ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; cchTextMax : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; iImage : INT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; lParam : LPARAM (+40, 8byte)  qpoke st,40,値 / qpeek(st,40)  ※IronHSPのみ。3.7/3.8は lpoke st,40,下位 : lpoke st,44,上位
; iIndent : INT (+48, 4byte)  st.12 = 値  /  値 = st.12   (lpoke/lpeek も可)
; iGroupId : INT (+52, 4byte)  st.13 = 値  /  値 = st.13   (lpoke/lpeek も可)
; cColumns : DWORD (+56, 4byte)  st.14 = 値  /  値 = st.14   (lpoke/lpeek も可)
; puColumns : DWORD* (+64, 8byte)  qpoke st,64,値 / qpeek(st,64)  ※IronHSPのみ。3.7/3.8は lpoke st,64,下位 : lpoke st,68,上位
; piColFmt : LIST_VIEW_ITEM_COLUMN_FORMAT_FLAGS* (+72, 8byte)  qpoke st,72,値 / qpeek(st,72)  ※IronHSPのみ。3.7/3.8は lpoke st,72,下位 : lpoke st,76,上位
; iGroup : INT (+80, 4byte)  st.20 = 値  /  値 = st.20   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global LVITEMW
    #field int mask
    #field int iItem
    #field int iSubItem
    #field int state
    #field int stateMask
    #field intptr pszText
    #field int cchTextMax
    #field int iImage
    #field intptr lParam
    #field int iIndent
    #field int iGroupId
    #field int cColumns
    #field intptr puColumns
    #field intptr piColFmt
    #field int iGroup
#endstruct

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