Win32 API 日本語リファレンス
ホームSystem.Mmc › RESULTDATAITEM

RESULTDATAITEM

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

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

フィールド

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

このデータ構造の属性、またはこの構造体を使用する操作を指定するフラグのセットです。

次のフラグは、 RESULTDATAITEM 構造体のうち、有効なデータが格納されているメンバー、またはデータを設定する必要があるメンバーを指定します。1 つ以上のフラグを設定できます。

RDI_STR (0x0002)

str メンバーが有効であるか、または設定する必要があります。

RDI_IMAGE (0x0004)

nImage メンバーが有効であるか、または設定する必要があります。

RDI_STATE (0x0008)

nState メンバーが有効であるか、または設定する必要があります。

RDI_PARAM (0x0010)

lParam メンバーが有効であるか、または設定する必要があります。

RDI_INDEX (0x0020)

nIndex メンバーが有効であるか、または設定する必要があります。

RDI_INDENT (0x0040)

iIndent メンバーが有効であるか、または設定する必要があります。

bScopeItemBOOL4+4+4lParam メンバーがスコープ項目を参照する場合は TRUE です。lParam メンバーが結果項目を参照する場合は FALSE です。
itemIDINT_PTR8/4+8+8

結果項目に対してコンソールが提供する一意の項目識別子を指定する値です。この値は、一部の IResultData インターフェイスのメソッドを呼び出す際に、結果ペイン内の項目を識別するために使用されます。

スナップインが (IResultData::InsertItem を使用して) スコープペインへの項目の挿入に成功すると、 RESULTDATAITEM 構造体の itemID メンバーには、新しく挿入された項目の HRESULTITEM ハンドルが格納されます。このハンドルは、その結果項目の一意の識別子です。

スナップインは、後で IResultData::GetItem などのメソッドを呼び出して、挿入した項目を操作できるように、この値を保存しておく必要があります。この値を保存していない場合は、IResultData::FindItemByLParam を使用して調べることができます。

nIndexINT4+16+12この構造体が参照する項目の 0 から始まるインデックスを指定する値です。
nColINT4+20+16操作を実行する対象の列を指定する値です。列ではなく項目に対して操作を実行する場合、値は 0 になります。
strLPWSTR8/4+24+20

構造体が RDI_STR 項目属性を指定している場合に、項目のテキストを格納する null 終端文字列へのポインターです。このメンバーが MMC_CALLBACK 値である場合、その項目はコールバック項目です。

スナップインは、MMC_CALLBACK の代わりに MMC_TEXTCALLBACK を使用できることに注意してください。MMC_TEXTCALLBACK 値は、MMC_CALLBACK の型が正しい (キャスト不要な) バージョンです。

MMC_TEXTCALLBACK は MMC バージョン 1.2 で導入されました。

nImageINT4+32+24

大きいアイコンおよび小さいアイコンのイメージリストにおける、リストビュー項目のアイコンの仮想イメージインデックスです。仮想イメージインデックスは内部的に実際のインデックスにマップされることに注意してください。このメンバーは、コールバック項目として MMC_CALLBACK または MMC_IMAGECALLBACK を指定することもできます。MMC_IMAGECALLBACK 値は、MMC_CALLBACK の型が正しい (キャスト不要な) バージョンです。

MMC_IMAGECALLBACK は MMC バージョン 1.2 で導入されました。

nStateDWORD4+36+28

項目の状態マスクを指定する値です。次のいずれかの値を指定できます。

LVIS_CUT

項目は切り取りと貼り付け操作の対象としてマークされています。

LVIS_DROPHILITED

項目はドラッグアンドドロップのターゲットとして強調表示されています。

LVIS_FOCUSED

項目はフォーカスを持っており、標準のフォーカス四角形で囲まれます。複数の項目を選択できますが、フォーカスを持てるのは 1 つの項目だけです。

LVIS_SELECTED

項目は選択されています。選択された項目の外観は、その項目がフォーカスを持っているかどうか、および選択に使用されるシステムカラーによって異なります。

