STRUCTURE RESULTDATAITEM (mmc.h)

La structure RESULTDATAITEM spécifie ou reçoit les attributs des éléments de résultat dans le volet de résultats du composant logiciel enfichable.

Syntaxe

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

Membres

mask

Ensemble d’indicateurs qui spécifie les attributs de cette structure de données, ou une opération qui utilise cette structure.

Les indicateurs suivants spécifient les membres de la structure RESULTDATAITEM qui contiennent des données valides ou qui doivent être renseignés avec des données. Un ou plusieurs des indicateurs peuvent être définis.

RDI_STR (0x0002)

Le membre str est valide ou doit être renseigné.

RDI_IMAGE (0x0004)

Le membre nImage est valide ou doit être renseigné.

RDI_STATE (0x0008)

Le membre nState est valide ou doit être renseigné.

RDI_PARAM (0x0010)

Le membre lParam est valide ou doit être renseigné.

RDI_INDEX (0x0020)

Le membre nIndex est valide ou doit être renseigné.

RDI_INDENT (0x0040)

Le membre iIndent est valide ou doit être renseigné.

bScopeItem

TRUE si le membre lParam fait référence à un élément d’étendue. FALSE si le membre lParam fait référence à un élément de résultat.

itemID

Valeur qui spécifie un identificateur d’élément unique fourni par la console pour l’élément de résultat. Cette valeur est utilisée pour identifier un élément dans le volet de résultats des appels à certains
Méthodes d’interface IResultData .

Une fois que le composant logiciel enfichable a correctement inséré un élément dans le volet d’étendue (à l’aide de IResultData ::InsertItem), le membre itemID de la structure RESULTDATAITEM contient le handle HRESULTITEM de l’élément nouvellement inséré. Ce handle est l’identificateur unique de l’élément de résultat.

Le composant logiciel enfichable doit stocker cette valeur pour manipuler (ultérieurement) l’élément inséré en appelant des méthodes telles que IResultData ::GetItem. Si cette valeur n’est pas stockée, vous pouvez la rechercher à l’aide de IResultData ::FindItemByLParam.

nIndex

Valeur qui spécifie l’index de base zéro de l’élément auquel cette structure fait référence.

nCol

Valeur qui spécifie la colonne sur laquelle une opération doit être effectuée. Si l’opération doit être effectuée sur un élément et non sur une colonne, la valeur est zéro (0).

str

Pointeur vers une chaîne terminée par null qui contient le texte de l’élément si la structure spécifie l’attribut élément RDI_STR . Si ce membre est la valeur MMC_CALLBACK , l’élément est un élément de rappel.

N’oubliez pas que le composant logiciel enfichable peut utiliser MMC_TEXTCALLBACK au lieu de MMC_CALLBACK. La valeur MMC_TEXTCALLBACK est une version correcte de type (aucune conversion nécessaire) de MMC_CALLBACK.

MMC_TEXTCALLBACK est introduit dans MMC version 1.2.

nImage

Index d’image virtuelle de l’icône de l’élément d’affichage de liste dans les grandes et petites listes d’images d’icônes. N’oubliez pas que l’index d’image virtuelle est mappé en interne à l’index réel. Ce membre peut également être spécifié en tant qu’élément de rappel : MMC_CALLBACK ou MMC_IMAGECALLBACK. La valeur MMC_IMAGECALLBACK est une version correcte de type (aucune conversion nécessaire) de MMC_CALLBACK.

MMC_IMAGECALLBACK est introduit dans MMC version 1.2.

nState

Valeur qui spécifie le masque d’état de l’élément. Il peut avoir l’une des valeurs suivantes.

LVIS_CUT

L’élément est marqué pour une opération de couper-coller.

LVIS_DROPHILITED

L’élément est mis en surbrillance en tant que cible de glisser-déplacer.

LVIS_FOCUSED

L’élément ayant le focus, il est donc entouré d’un rectangle de focus standard. Plusieurs éléments peuvent être sélectionnés, mais un seul élément peut avoir le focus.

LVIS_SELECTED

L'élément est sélectionné. L’apparence d’un élément sélectionné dépend de son focus et des couleurs système utilisées pour la sélection.

lParam

Valeur qui spécifie une valeur 32 bits fournie par l’utilisateur à associer à l’élément. Cet élément, également appelé cookie, est la valeur qui est passée en tant que premier paramètre à IComponent ::QueryDataObject.

iIndent

Réservé.

Spécifications

Voir aussi

IResultData