CListCtrl Class

 

게시 날짜: 2016년 4월

Visual Studio 2017 에 대한 최신 설명서는 Visual Studio 2017 설명서를 참조하세요.

각각 이미지 목록의 아이콘과 레이블로 구성되는 항목 컬렉션을 표시하는 "목록 뷰 컨트롤"의 기능을 캡슐화합니다.

class CListCtrl : public CWnd  

Public 생성자

이름설명
CListCtrl::CListCtrlCListCtrl 개체를 생성합니다.

Public 메서드

이름설명
CListCtrl::ApproximateViewRect너비와 높이 목록 뷰 컨트롤의 항목을 표시 하는 데 필요한 결정 합니다.
CListCtrl::Arrange눈금에 항목을 정렬합니다.
CListCtrl::CancelEditLabel항목 텍스트 편집 작업을 취소 합니다.
CListCtrl::Create목록 컨트롤을 만들고에 연결 된 CListCtrl 개체입니다.
CListCtrl::CreateDragImage지정된 된 항목에 대 한 끌기 이미지 목록을 만듭니다.
CListCtrl::CreateEx지정 된 Windows 확장된 스타일을 사용 하 여 목록 컨트롤을 만들고에 연결 된 CListCtrl 개체입니다.
CListCtrl::DeleteAllItems컨트롤에서 모든 항목을 삭제합니다.
CListCtrl::DeleteColumnList view 컨트롤에서 열을 삭제합니다.
CListCtrl::DeleteItem컨트롤에서 항목을 삭제합니다.
CListCtrl::DrawItem소유자 그리기 컨트롤의 시각적 측면이 때 호출 됩니다.
CListCtrl::EditLabel항목의 텍스트의 내부 편집을 시작 합니다.
CListCtrl::EnableGroupView목록 뷰 컨트롤의 항목을 그룹으로 표시할지 여부를 사용 하지 않도록 설정 하거나 사용 합니다.
CListCtrl::EnsureVisible항목이 표시 되는지 확인 합니다.
CListCtrl::FindItem지정 된 특징을 가진 목록 보기 항목을 검색 합니다.
CListCtrl::GetBkColor목록 뷰 컨트롤의 배경색을 검색합니다.
CListCtrl::GetBkImage목록 뷰 컨트롤의 현재 배경 이미지를 검색합니다.
CListCtrl::GetCallbackMask목록 뷰 컨트롤에 대 한 콜백 마스크를 검색합니다.
CListCtrl::GetCheck항목에 연결 된 상태 이미지의 현재 상태 표시를 검색 합니다.
CListCtrl::GetColumn컨트롤의 열 특성을 검색 합니다.
CListCtrl::GetColumnOrderArray목록 뷰 컨트롤의 열 순서 (왼쪽에서 오른쪽)를 검색 합니다.
CListCtrl::GetColumnWidth보고서 보기 또는 목록 보기에서 열 너비를 검색합니다.
CListCtrl::GetCountPerPage목록 뷰 컨트롤에 세로로 들어갈 수 있는 항목의 수를 계산 합니다.
CListCtrl::GetEditControl항목의 텍스트를 편집 하는 데 사용 하는 편집 컨트롤의 핸들을 검색 합니다.
CListCtrl::GetEmptyText현재 목록 뷰 컨트롤이 비어 있으면 표시할 문자열을 검색 합니다.
CListCtrl::GetExtendedStyle목록 뷰 컨트롤의 현재 확장된 스타일을 검색합니다.
CListCtrl::GetFirstSelectedItemPosition목록 뷰 컨트롤에서 첫 번째 선택한 목록 보기 항목의 위치를 검색합니다.
CListCtrl::GetFocusedGroup현재 목록 뷰 컨트롤에 키보드 포커스가 있는 그룹을 검색 합니다.
CListCtrl::GetGroupCount현재 목록 뷰 컨트롤의 그룹 수를 검색합니다.
CListCtrl::GetGroupInfo지정된 된 그룹 목록 뷰 컨트롤에 대 한 정보를 가져옵니다.
CListCtrl::GetGroupInfoByIndex현재 목록 뷰 컨트롤에서 지정된 된 그룹에 대 한 정보를 검색합니다.
CListCtrl::GetGroupMetrics그룹의 메트릭을 검색합니다.
CListCtrl::GetGroupRect현재 목록 뷰 컨트롤에서 지정된 된 그룹에 대 한 경계 사각형을 검색 합니다.
CListCtrl::GetGroupState현재 목록 뷰 컨트롤에서 지정된 된 그룹에 대 한 상태를 검색합니다.
CListCtrl::GetHeaderCtrl목록 뷰 컨트롤의 헤더 컨트롤을 검색합니다.
CListCtrl::GetHotCursor목록 뷰 컨트롤에 대해 핫 트래킹을 때 사용 되는 커서를 검색 합니다.
CListCtrl::GetHotItem커서에서 현재 목록 보기 항목을 검색합니다.
CListCtrl::GetHoverTime목록 뷰 컨트롤의 현재 호버 시간을 검색합니다.
CListCtrl::GetImageList그리기 항목 목록 보기에 사용 되는 이미지 목록의 핸들을 검색 합니다.
CListCtrl::GetInsertMark삽입 표시의 현재 위치를 검색합니다.
CListCtrl::GetInsertMarkColor삽입 표시의 현재 색을 검색 합니다.
CListCtrl::GetInsertMarkRect삽입점을 제한 하는 사각형을 검색 합니다.
CListCtrl::GetItem특성 목록 보기 항목을 검색합니다.
CListCtrl::GetItemCount목록 뷰 컨트롤의 항목 수를 검색합니다.
CListCtrl::GetItemData항목에 연결 된 응용 프로그램 특정 값을 검색 합니다.
CListCtrl::GetItemIndexRect현재 목록 뷰 컨트롤의 하위 항목의 전체 또는 일부에 대 한 경계 사각형을 검색 합니다.
CListCtrl::GetItemPosition목록 보기 항목의 위치를 검색 합니다.
CListCtrl::GetItemRect항목에 대 한 경계 사각형을 검색 합니다.
CListCtrl::GetItemSpacing현재 목록 뷰 컨트롤의 항목 사이의 간격을 계산합니다.
CListCtrl::GetItemState목록 보기 항목의 상태를 검색합니다.
CListCtrl::GetItemText목록 보기 항목 또는 하위 항목의 텍스트를 검색합니다.
CListCtrl::GetNextItem속성을 지정 하 고 지정된 된 항목에 지정 된 관계로 목록 보기 항목을 검색 합니다.
CListCtrl::GetNextItemIndex지정된 된 속성 집합이 있는 현재 목록 뷰 컨트롤에서 항목의 인덱스를 검색 합니다.
CListCtrl::GetNextSelectedItem인덱스 목록 보기 항목 위치 및 반복에 대 한 다음 선택한 목록 보기 항목의 위치를 검색합니다.
CListCtrl::GetNumberOfWorkAreas현재는 목록 뷰 컨트롤에 대 한 작업 영역 수를 검색합니다.
CListCtrl::GetOrigin목록 뷰 컨트롤에 대 한 현재 보기 원점을 검색합니다.
CListCtrl::GetOutlineColor목록 뷰 컨트롤의 테두리 색을 검색 합니다.
CListCtrl::GetSelectedColumn목록 컨트롤에서 현재 선택 된 열의 인덱스를 검색합니다.
CListCtrl::GetSelectedCountList view 컨트롤에서 선택한 항목의 수를 가져옵니다.
CListCtrl::GetSelectionMark목록 뷰 컨트롤의 선택 표시를 검색합니다.
CListCtrl::GetStringWidth지정된 된 문자열의 모든 표시 하는 데 필요한 최소 열 너비를 결정 합니다.
CListCtrl::GetSubItemRect목록 뷰 컨트롤에 있는 항목의 경계 사각형을 검색 합니다.
CListCtrl::GetTextBkColor목록 뷰 컨트롤의 텍스트 배경 색을 검색합니다.
CListCtrl::GetTextColor목록 뷰 컨트롤의 텍스트 색을 검색합니다.
CListCtrl::GetTileInfo목록 뷰 컨트롤에서 타일에 대 한 정보를 검색합니다.
CListCtrl::GetTileViewInfoTile 보기에는 목록 뷰 컨트롤에 대 한 정보를 검색합니다.
CListCtrl::GetToolTips목록 뷰 컨트롤에서 사용 하 여 도구 설명을 표시 하는 도구 설명 컨트롤을 검색 합니다.
CListCtrl::GetTopIndex표시 되는 맨 위에 있는 항목의 인덱스를 검색 합니다.
CListCtrl::GetView목록 뷰 컨트롤의 뷰를 가져옵니다.
CListCtrl::GetViewRect목록 뷰 컨트롤의 모든 항목의 경계 사각형을 검색합니다.
CListCtrl::GetWorkAreas목록 뷰 컨트롤의 현재 작업 영역을 검색합니다.
CListCtrl::HasGroup목록 뷰 컨트롤에서 지정된 된 그룹에 있는지 확인 합니다.
CListCtrl::HitTest결정 목록 보기 항목은 지정된 된 위치에 있습니다.
CListCtrl::InsertColumn목록 뷰 컨트롤에 새 열을 삽입합니다.
CListCtrl::InsertGroup그룹 목록 뷰 컨트롤에 삽입합니다.
CListCtrl::InsertGroupSorted그룹의 정렬 된 목록에 지정된 된 그룹을 삽입합니다.
CListCtrl::InsertItem목록 뷰 컨트롤에 새 항목을 삽입합니다.
CListCtrl::InsertMarkHitTest지정된 된 지점에 가장 가까운 삽입 포인터를 검색합니다.
CListCtrl::IsGroupViewEnabled그룹 보기는 목록 뷰 컨트롤에 대 한 사용 되는지 여부를 결정 합니다.
CListCtrl::IsItemVisible현재 목록 뷰 컨트롤에서 지정된 된 항목 표시 여부를 나타냅니다.
CListCtrl::MapIDToIndex인덱스를 현재 목록 뷰 컨트롤에 있는 항목의 고유 ID를 매핑합니다.
CListCtrl::MapIndexToID고유 ID를 현재 목록 뷰 컨트롤에 있는 항목의 인덱스를 매핑합니다.
CListCtrl::MoveGroup지정된 된 그룹을 이동합니다.
CListCtrl::MoveItemToGroup지정 된 그룹에 지정 된 목록 뷰 컨트롤의 0 기반된 인덱스를 이동 합니다.
CListCtrl::RedrawItems항목의 범위를 다시 그려야 하는 목록 뷰 컨트롤을 강제로 수행 합니다.
CListCtrl::RemoveAllGroups목록 뷰 컨트롤에서 모든 그룹을 제거합니다.
CListCtrl::RemoveGroupList view 컨트롤에서 지정된 된 그룹을 제거합니다.
CListCtrl::Scroll목록 뷰 컨트롤의 내용을 스크롤합니다.
CListCtrl::SetBkColor목록 뷰 컨트롤의 배경색을 설정합니다.
CListCtrl::SetBkImage목록 뷰 컨트롤의 현재 배경 이미지를 설정합니다.
CListCtrl::SetCallbackMask목록 뷰 컨트롤에 대 한 콜백 마스크를 설정합니다.
CListCtrl::SetCheck현재 표시 항목에 연결 된 상태 이미지의 상태를 설정 합니다.
CListCtrl::SetColumn목록 뷰 열 특성을 설정합니다.
CListCtrl::SetColumnOrderArray목록 뷰 컨트롤의 열 순서 (왼쪽에서 오른쪽)를 설정 합니다.
CListCtrl::SetColumnWidth보고서 보기 또는 목록 보기에서 열 너비를 변경합니다.
CListCtrl::SetExtendedStyle목록 뷰 컨트롤의 현재 확장된 스타일을 설정합니다.
CListCtrl::SetGroupInfo목록 뷰 컨트롤의 지정된 된 그룹에 대 한 정보를 설정합니다.
CListCtrl::SetGroupMetrics목록 뷰 컨트롤의 그룹 메트릭을 설정합니다.
CListCtrl::SetHotCursor목록 뷰 컨트롤에 대해 핫 트래킹을 때 사용 되는 커서를 설정 합니다.
CListCtrl::SetHotItem목록 뷰 컨트롤의 현재 활성 항목을 설정합니다.
CListCtrl::SetHoverTime목록 뷰 컨트롤의 현재 호버 시간을 설정합니다.
CListCtrl::SetIconSpacing목록 뷰 컨트롤의 아이콘 사이의 간격을 설정 합니다.
CListCtrl::SetImageList이미지 목록을 목록 뷰 컨트롤에 할당합니다.
CListCtrl::SetInfoTip도구 설명 텍스트를 설정합니다.
CListCtrl::SetInsertMark정의 된 위치에 삽입 포인터를 설정합니다.
CListCtrl::SetInsertMarkColor삽입 포인터의 색을 설정 합니다.
CListCtrl::SetItem일부 또는 전체 목록 보기 항목의 특성을 설정합니다.
CListCtrl::SetItemCount많은 수의 항목을 추가 하는 데는 목록 뷰 컨트롤을 준비 합니다.
CListCtrl::SetItemCountEx가상 목록 뷰 컨트롤에 대 한 항목 수를 설정합니다.
CListCtrl::SetItemData항목의 응용 프로그램 특정 값을 설정합니다.
CListCtrl::SetItemIndexState현재 목록 뷰 컨트롤에서 항목의 상태를 설정합니다.
CListCtrl::SetItemPosition목록 뷰 컨트롤의 지정된 된 위치에 항목을 이동합니다.
CListCtrl::SetItemState목록 뷰 컨트롤에 있는 항목의 상태를 변경합니다.
CListCtrl::SetItemText목록 보기 항목 또는 하위 항목의 텍스트를 변경합니다.
CListCtrl::SetOutlineColor목록 뷰 컨트롤의 테두리 색을 설정합니다.
CListCtrl::SetSelectedColumn목록 뷰 컨트롤의 선택된 된 열을 설정합니다.
CListCtrl::SetSelectionMark목록 뷰 컨트롤의 선택 표시를 설정합니다.
CListCtrl::SetTextBkColor목록 뷰 컨트롤에서 텍스트의 배경색을 설정합니다.
CListCtrl::SetTextColor목록 뷰 컨트롤의 텍스트 색을 설정합니다.
CListCtrl::SetTileInfo목록 뷰 컨트롤의 타일에 대 한 정보를 설정합니다.
CListCtrl::SetTileViewInfoTile 보기에는 목록 뷰 컨트롤을 사용 하는 정보를 설정 합니다.
CListCtrl::SetToolTipsList view 컨트롤에서 도구 설명을 표시 하려면 사용할 도구 설명 컨트롤을 설정 합니다.
CListCtrl::SetView목록 뷰 컨트롤의 뷰를 설정합니다.
CListCtrl::SetWorkAreas목록 뷰 컨트롤의 아이콘 표시 될 수 있는 영역을 설정 합니다.
CListCtrl::SortGroups목록의 그룹을 정렬 합니다. 사용자 정의 함수를 사용 하 여 제어를 봅니다.
CListCtrl::SortItems응용 프로그램 정의 된 비교 함수를 사용 하 여 목록 보기 항목을 정렬 합니다.
CListCtrl::SortItemsEx응용 프로그램 정의 된 비교 함수를 사용 하 여 목록 보기 항목을 정렬 합니다.
CListCtrl::SubItemHitTest지정된 된 위치에 있는 경우 목록 보기 항목을 결정 합니다.
CListCtrl::Update지정된 된 항목 자동으로 그려지도록 강제로 합니다.

프로그램 아이콘 및 레이블 외에도 각 항목 아이콘 및 레이블 오른쪽 열에 표시 되는 정보가 있을 수 있습니다. 이 컨트롤 (및 따라서는 CListCtrl 클래스)은 이상 Windows 95/98 및 Windows NT 버전 3.51에서 실행 중인 프로그램에만 사용할 수 있습니다.

다음은의 간략 한 개요는 CListCtrl 클래스입니다. 개념, 자세한 설명은 CListCtrl 사용 하 여컨트롤합니다.

