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

LVTILEINFO

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

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

フィールド

フィールドサイズx64x86説明
cbSizeDWORD4+0+0LVTILEINFO 構造体のサイズです。
iItemINT4+4+4情報を取得または設定する対象の項目です。
cColumnsDWORD4+8+8この項目に対して表示されるデータ列の数です。情報を取得する場合は、この値を puColumns 配列のサイズに初期化します。戻り値では、このメンバーには実際に項目に設定されている列の数が格納されます。
puColumnsDWORD*8/4+16+12列インデックスの配列へのポインターで、この項目に対してどの列を表示するか、およびそれらの列の順序を指定します。情報を取得する場合は、想定される最大の列数を格納できる十分な大きさの配列を割り当ててください。
piColFmtINT*8/4+24+16列の書式 (たとえば LVCFMT_LEFT) の配列へのポインターで、puColumns で指定された各列に対して 1 つずつ指定します。情報を取得する場合は、想定される最大の列書式の数を格納できる十分な大きさの配列を割り当ててください。

公式ドキュメント

リストビューコントロールがタイルビューで表示されているときの、項目に関する情報を提供します。

解説(Remarks)

タイルビューでは、項目名はアイコンの右側に表示されます。追加のサブ項目 (詳細ビューの列に対応します) を指定して、項目名の下の行に表示させることができます。puColumns 配列には、表示するサブ項目のインデックスが格納されます。サブ項目 0 は項目名であり既に表示されているため、インデックスは 0 より大きい値にしてください。

列の情報は、リスト項目を作成するときに LVITEM 構造体で設定することもできます。

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

各言語での定義

#include <windows.h>

// LVTILEINFO  (x64 32 / x86 20 バイト)
typedef struct LVTILEINFO {
    DWORD cbSize;
    INT iItem;
    DWORD cColumns;
    DWORD* puColumns;
    INT* piColFmt;
} LVTILEINFO;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct LVTILEINFO
{
    public uint cbSize;
    public int iItem;
    public uint cColumns;
    public IntPtr puColumns;
    public IntPtr piColFmt;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure LVTILEINFO
    Public cbSize As UInteger
    Public iItem As Integer
    Public cColumns As UInteger
    Public puColumns As IntPtr
    Public piColFmt As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class LVTILEINFO(ctypes.Structure):
    _fields_ = [
        ("cbSize", wintypes.DWORD),
        ("iItem", ctypes.c_int),
        ("cColumns", wintypes.DWORD),
        ("puColumns", ctypes.c_void_p),
        ("piColFmt", ctypes.c_void_p),
    ]
#[repr(C)]
pub struct LVTILEINFO {
    pub cbSize: u32,
    pub iItem: i32,
    pub cColumns: u32,
    pub puColumns: *mut core::ffi::c_void,
    pub piColFmt: *mut core::ffi::c_void,
}
import "golang.org/x/sys/windows"

type LVTILEINFO struct {
	cbSize uint32
	iItem int32
	cColumns uint32
	puColumns uintptr
	piColFmt uintptr
}
type
  LVTILEINFO = record
    cbSize: DWORD;
    iItem: Integer;
    cColumns: DWORD;
    puColumns: Pointer;
    piColFmt: Pointer;
  end;
const LVTILEINFO = extern struct {
    cbSize: u32,
    iItem: i32,
    cColumns: u32,
    puColumns: ?*anyopaque,
    piColFmt: ?*anyopaque,
};
type
  LVTILEINFO {.bycopy.} = object
    cbSize: uint32
    iItem: int32
    cColumns: uint32
    puColumns: pointer
    piColFmt: pointer
struct LVTILEINFO
{
    uint cbSize;
    int iItem;
    uint cColumns;
    void* puColumns;
    void* piColFmt;
}

HSP用 定義

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

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

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