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