Estrutura RESULTDATAITEM (mmc.h)

A estrutura RESULTDATAITEM especifica ou recebe os atributos dos itens de resultado no painel de resultados do snap-in.

Sintaxe

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

Membros

mask

Um conjunto de sinalizadores que especifica atributos dessa estrutura de dados ou uma operação que usa essa estrutura.

Os sinalizadores a seguir especificam os membros da estrutura RESULTDATAITEM que contêm dados válidos ou precisam ser preenchidos com dados. Um ou mais sinalizadores podem ser definidos.

RDI_STR (0x0002)

O membro str é válido ou deve ser preenchido.

RDI_IMAGE (0x0004)

O membro nImage é válido ou deve ser preenchido.

RDI_STATE (0x0008)

O membro nState é válido ou deve ser preenchido.

RDI_PARAM (0x0010)

O membro lParam é válido ou deve ser preenchido.

RDI_INDEX (0x0020)

O membro nIndex é válido ou deve ser preenchido.

RDI_INDENT (0x0040)

O membro iIndent é válido ou deve ser preenchido.

bScopeItem

TRUE se o membro lParam se referir a um item de escopo. FALSE se o membro lParam se referir a um item de resultado.

itemID

Um valor que especifica um identificador de item exclusivo fornecido pelo console para o item de resultado. Esse valor é usado para identificar um item no painel de resultados de chamadas para alguns
Métodos de interface IResultData .

Após o snap-in inserir com êxito um item no painel de escopo (usando IResultData::InsertItem), o membro itemID da estrutura RESULTDATAITEM contém o identificador HRESULTITEM do item recém-inserido. Esse identificador é o identificador exclusivo do item de resultado.

O snap-in deve armazenar esse valor para manipular (posteriormente) o item inserido chamando métodos como IResultData::GetItem. Se esse valor não for armazenado, ele poderá ser pesquisado usando IResultData::FindItemByLParam.

nIndex

Um valor que especifica o índice baseado em zero do item ao qual essa estrutura se refere.

nCol

Um valor que especifica a coluna na qual uma operação deve ser executada. Se a operação for executada em um item e não em uma coluna, o valor será zero (0).

str

Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o texto do item se a estrutura especificar o atributo de item RDI_STR . Se esse membro for o valor MMC_CALLBACK , o item será um item de retorno de chamada.

Lembre-se de que o snap-in pode usar MMC_TEXTCALLBACK em vez de MMC_CALLBACK. O valor MMC_TEXTCALLBACK é uma versão correta do tipo (nenhuma conversão necessária) do MMC_CALLBACK.

MMC_TEXTCALLBACK é introduzido no MMC versão 1.2.

nImage

Índice de imagem virtual do ícone do item de exibição de lista nas listas de imagens de ícone grande e pequena. Lembre-se de que o índice de imagem virtual é mapeado internamente para o índice real. Esse membro também pode ser especificado como um item de retorno de chamada: MMC_CALLBACK ou MMC_IMAGECALLBACK. O valor MMC_IMAGECALLBACK é uma versão correta do tipo (nenhuma conversão necessária) do MMC_CALLBACK.

MMC_IMAGECALLBACK é introduzido no MMC versão 1.2.

nState

Um valor que especifica a máscara de estado do item. Pode ser um dos seguintes valores.

LVIS_CUT

O item é marcado para uma operação de recortar e colar.

LVIS_DROPHILITED

O item é realçado como um destino de arrastar e soltar.

LVIS_FOCUSED

O item tem o foco, portanto, ele é cercado por um retângulo de foco padrão. Mais de um item pode ser selecionado, mas apenas um item pode ter o foco.

LVIS_SELECTED

O item está selecionado. A aparência de um item selecionado depende se ele tem o foco e as cores do sistema usadas para a seleção.

Nota Para usar as constantes LVIS_* , inclua CommCtrl.h no arquivo de origem.

 

lParam

Um valor que especifica um valor de 32 bits fornecido pelo usuário a ser associado ao item. Esse item, também chamado de cookie, é o valor que é passado como o primeiro parâmetro para IComponent::QueryDataObject.

iIndent

Reservado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	mmc.h

Confira também

IResultData