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

設定または取得する情報を示す、次のフラグの 1 つ以上の組み合わせです。

値 意味
LIF_ITEMINDEX
 数値の項目インデックスを取得します。項目は常にインデックスによってアクセスされるため、このフラグを常に設定し、iLink に値を指定する必要があります。項目 ID を取得するには、LIF_ITEMINDEX と LIF_ITEMID の両方を設定する必要があります。
LIF_STATE
 stateMask を使用して、リンクの状態を取得または設定します。
LIF_ITEMID
 szID で指定された ID 値によって項目を指定します。
LIF_URL
 この項目の URL を設定または取得します。
iLinkINT4+4+4項目インデックスを格納する int 型の値です。この数値インデックスは、SysLink コントロールのリンクにアクセスするために使用されます。
stateLIST_ITEM_STATE_FLAGS4+8+8

項目の状態を示す、次のフラグの 1 つ以上の組み合わせです。

値 意味
LIS_ENABLED
 リンクがユーザー入力に応答できます。コントロール全体が WS_DISABLED で作成されていない限り、これが既定です。WS_DISABLED で作成された場合は、すべてのリンクが無効になります。
LIS_FOCUSED
 リンクがキーボードフォーカスを持っています。ENTER キーを押すと NM_CLICK 通知が送信されます。
LIS_VISITED
 リンクがユーザーによって訪問済みです。まだ訪問していない URL に変更すると、このフラグはクリアされます。
LIS_HOTTRACK
 マウスポインターがコントロール上にあるときに、SysLink コントロールが別の色 (COLOR_HIGHLIGHT) で強調表示されることを示します。
LIS_DEFAULTCOLORS
 カスタムのテキスト色を使用できるようにします。
stateMaskLIST_ITEM_STATE_FLAGS4+12+12取得または設定する状態項目を示すフラグの組み合わせです。指定できる項目は state で使用できるものと同じです。
szIDWCHAR96+16+16ID 名を格納する WCHAR 文字列です。配列内の最大文字数は MAX_LINKID_TEXT です。ID 名を使用して SysLink コントロールのリンクにアクセスすることはできません。項目にアクセスするには項目インデックスを使用します。
szUrlWCHAR4168+112+112リンクが表す URL を格納する WCHAR 文字列です。配列内の最大文字数は L_MAX_URL_LENGTH です。

公式ドキュメント

リンク項目に関する情報を設定および取得するために使用します。

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

各言語での定義

#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