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

COMBOBOXEXITEMW

構造体
サイズx64: 56 バイト / x86: 36 バイト

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

フィールド

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

この構造体の属性、またはこの構造体を使用する操作の属性を指定するビットフラグの集合です。これらのフラグは、有効なメンバー、または設定しなければならないメンバーを指定します。このメンバーには次の値の組み合わせを指定できます。

Value Meaning
CBEIF_DI_SETITEM
CBEN_GETDISPINFO の処理時にこのフラグを設定します。ComboBoxEx コントロールは、指定された情報を保持し、再度要求しません。
CBEIF_IMAGE
                    <b>iImage</b> メンバーが有効であるか、設定しなければならないことを示します。
CBEIF_INDENT
                    <b>iIndent</b> メンバーが有効であるか、設定しなければならないことを示します。
CBEIF_LPARAM
                    <b>lParam</b> メンバーが有効であるか、設定しなければならないことを示します。
CBEIF_OVERLAY
                    <b>iOverlay</b> メンバーが有効であるか、設定しなければならないことを示します。
CBEIF_SELECTEDIMAGE
                    <b>iSelectedImage</b> メンバーが有効であるか、設定しなければならないことを示します。
CBEIF_TEXT
                    <b>pszText</b> メンバーが有効であるか、設定しなければならないことを示します。
iItemINT_PTR8/4+8+4項目の 0 から始まるインデックスです。
pszTextLPWSTR8/4+16+8項目のテキストを格納する、またはテキストを受け取る文字バッファーへのポインターです。テキスト情報を取得する場合、このメンバーにはテキストを受け取る文字バッファーのアドレスを設定しなければなりません。また、そのバッファーのサイズを cchTextMax に指定する必要があります。このメンバーに LPSTR_TEXTCALLBACK を設定すると、コントロールは CBEN_GETDISPINFO 通知コードを使用して情報を要求します。
cchTextMaxINT4+24+12pszText の長さ (TCHARs 単位) です。テキスト情報を設定する場合、このメンバーは無視されます。
iImageINT4+28+16イメージリスト内のイメージの、0 から始まるインデックスです。指定されたイメージは、項目が選択されていないときに表示されます。このメンバーに I_IMAGECALLBACK を設定すると、コントロールは CBEN_GETDISPINFO 通知コードを使用して情報を要求します。
iSelectedImageINT4+32+20イメージリスト内のイメージの、0 から始まるインデックスです。指定されたイメージは、項目が選択されているときに表示されます。このメンバーに I_IMAGECALLBACK を設定すると、コントロールは CBEN_GETDISPINFO 通知コードを使用して情報を要求します。
iOverlayINT4+36+24イメージリスト内のオーバーレイイメージの、1 から始まるインデックスです。このメンバーに I_IMAGECALLBACK を設定すると、コントロールは CBEN_GETDISPINFO 通知コードを使用して情報を要求します。
iIndentINT4+40+28項目に対して表示するインデントの数です。1 インデントは 10 ピクセルに相当します。このメンバーに I_INDENTCALLBACK を設定すると、コントロールは CBEN_GETDISPINFO 通知コードを使用して情報を要求します。
lParamLPARAM8/4+48+32項目に固有の値です。

公式ドキュメント

ComboBoxEx コントロール内の項目に関する情報を格納します。

解説(Remarks)

メモ

commctrl.h ヘッダーは COMBOBOXEXITEM を、UNICODE プリプロセッサ定数の定義に応じてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして定義します。エンコーディング中立のエイリアスを、エンコーディング中立でないコードと混在させて使用すると、不一致が生じてコンパイルエラーや実行時エラーの原因になることがあります。詳細については、Conventions for Function Prototypes を参照してください。

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

各言語での定義

#include <windows.h>