목록 뷰 컨트롤 "views." 라는 네 가지 방법으로 해당 콘텐츠를 표시할 수 있습니다.

  • 아이콘 보기

    각 항목 아래에 레이블이 있는 큰 아이콘 (32 x 32 픽셀 단위)으로 표시 됩니다. 목록 보기 창에서 임의의 위치에 항목을 끌 수 있습니다.

  • 작은 아이콘 보기

    각 항목의 오른쪽에 레이블이 있는 작은 아이콘 (16 x 16 픽셀)으로 표시 됩니다. 목록 보기 창에서 임의의 위치에 항목을 끌 수 있습니다.

  • 목록 보기

    각 항목의 오른쪽에 레이블이 있는 작은 아이콘으로 표시 됩니다. 항목 열에서 정리 되 고 목록 보기 창에서 임의의 위치에 끌어 올 수 없습니다.

  • 보고서 보기

    각 항목 오른쪽에 열으로 정렬 하는 추가 정보가 있는 별도 줄에 나타납니다. 작은 아이콘 및 레이블 맨 왼쪽 열 포함 고 후속 열 포함 응용 프로그램에 의해 지정 된 대로 하위 항목입니다. 포함 된 헤더 컨트롤 (클래스 CHeaderCtrl) 이러한 열을 구현 합니다. 헤더 컨트롤 및 보고서 보기의 열에 대 한 자세한 내용은 참조 하십시오. 를 사용 하 여 CListCtrl: 제어 (보고서 뷰)에 열 추가합니다.

다음 항목도 참조하세요.

  • 기술 자료 문서 Q250614: 방법: 보고서 뷰에서 CListCtrl 항목 정렬

  • 기술 자료 문서 Q200054: PRB: OnTimer()는 되지 호출 반복적으로 목록 컨트롤에 대 한

컨트롤의 현재 목록 보기의 스타일을 현재 보기를 결정합니다. 이러한 스타일과 사용법에 대 한 자세한 내용은 참조 하십시오. 를 사용 하 여 CListCtrl: 목록 컨트롤 스타일 변경합니다.

표준 목록 스타일 외에도 클래스 CListCtrl 다양 한 강화 된 기능을 제공 하는 확장된 스타일을 지원 합니다. 이 기능의 몇 가지 예는 다음과 같습니다.

  • 호버 선택

    기능을 사용 자동으로 선택 항목의 특정 기간에 대 한 항목 위로 커서를 유지할 때입니다.

  • 가상 목록 보기

    기능을 사용을 지원 하도록 컨트롤 DWORD 항목입니다. 이것이 가능한 것은 응용 프로그램에 대 한 항목 데이터를 관리 하는 오버 헤드를 배치 하 여입니다. 항목 선택 및 포커스 정보를 제외한 모든 항목 정보는 응용 프로그램에 의해 관리 되어야 합니다. 자세한 내용은 참조 를 사용 하 여 CListCtrl: 가상 목록 컨트롤합니다.

  • 1 및 2 – 클릭 정품 인증

    기능을 사용 (자동 강조 표시 된 항목 텍스트의) 하는 핫 트래킹 및 강조 표시 된 항목의 하나 또는 두 – 클릭 활성화 합니다.

  • 끌어서 놓기 열 순서

    사용 하도록 설정 하면 끌어서 놓기는 목록 뷰 컨트롤의 열 순서를 바꿀 수 있습니다. 보고서 보기에서 사용할 수 있습니다.

확장 스타일을 사용 하 여 이러한 새로운에 대 한 정보, 참조 를 사용 하 여 CListCtrl: 목록 컨트롤 스타일 변경합니다.

각 항목에는 목록 뷰 컨트롤 (이미지 목록)에서 아이콘, 레이블, 현재 상태 및 ("항목 데이터" 라고 함) 하는 응용 프로그램 정의 값으로 구성 됩니다. 하나 이상의 하위 항목 각 항목에 연결할 수도 있습니다. "하위"항목은 보고서 뷰에서 항목의 아이콘 및 레이블 오른쪽에 있는 열에 표시 될 수 있는 문자열입니다. 목록 뷰 컨트롤의 모든 항목에는 동일한 하위 항목 수가 있어야 합니다.

