다음을 통해 공유


컨트롤에 항목 추가

목록 컨트롤(CListCtrl)에 항목을 추가하려면 포함된 정보에 따라 여러 버전의 InsertItem 멤버 함수 중 하나를 호출합니다. 한 버전은 사용자가 준비하는 LVITEM 구조를 취합니다. 구조체에 LVITEM 여러 멤버가 포함되어 있으므로 목록 컨트롤 항목의 특성을 더 많이 제어할 수 있습니다.

구조체의 LVITEM 두 가지 중요한 멤버(보고서 뷰와 관련하여)는 멤버와 iSubItem 멤버입니다iItem. 멤버는 iItem 구조체가 참조하는 항목의 인덱스(0부터 시작하는 인덱스)이며 iSubItem 멤버는 하위 항목의 1부터 시작하는 인덱스이거나 구조에 항목에 대한 정보가 포함된 경우 0입니다. 이 두 멤버를 사용하여 목록 컨트롤이 보고서 보기에 있을 때 표시되는 하위 항목 정보의 형식과 값을 항목별로 결정합니다. 자세한 내용은 CListCtrl::SetItem을 참조하세요.

추가 멤버는 항목의 텍스트, 아이콘, 상태 및 항목 데이터를 지정합니다. "항목 데이터"는 목록 보기 항목과 연결된 애플리케이션 정의 값입니다. 구조에 LVITEM 대한 자세한 내용은 CListCtrl::GetItem을 참조하세요.

다른 버전의 경우 구조체의 InsertItem 멤버 LVITEM 에 해당하는 하나 이상의 별도 값을 사용하여 지원하려는 멤버만 초기화할 수 있습니다. 일반적으로 목록 컨트롤은 목록 항목에 대한 스토리지를 관리하지만 대신 "콜백 항목"을 사용하여 애플리케이션에 일부 정보를 저장할 수 있습니다. 자세한 내용은 이 항목의 콜백 항목 및 콜백 마스크Windows SDK의 콜백 항목 및 콜백 마스크 를 참조하세요.

자세한 내용은 목록 보기 항목 및 하위 항목 추가를 참조 하세요.

참고 항목

CListCtrl 사용
컨트롤