Estructura RESULTDATAITEM (mmc.h)
La estructura RESULTDATAITEM especifica o recibe los atributos de los elementos de resultado en el panel de resultados del complemento.
Sintaxis
typedef struct _RESULTDATAITEM {
DWORD mask;
BOOL bScopeItem;
HRESULTITEM itemID;
int nIndex;
int nCol;
LPOLESTR str;
int nImage;
UINT nState;
LPARAM lParam;
int iIndent;
} RESULTDATAITEM;
Miembros
mask
Conjunto de marcas que especifica los atributos de esta estructura de datos o una operación que usa esta estructura.
Las marcas siguientes especifican los miembros de la estructura RESULTDATAITEM que contienen datos válidos o deben rellenarse con datos. Se pueden establecer una o varias marcas.
RDI_STR (0x0002)
El miembro str es válido o debe rellenarse.
RDI_IMAGE (0x0004)
El miembro nImage es válido o debe rellenarse.
RDI_STATE (0x0008)
El miembro nState es válido o debe rellenarse.
RDI_PARAM (0x0010)
El miembro lParam es válido o debe rellenarse.
RDI_INDEX (0x0020)
El miembro nIndex es válido o debe rellenarse.
RDI_INDENT (0x0040)
El miembro iIndent es válido o debe rellenarse.
bScopeItem
TRUE si el miembro lParam hace referencia a un elemento de ámbito. FALSE si el miembro lParam hace referencia a un elemento de resultado.
itemID
Valor que especifica un identificador de elemento único proporcionado por la consola para el elemento de resultado. Este valor se usa para identificar un elemento en el panel de resultados de las llamadas a algunos
Métodos de interfaz IResultData .
Después de que el complemento inserte correctamente un elemento en el panel de ámbito (mediante IResultData::InsertItem), el miembro itemID de la estructura RESULTDATAITEM contiene el identificador HRESULTITEM del elemento recién insertado. Este identificador es el identificador único del elemento de resultado.
El complemento debe almacenar este valor para manipular (más adelante) el elemento insertado llamando a métodos como IResultData::GetItem. Si no se almacena este valor, se puede buscar mediante IResultData::FindItemByLParam.
nIndex
Valor que especifica el índice de base cero del elemento al que hace referencia esta estructura.
nCol
Valor que especifica la columna en la que se va a realizar una operación. Si la operación se va a realizar en un elemento y no en una columna, el valor es cero (0).
str
Puntero a una cadena terminada en null que contiene el texto del elemento si la estructura especifica el atributo de elemento RDI_STR . Si este miembro es el valor MMC_CALLBACK , el elemento es un elemento de devolución de llamada.
Tenga en cuenta que el complemento puede usar MMC_TEXTCALLBACK en lugar de MMC_CALLBACK. El valor de MMC_TEXTCALLBACK es una versión correcta del tipo (sin necesidad de conversión) de MMC_CALLBACK.
MMC_TEXTCALLBACK se introduce en MMC versión 1.2.
nImage
Índice de imagen virtual del icono del elemento de vista de lista en las listas de imágenes de iconos grandes y pequeños. Tenga en cuenta que el índice de imagen virtual se asigna internamente al índice real. Este miembro también se puede especificar como un elemento de devolución de llamada: MMC_CALLBACK o MMC_IMAGECALLBACK. El valor MMC_IMAGECALLBACK es una versión correcta del tipo (sin necesidad de conversión) de MMC_CALLBACK.
MMC_IMAGECALLBACK se introduce en MMC versión 1.2.
nState
Valor que especifica la máscara de estado del elemento. Puede ser uno de los siguientes valores.
LVIS_CUT
El elemento está marcado para una operación de cortar y pegar.
LVIS_DROPHILITED
El elemento se resalta como destino de arrastrar y colocar.
LVIS_FOCUSED
El elemento tiene el foco, por lo que está rodeado por un rectángulo de foco estándar. Se puede seleccionar más de un elemento, pero solo un elemento puede tener el foco.
LVIS_SELECTED
El elemento está seleccionado. La apariencia de un elemento seleccionado depende de si tiene el foco y de los colores del sistema usados para la selección.
lParam
Valor que especifica un valor de 32 bits proporcionado por el usuario que se va a asociar al elemento. Este elemento, también denominado cookie, es el valor que se pasa como primer parámetro a IComponent::QueryDataObject.
iIndent
Reservado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | mmc.h |