클래스 CListCtrl 삽입, 삭제, 찾기 및 이러한 항목의 수정에 대 한 몇 가지 기능을 제공 합니다. 자세한 내용은 참조 CListCtrl::GetItem, CListCtrl::InsertItem, 및 CListCtrl::FindItem, [를 사용 하 여 CListCtrl: 컨트롤에 항목 추가] (.. / Topic/CListCtrl%20Class.md#not_found.md#adding_items_to_the_control, 및 사용 clistctrl_ 스크롤, 정렬, 정렬 및 목록 컨트롤에서 찾기] [-brokenlink-(... / 항목/_arranging, _sorting, _and_finding_in_list_controls 스크롤).

기본적으로 목록 뷰 컨트롤은 항목의 아이콘 및 텍스트 특성을 저장 합니다. 그러나 이러한 항목 형식은 외에도 클래스 CListCtrl 지원 ""콜백 항목입니다. "콜백 항목"가 있는 목록 보기 항목을 응용 프로그램-컨트롤 대신-텍스트, 아이콘 또는 둘 모두를 저장 합니다. 콜백 마스크는 지정 된 항목 특성 (텍스트 및/또는 아이콘)는 응용 프로그램에서 제공 하는 데 사용 됩니다. 콜백 항목을 사용 하는 응용 프로그램 필요에 따라 텍스트 및/또는 아이콘 특성을 제공할 수 있어야 합니다. 콜백 항목은 응용 프로그램이 이미이 정보 중 일부를 유지 관리 하는 경우에 유용 합니다. 자세한 내용은 참조 를 사용 하 여 CListCtrl: 콜백 항목 및 콜백 마스크합니다.

아이콘, 헤더 항목 이미지 및 응용 프로그램 – 상태에 대해 정의 된 여러 이미지 목록에 목록 뷰 항목이 포함 된 (클래스에 의해 구현 CImageList)를 만들고 목록 뷰 컨트롤에 할당 합니다. 각 목록 뷰 컨트롤에는 최대 4 개의 서로 다른 유형의 이미지 목록 가질 수 있습니다.

  • 큰 아이콘

    큰 아이콘에 대 한 아이콘 보기에 사용 합니다.

  • 작은 아이콘

    더 작은 버전 아이콘 보기에 사용 되는 아이콘의 작은 아이콘, 목록 및 보고서 보기에 사용.

  • 응용 프로그램 정의 상태

    응용 프로그램 정의 상태를 표시 하는 항목의 아이콘 옆에 표시 되는 상태 이미지를 포함 합니다.

  • 헤더 항목

    각 헤더 컨트롤 항목에 표시 되는 작은 이미지에 대 한 보고서 보기에서 사용 합니다.

기본적으로는 목록 뷰 컨트롤 소멸; 소멸 될 때 할당 된 이미지 목록 그러나 개발자 응용 프로그램에 의해 결정 된 대로 더 이상 사용 하는 경우 각 이미지 목록 파괴 하 여이 동작을 사용자 지정할 수 없습니다. 자세한 내용은 참조 를 사용 하 여 CListCtrl: 목록 항목 및 이미지 목록합니다.

CObject

CCmdTarget

CWnd

CListCtrl

헤더: afxcmn.h

너비와 높이 목록 뷰 컨트롤의 항목을 표시 하는 데 필요한 결정 합니다.

CSize ApproximateViewRect(
    CSize sz = CSize(-1,  
 -1),  
    int iCount = -1) const;  

매개 변수

sz
픽셀 단위의 컨트롤의 제안 된 차원입니다. 차원을 지정 하지 않은 경우 프레임 워크는 컨트롤의 현재 너비 또는 높이 값을 사용 합니다.

iCount
컨트롤에 표시할 항목 수입니다. 이 매개 변수가-1 인 경우 프레임 워크 사용 하 여 항목의 총 현재 컨트롤에 있습니다.

반환 값

A CSize 대략적인 너비 및 높이 (픽셀)은 항목을 표시 하는 데 필요한 포함 된 개체입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_ApproximateViewRect에 설명 된 대로 Windows SDK합니다.

눈금에 정렬 되도록 아이콘 보기의 항목 위치를 변경 합니다.

BOOL Arrange(UINT nCode);

매개 변수

nCode
항목에 대 한 맞춤 스타일을 지정합니다. 다음 값 중 하나일 수 있습니다.

  • LVA_ALIGNLEFT창의 왼쪽된 가장자리를 따라 항목을 정렬합니다.

  • LVA_ALIGNTOP창의 위쪽 가장자리를 따라 항목을 정렬합니다.

  • LVA_DEFAULT목록 보기의 현재 맞춤 스타일 (기본값)에 따라 항목을 정렬합니다.

  • LVA_SNAPTOGRID가장 가까운 모눈 위치까지 모든 아이콘을 맞춥니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

nCode 맞춤 스타일 매개 변수를 지정 합니다.

예제

	// Align all of the list view control items along the top
	// of the window (the list view control must be in icon or
	// small icon mode).
	m_myListCtrl.Arrange(LVA_ALIGNTOP);

항목 텍스트 편집 작업을 취소 합니다.

void CancelEditLabel();

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_CANCELEDITLABEL 에 설명 된 대로 메시지는 Windows SDK합니다.

CListCtrl 개체를 생성합니다.

CListCtrl();

목록 컨트롤을 만들고에 연결 된 CListCtrl 개체입니다.

virtual BOOL Create(
    DWORD dwStyle,  
    const RECT& rect,  
    CWnd* pParentWnd,  
    UINT nID);

매개 변수

dwStyle
목록 컨트롤의 스타일을 지정합니다. 목록 컨트롤 스타일의 조합이 컨트롤에 적용 됩니다. 참조 목록 보기 창 스타일 에 Windows SDK 이러한 스타일의 전체 목록은 합니다. 확장 스타일을 사용 하 여 컨트롤에 특정 집합 SetExtendedStyle합니다.

rect
목록 컨트롤의 크기와 위치를 지정합니다. 수 중 하나는 CRect 개체 또는 RECT 구조입니다.

pParentWnd
목록 컨트롤의 부모 창에 일반적으로 지정 된 CDialog합니다. 않아야 NULL합니다.

nID
목록 컨트롤의 ID를 지정 합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

생성 한 CListCtrl 두 단계에서입니다. 먼저, 생성자를 호출 하 고 다음 호출 만들기, list view 컨트롤을 만들고 연결 하는 CListCtrl 개체입니다.

List 컨트롤 개체에 확장된 창 스타일을 적용할 호출 CreateEx 대신 만들기합니다.

예제

	m_myListCtrl.Create(
		WS_CHILD|WS_VISIBLE|WS_BORDER|LVS_REPORT|LVS_EDITLABELS,
		CRect(10,10,400,200), pParentWnd, IDD_MYLISTCTRL);   

컨트롤 (자식 창)와 연결 된 CListCtrl 개체입니다.

virtual BOOL CreateEx(
    DWORD dwExStyle,  
    DWORD dwStyle,  
    const RECT& rect,  
    CWnd* pParentWnd,  
    UINT nID);

매개 변수

dwExStyle
생성 되는 컨트롤의 확장된 스타일을 지정 합니다. 확장된 창 스타일의 목록에 대 한 참조는 dwExStyle 에 대 한 매개 변수 CreateWindowEx 에 Windows SDK합니다.

dwStyle
목록 컨트롤의 스타일을 지정합니다. 목록 컨트롤 스타일의 조합이 컨트롤에 적용 됩니다. 이러한 스타일의 전체 목록은 참조 하십시오. 목록 보기 창 스타일 에 Windows SDK합니다.

rect
에 대 한 참조는 RECT 크기와의 클라이언트 좌표에서 만든 창 위치를 설명 하는 구조 pParentWnd합니다.

pParentWnd
컨트롤의 부모 창에 대 한 포인터입니다.

nID
컨트롤의 자식 창 id입니다.

반환 값

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

사용 하 여 CreateEx 대신 만들기 Windows 확장된 스타일 앞에 지정 된 Windows 확장된 스타일을 적용 하려면 WS_EX_합니다.

CreateEx지정 된 확장된 창 스타일을 사용 하 여 컨트롤을 만듭니다 dwExStyle합니다. 호출을 설정 하려면 확장된 스타일 특정 컨트롤에 SetExtendedStyle합니다. 사용 예를 들어 CreateEx 으로 이러한 스타일을 설정 하려면 WS_EX_CONTEXTHELP를 사용 하지만 SetExtendedStyle 으로 이러한 스타일을 설정 하려면 LVS_EX_FULLROWSELECT합니다. 자세한 내용은 항목에서 설명 하는 스타일을 참조 하십시오. 확장 목록 뷰 스타일 에 Windows SDK합니다.

지정 된 항목에 대 한 끌기 이미지 목록을 만듭니다 nItem합니다.

CImageList* CreateDragImage(
    int nItem,  
    LPPOINT lpPoint);

매개 변수

nItem
끌기 이미지 목록이 있는 만들 항목의 인덱스입니다.

lpPoint
주소에 지점 구조, 이미지의 왼쪽 위 모퉁이의 초기 위치를 보기에 조정 합니다.

반환 값

성공 하는 경우에 끌기 이미지 목록에 대 한 포인터 그렇지 않으면 NULL합니다.

설명

CImageList 개체, 영구 적용 되며 완료 되 면 삭제 해야 합니다. 예:

		CImageList* pImageList = m_myListCtrl.CreateDragImage(nItem, &point);

		// do something

		delete pImageList;

List view 컨트롤에서 모든 항목을 삭제합니다.

BOOL DeleteAllItems();

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

예제

	// Delete all of the items from the list view control.
	m_myListCtrl.DeleteAllItems();
	ASSERT(m_myListCtrl.GetItemCount() == 0);

List view 컨트롤에서 열을 삭제합니다.

BOOL DeleteColumn(int nCol);

매개 변수

nCol
삭제할 열의 인덱스입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

예제

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

		// Delete all of the columns.
		for (int i=0; i < nColumnCount; i++)
		{
			m_myListCtrl.DeleteColumn(0);
		}

목록 뷰 컨트롤에서 항목을 삭제합니다.

BOOL DeleteItem(int nItem);

매개 변수

nItem
삭제할 항목의 인덱스를 지정 합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

예제

		int nCount = m_myListCtrl.GetItemCount();

		// Delete all of the items from the list view control.
		for (int i=0; i < nCount; i++)
		{
			m_myListCtrl.DeleteItem(0);
		}

소유자 그리기 목록 보기 컨트롤의 시각적 측면이 될 때 프레임 워크에 의해 호출 됩니다.

virtual void DrawItem(LPDRAWITEMSTRUCT lpDrawItemStruct);

매개 변수

lpDrawItemStruct
에 대 한 긴 포인터는 DRAWITEMSTRUCT 필요한 드로잉의 종류에 대 한 정보가 포함 된 구조체입니다.

설명

itemAction 의 멤버는 DRAWITEMSTRUCT 구조 수행 되는 그리기 작업을 정의 합니다.

이 멤버 함수는 기본적으로 아무 작업도 수행합니다. 소유자 그리기에 대 한 그리기를 구현 하려면이 멤버 함수 재정의 CListCtrl 개체입니다.

응용 프로그램에 제공 된 디스플레이 컨텍스트에 대해 선택한 모든 그래픽 장치 인터페이스 (GDI) 개체를 복원 해야 lpDrawItemStruct 전에이 멤버 함수를 종료 합니다.

항목의 텍스트의 내부 편집을 시작 합니다.

CEdit* EditLabel(int nItem);

매개 변수

nItem
편집할 수 있는 목록 보기 항목의 인덱스입니다.

반환 값

성공 하는 경우에 대 한 포인터는 CEdit 항목 텍스트를 편집 하는 데 사용 하 고, 그렇지 않으면 개체 NULL합니다.

설명

가 있는 목록 보기 컨트롤은 LVS_EDITLABELS 창 스타일을 통해 사용자 위치에 항목 레이블을 편집할 수 있습니다. 사용자는 포커스가 있는 항목의 레이블을 클릭 하 여 편집을 시작 합니다.

지정 된 목록 뷰 항목 텍스트의 내부 편집을 시작 하려면이 함수를 사용 합니다.

예제

		// Make sure the focus is set to the list view control.
		m_myListCtrl.SetFocus();

		// Show the edit control on the label of the first
		// item in the list view control.
		CEdit* pmyEdit = m_myListCtrl.EditLabel(1);
		ASSERT(pmyEdit != NULL);

목록 뷰 컨트롤의 항목을 그룹으로 표시할지 여부를 사용 하지 않도록 설정 하거나 사용 합니다.

LRESULT EnableGroupView(BOOL fEnable);

매개 변수

fEnable
항목 표시 listview 컨트롤 그룹을 사용할 수 있도록 여부를 나타냅니다. True 이면 그룹화를 사용 하도록 설정 하려면 FALSE 사용 하지 않도록 합니다.

반환 값

다음 값 중 하나를 반환합니다.

  • 0 목록 보기를 표시 하는 기능 항목으로 그룹을 이미 활성화 하거나 비활성화 합니다.

  • 1 컨트롤의 상태가 변경 되었습니다.

  • -1 작업이 실패 했습니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_ENABLEGROUPVIEW 에 설명 된 대로 메시지는 Windows SDK합니다.

목록 보기 항목을 부분적으로 표시 적어도 중인지 확인 합니다.

BOOL EnsureVisible(
    int nItem,  
    BOOL bPartialOK);

매개 변수

nItem
이 표시 되도록 하는 목록 보기 항목의 인덱스입니다.

bPartialOK
부분 가시성을 허용할지 여부를 지정 합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

필요한 경우 list view 컨트롤이 스크롤됩니다. 하는 경우는 bPartialOK 매개 변수는 0이 아니고, 스크롤이 되지 않는 항목은 부분적으로 표시 하는 경우 발생 합니다.

예제

		// Ensure that the last item is visible.
		int nCount = m_myListCtrl.GetItemCount();
		if (nCount > 0)
			m_myListCtrl.EnsureVisible(nCount-1, FALSE);

지정 된 특징을 가진 목록 보기 항목을 검색 합니다.

int FindItem(
    LVFINDINFO* pFindInfo,  
    int nStart = -1) const;  

매개 변수

pFindInfo
에 대 한 포인터는 LVFINDINFO 검색 한 항목에 대 한 정보가 포함 된 구조입니다.

nStart
-1을 처음부터 시작, 검색을 시작할 항목의 인덱스입니다. 에 있는 항목 nStart 경우 검색에서 제외 nStart -1과 같지 않습니다.

반환 값

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

설명

pFindInfo 매개 변수가 가리키는 LVFINDINFO 구조를 검색 하는 데 목록 보기 항목에 대 한 정보를 포함 합니다.

예제

		LVFINDINFO info;
		int nIndex;

		info.flags = LVFI_PARTIAL|LVFI_STRING;
		info.psz = _T("item");

		// Delete all of the items that begin with the string.
		while ((nIndex = m_myListCtrl.FindItem(&info)) != -1)
		{
			m_myListCtrl.DeleteItem(nIndex);
		}

목록 뷰 컨트롤의 배경색을 검색합니다.

COLORREF GetBkColor() const;  

반환 값

RGB 색을 지정 하는 데 사용 되는 32 비트 값입니다.

예제

예를 참조 CListCtrl::SetBkColor합니다.

목록 뷰 컨트롤의 현재 배경 이미지를 검색합니다.

BOOL GetBkImage(LVBKIMAGE* plvbkImage) const;  

매개 변수

plvbkImage
에 대 한 포인터는 LVBKIMAGE 목록 보기의 현재 배경 이미지를 포함 하는 구조입니다.

반환 값

그렇지 않으면 0 또는 성공 하면 0이 아닌 반환 합니다.

설명

이 메서드는 Win32 매크로의 동작을 구현 ListView_GetBkImage에 설명 된 대로 Windows SDK합니다.

예제

		LVBKIMAGE bki;

		// If no background image is set for the list view control use
		// the Microsoft homepage image as the background image.
		if (m_myListCtrl.GetBkImage(&bki) && (bki.ulFlags == LVBKIF_SOURCE_NONE))
		{
			m_myListCtrl.SetBkImage(
				_T("http://www.microsoft.com/library/images/gifs/homepage/microsoft.gif"),
				TRUE);
		}

목록 뷰 컨트롤에 대 한 콜백 마스크를 검색합니다.

UINT GetCallbackMask() const;  

반환 값

목록 뷰 컨트롤의 콜백 마스크입니다.

설명

"콜백 항목"가 있는 목록 보기 항목을 응용 프로그램-컨트롤 대신-텍스트, 아이콘 또는 둘 모두를 저장 합니다. 목록 뷰 컨트롤을 이러한 특성을 저장할 수, 있지만이 정보 중 일부 응용 프로그램에서 이미 유지 되는 경우 콜백 항목을 사용 하는 것이 좋습니다. 전체 컨트롤에는 대신 특정 항목에 적용 됩니다 및 콜백 마스크 항목 상태 비트는 응용 프로그램에서 유지 관리를 지정 합니다. 콜백 마스크는 기본적으로 컨트롤 모든 항목 상태를 추적 하는 0입니다. 콜백 항목을 사용 하 여 응용 프로그램 또는 0이 아니고 콜백 마스크를 지정 하는 경우 필요에 따라 목록 보기 항목 특성을 제공할 수 있어야 합니다.

예제

예를 참조 CListCtrl::SetCallbackMask합니다.

항목과 연결 되는 상태 이미지의 현재 상태 표시를 검색 합니다.

BOOL GetCheck(int nItem) const;  

매개 변수

nItem
목록 컨트롤 항목의 0부터 시작 하는 인덱스입니다.

반환 값

항목을 선택 하면 0이 아니고 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetCheckState에 설명 된 대로 Windows SDK합니다.

예제

예를 참조 CListCtrl::SetCheck합니다.

목록 뷰 컨트롤의 열 특성을 검색 합니다.

BOOL GetColumn(
    int nCol,  
    LVCOLUMN* pColumn) const;  

매개 변수

nCol
검색 된 특성을 가진 열의 인덱스입니다.

pColumn
주소에 LVCOLUMN 검색할 정보를 지정 하 고 열에 대 한 정보를 수신 하는 구조입니다. 마스크 멤버를 검색 하는 열 특성을 지정 합니다. 경우는 마스크 멤버 지정는 LVCF_TEXT 값은 pszText 멤버 항목의 텍스트를 받는 버퍼의 주소를 포함 해야 및 cchTextMax 멤버 버퍼의 크기를 지정 해야 합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

LVCOLUMN 구조는 보고서 보기의 열에 대 한 정보를 포함 합니다.

예제

		LVCOLUMN col;

		col.mask = LVCF_WIDTH;

		// Double the column width of the first column.
		if (m_myListCtrl.GetColumn(0, &col))
		{
			col.cx *= 2;
			m_myListCtrl.SetColumn(0, &col);
		}

목록 뷰 컨트롤의 열 순서 (왼쪽에서 오른쪽)를 검색 합니다.

BOOL GetColumnOrderArray(
    LPINT piArray,  
    int iCount = -1);

매개 변수

piArray
목록 뷰 컨트롤의 열 인덱스 값이 포함 될 버퍼에 대 한 포인터입니다. 버퍼는 목록 뷰 컨트롤에서 열의 총 수를 포함할 수 있는 크기 여야 합니다.

iCount
목록 뷰 컨트롤에서 열 수입니다. 이 매개 변수가-1 인 경우 열 수가 프레임 워크에 의해 자동으로 검색 됩니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetColumnOrderArray에 설명 된 대로 Windows SDK합니다.

예제

		// Reverse the order of the columns in the list view control
		// (i.e. make the first column the last, the last column
		// the first, and so on...).
		CHeaderCtrl* pHeaderCtrl = m_myListCtrl.GetHeaderCtrl();

		if (pHeaderCtrl != NULL)
		{
			int  nColumnCount = pHeaderCtrl->GetItemCount();
			LPINT pnOrder = (LPINT) malloc(nColumnCount*sizeof(int));
			ASSERT(pnOrder != NULL);

			m_myListCtrl.GetColumnOrderArray(pnOrder, nColumnCount);

			int i, j, nTemp;
			for (i = 0, j = nColumnCount-1; i < j; i++, j--)
			{
				nTemp = pnOrder[i];
				pnOrder[i] = pnOrder[j];
				pnOrder[j] = nTemp;
			}

			m_myListCtrl.SetColumnOrderArray(nColumnCount, pnOrder);
			free(pnOrder);
		}

보고서 보기 또는 목록 보기에서 열 너비를 검색합니다.

int GetColumnWidth(int nCol) const;  

매개 변수

nCol
너비는 검색할 열의 인덱스를 지정 합니다.

반환 값

너비 (픽셀)로 지정 된 열의 nCol합니다.

예제

		// Increase the column width of the second column by 20.
		int nWidth = m_myListCtrl.GetColumnWidth(1);
		m_myListCtrl.SetColumnWidth(1, 20 + nWidth);

목록 보기 또는 보고서 보기에는 목록 뷰 컨트롤의 표시 영역에 세로로 들어갈 수 있는 항목의 수를 계산 합니다.

int GetCountPerPage() const;  

반환 값

목록 보기 또는 보고서 보기에는 목록 뷰 컨트롤의 표시 영역에 세로로 들어갈 수 있는 항목의 수입니다.

예제

예를 참조 CListCtrl::GetTopIndex합니다.

목록 보기 항목의 텍스트를 편집 하는 데 사용 하는 편집 컨트롤의 핸들을 검색 합니다.

CEdit* GetEditControl() const;  

반환 값

성공 하는 경우에 대 한 포인터는 CEdit 항목 텍스트를 편집 하는 데 사용 하 고, 그렇지 않으면 개체 NULL합니다.

예제

		// The string replacing the text in the edit control.
		LPCTSTR lpszmyString = _T("custom label!");

		// If possible, replace the text in the label edit control.
		CEdit* pEdit = m_myListCtrl.GetEditControl();

		if (pEdit != NULL)
		{
			pEdit->SetWindowText(lpszmyString);
		}

현재 목록 뷰 컨트롤이 비어 있으면 표시할 문자열을 검색 합니다.

CString GetEmptyText() const;  

반환 값

A CString 컨트롤이 빈 경우 표시할 텍스트를 포함 하는 합니다.

설명

이 메서드는 전송 된 LVM_GETEMPTYTEXT 에 설명 된 메시지는 Windows SDK합니다.

목록 뷰 컨트롤의 현재 확장된 스타일을 검색합니다.

DWORD GetExtendedStyle();

반환 값

목록에서 사용 중인 확장된 스타일의 조합 뷰 컨트롤입니다. 이러한 확장된 스타일 목록은 설명이 포함 된 참조는 확장 목록 뷰 스타일 항목에는 Windows SDK합니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetExtendedListViewStyle에 설명 된 대로 Windows SDK합니다.

예제

예를 참조 CListCtrl::SetExtendedStyle합니다.

목록 뷰 컨트롤에서 선택된 된 첫 번째 항목의 위치를 가져옵니다.

POSITION GetFirstSelectedItemPosition() const;  

반환 값

A 위치 반복 또는 개체 포인터 검색;에 사용할 수 있는 값 NULL 없는 항목을 선택 합니다.

예제

다음 코드 예제에서는이 함수의 사용을 보여 줍니다.

		POSITION pos = m_myListCtrl.GetFirstSelectedItemPosition();
		if (pos == NULL)
		{
			TRACE(_T("No items were selected!\n"));
		}
		else
		{
			while (pos)
			{
				int nItem = m_myListCtrl.GetNextSelectedItem(pos);
				TRACE(_T("Item %d was selected!\n"), nItem);
				// you could do your own processing on nItem here
			}
		}

현재 목록 뷰 컨트롤에 키보드 포커스가 있는 그룹을 검색 합니다.

int GetFocusedGroup() const;  

반환 값

상태 그룹의 인덱스 LVGS_FOCUSED이러한 그룹; 하는 경우, 그렇지 않으면-1입니다.

설명

이 메서드는 전송 된 LVM_GETFOCUSEDGROUP 에 설명 된 메시지는 Windows SDK합니다. 자세한 내용은 참조는 LVGS_FOCUSED 값은 state 의 멤버는 LVGROUP 구조입니다.

현재 목록 뷰 컨트롤의 그룹 수를 검색합니다.

int GetGroupCount()const;  

반환 값

목록 뷰 컨트롤의 그룹 수를 지정 합니다.

설명

이 메서드는 전송 된 LVM_GETGROUPCOUNT 에 설명 된 메시지는 Windows SDK합니다.

지정된 된 그룹 목록 뷰 컨트롤에 대 한 정보를 가져옵니다.

int GetGroupInfo(
    int iGroupId,  
    PLVGROUP pgrp) const;  

매개 변수

iGroupId
해당 정보를 검색 하는 그룹의 식별자입니다.

pgrp
에 대 한 포인터는 LVGROUP 지정 된 그룹에 대 한 정보를 포함 합니다.

반환 값

그렇지 않으면 성공 하면 그룹 또는-1의 ID를 반환 합니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_GETGROUPINFO 에 설명 된 대로 메시지는 Windows SDK합니다.

현재 목록 뷰 컨트롤에서 지정된 된 그룹에 대 한 정보를 검색합니다.

BOOL GetGroupInfoByIndex(
    int iIndex,   
    PLVGROUP pGroup) const;  

매개 변수

매개 변수설명
[in] iIndex그룹의 인덱스 0부터 시작 합니다.
[out] pGroup에 대 한 포인터는 LVGROUP 구조에서 지정한 그룹에 대 한 정보를 수신 하는 iIndex 매개 변수입니다.

호출자의 멤버를 초기화 하는 LVGROUP 구조입니다. 설정의 cbSize 구조체의 크기 및 플래그의 멤버는 mask 검색할 정보를 지정 하는 멤버입니다.

반환 값

이 메서드가 성공적으로 수행되면 true이고, 그렇지 않으면 false입니다.

설명

이 메서드는 전송 된 LVM_GETGROUPINFOBYINDEX 에 설명 된 메시지는 Windows SDK합니다.

예제

변수를 정의 하는 다음 코드 예제에서는 m_listCtrl, 즉 현재 목록 뷰 컨트롤에 액세스 하는 데 사용 합니다. 이 변수는 다음 예제에서 사용됩니다.

public:
	// Variable used to access the list control.
	CListCtrl m_listCtrl; 

예제

다음 코드 예제는 GetGroupInfoByIndex 메서드. 이 코드의 이전 섹션에는 목록 뷰 컨트롤 만든 예제 보고서 보기에서 "ClientID" 및 "등급" 라는 두 개의 열을 표시 합니다. 다음 코드 예제에서는 이러한 그룹이 있으면 해당 인덱스는 0, 그룹에 대 한 정보를 검색 합니다.

	// GetGroupInfoByIndex
	const int GROUP_HEADER_BUFFER_SIZE = 40;

// Initialize the structure 
	LVGROUP gInfo = {0};
	gInfo.cbSize = sizeof(LVGROUP);
	wchar_t wstrHeadGet[GROUP_HEADER_BUFFER_SIZE] = {0};
	gInfo.cchHeader = GROUP_HEADER_BUFFER_SIZE;
	gInfo.pszHeader = wstrHeadGet;
	gInfo.mask = (LVGF_ALIGN | LVGF_STATE | LVGF_HEADER | LVGF_GROUPID);
	gInfo.state = LVGS_NORMAL;
	gInfo.uAlign  = LVGA_HEADER_LEFT;

	BOOL bRet = m_listCtrl.GetGroupInfoByIndex( 0, &gInfo );
	if (bRet == TRUE) {
		CString strHeader = CString( gInfo.pszHeader );
		CString str;
		str.Format(_T("Header: '%s'"), strHeader);
		AfxMessageBox(str, MB_ICONINFORMATION);
	}
	else
	{
		AfxMessageBox(_T("No group information was retrieved."));
	}

그룹의 메트릭을 검색합니다.

void GetGroupMetrics(PLVGROUPMETRICS pGroupMetrics) const;  

매개 변수

pGroupMetrics
에 대 한 포인터는 LVGROUPMETRICS 그룹 메트릭 정보를 포함 합니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_GETGROUPMETRICS 에 설명 된 대로 메시지는 Windows SDK합니다.

현재 목록 뷰 컨트롤에서 지정된 된 그룹에 대 한 경계 사각형을 검색 합니다.

BOOL GetGroupRect(
    int iGroupId,   
    LPRECT lpRect,   
    int iCoords = LVGGR_GROUP) const;  

매개 변수

매개 변수설명
[in] iGroupId그룹을 지정합니다.
[in, out] lpRect에 대 한 포인터는 RECT 구조입니다. 이 메서드가 성공적 이면 구조 좌표가 사각형으로 지정 된 그룹의 iGroupId합니다.
[in] iCoords검색할 사각형 좌표를 지정 합니다. 다음이 값 중 하나를 사용 합니다.

- LVGGR_GROUP-전체 확장 된 그룹의 (기본값) 좌표입니다.
- LVGGR_HEADER좌표 헤더 (축소 된 그룹)입니다.
- LVGGR_SUBSETLINK좌표 (태그 하위 집합) 하위 집합 링크만입니다.

반환 값

이 메서드가 성공적으로 수행되면 true이고, 그렇지 않으면 false입니다.

설명

호출자가 할당 해야는 RECT 가리키는 구조는 pRect 매개 변수입니다.

이 메서드는 전송 된 LVM_GETGROUPRECT 에 설명 된 메시지는 Windows SDK합니다.

예제

변수를 정의 하는 다음 코드 예제에서는 m_listCtrl, 즉 현재 목록 뷰 컨트롤에 액세스 하는 데 사용 합니다. 이 변수는 다음 예제에서 사용됩니다.

public:
	// Variable used to access the list control.
	CListCtrl m_listCtrl; 

예제

다음 코드 예제는 GetGroupRect 메서드. 이 코드 예제에서는 이전 단원에서 "ClientID" 및 "등급"이 보고서 뷰에서 라는 두 개의 열을 표시 하는 목록 뷰 컨트롤을 만들었습니다. 다음 코드 예제에서는 이러한 그룹이 있으면 해당 인덱스는 0, 그룹 주위 3D 사각형을 그립니다.

	// GetGroupRect

	// Get the graphics rectangle that surrounds group 0.
	CRect rect;
	BOOL bRet = m_listCtrl.GetGroupRect( 0, &rect, LVGGR_GROUP); 
	// Draw a blue rectangle around group 0.
	if (bRet == TRUE) {
		m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(0, 0, 255), RGB(0, 0, 255));
	}
	else {
		AfxMessageBox(_T("No group information was retrieved."), MB_ICONINFORMATION);
	}

