RESULTDATAITEM

[This is preliminary documentation and subject to change.]

The RESULTDATAITEM structure specifies or receives the attributes of the result pane.

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

Members

mask

A set of bit flags that specify attributes of this data structure or of an operation that is using this structure.

The following bit flags specify the members of the RESULTDATAITEM structure that contain valid data or need to be filled in. One or more of these bit flags may be set:

Value:	Meaning
RDI_STR = 0x0002	The str member is valid or needs to be filled in.
RDI_IMAGE = 0x0004	The nImage member is valid or needs to be filled in.
RDI_STATE = 0x0008	The nState member is valid or needs to be filled in.
RDI_PARAM = 0x0010	The lParam member is valid or needs to be filled in.
RDI_INDEX = 0x0020	The nIndex member is valid or needs to be filled in.
RDI_INDENT = 0x0040	The iIndent member is valid or needs to be filled in.

bScopeItem

TRUE if the lParam member refers to a scope pane item. FALSE if the lParam member refers to a result pane item.

itemID

Specifies a unique item identifier.

nIndex

Specifies the zero-based index of the item to which this structure refers.

nCol

Specifies the column on which an operation is to be performed or zero if the operation is to be performed on an item rather than an individual column.

str

Pointer to a null-terminated string that contains the item text if the structure specifies RDI_STR item attribute. If this member is the MMC_CALLBACK value, the item is a callback item.

nImage

Virtual image index of the list view item's icon in the large icon and small icon image lists. Note that the virtual image index is internally mapped to the actual index.

nState

Specifies the state mask for the item. It can be one of the following:

Value	Meaning
LVIS_CUT	The item is marked for a cut and paste operation.
LVIS_DROPHILITED	The item is highlighted as a drag-and-drop target.
LVIS_FOCUSED	The item has focus, so it is surrounded by a standard focus rectangle. Although more than one item may be selected, only one item can have focus.
LVIS_SELECTED	The item is selected. The appearance of a selected item depends on whether it has focus and on the system colors used for the selection.

lParam

Specifies a user-supplied 32-bit value to associate with the item. This item, also called a cookie, is the value that is passed as the first parameter to IComponent::QueryDataObject.

iIndent

(reserved)

See Also

IResultData