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

COMPAREITEMSTRUCT

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

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

フィールド

フィールド型サイズx64x86説明
CtlTypeDRAWITEMSTRUCT_CTL_TYPE4+0+0ODT_LISTBOX (オーナー描画のリスト ボックス) または ODT_COMBOBOX (オーナー描画のコンボ ボックス) です。
CtlIDDWORD4+4+4リスト ボックスまたはコンボ ボックスの識別子です。
hwndItemHWND8/4+8+8コントロールへのハンドルです。
itemID1DWORD4+16+12比較対象となる、リスト ボックスまたはコンボ ボックス内の 1 つ目の項目のインデックスです。項目がまだ挿入されていない場合、またはリスト ボックスやコンボ ボックス内で候補となる項目を検索している場合、このメンバーは -1 になります。
itemData1UINT_PTR8/4+24+16比較対象となる 1 つ目の項目について、アプリケーションが指定したデータです。(この値は、リスト ボックスまたはコンボ ボックスに項目を追加したメッセージの lParam パラメーターとして渡された値です。)
itemID2DWORD4+32+20比較対象となる、リスト ボックスまたはコンボ ボックス内の 2 つ目の項目のインデックスです。
itemData2UINT_PTR8/4+40+24比較対象となる 2 つ目の項目について、アプリケーションが指定したデータです。この値は、リスト ボックスまたはコンボ ボックスに項目を追加したメッセージの lParam パラメーターとして渡された値です。項目がまだ挿入されていない場合、またはリスト ボックスやコンボ ボックス内で候補となる項目を検索している場合、このメンバーは -1 になります。
dwLocaleIdDWORD4+48+28ロケール識別子です。ロケール識別子を作成するには、MAKELCID マクロを使用します。

公式ドキュメント

ソートされたオーナー描画のリスト ボックスまたはコンボ ボックス内の 2 つの項目について、識別子とアプリケーションが指定したデータを提供します。

CBS_SORT スタイルまたは LBS_SORT スタイルで作成されたオーナー描画のリスト ボックスまたはコンボ ボックスに、アプリケーションが新しい項目を追加すると、システムはオーナーに WM_COMPAREITEM メッセージを送信します。このメッセージの lParam パラメーターには、COMPAREITEMSTRUCT 構造体への long ポインターが格納されます。オーナーはこのメッセージを受け取ると 2 つの項目を比較し、どちらの項目が先に並ぶかを示す値を返します。

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

各言語での定義

#include <windows.h>

// COMPAREITEMSTRUCT  (x64 56 / x86 32 バイト)
typedef struct COMPAREITEMSTRUCT {
    DRAWITEMSTRUCT_CTL_TYPE CtlType;
    DWORD CtlID;
    HWND hwndItem;
    DWORD itemID1;
    UINT_PTR itemData1;
    DWORD itemID2;
    UINT_PTR itemData2;
    DWORD dwLocaleId;
} COMPAREITEMSTRUCT;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct COMPAREITEMSTRUCT
{
    public uint CtlType;
    public uint CtlID;
    public IntPtr hwndItem;
    public uint itemID1;
    public UIntPtr itemData1;
    public uint itemID2;
    public UIntPtr itemData2;
    public uint dwLocaleId;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure COMPAREITEMSTRUCT
    Public CtlType As UInteger
    Public CtlID As UInteger
    Public hwndItem As IntPtr
    Public itemID1 As UInteger
    Public itemData1 As UIntPtr
    Public itemID2 As UInteger
    Public itemData2 As UIntPtr
    Public dwLocaleId As UInteger
End Structure
import ctypes
from ctypes import wintypes

class COMPAREITEMSTRUCT(ctypes.Structure):
    _fields_ = [
        ("CtlType", wintypes.DWORD),
        ("CtlID", wintypes.DWORD),
        ("hwndItem", ctypes.c_void_p),
        ("itemID1", wintypes.DWORD),
        ("itemData1", ctypes.c_size_t),
        ("itemID2", wintypes.DWORD),
        ("itemData2", ctypes.c_size_t),
        ("dwLocaleId", wintypes.DWORD),
    ]
#[repr(C)]
pub struct COMPAREITEMSTRUCT {
    pub CtlType: u32,
    pub CtlID: u32,
    pub hwndItem: *mut core::ffi::c_void,
    pub itemID1: u32,
    pub itemData1: usize,
    pub itemID2: u32,
    pub itemData2: usize,
    pub dwLocaleId: u32,
}
import "golang.org/x/sys/windows"

type COMPAREITEMSTRUCT struct {
	CtlType uint32
	CtlID uint32
	hwndItem uintptr
	itemID1 uint32
	itemData1 uintptr
	itemID2 uint32
	itemData2 uintptr
	dwLocaleId uint32
}
type
  COMPAREITEMSTRUCT = record
    CtlType: DWORD;
    CtlID: DWORD;
    hwndItem: Pointer;
    itemID1: DWORD;
    itemData1: NativeUInt;
    itemID2: DWORD;
    itemData2: NativeUInt;
    dwLocaleId: DWORD;
  end;
const COMPAREITEMSTRUCT = extern struct {
    CtlType: u32,
    CtlID: u32,
    hwndItem: ?*anyopaque,
    itemID1: u32,
    itemData1: usize,
    itemID2: u32,
    itemData2: usize,
    dwLocaleId: u32,
};
type
  COMPAREITEMSTRUCT {.bycopy.} = object
    CtlType: uint32
    CtlID: uint32
    hwndItem: pointer
    itemID1: uint32
    itemData1: uint
    itemID2: uint32
    itemData2: uint
    dwLocaleId: uint32
struct COMPAREITEMSTRUCT
{
    uint CtlType;
    uint CtlID;
    void* hwndItem;
    uint itemID1;
    size_t itemData1;
    uint itemID2;
    size_t itemData2;
    uint dwLocaleId;
}

HSP用 定義

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

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

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