현재 목록 뷰 컨트롤에서 지정된 된 그룹에 대 한 상태를 검색합니다.

UINT GetGroupState(
    int iGroupId,   
    DWORD dwMask) const;  

매개 변수

매개 변수설명
[in] iGroupId그룹의 인덱스 0부터 시작 합니다.
[in] dwMask지정된 된 그룹에 대 한 검색 하는 상태 값을 지정 하는 마스크입니다. 자세한 내용은 참조는 mask 의 멤버는 LVGROUP 구조입니다.

반환 값

지정된 된 그룹 또는 그룹을 찾을 수 없는 경우 0에 대 한 요청 된 상태입니다.

설명

반환 값에 비트 AND 연산의 결과이 dwMask 의 값과 매개 변수는 state 의 멤버는 LVGROUP 현재 목록 뷰 컨트롤을 나타내는 구조입니다.

이 메서드는 전송 된 LVM_GETGROUPSTATE 에 설명 된 메시지는 Windows SDK합니다. 자세한 내용은 참조는 ListView_GetGroupState 매크로입니다.

목록 뷰 컨트롤의 헤더 컨트롤을 검색합니다.

CHeaderCtrl* GetHeaderCtrl();

반환 값

List view 컨트롤에서 사용 하는 헤더 컨트롤에 대 한 포인터입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetHeader에 설명 된 대로 Windows SDK합니다.

예제

예를 참조 CListCtrl::GetColumnOrderArray합니다.

목록 뷰 컨트롤에 대해 핫 트래킹을 때 사용 되는 커서를 검색 합니다.

HCURSOR GetHotCursor();

반환 값

List view 컨트롤에서 사용 중인 현재 핫 커서 리소스에 대 한 핸들입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetHotCursor에 설명 된 대로 Windows SDK합니다. 핫 커서 호버 선택을 사용 하는 경우에 표시 되는 모든 목록 보기 항목 위로 커서를 이동할 때 나타납니다. 설정 하 여 호버 선택을 사용 하는지는 LVS_EX_TRACKSELECT 확장 스타일입니다.

예제

		// Set the hot cursor to be the system app starting cursor.
		HCURSOR hCursor = ::LoadCursor(NULL, IDC_APPSTARTING);
		m_myListCtrl.SetHotCursor(hCursor);
		ASSERT(m_myListCtrl.GetHotCursor() == hCursor);

커서에서 현재 목록 보기 항목을 검색합니다.

int GetHotItem();

반환 값

목록 뷰 컨트롤의 현재 활성 항목의 인덱스입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetHotItem에 설명 된 대로 Windows SDK합니다. 핫 추적 (및 선택 마우스를 이동) 하는 경우 현재 선택 된 항목을 사용할 수 있는 핫 항목 정의 됩니다.

핫 트래킹을 사용 사용자 목록 보기 항목 위에 놓을 때을 하는 경우 항목 레이블은 마우스 단추를 사용 하지 않고 자동으로 강조 표시 됩니다.

예제

	// Set the hot item to the first item only if no other item is 
	// highlighted.
	if (m_myListCtrl.GetHotItem() == -1)
		m_myListCtrl.SetHotItem(0);

목록 뷰 컨트롤의 현재 호버 시간을 검색합니다.

DWORD GetHoverTime() const;  

반환 값

이 선택 되기 전에 마우스 커서를 항목 위로 해야 밀리초 지연 시간을 반환 합니다. 반환 값이-1 인 경우 다음 호버 시간은 기본 호버 시간입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetHoverTime에 설명 된 대로 Windows SDK합니다.

예제

		// If the hover time is the default set to 1 sec.
		DWORD dwTime = m_myListCtrl.GetHoverTime();
		if (dwTime == -1)
			m_myListCtrl.SetHoverTime(1000);

그리기 항목 목록 보기에 사용 되는 이미지 목록의 핸들을 검색 합니다.

CImageList* GetImageList(int nImageList) const;  

매개 변수

nImageList
검색 하는 이미지 목록을 지정 하는 값입니다. 다음이 값 중 하나일 수 있습니다.

  • LVSIL_NORMAL큰 아이콘으로 이미지 목록입니다.

  • LVSIL_SMALL작은 아이콘에 있는 이미지 목록입니다.

  • LVSIL_STATE상태 이미지와 이미지 목록입니다.

반환 값

목록 보기 항목을 그리는 데 사용 되는 이미지 목록에 대 한 포인터입니다.

예제

		ASSERT(m_myListCtrl.GetImageList(LVSIL_NORMAL) == NULL);

		m_myListCtrl.SetImageList(&m_lcImageList, LVSIL_NORMAL);
		ASSERT(m_myListCtrl.GetImageList(LVSIL_NORMAL) == &m_lcImageList);

삽입 표시의 현재 위치를 검색합니다.

BOOL GetInsertMark(LPLVINSERTMARK lvim) const;  

매개 변수

lvim
에 대 한 포인터는 LVINSERTMARK 있는 삽입 표시에 대 한 정보가 포함 된 구조입니다.

반환 값

반환 TRUE 성공 하는 경우 또는 FALSE 그렇지 않은 경우. FALSE 경우 반환 됩니다의 크기는 cbSize 의 멤버는 LVINSERTMARK 구조 구조체의 실제 크기와 같지 않습니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_GETINSERTMARK 에 설명 된 대로 메시지는 Windows SDK합니다.

삽입 표시의 현재 색을 검색 합니다.

COLORREF GetInsertMarkColor() const;  

반환 값

반환 된 COLORREF 삽입 지점의 색을 포함 하는 구조입니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_GETINSERTMARKCOLOR 에 설명 된 대로 메시지는 Windows SDK합니다.

삽입점을 제한 하는 사각형을 검색 합니다.

int GetInsertMarkRect(LPRECT pRect) const;  

매개 변수

pRect
에 대 한 포인터는 RECT 삽입 포인터를 제한 하는 사각형의 좌표를 포함 하는 구조입니다.

반환 값

다음 값 중 하나를 반환합니다.

  • 0 삽입 지점을 찾을 수 없습니다.

  • 1 삽입 지점을 찾을 수 있습니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_GETINSERTMARKRECT 에 설명 된 대로 메시지는 Windows SDK합니다.

목록 보기 항목을 특성의 일부 또는 전부를 검색합니다.

BOOL GetItem(LVITEM* pItem) const;  

매개 변수

pItem
에 대 한 포인터는 LVITEM 구조체 항목의 특성입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

LVITEM 구조 지정 하거나 목록 보기 항목의 특성을 받습니다.

목록 뷰 컨트롤의 항목 수를 검색합니다.

int GetItemCount() const;  

반환 값

목록 뷰 컨트롤의 항목 수를 지정 합니다.

예제

예를 참조 CListCtrl::DeleteItem합니다.

지정 된 항목과 연결 된 32 비트 응용 프로그램 관련 값을 검색 nItem합니다.

DWORD_PTR GetItemData(int nItem) const; 

매개 변수

nItem
데이터가 검색 된 목록 항목의 인덱스입니다.

반환 값

지정 된 항목에 연결 하는 32 비트 응용 프로그램 관련 값입니다.

설명

이 값은는 lParam 의 멤버는 LVITEM 에 설명 된 대로 구조는Windows SDK

예제

	// If any item's data is equal to zero then reset it to -1.
	for (int i=0; i < m_myListCtrl.GetItemCount(); i++)
	{
		if (m_myListCtrl.GetItemData(i) == 0)
		{
			m_myListCtrl.SetItemData(i, (DWORD) -1);
		}
	}

현재 목록 뷰 컨트롤의 하위 항목의 전체 또는 일부에 대 한 경계 사각형을 검색 합니다.

BOOL GetItemIndexRect(
    PLVITEMINDEX pItemIndex,   
    int iColumn,   
    int rectType,   
    LPRECT pRect) const;  

매개 변수

매개 변수설명
[in] pItemIndex에 대 한 포인터는 LVITEMINDEX 하위 항목의 부모 항목에 대 한 구조입니다.

호출자는 할당의 멤버를 설정 하는 LVITEMINDEX 구조입니다. 이 매개 변수 수 없습니다 NULL합니다.
[in] iColumn컨트롤에 있는 열의 0부터 시작 인덱스입니다.
[in] rectType경계 사각형을 검색 되는 목록 뷰 하위 항목의 일부입니다. 다음 값 중 하나를 지정합니다.

 LVIR_BOUNDS-아이콘 및 레이블을 포함 하 여 전체 하위 항목의 경계 사각형을 반환 합니다.

 LVIR_ICON-아이콘 또는 작은 아이콘의 하위 항목의 경계 사각형을 반환합니다.

 LVIR_LABEL-하위 항목 텍스트의 경계 사각형을 반환합니다.
[out] pRect에 대 한 포인터는 RECT 하위 항목의 경계 사각형에 대 한 정보를 수신 하는 구조입니다.

호출자가 할당 된 RECT 구조입니다. 이 매개 변수 수 없습니다 NULL합니다.

반환 값

이 메서드가 성공적으로 수행되면 true이고, 그렇지 않으면 false입니다.

설명

이 메서드는 전송 된 LVM_GETITEMINDEXRECT 에 설명 된 메시지는 Windows SDK합니다. 자세한 내용은 참조 ListView_GetItemIndexRect 매크로합니다.

예제

변수를 정의 하는 다음 코드 예제에서는 m_listCtrl, 즉 현재 목록 뷰 컨트롤에 액세스 하는 데 사용 합니다. 이 변수는 다음 예제에서 사용됩니다.

public:
	// Variable used to access the list control.
	CListCtrl m_listCtrl; 

예제

다음 코드 예제는 GetGroupRect 메서드. 이 코드를 입력 하기 전에 목록 뷰 컨트롤 만든 예제 보고서 보기에서 "ClientID" 및 "등급" 라는 두 개의 열을 표시 합니다. 다음 코드 예제에서는 두 열 모두에 두 번째 하위 항목 주위 3D 사각형을 그립니다.

	// GetItemIndexRect
	// Get the rectangle that bounds the second item in the first group.
	LVITEMINDEX lvItemIndex;
	lvItemIndex.iGroup = 0;
	lvItemIndex.iItem = 1;
	CRect rect;
	BOOL bRet = m_listCtrl.GetItemIndexRect(
		&lvItemIndex, 0, LVIR_BOUNDS, &rect);

	// Draw a red rectangle around the item.
	m_listCtrl.GetDC()->Draw3dRect( &rect, RGB(255, 0, 0), RGB(255, 0, 0) );

목록 보기 항목의 위치를 검색 합니다.

BOOL GetItemPosition(
    int nItem,  
    LPPOINT lpPoint) const;  

매개 변수

nItem
해당 위치를 검색할 항목의 인덱스입니다.

lpPoint
주소에 지점 항목의 왼쪽 위 모퉁이의 위치를 수신 하는 구조 보기에서 조정 합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

예제

		POINT pt;

		// Move all items in the list control 100 pixels to the right.
		UINT i, nCount = m_myListCtrl.GetItemCount();

		for (i=0; i < nCount; i++)
		{
			m_myListCtrl.GetItemPosition(i, &pt);
			pt.x += 100;
			m_myListCtrl.SetItemPosition(i, pt);
		}   

현재 보기에서 항목의 전체 또는 일부에 대 한 경계 사각형을 검색 합니다.

BOOL GetItemRect(
    int nItem,  
    LPRECT lpRect,  
    UINT nCode) const;  

매개 변수

nItem
해당 위치를 검색할 항목의 인덱스입니다.

lpRect
주소에 RECT 구조체는 경계 사각형입니다.

nCode
목록 보기 항목을 검색할 경계 사각형의 일부입니다. 다음이 값 중 하나일 수 있습니다.

  • LVIR_BOUNDS아이콘 및 레이블을 포함 하 여 전체 항목의 경계 사각형을 반환 합니다.

  • LVIR_ICON아이콘 또는 작은 아이콘의 경계 사각형을 반환합니다.

  • LVIR_LABEL항목 텍스트의 경계 사각형을 반환합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

예제

// OnClick is the handler for the NM_CLICK notification
void CListCtrlDlg::OnClick(NMHDR* pNMHDR, LRESULT* pResult)
{
	UNREFERENCED_PARAMETER(pResult);

	LPNMITEMACTIVATE pia = (LPNMITEMACTIVATE)pNMHDR;

	// Get the current mouse location and convert it to client
	// coordinates.
	CPoint pos( ::GetMessagePos() ); 
	ScreenToClient(&pos);

	// Get indexes of the first and last visible items in 
	// the listview control.
	int index = m_myListCtrl.GetTopIndex();
	int last_visible_index = index + m_myListCtrl.GetCountPerPage();
	if (last_visible_index > m_myListCtrl.GetItemCount())
		last_visible_index = m_myListCtrl.GetItemCount();

	// Loop until number visible items has been reached.
	while (index <= last_visible_index)
	{
		// Get the bounding rectangle of an item. If the mouse
		// location is within the bounding rectangle of the item,
		// you know you have found the item that was being clicked.
		CRect r;
		m_myListCtrl.GetItemRect(index, &r, LVIR_BOUNDS);
		if (r.PtInRect(pia->ptAction))
		{
			UINT flag = LVIS_SELECTED | LVIS_FOCUSED;
			m_myListCtrl.SetItemState(index, flag, flag);
			break;
		}

		// Get the next item in listview control.
		index++;
	}
}

현재 목록 뷰 컨트롤의 항목 사이의 간격을 계산합니다.

BOOL GetItemSpacing(
    BOOL fSmall,   
    int* pnHorzSpacing,   
    int* pnVertSpacing) const;  

매개 변수

매개 변수설명
[in] fSmall검색할 항목 간격에 대 한 보기입니다. 지정 true 작은 아이콘 보기의 경우 또는 false 아이콘 보기에 대 한 합니다.
[out] pnHorzSpacing항목 간에 가로 간격을 포함합니다.
[out] pnVertSpacing항목 간 세로 간격을 포함합니다.

반환 값

이 메서드가 성공적으로 수행되면 true이고, 그렇지 않으면 false입니다.

설명

이 메서드는 전송 된 LVM_GETITEMSPACING 에 설명 된 메시지는 Windows SDK합니다.

목록 보기 항목의 상태를 검색합니다.

UINT GetItemState(
    int nItem,  
    UINT nMask) const;  

매개 변수

nItem
상태가 검색할 항목의 인덱스입니다.

nMask
항목의 상태를 반환 하는 플래그를 지정 하는 마스크입니다.

반환 값

지정된 된 목록에 대 한 상태 플래그 항목 보기.

설명

항목의 상태를 지정 하 여는 상태 의 멤버는 LVITEM 구조체에 설명 된 대로 Windows SDK합니다. 지정 하거나 항목의 상태를 변경할 때의 stateMask 멤버 상태 비트를 변경 하려면 지정 합니다.

예제

