Partager via


CListCtrl::SetItem

Définit une partie ou l'ensemble des attributs d'un élément de l'affichage de liste.

BOOL SetItem( 
   const LVITEM* pItem  
); 
BOOL SetItem( 
   int nItem, 
   int nSubItem, 
   UINT nMask, 
   LPCTSTR lpszItem, 
   int nImage, 
   UINT nState, 
   UINT nStateMask, 
   LPARAM lParam  
); 
BOOL SetItem( 
   int nItem, 
   int nSubItem, 
   UINT nMask, 
   LPCTSTR lpszItem, 
   int nImage, 
   UINT nState, 
   UINT nStateMask, 
   LPARAM lParam, 
   int nIndent  
);

Paramètres

  • pItem
    Adresse d'une structure de LVITEM qui contient les nouveaux attributs de l'élément, comme décrit dans Kit de développement logiciel Windows. Les membres d' iItem et d' iSubItem de la structure identifient l'élément ou le sous-élément, et le membre de MASK de la structure qui spécifie l'attribut au jeu. Pour plus d'informations sur le membre de MASK , consultez Notes.

  • nItem
    Index de l'élément dont les attributs doivent être définis.

  • nSubItem
    Index du sous-élément dont les attributs doivent être définis.

  • nMask
    Spécifie que les attributs doivent être défini (consultez les notes).

  • lpszItem
    Adresse d'une chaîne terminée par le caractère NULL spécifiant l'étiquette de l'élément.

  • nImage
    Index de l'image de l'élément dans la liste d'images.

  • nState
    Spécifie des valeurs pour que les rapports soient changés (consultez les notes).

  • nStateMask
    Spécifie les états doivent être changés (consultez les notes).

  • lParam
    Une valeur spécifique à l'application de 32 bits à associer à l'élément.

  • nIndent
    Largeur, en pixels, de la mise en retrait. Si nIndent est moins que la largeur minimale définie par le système, la nouvelle largeur est définie au minimum défini par le système

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon zéro.

Notes

Les membres d' iItem et d' iSubItem de la structure de LVITEM et des paramètres d' nItem et d' nSubItem identifient l'élément et le sous-élément dont les attributs doivent être définis.

Le membre de MASK de la structure de LVITEM et le paramètre d' nMask spécifient que les attributs d'élément doivent être défini :

  • LVIF_TEXT le membre de pszText ou le paramètre d' lpszItem est l'adresse d'une chaîne terminée par le caractère NULL ; le membre de cchTextMax est ignoré.

  • LVIF_STATE le membre de stateMask ou le paramètre d' nStateMask spécifie que les états d'élément à modifier et le membre de état ou le paramètre d' nState contient des valeurs pour ces rapports.

Exemple

Consultez l'exemple pour CListCtrl::HitTest.

Configuration requise

Header: afxcmn.h

Voir aussi

Référence

CListCtrl, classe

Graphique de la hiérarchie

CListCtrl::GetItem