// COMBOBOXEXITEMW  (x64 56 / x86 36 バイト)
typedef struct COMBOBOXEXITEMW {
    COMBOBOX_EX_ITEM_FLAGS mask;
    INT_PTR iItem;
    LPWSTR pszText;
    INT cchTextMax;
    INT iImage;
    INT iSelectedImage;
    INT iOverlay;
    INT iIndent;
    LPARAM lParam;
} COMBOBOXEXITEMW;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct COMBOBOXEXITEMW
{
    public uint mask;
    public IntPtr iItem;
    public IntPtr pszText;
    public int cchTextMax;
    public int iImage;
    public int iSelectedImage;
    public int iOverlay;
    public int iIndent;
    public IntPtr lParam;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure COMBOBOXEXITEMW
    Public mask As UInteger
    Public iItem As IntPtr
    Public pszText As IntPtr
    Public cchTextMax As Integer
    Public iImage As Integer
    Public iSelectedImage As Integer
    Public iOverlay As Integer
    Public iIndent As Integer
    Public lParam As IntPtr
End Structure
import ctypes
from ctypes import wintypes

class COMBOBOXEXITEMW(ctypes.Structure):
    _fields_ = [
        ("mask", wintypes.DWORD),
        ("iItem", ctypes.c_ssize_t),
        ("pszText", ctypes.c_void_p),
        ("cchTextMax", ctypes.c_int),
        ("iImage", ctypes.c_int),
        ("iSelectedImage", ctypes.c_int),
        ("iOverlay", ctypes.c_int),
        ("iIndent", ctypes.c_int),
        ("lParam", ctypes.c_ssize_t),
    ]
#[repr(C)]
pub struct COMBOBOXEXITEMW {
    pub mask: u32,
    pub iItem: isize,
    pub pszText: *mut core::ffi::c_void,
    pub cchTextMax: i32,
    pub iImage: i32,
    pub iSelectedImage: i32,
    pub iOverlay: i32,
    pub iIndent: i32,
    pub lParam: isize,
}
import "golang.org/x/sys/windows"

type COMBOBOXEXITEMW struct {
	mask uint32
	iItem uintptr
	pszText uintptr
	cchTextMax int32
	iImage int32
	iSelectedImage int32
	iOverlay int32
	iIndent int32
	lParam uintptr
}
type
  COMBOBOXEXITEMW = record
    mask: DWORD;
    iItem: NativeInt;
    pszText: Pointer;
    cchTextMax: Integer;
    iImage: Integer;
    iSelectedImage: Integer;
    iOverlay: Integer;
    iIndent: Integer;
    lParam: NativeInt;
  end;
const COMBOBOXEXITEMW = extern struct {
    mask: u32,
    iItem: isize,
    pszText: ?*anyopaque,
    cchTextMax: i32,
    iImage: i32,
    iSelectedImage: i32,
    iOverlay: i32,
    iIndent: i32,
    lParam: isize,
};
type
  COMBOBOXEXITEMW {.bycopy.} = object
    mask: uint32
    iItem: int
    pszText: pointer
    cchTextMax: int32
    iImage: int32
    iSelectedImage: int32
    iOverlay: int32
    iIndent: int32
    lParam: int
struct COMBOBOXEXITEMW
{
    uint mask;
    ptrdiff_t iItem;
    void* pszText;
    int cchTextMax;
    int iImage;
    int iSelectedImage;
    int iOverlay;
    int iIndent;
    ptrdiff_t lParam;
}

HSP用 定義

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

; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; COMBOBOXEXITEMW サイズ: 36 バイト(x86)
dim st, 9    ; 4byte整数×9(構造体サイズ 36 / 4 切り上げ)
; mask : COMBOBOX_EX_ITEM_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; iItem : INT_PTR (+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 も可)
; iImage : INT (+16, 4byte)  st.4 = 値  /  値 = st.4   (lpoke/lpeek も可)
; iSelectedImage : INT (+20, 4byte)  st.5 = 値  /  値 = st.5   (lpoke/lpeek も可)
; iOverlay : INT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; iIndent : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; lParam : LPARAM (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; COMBOBOXEXITEMW サイズ: 56 バイト(x64)
dim st, 14    ; 4byte整数×14(構造体サイズ 56 / 4 切り上げ)
; mask : COMBOBOX_EX_ITEM_FLAGS (+0, 4byte)  st.0 = 値  /  値 = st.0   (lpoke/lpeek も可)
; iItem : INT_PTR (+8, 8byte)  qpoke st,8,値 / qpeek(st,8)  ※IronHSPのみ。3.7/3.8は lpoke st,8,下位 : lpoke st,12,上位
; pszText : LPWSTR (+16, 8byte)  qpoke st,16,値 / qpeek(st,16)  ※IronHSPのみ。3.7/3.8は lpoke st,16,下位 : lpoke st,20,上位
; cchTextMax : INT (+24, 4byte)  st.6 = 値  /  値 = st.6   (lpoke/lpeek も可)
; iImage : INT (+28, 4byte)  st.7 = 値  /  値 = st.7   (lpoke/lpeek も可)
; iSelectedImage : INT (+32, 4byte)  st.8 = 値  /  値 = st.8   (lpoke/lpeek も可)
; iOverlay : INT (+36, 4byte)  st.9 = 値  /  値 = st.9   (lpoke/lpeek も可)
; iIndent : INT (+40, 4byte)  st.10 = 値  /  値 = st.10   (lpoke/lpeek も可)
; lParam : LPARAM (+48, 8byte)  qpoke st,48,値 / qpeek(st,48)  ※IronHSPのみ。3.7/3.8は lpoke st,48,下位 : lpoke st,52,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。
; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
#defstruct global COMBOBOXEXITEMW
    #field int mask
    #field intptr iItem
    #field intptr pszText
    #field int cchTextMax
    #field int iImage
    #field int iSelectedImage
    #field int iOverlay
    #field int iIndent
    #field intptr lParam
#endstruct

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