예를 참조 CListCtrl::GetTopIndex합니다.

목록 보기 항목 또는 하위 항목의 텍스트를 검색합니다.

int GetItemText(
    int nItem,  
    int nSubItem,  
    LPTSTR lpszText,  
    int nLen) const; 
 
CString GetItemText(
    int nItem,  
    int nSubItem) const;  

매개 변수

nItem
검색할 수 있는 텍스트는 항목의 인덱스입니다.

nSubItem
검색할 텍스트가 하위 항목을 지정 합니다.

lpszText
항목 텍스트를 수신 하는 문자열에 대 한 포인터입니다.

nLen
가 가리키는 버퍼의 길이 lpszText합니다.

반환 값

반환 되는 버전 int 검색 된 문자열의 길이 반환 합니다.

반환 되는 버전을 CString 항목 텍스트를 반환 합니다.

설명

경우 nSubItem 가 0 인 경우이 함수에 항목 레이블; 검색 nSubItem 는 0이 아닌 경우 텍스트를 검색 하위 항목의 합니다. 하위 항목 인수에 대 한 자세한 내용은 설명 부분을 참조 하십시오.는 LVITEM 구조에서 Windows SDK합니다.

목록에 대 한 검색 볼 항목 이동 하 고 지정 된 속성이 있는 특정된 항목에 지정된 된 관계를 갖습니다.

int GetNextItem(
    int nItem,  
    int nFlags) const;  

매개 변수

nItem
지정된 된 플래그와 일치 하는 첫 번째 항목을 찾습니다.-1, 검색을 시작할 항목의 인덱스입니다. 지정 된 항목 자체는 검색에서 제외 됩니다.

nFlags
요청된 된 항목의 상태와 지정된 된 항목을 요청한 항목의 기하학적 관계입니다. 기하학적 관계는 다음이 값 중 하나일 수 있습니다.

  • LVNI_ABOVE지정된 된 항목 위쪽에 있는 항목을 검색 합니다.

  • LVNI_ALL인덱스 (기본값) 별로 다음 항목을 검색 합니다.

  • LVNI_BELOW지정된 된 항목 아래에 있는 항목을 검색 합니다.

  • LVNI_TOLEFT지정된 된 항목의 왼쪽에 있는 항목을 검색 합니다.

  • LVNI_TORIGHT지정된 된 항목의 오른쪽에 있는 항목을 검색 합니다.

상태는 0 일 수 또는 이러한 값 중 하나 이상을 사용할 수 있습니다.

  • LVNI_DROPHILITED항목에는 LVIS_DROPHILITED 플래그가 설정 된 상태입니다.

  • LVNI_FOCUSED항목에는 LVIS_FOCUSED 플래그가 설정 된 상태입니다.

  • LVNI_SELECTED항목에는 LVIS_SELECTED 플래그가 설정 된 상태입니다.

항목에 지정 된 상태 플래그 집합의 일부 없는 경우 다음 항목을 계속 검색 합니다.

반환 값

그렇지 않으면-1 성공 하는 경우 다음 항목의 인덱스입니다.

지정된 된 속성 집합이 있는 현재 목록 뷰 컨트롤에서 항목의 인덱스를 검색 합니다.

BOOL GetNextItemIndex(
    PLVITEMINDEX pItemIndex,   
    int nFlags) const;  

매개 변수

매개 변수설명
[in, out] pItemIndex에 대 한 포인터는 LVITEMINDEX 검색이 시작 되는 항목을 설명 하는 구조 또는-1은 첫 번째 일치 하는 항목에 플래그를 찾기는 nFlags 매개 변수입니다.

이 메서드가 성공적으로 수행 되는 LVITEMINDEX 구조 검색 하 여 항목을 설명 합니다.
[in] nFlags검색을 수행 하는 방법을 지정 하는 플래그의 비트 조합 (OR)입니다.

검색 인덱스, 상태 또는 대상 항목의 모양에 따라 달라질 수 또는으로 지정 된 항목을 기준으로 대상 항목의 실제 위치는 pItemIndex 매개 변수입니다. 자세한 내용은 참조는 flags 매개 변수는 LVM_GETNEXTITEMINDEX 메시지입니다.

반환 값

이 메서드가 성공적으로 수행되면 true이고, 그렇지 않으면 false입니다.

설명

호출자는 할당의 멤버를 설정 하는 LVITEMINDEX 가리키는 구조는 pItemIndex 매개 변수입니다.

이 메서드는 전송 된 LVM_GETNEXTITEMINDEX 메시지는 Windows SDK에 설명 되어 있습니다.

식별 되는 목록 항목의 인덱스를 가져옵니다 pos를 설정 하는 다음 pos위치 값입니다.

int GetNextSelectedItem(POSITION& pos) const;  

매개 변수

pos
에 대 한 참조는 위치 에 대 한 이전 호출에서 반환 된 값 GetNextSelectedItem 또는 GetFirstSelectedItemPosition합니다. 값은 다음 위치에이 호출으로 업데이트 됩니다.

반환 값

식별 되는 목록 항목의 인덱스 pos합니다.

설명

사용할 수 있습니다 GetNextSelectedItem 정방향 반복 루프를 호출 하 여 초기 위치를 설정 하는 경우에 GetFirstSelectedItemPosition합니다.

확인 해야 하면 위치 값이 유효 합니다. 올바르지 않을 경우 Microsoft Foundation 클래스 라이브러리의 디버그 버전 어설션 합니다.

예제

다음 코드 예제에서는이 함수의 사용을 보여 줍니다.

		POSITION pos = m_myListCtrl.GetFirstSelectedItemPosition();
		if (pos == NULL)
		{
			TRACE(_T("No items were selected!\n"));
		}
		else
		{
			while (pos)
			{
				int nItem = m_myListCtrl.GetNextSelectedItem(pos);
				TRACE(_T("Item %d was selected!\n"), nItem);
				// you could do your own processing on nItem here
			}
		}

현재는 목록 뷰 컨트롤에 대 한 작업 영역 수를 검색합니다.

UINT GetNumberOfWorkAreas() const;  

반환 값

이 이번에는 사용 되지 않습니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetNumberOfWorkAreas에 설명 된 대로 Windows SDK합니다.

예제

		UINT i, uCount = m_myListCtrl.GetNumberOfWorkAreas();
		LPRECT lpRects = (LPRECT) malloc(uCount*sizeof(RECT));

		if (lpRects != NULL)
		{
			// Dump all of the work area dimensions.
			m_myListCtrl.GetWorkAreas(uCount, lpRects);

			for (i=0; i < uCount; i++)
			{
				TRACE(_T("Work area %d; left = %d, top = %d, right = %d, ")
					_T("bottom = %d\r\n"),
					i, lpRects[i].left, lpRects[i].top, lpRects[i].right, 
					lpRects[i].bottom);
			}

			free(lpRects);
		}
		else
		{
			TRACE(_T("Couldn't allocate enough memory!"));   
		}

목록 뷰 컨트롤의 테두리 색을 검색 합니다.

COLORREF GetOutlineColor() const;  

반환 값

반환 된 COLORREF 윤곽선 색을 포함 하는 구조입니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_GETOUTLINECOLOR 에 설명 된 대로 메시지는 Windows SDK합니다.

목록 뷰 컨트롤에 대 한 현재 보기 원점을 검색합니다.

BOOL GetOrigin(LPPOINT lpPoint) const;  

매개 변수

lpPoint
주소에 지점 구조체 뷰 원점입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다. 그러나 컨트롤이 보고서 뷰에서 경우 반환 값은 항상 0입니다.

목록 컨트롤에서 현재 선택 된 열의 인덱스를 검색합니다.

UINT GetSelectedColumn() const;  

반환 값

선택한 열의 인덱스입니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_GETSELECTEDCOLUMN 에 설명 된 대로 메시지는 Windows SDK합니다.

List view 컨트롤에서 선택한 항목의 수를 가져옵니다.

UINT GetSelectedCount() const;  

반환 값

List view 컨트롤에서 선택한 항목의 수입니다.

예제

		UINT i, uSelectedCount = m_myListCtrl.GetSelectedCount();
		int  nItem = -1;

		// Update all of the selected items.
		if (uSelectedCount > 0)
		{
			for (i=0; i < uSelectedCount; i++)
			{
				nItem = m_myListCtrl.GetNextItem(nItem, LVNI_SELECTED);
				ASSERT(nItem != -1);
				m_myListCtrl.Update(nItem); 
			}
		}

목록 뷰 컨트롤의 선택 표시를 검색합니다.

int GetSelectionMark();

반환 값

0부터 시작 선택 영역 표시 또는 선택 표시가 없는 경우-1입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetSelectionMark에 설명 된 대로 Windows SDK합니다.

예제

	// Set the selection mark to the first item only if no other item is 
	// selected.
	if (m_myListCtrl.GetSelectionMark() == -1)
		m_myListCtrl.SetSelectionMark(0);

지정된 된 문자열의 모든 표시 하는 데 필요한 최소 열 너비를 결정 합니다.

int GetStringWidth(LPCTSTR lpsz) const;  

매개 변수

lpsz
해당 너비를 결정 해야 하는 null로 끝나는 문자열의 주소입니다.

반환 값

너비를 가리키는 문자열의 크기를 픽셀 단위로 lpsz합니다.

설명

반환 된 너비는 컨트롤의 현재 글꼴 및 열 여백 하지만 작은 아이콘의 너비가 아닌을 고려 합니다.

예제

		CString strColumn;
		int nWidth;

		// Insert six columns in the list view control. Make the width of
		// the column be the width of the column header plus 50%.
		for (int i = 0; i < 6; i++)
		{
			strColumn.Format(_T("column %d"), i);
			nWidth = 3*m_myListCtrl.GetStringWidth(strColumn)/2;
			m_myListCtrl.InsertColumn(i, strColumn, LVCFMT_LEFT, nWidth);
		}

목록 뷰 컨트롤에 있는 항목의 경계 사각형을 검색 합니다.

BOOL GetSubItemRect(
    int iItem,  
    int iSubItem,  
    int nArea,  
    CRect& ref);

매개 변수

iItem
하위 항목의 부모 항목의 인덱스입니다.

iSubItem
하위 항목의 1부터 시작 인덱스입니다.

nArea
검색할 (목록 보기의 하위 항목)의 경계 사각형의 부분을 결정 합니다. 경계 사각형의 부분 (아이콘, 레이블 또는 둘 다)은 다음 값 중 하나 이상의 비트 OR 연산자를 적용 하 여 지정 됩니다.

  • LVIR_BOUNDS아이콘 및 레이블을 포함 하 여 전체 항목의 경계 사각형을 반환 합니다.

  • LVIR_ICON아이콘 또는 작은 아이콘의 경계 사각형을 반환합니다.

  • LVIR_LABEL아이콘 및 레이블을 포함 하 여 전체 항목의 경계 사각형을 반환 합니다. 동일 LVIR_BOUNDS합니다.

ref
에 대 한 참조는 CRect 하위 항목의 좌표를 포함 하는 개체의 경계 사각형입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetSubItemRect에 설명 된 대로 Windows SDK합니다.

목록 뷰 컨트롤의 텍스트 배경 색을 검색합니다.

COLORREF GetTextBkColor() const;  

반환 값

RGB 색을 지정 하는 데 사용 되는 32 비트 값입니다.

예제

예를 참조 CListCtrl::SetTextBkColor합니다.

목록 뷰 컨트롤의 텍스트 색을 검색합니다.

COLORREF GetTextColor() const;  

반환 값

RGB 색을 지정 하는 데 사용 되는 32 비트 값입니다.

예제

예를 참조 CListCtrl::SetTextColor합니다.

목록 뷰 컨트롤에서 타일에 대 한 정보를 검색합니다.

BOOL GetTileInfo(PLVTILEINFO pti) const;  

매개 변수

pti
에 대 한 포인터는 LVTILEINFO 타일 정보를 수신 하는 구조입니다.

반환 값

반환 값은 사용 되지 않습니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_GETTILEINFO 에 설명 된 대로 메시지는 Windows SDK합니다.

Tile 보기에는 목록 뷰 컨트롤에 대 한 정보를 검색합니다.

BOOL GetTileViewInfo(PLVTILEVIEWINFO ptvi) const;  

매개 변수

ptvi
에 대 한 포인터는 LVTILEVIEWINFO 검색 된 정보를 수신 하는 구조입니다.

반환 값

반환 값은 사용 되지 않습니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_GETTILEVIEWINFO 에 설명 된 대로 메시지는 Windows SDK합니다.

목록 뷰 컨트롤에서 사용 하 여 도구 설명을 표시 하는 도구 설명 컨트롤을 검색 합니다.

CToolTipCtrl* GetToolTips() const;  

반환 값

에 대 한 포인터는 CToolTipCtrl 목록 컨트롤에서 사용할 개체입니다. 경우는 만들기 스타일을 사용 하는 멤버 함수 LVS_NOTOOLTIPS, 도구 설명 없음 사용 되 고 NULL 반환 됩니다.

설명

이 멤버 함수는 Win32 메시지의 동작을 구현 LVM_GETTOOLTIPS에 설명 된 대로 Windows SDK합니다. MFC 구현 GetToolTips 반환는 CToolTipCtrl 도구 설명 컨트롤에 대 한 핸들 보다는 목록 컨트롤에서 사용 되는 개체입니다.

예제

		CToolTipCtrl* pTip = m_myListCtrl.GetToolTips();
		if (NULL != pTip)
		{
			pTip->UpdateTipText(_T("I'm a list view!"), &m_myListCtrl,
				IDD_MYLISTCTRL);
		}

목록 보기 또는 보고서에서 표시 되는 맨 위에 있는 항목의 인덱스를 검색 합니다.

int GetTopIndex() const;  

반환 값

표시 되는 맨 위에 있는 항목의 인덱스입니다.

예제

		// Make sure the focus is set to the list view control.
		m_myListCtrl.SetFocus();

		// Select all of the items that are completely visible.
		int n = m_myListCtrl.GetTopIndex();
		int nLast = n + m_myListCtrl.GetCountPerPage();

		for (; n < nLast; n++)
		{
			m_myListCtrl.SetItemState(n, LVIS_SELECTED, LVIS_SELECTED);
			ASSERT(m_myListCtrl.GetItemState(n, LVIS_SELECTED) == LVIS_SELECTED); 
		}

목록 뷰 컨트롤의 뷰를 가져옵니다.

DWORD GetView() const;  

반환 값

목록 뷰 컨트롤의 현재 보기입니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_GETVIEW 에 설명 된 대로 메시지는 Windows SDK합니다.

목록 뷰 컨트롤의 모든 항목의 경계 사각형을 검색합니다.

BOOL GetViewRect(LPRECT lpRect) const;  

매개 변수

lpRect
주소에 RECT 구조입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

목록 보기 보기 아이콘 또는 작은 아이콘 보기에 있어야 합니다.

목록 뷰 컨트롤의 현재 작업 영역을 검색합니다.

void GetWorkAreas(
    int nWorkAreas,  
    LPRECT prc) const;  

매개 변수

nWorkAreas
수가 RECT 에 포함 된 구조는 중국 배열입니다.

prc
배열에 대 한 포인터 RECT 구조 (또는 CRect 개체)의 목록 보기 컨트롤의 작업 영역을 수신 하 합니다. 이러한 구조체의 값은 클라이언트 좌표입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_GetWorkAreas에 설명 된 대로 Windows SDK합니다.

예제

예를 참조 CListCtrl::GetNumberOfWorkAreas합니다.

목록 뷰 컨트롤에서 지정된 된 그룹에 있는지 확인 합니다.

BOOL HasGroup(int iGroupId) const;  

매개 변수

iGroupId
요청 되는 그룹의 식별자입니다.

반환 값

반환 TRUE 성공 FALSE 실패 합니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_HASGROUP 에 설명 된 대로 메시지는 Windows SDK합니다.

지정된 된 위치에 있는 경우 목록 보기 항목을 결정 합니다.

int HitTest(LVHITTESTINFO* pHitTestInfo) const;  
  
int HitTest(
    CPoint pt,  
    UINT* pFlags = NULL) const;  

매개 변수

pHitTestInfo
주소에 LVHITTESTINFO 적중된 테스트의 결과 대 한 정보를 수신 하는 적중 테스트에 위치를 포함 하는 구조입니다.

pt
테스트 지점입니다.

pFlags
테스트의 결과 대 한 정보를 수신 하는 정수에 대 한 포인터입니다. 설명을 참조 하십시오.는 플래그 의 멤버는 LVHITTESTINFO 구조에서 Windows SDK합니다.

