이 설명서는 보관되지만 유지 되지 않습니다.

ListView.CheckBoxes 속성

업데이트: 2007년 11월

컨트롤에 있는 각 항목 옆에 확인란을 표시할지 여부를 나타내는 값을 가져오거나 설정합니다.

네임스페이스:  System.Windows.Forms
어셈블리:  System.Windows.Forms(System.Windows.Forms.dll)

public bool CheckBoxes { get; set; }
/** @property */
public boolean get_CheckBoxes()
/** @property */
public  void set_CheckBoxes(boolean value)

public function get CheckBoxes () : boolean
public function set CheckBoxes (value : boolean)

속성 값

형식: System.Boolean

ListView 컨트롤의 각 항목 옆에 확인란이 있으면 true이고, 그렇지 않으면 false입니다. 기본값은 false입니다.

CheckBoxes 속성을 사용하면 목록에 있는 각 항목 옆에 확인란을 표시할 수 있습니다. 이렇게 하면 응용 프로그램에서 확인란을 클릭하여 선택할 수 있도록 항목 및 하위 항목(View 속성이 View.Details로 설정되어 있는 경우) 목록을 표시할 수 있습니다. CheckBoxes 속성을 사용하면 Ctrl 키를 사용하지 않고도 ListView 컨트롤에서 여러 항목을 선택할 수 있습니다. 응용 프로그램에 따라 표준적인 다중 선택 방법보다 확인란을 사용하여 항목을 선택하는 방법이 더 편리할 수 있습니다. ListView 컨트롤의 MultiSelect 속성이 false로 설정된 경우에도 확인란을 표시할 수 있으며 다중 선택 기능을 제공할 수 있습니다. 이 기능은 응용 프로그램에서 여러 항목을 선택할 수 없게 하면서도 목록에서 여러 항목을 선택하여 작업을 수행할 수 있게 할 경우 유용합니다.

항목의 확인란이 선택되었는지 결정하려면 ItemCheck 이벤트에 대한 이벤트 처리기를 만듭니다. ListView에서 확인란이 선택된 모든 항목을 가져오려면 CheckedItems 속성을 사용하여 컨트롤의 ListView.CheckedIndexCollection에 액세스합니다. ListView에서 확인란이 선택된 모든 항목의 인덱스를 가져오려면 CheckedIndices 속성을 사용합니다.

StateImageList 속성에 ImageList가 지정되어 있으면 ImageList에서 인덱스가 0과 1인 이미지가 확인란 대신 표시됩니다. 인덱스 0 위치에 있는 이미지는 선택되지 않은 확인란 대신 표시되며 인덱스 1 위치에 있는 이미지는 선택한 확인란 대신 표시됩니다.

참고:

이 속성을 true로 설정하면 ItemCheck 이벤트가 발생합니다.

View 속성이 Tile로 설정되어 있으면 확인란이 표시되지 않습니다.

다음 코드 예제에서는 각 항목에 대해 세 개의 ListViewItem 개체 및 세 개의 ListViewItem.ListViewSubItem 개체가 지정되어 있는 ListView 컨트롤을 만듭니다. 이 예제에서는 자세히 보기에 하위 항목도 표시하는 ColumnHeader 개체도 만듭니다. ImageList 개체도 코드 예제에 만들어져 ListViewItem 개체에 이미지를 제공합니다. 이런 ImageList 개체는 LargeImageListSmallImageList 속성에 추가됩니다. 이 예제에서는 다음과 같은 속성을 사용하여 ListView 컨트롤을 만듭니다.

