CListCtrl::InsertItem

아티클
02/21/2013

목록 뷰 컨트롤에 항목을 삽입합니다.

int InsertItem(
   const LVITEM* pItem 
);
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
);

매개 변수

pItem
포인터는 LVITEM 에 설명 된 대로 항목의 특성을 지정 하는 구조는 Windows SDK.
nItem
삽입할 항목의 인덱스입니다.
lpszItem
주소 항목의 레이블이 포함 된 문자열 또는 LPSTR_TEXTCALLBACK 콜백 항목 항목이 있는 경우.콜백 항목에 대 한 자세한 내용은 CListCtrl::GetCallbackMask.
nImage
색인 항목의 이미지 또는 I_IMAGECALLBACK 콜백 항목 항목이 있는 경우.콜백 항목에 대 한 자세한 내용은 CListCtrl::GetCallbackMask.
nMask
nMask 매개 변수는 항목을 지정 합니다 유효한 매개 변수로 전달 되는 특성입니다.하나가 될 수 있습니다 또는 마스크 값 설명 LVITEM Structure 에 있는 Windows SDK.유효한 값은 비트 OR 연산자를 결합할 수 있습니다.
nState
항목의 상태, 이미지 상태 및 오버레이 이미지를 나타냅니다.참조는 Windows SDK 항목 LVITEM Structure 에 대 한 자세한 내용은 및 List-View Item States 잘못 된 플래그 목록을.
nStateMask
어떤 비트 상태 멤버를 검색 하거나 수정할 나타냅니다.참조 LVITEM Structure 에 있는 Windows SDK 에 대 한 자세한 내용은.
lParam
32 비트 응용 프로그램 특정 항목과 연결 된 값입니다.설정 해야이 매개 변수를 지정 하는 경우는 nMask 특성 LVIF_PARAM.

반환 값

인덱스 성공 하면 새 항목 또는 그렇지 않으면-1입니다.

설명

전화 하면 발생할 수 있습니다이 메서드는 LVM_INSERTITEM 컨트롤 창에 보낼 메시지입니다.연결 된 메시지 처리기는 컨트롤에 대 한 특정 조건에서 텍스트 항목을 설정 하지 못할 수 있습니다 (창 스타일을 사용 하는 등 LVS_OWNERDRAW).이러한 조건에 대 한 자세한 내용은 참조 LVM_INSERTITEM 에 있는 Windows SDK.

예제

        CString strText;
        int nColumnCount = m_myListCtrl.GetHeaderCtrl()->GetItemCount();

        // Insert 10 items in the list view control.
        for (int i = 0; i < 10; i++)
        {
            strText.Format(TEXT("item %d"), i);

            // Insert the item, select every other item.
            m_myListCtrl.InsertItem(LVIF_TEXT | LVIF_STATE, i, strText, 
                (i % 2) == 0 ? LVIS_SELECTED : 0, LVIS_SELECTED, 0, 0);

            // Initialize the text of the subitems.
            for (int j = 1; j < nColumnCount; j++)
            {
                strText.Format(TEXT("sub-item %d %d"), i, j);
                m_myListCtrl.SetItemText(i, j, strText);
            }
        }