반환 값

에 지정 된 위치에 있는 항목의 인덱스 pHitTestInfo, 그렇지 않으면-1을 반환 합니다.

설명

사용할 수는 LVHT_ABOVE, LVHT_BELOW, LVHT_TOLEFT, 및 LVHT_TORIGHT 는 구조체의 값 플래그 멤버는 목록 뷰 컨트롤의 콘텐츠 스크롤 여부를 결정 합니다. 이러한 플래그 중 두 가지 결합할 수 있습니다, 예를 들어 위와 클라이언트 영역의 왼쪽에 위치는 경우.

테스트할 수 있습니다는 LVHT_ONITEM 구조체의 값 플래그 멤버 목록 보기 항목을 통해 지정된 된 위치 인지 여부를 확인 합니다. 이 값은 비트 OR 작업에는 LVHT_ONITEMICON, LVHT_ONITEMLABEL, 및 LVHT_ONITEMSTATEICON 는 구조체의 값 플래그 멤버입니다.

예제

void CListCtrlDlg::OnRClick(NMHDR* pNMHDR, LRESULT* pResult)
{
	LPNMITEMACTIVATE pia = (LPNMITEMACTIVATE)pNMHDR;
	CPoint point(pia->ptAction);

	// Select the item the user clicked on.
	UINT uFlags;
	int nItem = m_myListCtrl.HitTest(point, &uFlags);

	if (uFlags & LVHT_ONITEMLABEL)
	{
		m_myListCtrl.SetItem(nItem, 0, LVIF_STATE, NULL, 0, LVIS_SELECTED, 
			LVIS_SELECTED, 0);
	}

	*pResult = 0;
}

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

int InsertColumn(
    int nCol,  
    const LVCOLUMN* pColumn);

 
int InsertColumn(
    int nCol,  
    LPCTSTR lpszColumnHeading,  
    int nFormat = LVCFMT_LEFT,  
    int nWidth = -1,  
    int nSubItem = -1);

매개 변수

nCol
새 열의 인덱스입니다.

pColumn
주소에 LVCOLUMN 새 열의 특성을 포함 하는 구조입니다.

lpszColumnHeading
열 머리글을 포함 하는 문자열의 주소입니다.

nFormat
열의 맞춤을 지정 하는 정수입니다. 다음이 값 중 하나일 수 있습니다: LVCFMT_LEFT, LVCFMT_RIGHT, 또는 LVCFMT_CENTER합니다.

nWidth
픽셀 단위로 열 너비입니다. 이 매개 변수는-1, 열 너비 설정 되지 않았습니다.

nSubItem
열에 연결 된 하위 항목의 인덱스입니다. 이 매개 변수는-1을 하위 항목이 없는 열과 연결 됩니다.

반환 값

성공 하는 경우 새 열 또는 그렇지 않으면-1의 인덱스입니다.

설명

목록 뷰 컨트롤에서 가장 왼쪽 열에는 왼쪽 정렬 해야 합니다.

LVCOLUMN 구조 보고서 보기에 있는 열의 특성을 포함 합니다. 열에 대 한 정보를 받을 사용 됩니다. 이 구조에 설명 된 Windows SDK합니다.

그룹 목록 뷰 컨트롤에 삽입합니다.

LRESULT InsertGroup(
    int index,  
    PLVGROUP pgrp);

매개 변수

인덱스
그룹을 삽입할 수 있는 항목의 인덱스입니다.

pgrp
에 대 한 포인터는 LVGROUP 추가할 그룹을 포함 하는 구조입니다.

반환 값

작업에 실패 하면 그룹에 추가 된 항목의 인덱스를 반환 합니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_INSERTGROUP 에 설명 된 대로 메시지는 Windows SDK합니다.

그룹의 정렬 된 목록에 지정된 된 그룹을 삽입합니다.

LRESULT InsertGroupSorted(PLVINSERTGROUPSORTED pStructInsert);

매개 변수

pStructInsert
에 대 한 포인터는 LVINSERTGROUPSORTED 삽입 하는 그룹을 포함 하는 구조입니다.

반환 값

반환 값은 사용 되지 않습니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_INSERTGROUPSORTED 에 설명 된 대로 메시지는 Windows SDK합니다.

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

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 구조 에 Windows SDK합니다. 비트 OR 연산자와 함께 사용할 수 있는 값을 결합할 수 있습니다.

nState
항목의 상태, 상태 이미지 및 오버레이 이미지를 나타냅니다. 참조는 Windows SDK 항목 LVITEM 구조 에 대 한 자세한 내용은 및 목록 뷰 항목 상태 유효한 플래그 목록은 합니다.

nStateMask
상태 멤버의 비트를 검색 하거나 수정할 수를 나타냅니다. 참조 LVITEM 구조 에 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);
			}
		}

지정된 된 지점에 가장 가까운 삽입 포인터를 검색합니다.

int InsertMarkHitTest(
    LPPOINT pPoint,  
    LPLVINSERTMARK lvim) const;  

매개 변수

pPoint
에 대 한 포인터는 지점 목록 컨트롤의 클라이언트 영역을 기준으로 적중된 테스트를 포함 하는 구조를 조정 합니다.

lvim
에 대 한 포인터는 LVINSERTMARK 지점 매개 변수에 의해 정의 된 좌표에 가장 가까운 삽입 지점을 지정 하는 구조입니다.

반환 값

가장 가까이 삽입 포인터를 지정 된 지점.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_INSERTMARKHITTEST 에 설명 된 대로 메시지는 Windows SDK합니다.

그룹 보기는 목록 뷰 컨트롤에 대 한 사용 되는지 여부를 결정 합니다.

BOOL IsGroupViewEnabled() const;  

반환 값

반환 TRUE 그룹 보기를 사용 하는 경우 또는 FALSE 그렇지 않은 경우.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_ISGROUPVIEWENABLED 에 설명 된 대로 메시지는 Windows SDK합니다.

현재 목록 뷰 컨트롤에서 지정된 된 항목 표시 여부를 나타냅니다.

BOOL IsItemVisible(int index) const;  

매개 변수

매개 변수설명
[in] index현재 목록 뷰 컨트롤에 있는 항목의 0부터 시작 인덱스입니다.

반환 값

true지정 된 항목이 표시 되 고, 그렇지 않으면 경우 false합니다.

설명

이 메서드는 전송 된 LVM_ISITEMVISIBLE 에 설명 된 메시지는 Windows SDK합니다.

인덱스를 현재 목록 뷰 컨트롤에 있는 항목의 고유 ID를 매핑합니다.

UINT MapIDToIndex(UINT id) const;  

매개 변수

매개 변수설명
[in] id항목의 고유 ID입니다.

반환 값

지정 된 ID에 대 한 현재 인덱스

설명

내부적으로 목록 뷰 컨트롤 인덱스 별로 항목을 추적합니다. 인덱스는 컨트롤의 수명 동안 변경 될 수 있으므로 문제가 발생할 수 있습니다. 항목이 만들어질 때이 ID를 사용 하 여 목록 뷰 컨트롤의 수명 동안 고유성을 보장 하기 위해 목록 뷰 컨트롤에 id가 항목을 태그 수 있습니다.

Note 다중 스레드 환경에서 배경 스레드에서 하지 목록 뷰 컨트롤을 호스트 하는 스레드에서 인덱스 보장 됩니다.

이 메서드는 전송 된 LVM_MAPIDTOINDEX 에 설명 된 메시지는 Windows SDK합니다.

고유 ID를 현재 목록 뷰 컨트롤에 있는 항목의 인덱스를 매핑합니다.

UINT MapIndexToID(UINT index) const;  

매개 변수

매개 변수설명
[in] index항목의 0부터 시작 하는 인덱스입니다.

반환 값

지정된 된 항목에 대 한 고유 ID입니다.

설명

내부적으로 목록 뷰 컨트롤 인덱스 별로 항목을 추적합니다. 인덱스는 컨트롤의 수명 동안 변경 될 수 있으므로 문제가 발생할 수 있습니다. 항목을 만들 때 목록 뷰 컨트롤에 id가 항목을 태그 수 있습니다. 목록 뷰 컨트롤의 수명에 대 한 특정 항목에 액세스 하려면이 ID를 사용할 수 있습니다.

Note 다중 스레드 환경에서 배경 스레드에서 하지 목록 뷰 컨트롤을 호스트 하는 스레드에서 인덱스 보장 됩니다.

이 메서드는 전송 된 LVM_MAPINDEXTOID 에 설명 된 메시지는 Windows SDK합니다.

예제

변수를 정의 하는 다음 코드 예제에서는 m_listCtrl, 즉 현재 목록 뷰 컨트롤에 액세스 하는 데 사용 합니다. 이 변수는 다음 예제에서 사용됩니다.

public:
	// Variable used to access the list control.
	CListCtrl m_listCtrl; 

예제

다음 코드 예제는 MapIndexToID 메서드. 이 코드 예제에서는 이전 단원에서 "ClientID" 및 "등급"이 보고서 뷰에서 라는 두 개의 열을 표시 하는 목록 뷰 컨트롤을 만들었습니다. 다음 예제에서는 각 목록 보기 항목의 인덱스 id 번호에 매핑하고 각 id에 대 한 인덱스를 검색 합니다. 마지막으로,이 예제에서는 원래 인덱스 검색 된 있는지 여부를 보고 합니다.

	// MapIndexToID
	int iCount = m_listCtrl.GetItemCount();
	UINT nId = 0;
	UINT nIndex = 0;
	for (int iIndexOriginal = 0; iIndexOriginal < iCount; iIndexOriginal++)
	{
		// Map index to ID.
		nId = m_listCtrl.MapIndexToID((UINT)iIndexOriginal);

		// Map ID to index.
		nIndex = m_listCtrl.MapIDToIndex(nId);

		if (nIndex != (UINT)(iIndexOriginal))
		{
			CString str;
			str.Format(_T("Mapped index (%d) is not equal to original index (%d)"),
				nIndex, (UINT)(iIndexOriginal));
			AfxMessageBox(str);
			return;
		}
	}
	AfxMessageBox(_T("The mapped indexes and original indexes are equal."), 
		MB_ICONINFORMATION);

지정 된 그룹에 지정 된 목록 뷰 컨트롤의 0 기반된 인덱스를 이동 합니다.

LRESULT MoveGroup(
    int iGroupId,  
    int toIndex);

매개 변수

iGroupId
이동 해야 하는 그룹의 식별자입니다.

toIndex
여기서 그룹을 이동 해야 하는 0부터 시작 하는 인덱스입니다.

반환 값

반환 값은 사용 되지 않습니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_MOVEGROUP 에 설명 된 대로 메시지는 Windows SDK합니다.

지정된 된 그룹에 지정된 된 항목을 이동합니다.

void MoveItemToGroup(
    int idItemFrom,  
    int idGroupTo);

매개 변수

[in] idItemFrom
이동할 항목의 인덱스입니다.

[in] idGroupTo
그룹의 식별자는 항목으로 이동 됩니다.

설명

System_CAPS_ICON_note.jpg 참고

이 메서드가 현재 구현 되지 않았습니다.

기능을 에뮬레이션 하는이 메서드는 LVM_MOVEITEMTOGROUP 에 설명 된 대로 메시지는 Windows SDK합니다.

항목의 범위를 다시 그려야 하는 목록 뷰 컨트롤을 강제로 수행 합니다.

BOOL RedrawItems(
    int nFirst,  
    int nLast);

매개 변수

nFirst
그려야 하는 첫 번째 항목의 인덱스입니다.

nLast
그려야 하는 마지막 항목의 인덱스입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

지정된 된 항목 목록 보기 창에는 수신 될 때까지 실제로 다시 하지는 WM_PAINT 메시지입니다. 즉시 다시 그리게 하는 Windows 호출 UpdateWindow 후이 함수를 사용 하는 함수입니다.

목록 뷰 컨트롤에서 모든 그룹을 제거합니다.

void RemoveAllGroups();

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_REMOVEALLGROUPS 에 설명 된 대로 메시지는 Windows SDK합니다.

List view 컨트롤에서 지정된 된 그룹을 제거합니다.

LRESULT RemoveGroup(int iGroupId);

매개 변수

iGroupId
제거할 그룹의 식별자입니다.

반환 값

그렇지 않으면 성공 하는 경우 그룹의 인덱스를 반환 합니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_REMOVEGROUP 에 설명 된 대로 메시지는 Windows SDK합니다.

목록 뷰 컨트롤의 내용을 스크롤합니다.

BOOL Scroll(CSize size);

매개 변수

size
A CSize 가로 및 세로 스크롤, 픽셀에서의 크기를 지정 하는 개체입니다. y 소속 size (픽셀) 목록 뷰 컨트롤의 각 줄의 높이 나눈 결과 수가 줄에서 컨트롤은 스크롤.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

목록 뷰 컨트롤의 배경색을 설정합니다.

BOOL SetBkColor(COLORREF cr);

매개 변수

cr
배경색을 설정 하려면 또는 CLR_NONE 없는 배경색에 대 한 값입니다. 배경색을 사용 하 여 목록 뷰 컨트롤 스스로 다시 그릴 크게 배경색 없이 보다 더 빨리 합니다. 내용은 COLORREF 에 Windows SDK합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

예제

		// Use the 3D button face color for the background.
		COLORREF crBkColor = ::GetSysColor(COLOR_3DFACE);
		m_myListCtrl.SetBkColor(crBkColor);
		ASSERT(m_myListCtrl.GetBkColor() == crBkColor);

목록 뷰 컨트롤의 배경 이미지를 설정합니다.

BOOL SetBkImage(LVBKIMAGE* plvbkImage);
 
BOOL SetBkImage(
    HBITMAP hbm,  
    BOOL fTile = TRUE,  
    int xOffsetPercent = 0,  
    int yOffsetPercent = 0);
 
BOOL SetBkImage(
    LPTSTR pszUrl,  
    BOOL fTile = TRUE,  
    int xOffsetPercent = 0,  
    int yOffsetPercent = 0);

매개 변수

plvbkImage
주소에 LVBKIMAGE 새 배경 이미지 정보가 포함 된 구조입니다.

hbm
비트맵에 대 한 핸들입니다.

pszUrl
A NULL-배경 이미지의 URL이 포함 된 문자열을 종료 합니다.

fTile
이미지는 목록 뷰 컨트롤의 배경에 바둑판식으로 배열 하는 경우 0이 아닌 그렇지 않으면 0입니다.

xOffsetPercent
목록 뷰 컨트롤의 원점에서 이미지의 왼쪽된 가장자리를 픽셀 단위로 오프셋입니다.

yOffsetPercent
목록 뷰 컨트롤의 원점에서 이미지의 위쪽 가장자리를 픽셀 단위로 오프셋입니다.

반환 값

그렇지 않으면 0 또는 성공 하면 0이 아닌 반환 합니다.

설명

System_CAPS_ICON_note.jpg 참고

때문에 CListCtrl::SetBkImage OLE COM 기능 활용, OLE 라이브러리를 사용 하기 전에 초기화 해야 SetBkImage합니다. 응용 프로그램이 초기화 될 때 COM 라이브러리를 초기화 하 고 응용 프로그램이 종료 될 때 라이브러리의 초기화를 취소 하는 것이 좋습니다. 이 작업은 자동으로 수행 하는 응용 프로그램 mfc에서 ActiveX 기술, OLE 자동화, OLE 링크/포함, 또는 ODBC/DAO 작업의 사용 합니다.

예제

예를 참조 CListCtrl::GetBkImage합니다.

목록 뷰 컨트롤에 대 한 콜백 마스크를 설정합니다.

BOOL SetCallbackMask(UINT nMask);

매개 변수

nMask
콜백 마스크의 새 값입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

예제

	// Set the callback mask so that only the selected and focused states
	// are stored for each item.
	m_myListCtrl.SetCallbackMask(LVIS_SELECTED|LVIS_FOCUSED);
	ASSERT(m_myListCtrl.GetCallbackMask() == 
		(LVIS_SELECTED|LVIS_FOCUSED));

목록 컨트롤 항목의 상태 이미지가 표시 되는지를 결정 합니다.

BOOL SetCheck(
    int nItem,  
    BOOL fCheck = TRUE);

매개 변수

nItem
목록 컨트롤 항목의 0부터 시작 하는 인덱스입니다.

fCheck
항목의 상태 이미지 표시할지 여부를 지정 합니다. 기본적으로 fCheckTRUE 상태 이미지 표시 됩니다. 경우 fCheckFALSE, 표시 되지 않습니다.