メモ LVIS_* 定数を使用するには、ソースファイルに CommCtrl.h をインクルードしてください。
lParamLPARAM8/4+40+32項目に関連付ける、ユーザーが指定した 32 ビット値を指定する値です。この項目は cookie とも呼ばれ、 IComponent::QueryDataObject の第 1 パラメーターとして渡される値です。
iIndentINT4+48+36予約済みです。

公式ドキュメント

RESULTDATAITEM 構造体は、スナップインの結果ペインにある結果項目の属性を指定するか、または受け取ります。

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

各言語での定義

#include <windows.h>

// RESULTDATAITEM  (x64 56 / x86 40 バイト)
typedef struct RESULTDATAITEM {
    DWORD mask;
    BOOL bScopeItem;
    INT_PTR itemID;
    INT nIndex;
    INT nCol;
    LPWSTR str;
    INT nImage;
    DWORD nState;
    LPARAM lParam;
    INT iIndent;
} RESULTDATAITEM;
using System;
using System.Runtime.InteropServices;

[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct RESULTDATAITEM
{
    public uint mask;
    [MarshalAs(UnmanagedType.Bool)] public bool bScopeItem;
    public IntPtr itemID;
    public int nIndex;
    public int nCol;
    public IntPtr str;
    public int nImage;
    public uint nState;
    public IntPtr lParam;
    public int iIndent;
}
Imports System.Runtime.InteropServices

<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure RESULTDATAITEM
    Public mask As UInteger
    <MarshalAs(UnmanagedType.Bool)> Public bScopeItem As Boolean
    Public itemID As IntPtr
    Public nIndex As Integer
    Public nCol As Integer
    Public str As IntPtr
    Public nImage As Integer
    Public nState As UInteger
    Public lParam As IntPtr
    Public iIndent As Integer
End Structure
import ctypes
from ctypes import wintypes

class RESULTDATAITEM(ctypes.Structure):
    _fields_ = [
        ("mask", wintypes.DWORD),
        ("bScopeItem", wintypes.BOOL),
        ("itemID", ctypes.c_ssize_t),
        ("nIndex", ctypes.c_int),
        ("nCol", ctypes.c_int),
        ("str", ctypes.c_void_p),
        ("nImage", ctypes.c_int),
        ("nState", wintypes.DWORD),
        ("lParam", ctypes.c_ssize_t),
        ("iIndent", ctypes.c_int),
    ]
#[repr(C)]
pub struct RESULTDATAITEM {
    pub mask: u32,
    pub bScopeItem: i32,
    pub itemID: isize,
    pub nIndex: i32,
    pub nCol: i32,
    pub str: *mut core::ffi::c_void,
    pub nImage: i32,
    pub nState: u32,
    pub lParam: isize,
    pub iIndent: i32,
}
import "golang.org/x/sys/windows"

type RESULTDATAITEM struct {
	mask uint32
	bScopeItem int32
	itemID uintptr
	nIndex int32
	nCol int32
	str uintptr
	nImage int32
	nState uint32
	lParam uintptr
	iIndent int32
}
type
  RESULTDATAITEM = record
    mask: DWORD;
    bScopeItem: BOOL;
    itemID: NativeInt;
    nIndex: Integer;
    nCol: Integer;
    str: Pointer;
    nImage: Integer;
    nState: DWORD;
    lParam: NativeInt;
    iIndent: Integer;
  end;
const RESULTDATAITEM = extern struct {
    mask: u32,
    bScopeItem: i32,
    itemID: isize,
    nIndex: i32,
    nCol: i32,
    str: ?*anyopaque,
    nImage: i32,
    nState: u32,
    lParam: isize,
    iIndent: i32,
};
type
  RESULTDATAITEM {.bycopy.} = object
    mask: uint32
    bScopeItem: int32
    itemID: int
    nIndex: int32
    nCol: int32
    str: pointer
    nImage: int32
    nState: uint32
    lParam: int
    iIndent: int32
struct RESULTDATAITEM
{
    uint mask;
    int bScopeItem;
    ptrdiff_t itemID;
    int nIndex;
    int nCol;
    void* str;
    int nImage;
    uint nState;
    ptrdiff_t lParam;
    int iIndent;
}

HSP用 定義

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

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

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