IResultData::ModifyItemState, méthode (mmc.h)

La méthode IResultData::ModifyItemState permet au composant logiciel enfichable de modifier l’état d’un élément.

Syntaxe

HRESULT ModifyItemState(
  [in] int         nIndex,
  [in] HRESULTITEM itemID,
  [in] UINT        uAdd,
  [in] UINT        uRemove
);

Paramètres

[in] nIndex

Valeur qui spécifie l’index de l’élément dont l’état doit être modifié. Ce paramètre est utilisé uniquement lorsque le paramètre itemID est égal à zéro. Lorsqu’il est appliqué à des listes virtuelles, vous devez utiliser nIndex et définir itemID sur zéro.

[in] itemID

Identificateur unique de l’élément dont l’état doit être modifié. Lorsqu’il est appliqué à des listes virtuelles, définissez itemID = 0.

[in] uAdd

Valeur qui spécifie les indicateurs d’état d’affichage de liste Windows qui peuvent être définis. Lorsqu’ils sont appliqués à des listes virtuelles, seuls les états de focus et de sélection peuvent être modifiés. Cette valeur peut être n’importe quelle combinaison valide des éléments suivants :

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 glisser-déplacer.

LVIS_FOCUSED

L’élément ayant le focus, il est entouré d’un rectangle de focus standard. Bien que plusieurs éléments puissent être sélectionnés, 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 sa présence ou non du focus et des couleurs système utilisées pour la sélection.

[in] uRemove

Valeur qui spécifie les indicateurs d’état d’élément d’affichage de liste qui peuvent être supprimés. Cette valeur peut être n’importe quelle combinaison valide des indicateurs Win32 LVIS_* précédents affichés pour le paramètre uAdd.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Spécifications

Voir aussi

IResultData

IResultData2