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

LVFOOTERITEM

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

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

フィールド

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

この構造体のどのメンバーに設定するデータが格納されているか、またはどのメンバーが要求されているかを指定するフラグのセットです。このパラメーターは次のいずれかの値でなければなりません。

意味
LVFIF_TEXT
pszText メンバーは呼び出し元からの有効な入力であるか、または要求されているため受信側で設定する必要があります。
LVFIF_STATE
state メンバーは呼び出し元からの有効な入力であるか、または要求されているため受信側で設定する必要があります。
iItemINT4+4+4項目のインデックスです。
pszTextLPWSTR8/4+8+8NULL で終わる Unicode バッファーへのポインターです。バッファーの割り当ては呼び出し元のプロセスが行います。
cchTextMaxINT4+16+12pszText が指すバッファー内の WCHARs の数です。終端の NULL を含みます。
stateDWORD4+20+16

項目の状態を示します。stateMask メンバーは、このメンバーの有効なビットを示します。現在のところ、state には次の値を設定しなければなりません。

意味
LVFIS_FOCUSED
フォーカス状態を示すビットです。項目にフォーカスがある場合はセットされ、それ以外の場合はクリアされます。
stateMaskDWORD4+24+20

state メンバーのどのビットを取得または変更するかを指定する値です。現在のところ、この値は次のものでなければなりません。

意味
LVFIS_FOCUSED
state メンバーの LVFIS_FOCUSED ビットが有効です。たとえば、このメンバーに LVFIS_FOCUSED を設定すると、フォーカス状態が state メンバーに取得されます。

公式ドキュメント

フッター項目に関する情報を格納します。

解説(Remarks)

この構造体は、ListView_GetFooterItem マクロおよび LVM_GETFOOTERITEM メッセージで使用されます。

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

各言語での定義

#include <windows.h>

// LVFOOTERITEM  (x64 32 / x86 24 バイト)
typedef struct LVFOOTERITEM {
    LVFOOTERITEM_MASK mask;
    INT iItem;
    LPWSTR pszText;
    INT cchTextMax;
    DWORD state;
    DWORD stateMask;
} LVFOOTERITEM;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LVFOOTERITEM
{
    public uint mask;
    public int iItem;
    public IntPtr pszText;
    public int cchTextMax;
    public uint state;
    public uint stateMask;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LVFOOTERITEM
    Public mask As UInteger
    Public iItem As Integer
    Public pszText As IntPtr
    Public cchTextMax As Integer
    Public state As UInteger
    Public stateMask As UInteger
End Structure
import ctypes
from ctypes import wintypes

class LVFOOTERITEM(ctypes.Structure):
    _fields_ = [
        ("mask", wintypes.DWORD),
        ("iItem", ctypes.c_int),
        ("pszText", ctypes.c_void_p),
        ("cchTextMax", ctypes.c_int),
        ("state", wintypes.DWORD),
        ("stateMask", wintypes.DWORD),
    ]
#[repr(C)]
pub struct LVFOOTERITEM {
    pub mask: u32,
    pub iItem: i32,
    pub pszText: *mut core::ffi::c_void,
    pub cchTextMax: i32,
    pub state: u32,
    pub stateMask: u32,
}
import "golang.org/x/sys/windows"

type LVFOOTERITEM struct {
	mask uint32
	iItem int32
	pszText uintptr
	cchTextMax int32
	state uint32
	stateMask uint32
}
type
  LVFOOTERITEM = record
    mask: DWORD;
    iItem: Integer;
    pszText: Pointer;
    cchTextMax: Integer;
    state: DWORD;
    stateMask: DWORD;
  end;
const LVFOOTERITEM = extern struct {
    mask: u32,
    iItem: i32,
    pszText: ?*anyopaque,
    cchTextMax: i32,
    state: u32,
    stateMask: u32,
};
type
  LVFOOTERITEM {.bycopy.} = object
    mask: uint32
    iItem: int32
    pszText: pointer
    cchTextMax: int32
    state: uint32
    stateMask: uint32
struct LVFOOTERITEM
{
    uint mask;
    int iItem;
    void* pszText;
    int cchTextMax;
    uint state;
    uint stateMask;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; LVFOOTERITEM サイズ: 24 バイト(x86)
dim st, 6    ; 4byte整数×6(構造体サイズ 24 / 4 切り上げ)
; mask : LVFOOTERITEM_MASK (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; iItem : INT (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pszText : LPWSTR (+8, 4byte)  st.2 = 値  /  値 = st.2   (lpoke/lpeek も可)
; cchTextMax : INT (+12, 4byte)  st.3 = 値  /  値 = st.3   (lpoke/lpeek も可)
; state : DWORD (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; stateMask : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; LVFOOTERITEM サイズ: 32 バイト(x64)
dim st, 8    ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; mask : LVFOOTERITEM_MASK (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; iItem : INT (+4, 4byte)  st.1 = 値  /  値 = st.1   (lpoke/lpeek も可)
; pszText : LPWSTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; cchTextMax : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; state : DWORD (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; stateMask : DWORD (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global LVFOOTERITEM
    #field int mask
    #field int iItem
    #field intptr pszText
    #field int cchTextMax
    #field int state
    #field int stateMask
#endstruct

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