RESULTDATAITEM 结构 (mmc.h)

项目
08/24/2023

RESULTDATAITEM 结构指定或接收管理单元结果窗格中结果项的属性。

语法

typedef struct _RESULTDATAITEM {
  DWORD       mask;
  BOOL        bScopeItem;
  HRESULTITEM itemID;
  int         nIndex;
  int         nCol;
  LPOLESTR    str;
  int         nImage;
  UINT        nState;
  LPARAM      lParam;
  int         iIndent;
} RESULTDATAITEM;

成员

mask

一组标志，指定此数据结构的属性，或使用此结构的操作。

以下标志指定包含有效数据或需要用数据填充的 RESULTDATAITEM 结构的成员。可以设置一个或多个标志。

RDI_STR (0x0002)

str 成员有效或必须填写。

RDI_IMAGE (0x0004)

nImage 成员有效或必须填写。

RDI_STATE (0x0008)

nState 成员有效或必须填写。

RDI_PARAM (0x0010)

lParam 成员有效或必须填写。

RDI_INDEX (0x0020)

nIndex 成员有效或必须填写。

RDI_INDENT (0x0040)

iIndent 成员有效或必须填写。

bScopeItem

如果 lParam 成员引用范围项，则为 TRUE。如果 lParam 成员引用结果项，则为 FALSE。

itemID

一个值，该值指定控制台为结果项提供的唯一项标识符。此值用于标识对某些调用的结果窗格中的项
IResultData 接口方法。

管理单元使用 IResultData：：InsertItem) 在作用域窗格中成功插入项 (后，RESULTDATAITEM 结构的 itemID 成员包含新插入的项的 HRESULTITEM 句柄。此句柄是结果项的唯一标识符。

管理单元应存储此值以操作 (稍后通过调用 IResultData：：GetItem 等方法) 插入的项。如果未存储此值，可以使用 IResultData：：FindItemByLParam 查找该值。

nIndex

一个值，该值指定此结构所引用的项的从零开始的索引。

nCol

一个值，该值指定要对其执行操作的列。如果要对项而不是列执行操作，则值为零 (0) 。

str

指向以 null 结尾的字符串的指针，如果结构指定 RDI_STR 项属性，则该字符串包含项文本。如果此成员是 MMC_CALLBACK 值，则该项是回调项。

请注意，管理单元可以使用 MMC_TEXTCALLBACK 而不是 MMC_CALLBACK。 MMC_TEXTCALLBACK值是类型正确的 (无需强制转换) 版本的MMC_CALLBACK。

MMC 版本 1.2 中引入了MMC_TEXTCALLBACK。

nImage

大图标和小图标图像列表中的列表视图项图标的虚拟图像索引。请注意，虚拟图像索引在内部映射到实际索引。还可以将此成员指定为回调项： MMC_CALLBACK 或 MMC_IMAGECALLBACK。 MMC_IMAGECALLBACK值是一个类型正确的 (无需强制转换) 版本的MMC_CALLBACK。

MMC 版本 1.2 中引入了MMC_IMAGECALLBACK。

nState

一个值，该值指定项的状态掩码。可以是下列值之一。

LVIS_CUT

项被标记为剪切操作。

LVIS_DROPHILITED

项被标记为拖放目标。

LVIS_FOCUSED

该项具有焦点，因此它被标准焦点矩形包围。可以选择多个项，但只有一个项目可以具有焦点。

LVIS_SELECTED

该项已选定。所选项的外观取决于它是否具有焦点，以及用于选择的系统颜色。

注意若要使用 LVIS_* 常量，请在源文件中包含 CommCtrl.h。

lParam

一个值，该值指定要与项关联的用户提供的 32 位值。此项也称为 Cookie，是作为第一个参数传递给 IComponent：：QueryDataObject 的值。

iIndent

保留。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	mmc.h

另请参阅

IResultData

通过