intInsertItem (pItemconstLVITEM *);
int InsertItem (int nItem, LPCTSTR lpszItem );
int InsertItem (int nItem, LPCTSTR lpszItem, int nImage );
int InsertItem (UINT nMask, int nItem, LPCTSTR lpszItem, UINT nState, UINT nStateMask, int nImage, LPARAM lParam );
Valeur de retour
L'index de l'élément nouveau en cas de succès ou -1 sinon.
Paramètres
pItem
Pointeur vers un structure LVITEM qui spécifie les attributs de l'élément, comme décrit dans le SDK de la plate-forme.
nItem
Index de l'élément à insérer.
lpszItem
;Adresse d'une chaîne contenant l'étiquette de l'élément, ou LPSTR_TEXTCALLBACK si l'élément est un élément de rappel. Pour plus d'informations sur les objets de rappel, consultez CListCtrl::GetCallbackMask.
nImage
Index de l'élément image, ou I_IMAGECALLBACK si l'élément est un élément de rappel. Pour plus d'informations sur les objets de rappel, consultez CListCtrl::GetCallbackMask.
nMask
Le paramètre nMask spécifie l'élément sur lequel les attributs passés comme paramètres sont valides. Il peut être une ou plusieurs des valeurs masque décrits dans LVITEM structure dans la Plate-forme SDK. Les valeurs valides peuvent être combinés avec l'opérateur de bits OR.
nState
Indique l'état de l'élément, l'image de l'État et image de superposition. Consultez les rubriques de la Plate-forme SDK LVITEM pour plus d'informations et États de point vue liste pour une liste des indicateurs valides.
nStateMask
Indique les bits de l'État membre seront récupérées ou de modification. Voir LVITEM dans la Plate-forme SDK pour plus d'informations.
nImage
Index de l'image de l'élément dans la liste d'images.
lParam
Une valeur 32 bits spécifiques à l'application associée à l'élément. Si ce paramètre est spécifié, vous devez définir l'attribut de nMask LVIF_PARAM.
Remarques
Insère un élément dans le contrôle list view.
Aperçu de CListCtrl | ; Membres de la classe | Graphique de la hiérarchie
Voir aussi ;CListCtrl::DeleteItem, CListCtrl::DeleteAllItems