반환 값

항목을 선택한 경우에 0이 아니고 그렇지 않으면 0입니다.

예제

		int nCount = m_myListCtrl.GetItemCount();
		BOOL fCheck = FALSE;

		// Set the check state of every other item to TRUE and 
		// all others to FALSE.
		for (int i = 0; i < nCount; i++)
		{
			m_myListCtrl.SetCheck(i, fCheck);
			ASSERT((m_myListCtrl.GetCheck(i) && fCheck) || 
				(!m_myListCtrl.GetCheck(i) && !fCheck));
			fCheck = !fCheck;
		}

목록 뷰 열 특성을 설정합니다.

BOOL SetColumn(
    int nCol,  
    const LVCOLUMN* pColumn);

매개 변수

nCol
설정 된 특성을 가진 열의 인덱스입니다.

pColumn
주소에 LVCOLUMN 에 설명 된 대로 새 열이 포함 된 구조 특성은 Windows SDK합니다. 구조체의 마스크 멤버는 열을 설정 하려면 특성을 지정 합니다. 하는 경우는 마스크 멤버 지정는 LVCF_TEXT 값 구조체의 pszText 멤버는 null로 끝나는 문자열 및 구조체의 주소 cchTextMax 멤버가 무시 됩니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

예제

예를 참조 CListCtrl::GetColumn합니다.

목록 뷰 컨트롤의 열 순서 (왼쪽에서 오른쪽)를 설정 합니다.

BOOL SetColumnOrderArray(
    int iCount,  
    LPINT piArray);

매개 변수

piArray
목록 뷰 컨트롤 (왼쪽에서 오른쪽)에 있는 열의 인덱스 값을 포함 하는 버퍼에 대 한 포인터입니다. 버퍼는 목록 뷰 컨트롤에서 열의 총 수를 포함할 수 있는 크기 여야 합니다.

iCount
목록 뷰 컨트롤에서 열 수입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SetColumnOrderArray에 설명 된 대로 Windows SDK합니다.

예제

예를 참조 CListCtrl::GetColumnOrderArray합니다.

보고서 보기 또는 목록 보기에서 열 너비를 변경합니다.

BOOL SetColumnWidth(
    int nCol,  
    int cx);

매개 변수

nCol
너비 설정 하는 열의 인덱스입니다. 목록 보기에서이 매개 변수는 0 이어야 합니다.

cx
열의 새 너비입니다. 일 수 있습니다 LVSCW_AUTOSIZE 또는 LVSCW_AUTOSIZE_USEHEADER에 설명 된 대로 LVM_SETCOLUMNWIDTH 에 Windows SDK합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

목록 뷰 컨트롤의 현재 확장된 스타일을 설정합니다.

DWORD SetExtendedStyle(DWORD dwNewStyle);

매개 변수

dwNewStyle
List view 컨트롤에서 사용할 확장된 스타일의 조합입니다. 이러한 스타일의 설명이 포함 된 목록에 대 한 참조는 확장 목록 뷰 스타일 항목에는 Windows SDK합니다.

반환 값

List view 컨트롤에서 사용 하는 이전 확장된 스타일의 조합입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SetExtendedListViewStyle에 설명 된 대로 Windows SDK합니다.

예제

	// Allow the header controls item to be movable by the user.
	m_myListCtrl.SetExtendedStyle
		(m_myListCtrl.GetExtendedStyle()|LVS_EX_HEADERDRAGDROP);

현재 목록 뷰 컨트롤의 지정된 된 그룹을 설명 하는 정보를 설정 합니다.

int SetGroupInfo(
    int iGroupId,  
    PLVGROUP pgrp);

매개 변수

iGroupId
해당 정보가 설정 되어 그룹의 식별자입니다.

pgrp
에 대 한 포인터는 LVGROUP 설정 하는 정보를 포함 하는 구조입니다. 호출자는이 구조를 할당 하 고 해당 멤버를 설정 해야 합니다.

반환 값

메서드가 성공 하면 그룹의 ID 그렇지 않으면-1입니다.

설명

이 메서드는 전송 된 LVM_SETGROUPINFO 에 설명 된 메시지는 Windows SDK합니다.

목록 뷰 컨트롤의 그룹 메트릭을 설정합니다.

void SetGroupMetrics(PLVGROUPMETRICS pGroupMetrics);

매개 변수

pGroupMetrics
에 대 한 포인터는 LVGROUPMETRICS 설정할 그룹 메트릭 정보를 포함 하는 구조입니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_SETGROUPMETRICS 에 설명 된 대로 메시지는 Windows SDK합니다.

목록 뷰 컨트롤에 대해 핫 트래킹을 때 사용 되는 커서를 설정 합니다.

HCURSOR SetHotCursor(HCURSOR hc);

매개 변수

hc가
핫 커서를 나타내는 데 사용 하 여 커서 리소스에 대 한 핸들입니다.

반환 값

List view 컨트롤에서 사용 하 고 이전 핫 커서 리소스에 대 한 핸들입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SetHotCursor에 설명 된 대로 Windows SDK합니다.

핫 커서 호버 선택을 사용 하는 경우에 표시 되는 모든 목록 보기 항목 위로 커서를 움직이면 나타납니다. 설정 하 여 호버 선택을 사용 하는지는 LVS_EX_TRACKSELECT 확장 스타일입니다.

예제

예를 참조 CListCtrl::GetHotCursor합니다.

목록 뷰 컨트롤의 현재 활성 항목을 설정합니다.

int SetHotItem(int iIndex);

매개 변수

iIndex
활성 항목으로 설정할 항목의 0부터 시작 인덱스입니다.

반환 값

이전에 핫 항목의 0부터 시작 하는 인덱스입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SetHotItem에 설명 된 대로 Windows SDK합니다.

예제

예를 참조 CListCtrl::GetHotItem합니다.

목록 뷰 컨트롤의 현재 호버 시간을 설정합니다.

DWORD SetHoverTime(DWORD dwHoverTime = (DWORD)-1);

매개 변수

dwHoverTime
이 선택 되기 전에 마우스 커서를 항목 위로 해야 밀리초 새 지연입니다. 기본 값이 전달 되 면 시간 기본 호버 시간으로 설정 됩니다.

반환 값

이전 호버 시간 (밀리초)입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SetHoverTime에 설명 된 대로 Windows SDK합니다.

예제

예를 참조 CListCtrl::GetHoverTime합니다.

목록 뷰 컨트롤의 아이콘 사이의 간격을 설정 합니다.

CSize SetIconSpacing(
    int cx,  
    int cy);  
  
CSize SetIconSpacing(CSize size);

매개 변수

cx
거리 (픽셀 단위)는 x 축에 아이콘 사이입니다.

cy
거리 (픽셀 단위) y 축에 아이콘 사이입니다.

size
A CSize 아이콘에 x 축과 y 사이의 거리 (픽셀 단위)를 지정 하는 개체입니다.

반환 값

A CSize 아이콘 간격에 대 한 이전 값을 포함 하는 개체입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SetIconSpacing에 설명 된 대로 Windows SDK합니다.

예제

	// Leave lots of space between icons.
	m_myListCtrl.SetIconSpacing(CSize(100, 100));

이미지 목록을 목록 뷰 컨트롤에 할당합니다.

CImageList* SetImageList(
    CImageList* pImageList,  
    int nImageListType);

매개 변수

pImageList
할당할 이미지 목록에 대 한 포인터입니다.

nImageListType
이미지 목록의 형식입니다. 다음이 값 중 하나일 수 있습니다.

  • LVSIL_NORMAL큰 아이콘으로 이미지 목록입니다.

  • LVSIL_SMALL작은 아이콘에 있는 이미지 목록입니다.

  • LVSIL_STATE상태 이미지와 이미지 목록입니다.

반환 값

이전 이미지 목록에 대 한 포인터입니다.

예제

예를 참조 CListCtrl::GetImageList합니다.

도구 설명 텍스트를 설정합니다.

BOOL SetInfoTip(PLVSETINFOTIP plvInfoTip);

매개 변수

plvInfoTip
에 대 한 포인터는 LVFSETINFOTIP 설정할 정보가 포함 된 구조입니다.

반환 값

반환 TRUE 성공 FALSE 실패 합니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_SETINFOTIP 에 설명 된 대로 메시지는 Windows SDK합니다.

정의 된 위치에 삽입 포인터를 설정합니다.

BOOL SetInsertMark(LPLVINSERTMARK lvim);

매개 변수

lvim
에 대 한 포인터는 LVINSERTMARK 삽입 포인터를 설정 하는 위치를 지정 하는 구조입니다.

반환 값

반환 TRUE 성공 하는 경우 또는 FALSE 그렇지 않은 경우. FALSE 경우 반환 됩니다의 크기는 cbSize 의 멤버는 LVINSERTMARK 구조는 구조와의 실제 크기와 일치 하지 않음을 또는 삽입점 때 현재 뷰에 적용 되지 않습니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_SETINSERTMARK 에 설명 된 대로 메시지는 Windows SDK합니다.

삽입 포인터의 색을 설정 합니다.

COLORREF SetInsertMarkColor(COLORREF color);

매개 변수

color
A COLORREF 삽입 포인터를 설정 하는 색을 지정 하는 구조입니다.

반환 값

반환 된 COLORREF 이전 색이 포함 된 구조입니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_SETINSERTMARKCOLOR 에 설명 된 대로 메시지는 Windows SDK합니다.

일부 또는 전체 목록 보기 항목의 특성을 설정합니다.

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);

매개 변수

pItem
주소에 LVITEM 에 설명 된 대로 새 항목을 포함 하는 구조 특성은 Windows SDK합니다. 구조체의 iItemiSubItem 항목 또는 하위 항목이 고 구조체의 멤버를 식별 마스크 멤버 특성 집합을 지정 합니다. 대 한 자세한 내용은 마스크 멤버 참조는 주의합니다.

nItem
설정 된 특성을 가진 항목의 인덱스입니다.

nSubItem
설정 된 특성을 가진 하위 항목의 인덱스입니다.

nMask
(주의 참조)을 설정할 수 있는 특성을 지정 합니다.

lpszItem
항목의 레이블을 지정 하는 null로 끝나는 문자열의 주소입니다.

nImage
이미지 목록 내에서 항목의 이미지의 인덱스입니다.

nState
변경할 (설명 부분 참조) 상태에 대 한 값을 지정 합니다.

nStateMask
(주의 참조)을 변경할 수 있는 상태 지정 합니다.

lParam
항목에 연결할 수는 32 비트 응용 프로그램 관련 값입니다.

nIndent
들여쓰기를 픽셀 단위로 너비입니다. 경우 nIndent 작으면 시스템에 정의 된 최소 너비 보다으로 새 너비는 시스템에 정의 된 최소로 설정 되어

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

iItemiSubItem 의 멤버는 LVITEM 구조 및 nItemnSubItem 항목과 하위 항목이 설정 된 특성을 가진 매개 변수를 식별 합니다.

마스크 의 멤버는 LVITEM 구조 및 nMask 어떤 항목을 지정 하는 매개 변수를 설정할 특성은:

  • LVIF_TEXTpszText 멤버 또는 lpszItem 매개 변수는 null로 끝나는 문자열의 주소 이며, cchTextMax 멤버가 무시 됩니다.

  • LVIF_STATEstateMask 멤버 또는 nStateMask 매개 변수를 변경 하는 항목 상태 지정 및 상태 멤버 또는 nState 매개 변수는 해당 상태에 대 한 값을 포함 합니다.

예제

예를 참조 CListCtrl::HitTest합니다.

많은 수의 항목을 추가 하는 데는 목록 뷰 컨트롤을 준비 합니다.

void SetItemCount(int nItems);

매개 변수

nItems
컨트롤은 궁극적으로 포함 하는 항목 수입니다.

설명

가상 목록 뷰 컨트롤에 대 한 항목 수를 설정 하려면 참조 CListCtrl::SetItemCountEx합니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SetItemCount에 설명 된 대로 Windows SDK합니다.

예제

		CString str;

		// Add 1024 items to the list view control.
		m_myListCtrl.SetItemCount(1024);

		for (int i = 0; i < 1024; i++)
		{
			str.Format(TEXT("item %d"), i);
			m_myListCtrl.InsertItem(i, str);
		}

가상 목록 뷰 컨트롤에 대 한 항목 수를 설정합니다.

BOOL SetItemCountEx(
    int iCount,  
    DWORD dwFlags = LVSICF_NOINVALIDATEALL);

매개 변수

iCount
컨트롤은 궁극적으로 포함 하는 항목 수입니다.

dwFlags
항목 수를 재설정 한 후 목록 뷰 컨트롤의 동작을 지정 합니다. 이 값은 다음의 조합 수 있습니다.

  • LVSICF_NOINVALIDATEALL 영향을 받는 항목 보기의 현재 없으면 목록 뷰 컨트롤에서이 그려집니다. 기본값입니다.

  • LVSICF_NOSCROLL 목록 뷰 컨트롤의 항목 수 변경 하는 경우 스크롤 위치를 변경 되지 것입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SetItemCountEx에 설명 된 대로 Windows SDK가상 목록 보기에만 호출 해야 합니다.

예제

		CString str;

		// Add 1024 items to the list view control.

		// Force my virtual list view control to allocate 
		// enough memory for my 1024 items.
		m_myVirtualListCtrl.SetItemCountEx(1024, LVSICF_NOSCROLL|
			LVSICF_NOINVALIDATEALL);

		for (int i = 0; i < 1024; i++)
		{
			str.Format(TEXT("item %d"), i);
			m_myVirtualListCtrl.InsertItem(i, str);
		}

지정 된 항목과 연결 된 32 비트 응용 프로그램 관련 값을 설정 nItem합니다.

BOOL SetItemData(int nItem, DWORD_PTR dwData);

매개 변수

nItem
해당 데이터를 설정할 목록 항목의 인덱스입니다.

dwData
항목에 연결할 수는 32 비트 값입니다.

반환 값

성공하면 0이 아니고, 그렇지 않으면 0입니다.

설명

이 값은는 lParam 의 멤버는 LVITEM 구조체에 설명 된 대로 Windows SDK합니다.

예제

	// Set the data of each item to be equal to its index.
	for (int i = 0; i < m_myListCtrl.GetItemCount(); i++)
	{
		m_myListCtrl.SetItemData(i, i);
	}

현재 목록 뷰 컨트롤에서 항목의 상태를 설정합니다.

BOOL SetItemIndexState(
    PLVITEMINDEX pItemIndex,   
    DWORD dwState,   
    DWORD dwMask) const;  

매개 변수

매개 변수설명
[in] pItemIndex에 대 한 포인터는 LVITEMINDEX 는 항목을 설명 하는 구조입니다. 호출자는이 구조를 할당 하 고 해당 멤버를 설정 해야 합니다.
[in] dwState해당 항목을 설정 하려면 상태의 비트 조합입니다 보기 항목 상태 목록합니다. 재설정 하는 0 또는 상태를 설정 하려면 하나를 지정 합니다.
[in] dwMask지정 된 상태로의 유효한 비트 마스크는 dwState 매개 변수입니다. 비트 조합 (OR)을 지정 보기 항목 상태 목록합니다.

반환 값

이 메서드가 성공적으로 수행되면 true이고, 그렇지 않으면 false입니다.

설명

에 대 한 자세한 내용은 dwState 매개 변수를 참조 하십시오 목록 보기 항목 상태합니다.

에 대 한 자세한 내용은 dwMask 매개 변수 참조는 stateMask 의 멤버는 LVITEM 구조입니다.

이 메서드는 전송 된 LVM_SETITEMINDEXSTATE 에 설명 된 메시지는 Windows SDK합니다.

목록 뷰 컨트롤의 지정된 된 위치에 항목을 이동합니다.

BOOL SetItemPosition(
    int nItem,  
    POINT pt);

매개 변수

nItem
해당 위치를 설정할 항목의 인덱스입니다.

pt
A 지점 항목의 왼쪽 위 모퉁이의 보기에서 새 위치를 지정 하는 구조를 조정 합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

컨트롤은 아이콘 또는 작은 아이콘 보기에 있어야 합니다.

목록 뷰 컨트롤에는 LVS_AUTOARRANGE 스타일 목록 보기 항목의 위치를 설정한 후에 정렬 됩니다.

예제

예를 참조 CListCtrl::GetItemPosition합니다.

목록 뷰 컨트롤에 있는 항목의 상태를 변경합니다.

