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_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
這個項目已選取。 選取項目的外觀取決於其是否具有焦點,以及用於選取項目的系統色彩。
lParam
值,指定要與專案產生關聯的使用者提供32位值。 此專案也稱為 Cookie,是當做第一個參數傳遞至 IComponent::QueryDataObject 的值。
iIndent
保留的。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
標頭 | mmc.h |