이 예제를 실행하려면 코드를 Form에 추가하고 폼의 생성자나 다른 메서드로부터 예제에서 만든 메서드를 호출한 상태여야 합니다. 또한 MySmallImage1, MySmallImage2, MyLargeImage1MyLargeImage2라는 이미지가 C 드라이브의 루트 디렉터리에 있어야 합니다.

		private void CreateMyListView()
		{
			// Create a new ListView control.
			ListView listView1 = new ListView();
			listView1.Bounds = new Rectangle(new Point(10,10), new Size(300,200));

			// Set the view to show details.
			listView1.View = View.Details;
			// Allow the user to edit item text.
			listView1.LabelEdit = true;
			// Allow the user to rearrange columns.
			listView1.AllowColumnReorder = true;
			// Display check boxes.
			listView1.CheckBoxes = true;
			// Select the item and subitems when selection is made.
			listView1.FullRowSelect = true;
			// Display grid lines.
			listView1.GridLines = true;
			// Sort the items in the list in ascending order.
			listView1.Sorting = SortOrder.Ascending;
            			
			// Create three items and three sets of subitems for each item.
			ListViewItem item1 = new ListViewItem("item1",0);
			// Place a check mark next to the item.
			item1.Checked = true;
			item1.SubItems.Add("1");
			item1.SubItems.Add("2");
			item1.SubItems.Add("3");
			ListViewItem item2 = new ListViewItem("item2",1);
			item2.SubItems.Add("4");
			item2.SubItems.Add("5");
			item2.SubItems.Add("6");
			ListViewItem item3 = new ListViewItem("item3",0);
			// Place a check mark next to the item.
			item3.Checked = true;
			item3.SubItems.Add("7");
			item3.SubItems.Add("8");
			item3.SubItems.Add("9");

			// Create columns for the items and subitems.
			listView1.Columns.Add("Item Column", -2, HorizontalAlignment.Left);
			listView1.Columns.Add("Column 2", -2, HorizontalAlignment.Left);
			listView1.Columns.Add("Column 3", -2, HorizontalAlignment.Left);
			listView1.Columns.Add("Column 4", -2, HorizontalAlignment.Center);

			//Add the items to the ListView.
            		listView1.Items.AddRange(new ListViewItem[]{item1,item2,item3});

			// Create two ImageList objects.
			ImageList imageListSmall = new ImageList();
			ImageList imageListLarge = new ImageList();

			// Initialize the ImageList objects with bitmaps.
			imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage1.bmp"));
			imageListSmall.Images.Add(Bitmap.FromFile("C:\\MySmallImage2.bmp"));
			imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage1.bmp"));
			imageListLarge.Images.Add(Bitmap.FromFile("C:\\MyLargeImage2.bmp"));

			//Assign the ImageList objects to the ListView.
			listView1.LargeImageList = imageListLarge;
			listView1.SmallImageList = imageListSmall;

			// Add the ListView to the control collection.
			this.Controls.Add(listView1);
		}


private void CreateMyListView()
{
    // Create a new ListView control.
    ListView listView1 = new ListView();
    listView1.set_Bounds(new Rectangle(new Point(10, 10), 
        new Size(300, 200)));

    // Set the view to show details.
    listView1.set_View(View.Details);

    // Allow the user to edit item text.
    listView1.set_LabelEdit(true);

    // Allow the user to rearrange columns.
    listView1.set_AllowColumnReorder(true);

    // Display check boxes.
    listView1.set_CheckBoxes(true);

    // Select the item and subitems when selection is made.
    listView1.set_FullRowSelect(true);

    // Display grid lines.
    listView1.set_GridLines(true);

    // Sort the items in the list in ascending order.
    listView1.set_Sorting(SortOrder.Ascending);

    // Create three items and three sets of subitems for each item.
    ListViewItem item1 = new ListViewItem("item1", 0);

    // Place a check mark next to the item.
    item1.set_Checked(true);

    item1.get_SubItems().Add("1");
    item1.get_SubItems().Add("2");
    item1.get_SubItems().Add("3");

    ListViewItem item2 = new ListViewItem("item2", 1);
    item2.get_SubItems().Add("4");
    item2.get_SubItems().Add("5");
    item2.get_SubItems().Add("6");

    ListViewItem item3 = new ListViewItem("item3", 0);

    // Place a check mark next to the item.
    item3.set_Checked(true);

    item3.get_SubItems().Add("7");
    item3.get_SubItems().Add("8");
    item3.get_SubItems().Add("9");

    // Create columns for the items and subitems.
    listView1.get_Columns().Add("Item Column", -2, 
        HorizontalAlignment.Left);
    listView1.get_Columns().Add("Column 2", -2, HorizontalAlignment.Left);
    listView1.get_Columns().Add("Column 3", -2, HorizontalAlignment.Left);
    listView1.get_Columns().Add("Column 4", -2, HorizontalAlignment.Center);

    //Add the items to the ListView.
    listView1.get_Items().AddRange(new ListViewItem[] { item1, item2, 
        item3 });

    // Create two ImageList objects.
    ImageList imageListSmall = new ImageList();
    ImageList imageListLarge = new ImageList();

    // Initialize the ImageList objects with bitmaps.
    imageListSmall.get_Images().Add(Bitmap.FromFile(
        "C:\\MySmallImage1.bmp"));
    imageListSmall.get_Images().Add(Bitmap.FromFile(
        "C:\\MySmallImage2.bmp"));
    imageListLarge.get_Images().Add(Bitmap.FromFile(
        "C:\\MyLargeImage1.bmp"));
    imageListLarge.get_Images().Add(Bitmap.FromFile(
        "C:\\MyLargeImage2.bmp"));

    //Assign the ImageList objects to the ListView.
    listView1.set_LargeImageList(imageListLarge);
    listView1.set_SmallImageList(imageListSmall);

    // Add the ListView to the control collection.
    this.get_Controls().Add(listView1);
} //CreateMyListView


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

.NET Framework

3.5, 3.0, 2.0, 1.1, 1.0에서 지원

.NET Compact Framework

3.5, 2.0, 1.0에서 지원
표시: