共用方式為


RESULTDATAITEM 結構 (mmc.h)

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_CALLBACKMMC_TEXTCALLBACK值是類型正確的 (不需要) 版本的MMC_CALLBACK

MMC_TEXTCALLBACK 是在 MMC 1.2 版中引進。

nImage

大型和小型圖示影像清單中清單檢視項目圖示的虛擬影像索引。 請注意,虛擬映射索引會在內部對應至實際索引。 此成員也可以指定為回呼專案: MMC_CALLBACKMMC_IMAGECALLBACKMMC_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