RESULTDATAITEM 結構 (mmc.h)

發行項
02/29/2024

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

如果結構指定 RDI_STR 項目屬性，則為包含項目文字之 Null 終止字串的指標。如果這個成員是 MMC_CALLBACK 值，專案就是回呼專案。

請注意，嵌入式管理單元可以使用 MMC_TEXTCALLBACK ，而不是 MMC_CALLBACK。 MMC_TEXTCALLBACK值是類型正確的 (不需要) 版本的MMC_CALLBACK。

MMC_TEXTCALLBACK 是在 MMC 1.2 版中引進。

nImage

大型和小型圖示影像清單中清單檢視項目圖示的虛擬影像索引。請注意，虛擬映射索引會在內部對應至實際索引。此成員也可以指定為回呼專案： MMC_CALLBACK 或 MMC_IMAGECALLBACK。 MMC_IMAGECALLBACK值是類型正確的 (不需要) 版本的MMC_CALLBACK轉換。

MMC_IMAGECALLBACK 是在 MMC 1.2 版中引進。

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

共用方式為