ListView.View 속성

정의

컨트롤에서 항목의 표시 방법을 가져오거나 설정합니다.Gets or sets how items are displayed in the control.

public:
 property System::Windows::Forms::View View { System::Windows::Forms::View get(); void set(System::Windows::Forms::View value); };
public System.Windows.Forms.View View { get; set; }
member this.View : System.Windows.Forms.View with get, set
Public Property View As View

속성 값

View

View 값 중 하나입니다.One of the View values. 기본값은 LargeIcon입니다.The default is LargeIcon.

예외

지정된 값이 View 값 중 하나가 아닌 경우The value specified is not one of the View values.

예제

다음 코드 예제를 ListView 3 개를 사용 하 여 컨트롤 ListViewItem 지정 된 개체 및 3 ListViewItem.ListViewSubItem 각 항목에 대해 지정 된 개체입니다.The following code example creates a ListView control with three ListViewItem objects specified and three ListViewItem.ListViewSubItem objects specified for each item. 예제에서는 ColumnHeader 하위 항목 세부 정보 보기에 표시할 개체입니다.The example also creates ColumnHeader objects to display the subitems in details view. 두 개의 ImageList 이미지를 제공 하 여 코드 예제의 만들어집니다 개체는 ListViewItem 개체입니다.Two ImageList objects are also created in the code example to provide images for the ListViewItem objects. 이러한 ImageList 개체에 추가 되는 LargeImageListSmallImageList 속성입니다.These ImageList objects are added to the LargeImageList and SmallImageList properties. 이 예제에서는 컨트롤을 만들 때 다음 속성을 사용 합니다 ListView .The example uses the following properties in creating the ListView control.

이 예제 코드를 추가 하려면를 Form 폼에서 다른 메서드나 생성자의 예제에서 만든 메서드를 호출 합니다.This example requires that you have added the code to a Form and call the method created in the example from the constructor or another method on the form. 이 예제에서는 명명 된 이미지도 필요 MySmallImage1, MySmallImage2MyLargeImage1, 및 MyLargeImage2 C 드라이브의 루트 디렉터리에 있는The example also requires that images named MySmallImage1, MySmallImage2, MyLargeImage1, and MyLargeImage2 are located in the root directory of drive C.