BOOL SetItemState(
    int nItem,  
    LVITEM* pItem);

 
BOOL SetItemState(
    int nItem,  
    UINT nState,  
    UINT nMask);

매개 변수

nItem
상태가 설정할 항목의 인덱스입니다.

pItem
주소에 LVITEM 구조체에 설명 된 대로 Windows SDK합니다. 구조체의 stateMask 멤버는 상태 변경 및 구조체의 비트 지정 상태 멤버 이러한 비트에 대 한 새 값을 포함 합니다. 다른 멤버는 무시 됩니다.

nState
상태 비트에 대 한 새 값입니다. 가능한 값 목록은 참조 하십시오. CListCtrl::GetNextItemLVITEM 상태 멤버입니다.

nMask
상태를 변경 하려면 비트를 지정 하는 마스크입니다. 이 값의 stateMask 멤버에 해당 하는 LVITEM 구조입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

항목의 "상태"에 항목의 가용성을 지정 하 고, 사용자 작업을 나타내는 또는 그렇지 않으면 항목의 상태를 반영 하는 값입니다. 목록 뷰 컨트롤 사용자가 항목을 선택 하는 경우와 같은 일부 상태 비트를 변경 합니다. 응용 프로그램을 비활성화 하거나 해당 항목을 숨길 하거나 오버레이 이미지 또는 상태 이미지를 지정 하려면 다른 상태 비트를 변경할 수 있습니다.

예제

예를 참조 CListCtrl::GetTopIndex합니다.

목록 보기 항목 또는 하위 항목의 텍스트를 변경합니다.

BOOL SetItemText(
    int nItem,  
    int nSubItem,  
    LPCTSTR lpszText);

매개 변수

nItem
설정 되어야 하는 텍스트가 포함 된 항목의 인덱스입니다.

nSubItem
항목 레이블을 설정 하는 하위 항목이 또는 0의 인덱스입니다.

lpszText
새 항목의 텍스트를 포함 하는 문자열에 대 한 포인터입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 메서드는 아니며 LVS_OWNERDATA 창 스타일을 포함 하는 컨트롤과 (사실,이 인해 어설션에서의 디버그 빌드). 이 목록 컨트롤 스타일에 대 한 자세한 내용은 참조 목록 뷰 컨트롤 개요합니다.

예제

예를 참조 CListCtrl::InsertItem합니다.

목록 뷰 컨트롤의 테두리의 색을 설정 하는 경우는 LVS_EX_BORDERSELECT 확장된 창 스타일을 설정 합니다.

COLORREF SetOutlineColor(COLORREF color);

매개 변수

color
COLORREF 윤곽선 색을 포함 하는 구조입니다.

반환 값

이전 COLORREF 윤곽선 색을 포함 하는 구조

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_SETOUTLINECOLOR 에 설명 된 대로 메시지는 Windows SDK합니다.

목록 뷰 컨트롤의 선택된 된 열을 설정합니다.

LRESULT SetSelectedColumn(int iCol);

매개 변수

iCol
인덱스 열을 선택할 수입니다.

반환 값

반환 값은 사용 되지 않습니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_SETSELECTEDCOLUMN 에 설명 된 대로 메시지는 Windows SDK합니다.

목록 뷰 컨트롤의 선택 표시를 설정합니다.

int SetSelectionMark(int iIndex);

매개 변수

iIndex
여러 선택의 첫 번째 항목의 0부터 시작 하는 인덱스입니다.

반환 값

이전 선택 영역 표시 또는 선택 표시가 없으면 되었으면-1입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SetSelectionMark에 설명 된 대로 Windows SDK합니다.

예제

예를 참조 CListCtrl::GetSelectionMark합니다.

목록 뷰 컨트롤에서 텍스트의 배경색을 설정합니다.

BOOL SetTextBkColor(COLORREF cr);

매개 변수

cr
A COLORREF 새 텍스트 배경색을 지정 합니다. 내용은 COLORREF 에 Windows SDK합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

예제

		// Use the 3D button face color for the background.
		COLORREF crBkColor = ::GetSysColor(COLOR_3DFACE);
		m_myListCtrl.SetTextBkColor(crBkColor);
		ASSERT(m_myListCtrl.GetTextBkColor() == crBkColor);

목록 뷰 컨트롤의 텍스트 색을 설정합니다.

BOOL SetTextColor(COLORREF cr);

매개 변수

cr
A COLORREF 새 텍스트 색을 지정 합니다. 내용은 COLORREF 에 Windows SDK합니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

예제

	// Use the window text color for
	// the item text of the list view control.
	COLORREF crTextColor = ::GetSysColor(COLOR_WINDOWTEXT);
	m_myListCtrl.SetTextColor(crTextColor);
	ASSERT(m_myListCtrl.GetTextColor() == crTextColor);

목록 뷰 컨트롤의 타일에 대 한 정보를 설정합니다.

BOOL SetTileInfo(PLVTILEINFO pti);

매개 변수

pti
에 대 한 포인터는 LVTILEINFO 설정할 정보가 포함 된 구조입니다.

반환 값

반환 TRUE 성공 FALSE 실패 합니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_SETTILEINFO 에 설명 된 대로 메시지는 Windows SDK합니다.

Tile 보기에는 목록 뷰 컨트롤을 사용 하는 정보를 설정 합니다.

BOOL SetTileViewInfo(PLVTILEVIEWINFO ptvi);

매개 변수

ptvi
에 대 한 포인터는 LVTILEVIEWINFO 설정 하는 정보가 포함 된 구조입니다.

반환 값

반환 TRUE 성공 FALSE 실패 합니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_SETTILEVIEWINFO 에 설명 된 대로 메시지는 Windows SDK합니다.

List view 컨트롤에서 도구 설명을 표시 하려면 사용할 도구 설명 컨트롤을 설정 합니다.

CToolTipCtrl* SetToolTips(CToolTipCtrl* pWndTip);

매개 변수

pWndTip
에 대 한 포인터는 CToolTipCtrl 목록 컨트롤에서 사용할 개체입니다.

반환 값

에 대 한 포인터는 CToolTipCtrl 컨트롤에 의해 이전에 사용 되는 도구 설명이 포함 된 개체 또는 NULL 도구 설명 없음 이전에 사용 되는 경우.

설명

이 멤버 함수는 Win32 메시지의 동작을 구현 LVM_SETTOOLTIPS에 설명 된 대로 Windows SDK합니다.

도구 설명을 사용 하지 않도록를 나타내는 LVS_NOTOOLTIPS 스타일을 만들 때의 CListCtrl 개체입니다.

목록 뷰 컨트롤의 뷰를 설정합니다.

DWORD SetView(int iView);

매개 변수

iView
선택할 수는 보기입니다.

반환 값

그렇지 않으면-1 또는 1이 성공적으로 반환 합니다. 예를 들어 보기 올바르지 않으면-1이 반환 됩니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_SETVIEW 에 설명 된 대로 메시지는 Windows SDK합니다.

목록 뷰 컨트롤의 아이콘 표시 될 수 있는 영역을 설정 합니다.

void SetWorkAreas(
    int nWorkAreas,  
    LPRECT lpRect);

매개 변수

nWorkAreas
수가 RECT 구조 (또는 CRect 개체)로 가리키는 배열에 lpRect합니다.

lpRect
배열의 주소 RECT 구조 (또는 CRect 개체)의 목록 보기 컨트롤의 새 작업 영역을 지정 하는 합니다. 클라이언트 좌표에서 이러한 영역을 지정 해야 합니다. 이 매개 변수가 NULL, 작업 영역에서 컨트롤의 클라이언트 영역으로 설정 됩니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SetWorkAreas에 설명 된 대로 Windows SDK합니다.

예제

	// Remove all working areas.
	m_myListCtrl.SetWorkAreas(0, NULL);

List view 컨트롤 내의 ID로 그룹을 정렬 하는 응용 프로그램 정의 된 비교 함수를 사용 합니다.

BOOL SortGroups(
    PFNLVGROUPCOMPARE _pfnGroupCompare,  
    LPVOID _plv);

매개 변수

_pfnGroupCompare
그룹 비교 함수에 대 한 포인터입니다.

_plv
Void 포인터입니다.

반환 값

성공하면 true를 반환하고 실패하면 false를 반환합니다.

설명

기능을 에뮬레이션 하는이 멤버 함수는 LVM_SORTGROUPS 에 설명 된 대로 메시지는 Windows SDK합니다.

응용 프로그램 정의 된 비교 함수를 사용 하 여 목록 보기 항목을 정렬 합니다.

BOOL SortItems(
    PFNLVCOMPARE pfnCompare,  
    DWORD_PTR dwData);

매개 변수

[in] pfnCompare
응용 프로그램 정의 비교 함수의 주소입니다.

정렬 작업을 두 개의 목록 항목의 상대 순서를 지정 해야 할 때마다 비교 함수를 호출 합니다. 비교 함수는 클래스의 정적 멤버 이거나 모든 클래스의 멤버가 되지 않는 독립 실행형 함수 여야 합니다.

[in] dwData
비교 함수에 전달 되는 응용 프로그램 정의 값입니다.

반환 값

true경우 성공 메서드 그렇지 않으면 false합니다.

설명

이 메서드는 새 값으로 각 항목의 인덱스를 변경 합니다.

비교 함수 pfnCompare, 형식은 다음과 같습니다.

int CALLBACK CompareFunc(LPARAM lParam1,
    LPARAM lParam2,
    LPARAM lParamSort);

비교 함수는 첫 번째 항목 두 번째 앞에 야 하는 경우 음수 값을 반환 해야, 경우에는 0 또는 두 번째, 첫 번째 항목을 따르면 양수 값을 두 항목이 같으면 있습니다.

lParam1 매개 변수는 32 비트 값을 비교 하는 첫 번째 항목에 연결 된 고 lParam2 매개 변수는 두 번째 항목에 연결 된 값입니다. 에 지정 된 값은는 lParam 항목의 소속 LVITEM 목록에 삽입 한 구조입니다. lParamSort 매개 변수는 동일는 dwData 값입니다.

이 메서드는 전송 된 LVM_SORTITEMS 에 설명 된 메시지는 Windows SDK합니다.

예제

다음은 항목이로 정렬 하는 간단한 비교 함수는 lParam 값입니다.

// Sort items by associated lParam
int CALLBACK CListCtrlDlg::MyCompareProc(LPARAM lParam1, LPARAM lParam2, 
	LPARAM lParamSort)
{
	UNREFERENCED_PARAMETER(lParamSort);

	return (int)(lParam1 - lParam2);
}

// Sort the items by passing in the comparison function.
void CListCtrlDlg::Sort()
{
	m_myListCtrl.SortItems(&CListCtrlDlg::MyCompareProc, 0);
}

응용 프로그램 정의 된 비교 함수를 사용 하 여 현재 목록 뷰 컨트롤의 항목을 정렬 합니다.

BOOL SortItemsEx(
    PFNLVCOMPARE pfnCompare,   
    DWORD_PTR dwData);

매개 변수

매개 변수설명
[in] pfnCompare응용 프로그램 정의 비교 함수의 주소입니다.

정렬 작업을 두 개의 목록 항목의 상대 순서를 지정 해야 할 때마다 비교 함수를 호출 합니다. 비교 함수는 클래스의 정적 멤버 이거나 모든 클래스의 멤버가 되지 않는 독립 실행형 함수 여야 합니다.
[in] dwData응용 프로그램 정의 값 비교 함수에 전달 합니다.

반환 값

이 메서드가 성공적으로 수행되면 true이고, 그렇지 않으면 false입니다.

설명

이 메서드는 새 값으로 각 항목의 인덱스를 변경 합니다.

비교 함수 pfnCompare, 형식은 다음과 같습니다.

int CALLBACK CompareFunc(LPARAM lParam1,
    LPARAM lParam2,
    LPARAM lParamSort);

이 메시지는 같은 LVM_SORTITEMS, 비교 함수에 전달 된 정보 유형을 제외 하 고 있습니다. LVM_SORTITEMS, lParam1lParam2 비교할 항목의 값입니다. LVM_SORTITEMSEX, lParam1 비교할 첫 번째 항목의 현재 인덱스 및 lParam2 는 두 번째 항목의 현재 인덱스입니다. 보낼 수는 LVM_GETITEMTEXT 메시지 항목에 대 한 자세한 정보를 검색 합니다.

비교 함수는 첫 번째 항목 두 번째 앞에 야 하는 경우 음수 값을 반환 해야, 경우에는 0 또는 두 번째, 첫 번째 항목을 따르면 양수 값을 두 항목이 같으면 있습니다.

System_CAPS_ICON_note.jpg 참고

정렬 과정에서 목록 뷰 내용이 안정화 되지 않습니다. 콜백 함수 목록 뷰 컨트롤에 이외의 다른 모든 메시지를 보내는 경우 LVM_GETITEM, 결과 예측할 수 없습니다.

이 메서드는 전송 된 LVM_SORTITEMSEX 에 설명 된 메시지는 Windows SDK합니다.

예제

변수를 정의 하는 다음 코드 예제에서는 m_listCtrl, 즉 현재 목록 뷰 컨트롤에 액세스 하는 데 사용 합니다. 이 변수는 다음 예제에서 사용됩니다.

public:
	// Variable used to access the list control.
	CListCtrl m_listCtrl; 

예제

다음 코드 예제는 SortItemEx 메서드. 이 코드 예제에서는 이전 단원에서 "ClientID" 및 "등급"이 보고서 뷰에서 라는 두 개의 열을 표시 하는 목록 뷰 컨트롤을 만들었습니다. 다음 코드 예제에서는 "등급"이 열에 값을 사용 하 여 테이블을 정렬 합니다.

// The ListCompareFunc() method is a global function used by SortItemEx().
int CALLBACK ListCompareFunc(
							 LPARAM lParam1, 
							 LPARAM lParam2, 
							 LPARAM lParamSort)
{
	CListCtrl* pListCtrl = (CListCtrl*) lParamSort;
	CString    strItem1 = pListCtrl->GetItemText(static_cast<int>(lParam1), 1);
	CString    strItem2 = pListCtrl->GetItemText(static_cast<int>(lParam2), 1);

	int x1 = _tstoi(strItem1.GetBuffer());
	int x2 = _tstoi(strItem2.GetBuffer());
	int result = 0;
	if ((x1 - x2) < 0)
		result = -1;
	else if ((x1 - x2) == 0)
		result = 0;
	else
		result = 1;

	return result;
}

void CCListCtrl_s2Dlg::OnBnClickedButton1()
{
	// SortItemsEx
	m_listCtrl.SortItemsEx( ListCompareFunc, (LPARAM)&m_listCtrl );
}

지정된 된 위치에 있는 경우 목록 보기 항목을 결정 합니다.

int SubItemHitTest(LPLVHITTESTINFO pInfo);

매개 변수

pInfo
에 대 한 포인터는 LVHITTESTINFO 구조입니다.

반환 값

항목 또는 하위 항목, 테스트할 (있는 경우), 그렇지 않으면-1의 1부터 시작 인덱스입니다.

설명

이 멤버 함수는 Win32 매크로의 동작을 구현 ListView_SubItemHitTest에 설명 된 대로 Windows SDK합니다.

예제

void CListCtrlDlg::OnDblClk(NMHDR* pNMHDR, LRESULT* pResult)
{
	UNREFERENCED_PARAMETER(pResult);

	LPNMITEMACTIVATE pia = (LPNMITEMACTIVATE)pNMHDR;
	LVHITTESTINFO lvhti;

	// Clear the subitem text the user clicked on.
	lvhti.pt = pia->ptAction;
	m_myListCtrl.SubItemHitTest(&lvhti);

	if (lvhti.flags & LVHT_ONITEMLABEL)
	{
		m_myListCtrl.SetItemText(lvhti.iItem, lvhti.iSubItem, NULL);
	}
}

목록 뷰 컨트롤에 지정 된 항목 자동으로 그려지도록 강제 nItem합니다.

BOOL Update(int nItem);

매개 변수

nItem
업데이트할 항목의 인덱스입니다.

반환 값

성공하는 경우 0이 아니고, 그렇지 않으면 0입니다.

설명

이 함수는 또한 목록 뷰 컨트롤을 정렬 올바르게 구성 되었으면는 LVS_AUTOARRANGE 스타일입니다.

예제

예를 참조 CListCtrl::GetSelectedCount합니다.

MFC 샘플 ROWLIST
CWnd 클래스
계층 구조 차트
CImageList 클래스

표시: