Ajout d'éléments au contrôle
Pour ajouter des éléments au contrôle de liste (CListCtrl), appelez l'une de plusieurs versions de la fonction membre InsertItem, selon les informations que vous avez. Une version prend une structure LV_ITEM que vous préparez. Comme la structure LV_ITEM contient de nombreux membres, vous avez un contrôle optimisé les attributs de l'élément de liste.
Membres significatifs (en vue de l'affichage du Rapport) de la structure LV_ITEM sont les membres iItem et iSubItem. Le membre iItem est l'index de base zéro de l'élément de la structure de référence et le membre iSubItem à l'index en démarrant à 1 d'un sous-élément, ou NULL et si la structure contient des informations sur un élément. Avec les deux membres, vous déterminez par article, le type et la valeur d'informations sur le sous-élément affichées lorsque le contrôle de liste est en mode Rapport. Pour plus d'informations, consultez CListCtrl::SetItem.
Les membres supplémentaires spécifient le texte de l'élément, l'icône, l'état, et les données de l'élément. La « données de l'élément » est une valeur définie par l'application associée à un élément de l'affichage de la liste. Pour plus d'informations à propos de la structure LV_ITEM, consultez CListCtrl::GetItem.
D'autres versions de InsertItem prennent une ou plusieurs valeurs distinctes, correspondant aux membres de la structure LV_ITEM, ce qui vous permet de lancer uniquement les membres que vous voulez prendre en charge. En général, le contrôle de liste gère le stockage des éléments de liste, mais vous pouvez stocker certaines informations dans votre application à la place, en utilisant « les éléments de rappel. » Pour plus d'informations, consultez Éléments de rappel et le masque de rappel dans cette rubrique et Éléments de rappel et le masque de rappel dans Kit de développement logiciel Windows.
Pour plus d'informations, consultez Éléments de l'affichage de la liste et sous-éléments d'ajout.