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

LITEM

構造体
📘 Microsoft Learn (日本語) · English
サイズx64: 4280 バイト / x86: 4280 バイト

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

フィールド

フィールド型サイズx64x86説明
maskLIST_ITEM_FLAGS4+0+0有効なメンバーを示すLIF_系マスクフラグの組み合わせ。
iLinkINT4+4+4シンタックスリンクコントロール内のリンク項目のインデックス。
stateLIST_ITEM_STATE_FLAGS4+8+8リンク項目の状態を示すLIS_系フラグ。
stateMaskLIST_ITEM_STATE_FLAGS4+12+12stateのうち有効なビットを示すマスク。
szIDWCHAR96+16+16リンクのID文字列を保持する固定長バッファ。
szUrlWCHAR4168+112+112リンクのURL文字列を保持する固定長バッファ。

各言語での定義

#include <windows.h>

// LITEM  (x64 4280 / x86 4280 バイト)
typedef struct LITEM {
    LIST_ITEM_FLAGS mask;
    INT iLink;
    LIST_ITEM_STATE_FLAGS state;
    LIST_ITEM_STATE_FLAGS stateMask;
    WCHAR szID[48];
    WCHAR szUrl[2084];
} LITEM;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LITEM
{
    public uint mask;
    public int iLink;
    public uint state;
    public uint stateMask;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 48)] public string szID;
    [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 2084)] public string szUrl;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LITEM
    Public mask As UInteger
    Public iLink As Integer
    Public state As UInteger
    Public stateMask As UInteger
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=48)> Public szID As String
    <MarshalAs(UnmanagedType.ByValTStr, SizeConst:=2084)> Public szUrl As String
End Structure
import ctypes
from ctypes import wintypes

class LITEM(ctypes.Structure):
    _fields_ = [
        ("mask", wintypes.DWORD),
        ("iLink", ctypes.c_int),
        ("state", wintypes.DWORD),
        ("stateMask", wintypes.DWORD),
        ("szID", ctypes.c_wchar * 48),
        ("szUrl", ctypes.c_wchar * 2084),
    ]
#[repr(C)]
pub struct LITEM {
    pub mask: u32,
    pub iLink: i32,
    pub state: u32,
    pub stateMask: u32,
    pub szID: [u16; 48],
    pub szUrl: [u16; 2084],
}
import "golang.org/x/sys/windows"

type LITEM struct {
	mask uint32
	iLink int32
	state uint32
	stateMask uint32
	szID [48]uint16
	szUrl [2084]uint16
}
type
  LITEM = record
    mask: DWORD;
    iLink: Integer;
    state: DWORD;
    stateMask: DWORD;
    szID: array[0..47] of WideChar;
    szUrl: array[0..2083] of WideChar;
  end;
const LITEM = extern struct {
    mask: u32,
    iLink: i32,
    state: u32,
    stateMask: u32,
    szID: [48]u16,
    szUrl: [2084]u16,
};
type
  LITEM {.bycopy.} = object
    mask: uint32
    iLink: int32
    state: uint32
    stateMask: uint32
    szID: array[48, uint16]
    szUrl: array[2084, uint16]
struct LITEM
{
    uint mask;
    int iLink;
    uint state;
    uint stateMask;
    wchar[48] szID;
    wchar[2084] szUrl;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; LITEM サイズ: 4280 バイト(x64)
dim st, 1070    ; 4byte整数×1070(構造体サイズ 4280 / 4 切り上げ)
; mask : LIST_ITEM_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; iLink : INT (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; state : LIST_ITEM_STATE_FLAGS (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; stateMask : LIST_ITEM_STATE_FLAGS (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; szID : WCHAR (+16, 96byte)  varptr(st)+16 を基点に操作(96byte:入れ子/配列)
; szUrl : WCHAR (+112, 4168byte)  varptr(st)+112 を基点に操作(4168byte:入れ子/配列)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global LITEM
    #field int mask
    #field int iLink
    #field int state
    #field int stateMask
    #field wchar szID 48
    #field wchar szUrl 2084
#endstruct

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