private:
   void CreateMyListView()
   {
      // Create a new ListView control.
      ListView^ listView1 = gcnew ListView;
      listView1->Bounds = Rectangle(Point(10,10),System::Drawing::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 = gcnew 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 = gcnew ListViewItem( "item2",1 );
      item2->SubItems->Add( "4" );
      item2->SubItems->Add( "5" );
      item2->SubItems->Add( "6" );
      ListViewItem^ item3 = gcnew 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.
      // Width of -2 indicates auto-size.
      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.
      array<ListViewItem^>^temp1 = {item1,item2,item3};
      listView1->Items->AddRange( temp1 );

      // Create two ImageList objects.
      ImageList^ imageListSmall = gcnew ImageList;
      ImageList^ imageListLarge = gcnew 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.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.
    // Width of -2 indicates auto-size.
    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 Sub CreateMyListView()
    ' Create a new ListView control.
    Dim listView1 As 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.
    Dim item1 As 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")
    Dim item2 As New ListViewItem("item2", 1)
    item2.SubItems.Add("4")
    item2.SubItems.Add("5")
    item2.SubItems.Add("6")
    Dim item3 As 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.
    ' Width of -2 indicates auto-size.
    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.
    Dim imageListSmall As New ImageList()
    Dim imageListLarge As 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.
    Me.Controls.Add(listView1)
End Sub

설명

속성을 사용 하면 View ListView 컨트롤에서 항목을 표시 하는 데 사용 하는 표시 형식을 지정할 수 있습니다.The View property allows you to specify the type of display the ListView control uses to display items. 속성을 설정 View 하 여 각 항목을 크거나 작은 아이콘으로 표시 하거나 항목을 세로 목록으로 표시할 수 있습니다.You can set the View property to display each item with large or small icons or display items in a vertical list. 가장 다양 한 옵션은 항목 뿐만 아니라 각 항목에 대해 지정 된 하위 항목을 볼 수 있는 자세히 보기입니다.The richest option is the details view, which allows you to view not only the items but any subitems specified for each item. 각 항목은 표에 표시 되 고 각 항목은 세로로 나열 되며 열에는 각 항목에 대 한 하위 항목 (열 머리글 포함)이 표시 됩니다.Each item is displayed in a grid, with each item listed vertically and the subitems for each item displayed in a column, with column headers. 자세히 보기는 사용자에 게 데이터베이스 정보를 표시 하는 완벽 한 방법입니다.The details view is a perfect way to display database information to a user. Windows XP 및 Windows Server 2003를 사용 하면 선택한 하위 항목 정보와 함께 큰 아이콘을 표시 하 여 그래픽 및 텍스트 정보를 조정 하는 타일로 항목을 표시할 수도 있습니다.With Windows XP and Windows Server 2003, you can also display items as tiles that balance graphical and textual information by showing a large icon along with subitem information of your choosing. 타일 보기를 사용 하려면 애플리케이션 호출 해야 합니다는 Application.EnableVisualStyles 메서드.To enable tile view, your application must call the Application.EnableVisualStyles method. 작은 이미지 뷰는 아이콘 및 텍스트 정보가 있는 각 항목을 아이콘 오른쪽에 표시 합니다.The small-image view displays each item with an icon and textual information to the right of the icon. 크게 이미지 뷰는 아이콘 및 텍스트 정보가 있는 각 항목을 아이콘 아래에 표시 합니다.The large-image view displays each item with an icon and textual information below the icon. 이미지 목록에 대 한 아이콘의 크기는 ImageSize ImageList 또는 속성에 대 한의 속성에 의해 지정 됩니다 SmallImageList LargeImageList .The size of the icons for the image list is specified by the ImageSize property of the ImageList for the SmallImageList or LargeImageList properties.

참고

컨트롤을 사용 하 여 작고 작은 아이콘 보기에 여러 이미지 목록을 사용 하는 경우 이미지 ListView 의 작은 버전과 많은 버전을 해당 이미지 목록의 동일한 인덱스 위치에 배치 해야 합니다.If you are using multiple image lists, for small and large icon view, with a ListView control, you should place small and large versions of the image at the same index location in their respective image lists. 보기 간을 전환할 때 지정 된 키 값에 관계 없이 한 목록에 있는 이미지의 인덱스 위치를 사용 하 여 다른 목록의 이미지를 찾습니다.When switching between views, the index location of the image in one list is used to locate the image in the other list, regardless of the key value specified.

컨트롤의 대부분의 속성은 ListView 여러 뷰가 동작 하거나 표시 되는 방식에 영향을 줍니다.Most of the properties in the ListView control affect how the different views behave or are displayed. 항목의 뷰에 영향을 주는 일부 속성은 속성이 특정 값으로 설정 된 경우에만 유용 하지만 다른 속성은 View 모든 뷰에서 유용 합니다.Some properties that affect the views of the items are only useful when the View property is set to a specific value, while others are useful in all views. 예를 들어 및와 같은 속성은 GridLines FullRowSelect 속성이로 설정 된 경우에만 유용 하지만 View View.Details MultiSelect 및 속성은 CheckBoxes 모든 뷰에서 유용 합니다.For example, properties such as GridLines and FullRowSelect are only useful when the View property is set to View.Details, while the MultiSelect and CheckBoxes properties are useful in all views.

다음 표에서는 일부 ListView 멤버와 이러한 멤버가 유효한 뷰를 보여 줍니다.The following table shows some of the ListView members and the views they are valid in.

ListView 멤버ListView member ViewView
Alignment 속성Alignment property SmallIcon 또는 LargeIconSmallIcon or LargeIcon
AutoArrange 속성AutoArrange property SmallIcon 또는 LargeIconSmallIcon or LargeIcon
AutoResizeColumn 메서드AutoResizeColumn method Details
CheckBoxes 다음을 제외한 모든 뷰 TileAll views except Tile
Columns 속성Columns property Details 또는 TileDetails or Tile
DrawSubItem 이벤트DrawSubItem event Details
FindItemWithText 메서드FindItemWithText method Details, List또는 TileDetails, List, or Tile
FindNearestItem 메서드FindNearestItem method SmallIcon 또는 LargeIconSmallIcon or LargeIcon
GetItemAt 메서드GetItemAt method Details 또는 TileDetails or Tile
Groups 속성Groups property 다음을 제외한 모든 뷰 ListAll views except List
HeaderStyle 속성HeaderStyle property Details
InsertionMark 속성InsertionMark property LargeIcon, SmallIcon또는 TileLargeIcon, SmallIcon, or Tile

사용할 수는 View 다른 애플리케이션에서 데이터 뷰를 제공 하거나 해당 보기의 혜택을 활용 하려면 특정 보기를 잠글 수 속성입니다.You can use the View property to provide different views of data in your application, or to lock a specific view to utilize that view's benefits. 예를 들어 View View.Details 자세히 보기에서는 다른 보기에서 사용할 수 없는 여러 가지 보기 옵션을 제공 하기 때문에 속성이로 설정 되는 경우가 많습니다.For example, the View property is often set to View.Details because the details view provides a number of viewing options not available in the other views.

참고

컨트롤에 ListView 지정 된 열 머리글이 없고 속성을로 설정 하는 경우 View View.Details ListView 컨트롤에 항목이 표시 되지 않습니다.If your ListView control does not have any column headers specified and you set the View property to View.Details, the ListView control will not display any items. 컨트롤에 ListView 지정 된 열 머리글이 없고 속성을로 설정 하는 경우 View View.Tile ListView 컨트롤은 하위 항목을 표시 하지 않습니다.If your ListView control does not have any column headers specified and you set the View property to View.Tile, the ListView control will not display any subitems.

바둑판식으로 표시 된 각 항목은 왼쪽에는 크고 오른쪽에는 텍스트 정보가 표시 됩니다.The tile view displays each item with a large icon on the left and textual information on the right. 텍스트 정보는 항목 레이블과 하위 항목 순으로 구성 됩니다.The textual information consists of the item label followed by subitems. 기본적으로 항목 레이블에 해당 하는 첫 번째 하위 항목만 표시 됩니다.By default, only the first subitem is displayed, which corresponds to the item label. 추가 하위 항목을 표시 하려면 개체를 ColumnHeader 컬렉션에 추가 해야 합니다 Columns .To display additional subitems, you must add ColumnHeader objects to the Columns collection. 타일의 각 하위 항목은 열 머리글에 해당 합니다.Each subitem in the tile corresponds to a column header. 표시 되는 하위 항목과 표시 되는 순서를 제어 하려면 각 ListViewItem.ListViewSubItem.Name 항목에 대해 속성을 설정 하 고 ColumnHeader.Name 각 헤더에 대 한 속성을 설정 해야 합니다.To control which subitems are displayed and the order in which they are displayed, you must set the ListViewItem.ListViewSubItem.Name property for each item and the ColumnHeader.Name property for each header. 그런 다음 컬렉션에서 헤더를 추가, 제거 및 다시 정렬 Columns 하 여 원하는 결과를 얻을 수 있습니다.You can then add, remove, and rearrange headers in the Columns collection to achieve the desired result.

타일 보기에서 타일의 크기를 제어 하려면 속성을 설정 TileSize 합니다.To control the size of the tiles in the tile view, set the TileSize property. 이 기능은 하위 항목 텍스트가 한 줄에 비해 너무 긴 경우 줄 바꿈을 방지 하는 데 유용 합니다.This is useful to prevent line-wrapping when subitem text is too long for a single line.

Tile 보기의 예제는 속성을 참조 하세요 TileSize .For an example of the tile view, see the TileSize property.

참고

열은 자세히 보기에만 표시 되지만 열 머리글이 없는 하위 항목은 자세히 보기 또는 타일 보기에 표시 되지 않습니다.Although columns are only displayed in the details view, subitems without column headers will not display in either the details view or the tile view.

바둑판식 뷰는 애플리케이션에서 호출 하는 경우 Windows XP 및 Windows Server 2003에만 사용할 수는 Application.EnableVisualStyles 메서드.The tile view is available only on Windows XP and Windows Server 2003 when your application calls the Application.EnableVisualStyles method. 이전 운영 체제에서는 바둑판식 뷰와 관련 된 모든 코드가 영향을 받지 않고 ListView 컨트롤이 커다란 아이콘 보기에 표시 됩니다.On earlier operating systems, any code related to the tile view has no effect, and the ListView control displays in the large icon view. 따라서 tile 보기에 의존 하는 모든 코드가 제대로 작동 하지 않을 수 있습니다.As a result, any code that depends on the tile view might not work correctly.

타일 보기를 사용할 수 있는지 여부를 결정 하는 코드를 포함 하 고 사용할 수 없는 경우 대체 기능을 제공할 수 있습니다.You might want to include code that determines whether tile view is available, and provide alternate functionality when it is unavailable. 예를 들어, 소유자 그리기를 사용 하 여 타일 보기에서 항목의 모양을 사용자 지정 하는 경우, ListView 타일 보기를 지원 하지 않는 운영 체제에서 실행 하는 경우에는 크게 아이콘 보기에 적합 한 그리기 코드를 사용 하는 것이 좋습니다.For example, when you use owner drawing to customize the appearance of ListView items in the tile view, you might want to use drawing code appropriate to the large icon view when running on operating systems that do not support the tile view.

타일 보기 기능은 운영 체제 테마 기능을 제공 하는 동일한 라이브러리에서 제공 됩니다.The tile view feature is provided by the same library that provides the operating system themes feature. 이 라이브러리의 가용성을 확인 하려면 호출을 FeatureSupport.IsPresent(Object) 메서드 오버 로드 하 고 전달 합니다 OSFeature.Themes 값입니다.To check for the availability of this library, call the FeatureSupport.IsPresent(Object) method overload and pass in the OSFeature.Themes value.

적용 대상

추가 정보