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

COMBOBOXEXITEMA

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

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

フィールド

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

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

意味
CBEIF_DI_SETITEM
CBEN_GETDISPINFO を処理するときにこのフラグを設定します。ComboBoxEx コントロールは指定された情報を保持し、再度要求することはありません。
CBEIF_IMAGE
iImage メンバーが有効であるか、または設定する必要があります。
CBEIF_INDENT
iIndent メンバーが有効であるか、または設定する必要があります。
CBEIF_LPARAM
lParam メンバーが有効であるか、または設定する必要があります。
CBEIF_OVERLAY
iOverlay メンバーが有効であるか、または設定する必要があります。
CBEIF_SELECTEDIMAGE
iSelectedImage メンバーが有効であるか、または設定する必要があります。
CBEIF_TEXT
pszText メンバーが有効であるか、または設定する必要があります。
iItemINT_PTR8/4+8+4項目の 0 から始まるインデックスです。
pszTextLPSTR8/4+16+8項目のテキストを格納する、またはテキストを受け取る文字バッファーへのポインターです。テキスト情報を取得する場合、このメンバーにはテキストを受け取る文字バッファーのアドレスを設定する必要があります。また、そのバッファーのサイズを cchTextMax に指定する必要があります。このメンバーに LPSTR_TEXTCALLBACK を設定した場合、コントロールは CBEN_GETDISPINFO 通知コードを使用してこの情報を要求します。
cchTextMaxINT4+24+12pszText の長さを TCHAR 単位で指定します。テキスト情報を設定する場合、このメンバーは無視されます。
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 ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいてこの関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして COMBOBOXEXITEM を定義しています。エンコーディング中立のエイリアスを、エンコーディング中立でないコードと混在させると不一致が生じ、コンパイルエラーや実行時エラーの原因となる場合があります。詳細については、関数プロトタイプの規則 を参照してください。

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

各言語での定義

#include <windows.h>

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

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct COMBOBOXEXITEMA
{
    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 COMBOBOXEXITEMA
    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 COMBOBOXEXITEMA(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 COMBOBOXEXITEMA {
    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 COMBOBOXEXITEMA struct {
	mask uint32
	iItem uintptr
	pszText uintptr
	cchTextMax int32
	iImage int32
	iSelectedImage int32
	iOverlay int32
	iIndent int32
	lParam uintptr
}
type
  COMBOBOXEXITEMA = record
    mask: DWORD;
    iItem: NativeInt;
    pszText: Pointer;
    cchTextMax: Integer;
    iImage: Integer;
    iSelectedImage: Integer;
    iOverlay: Integer;
    iIndent: Integer;
    lParam: NativeInt;
  end;
const COMBOBOXEXITEMA = extern struct {
    mask: u32,
    iItem: isize,
    pszText: ?*anyopaque,
    cchTextMax: i32,
    iImage: i32,
    iSelectedImage: i32,
    iOverlay: i32,
    iIndent: i32,
    lParam: isize,
};
type
  COMBOBOXEXITEMA {.bycopy.} = object
    mask: uint32
    iItem: int
    pszText: pointer
    cchTextMax: int32
    iImage: int32
    iSelectedImage: int32
    iOverlay: int32
    iIndent: int32
    lParam: int
struct COMBOBOXEXITEMA
{
    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 レイアウト)
; COMBOBOXEXITEMA サイズ: 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 : LPSTR (+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 レイアウト)
; COMBOBOXEXITEMA サイズ: 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 : LPSTR (+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 COMBOBOXEXITEMA
    #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, COMBOBOXEXITEMA        ; NSTRUCT 変数を確保
st->mask = 100
mes "mask=" + st->mask