ListView.View Özellik

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Öğelerin denetimde nasıl görüntüleneceğini alır veya ayarlar.

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

Özellik Değeri

View

Değerlerden View biri. Varsayılan değer: LargeIcon.

Özel durumlar

InvalidEnumArgumentException

Belirtilen değer değerlerden biri View değil.

Örnekler

Aşağıdaki kod örneği, belirtilen üç ListViewItem nesne ve her öğe için üç ListViewItem.ListViewSubItem nesne belirtilen bir ListView denetim oluşturur. Örnek ayrıca alt öğeleri ayrıntılar görünümünde görüntülemek için nesneler oluşturur ColumnHeader . Ayrıca kod örneğinde nesneler için görüntü sağlamak üzere ListViewItem iki ImageList nesne oluşturulur. Bu ImageList nesneler ve SmallImageList özelliklerine LargeImageList eklenir. Örnek, denetimi oluştururken ListView aşağıdaki özellikleri kullanır.

Bu örnek için kodu bir Form öğesine eklemiş olmanız ve örnekte oluşturulan yöntemi oluşturucudan veya formdaki başka bir yöntemden çağırmanız gerekir. Örnek ayrıca , , MySmallImage2MyLargeImage1ve MyLargeImage2 adlı MySmallImage1görüntülerin C sürücüsünün kök dizininde yer almalarını gerektirir.

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

Açıklamalar

özelliği, View denetimin öğeleri görüntülemek için kullandığı görüntüleme ListView türünü belirtmenize olanak tanır. Özelliğini, her öğeyi View büyük veya küçük simgelerle ya da öğeleri dikey listede görüntüleyecek şekilde ayarlayabilirsiniz. En zengin seçenek, yalnızca öğeleri değil, her öğe için belirtilen alt öğeleri de görüntülemenizi sağlayan ayrıntılar görünümüdür. Her öğe bir kılavuzda görüntülenir; her öğe dikey olarak listelenir ve her öğenin alt öğeleri sütun başlıklarıyla birlikte bir sütunda görüntülenir. Ayrıntılar görünümü, kullanıcıya veritabanı bilgilerini görüntülemenin mükemmel bir yoludur. Windows XP ve Windows Server 2003 ile, büyük bir simge ve seçtiğiniz alt öğe bilgilerini göstererek öğeleri grafik ve metin bilgilerini dengeleyen kutucuklar olarak da görüntüleyebilirsiniz. Kutucuk görünümünü etkinleştirmek için uygulamanızın yöntemini çağırması Application.EnableVisualStyles gerekir. Küçük resim görünümü, her öğeyi bir simgeyle ve simgenin sağındaki metin bilgileriyle görüntüler. Büyük resim görünümü, her öğeyi simgenin altında bir simge ve metin bilgileriyle birlikte görüntüler. Görüntü listesinin simgelerinin boyutu, veya LargeImageList özellikleri için özelliğinin SmallImageList ImageList özelliği tarafından ImageSize belirtilir.

Not

Küçük ve büyük simge görünümü için bir denetimle ListView birden çok resim listesi kullanıyorsanız, görüntünün küçük ve büyük sürümlerini ilgili görüntü listelerinde aynı dizin konumuna yerleştirmeniz gerekir. Görünümler arasında geçiş yaparken, bir listedeki görüntünün dizin konumu, belirtilen anahtar değerinden bağımsız olarak diğer listedeki görüntüyü bulmak için kullanılır.

Denetimdeki ListView özelliklerin çoğu, farklı görünümlerin nasıl davrandığını veya görüntülendiğini etkiler. Öğelerin görünümlerini etkileyen bazı özellikler yalnızca özellik belirli bir değere ayarlandığında, View diğerleri ise tüm görünümlerde yararlıdır. Örneğin ve gibi GridLines FullRowSelect özellikler yalnızca özelliği olarak View.Details MultiSelect ayarlandığında, View ve CheckBoxes özellikleri ise tüm görünümlerde yararlıdır.

Aşağıdaki tabloda bazı ListView üyeler ve geçerli oldukları görünümler gösterilmektedir.

ListView üyesi	Görünüm
Alignment Özellik	SmallIcon veya LargeIcon
AutoArrange Özellik	SmallIcon veya LargeIcon
AutoResizeColumn yöntemi	Details
CheckBoxes	Dışındaki tüm görünümler Tile
Columns Özellik	Details veya Tile
DrawSubItem Olay	Details
FindItemWithText yöntemi	Details, Listveya Tile
FindNearestItem yöntemi	SmallIcon veya LargeIcon
GetItemAt yöntemi	Details veya Tile
Groups Özellik	Dışındaki tüm görünümler List
HeaderStyle Özellik	Details
InsertionMark Özellik	LargeIcon, SmallIconveya Tile

özelliği, View uygulamanızdaki verilerin farklı görünümlerini sağlamak veya belirli bir görünümü bu görünümün avantajlarını kullanacak şekilde kilitlemek için kullanabilirsiniz. Örneğin, View ayrıntılar görünümü diğer görünümlerde kullanılamayan bir dizi görüntüleme seçeneği sağladığından özelliği genellikle olarak ayarlanır View.Details .

Not

Denetiminizde ListView herhangi bir sütun üst bilgisi belirtilmemişse ve özelliğini olarak View.Details ListView ayarlarsanızView, denetim hiçbir öğe görüntülemez. Denetiminizde ListView herhangi bir sütun üst bilgisi belirtilmemişse ve özelliğini olarak View.Tile ListView ayarlarsanızView, denetim hiçbir alt öğe görüntülemez.

Kutucuk görünümünde her öğe solda büyük bir simge, sağda ise metinsel bilgiler görüntülenir. Metin bilgileri, öğe etiketinden ve ardından alt öğelerden oluşur. Varsayılan olarak, öğe etiketine karşılık gelen yalnızca ilk alt öğe görüntülenir. Ek alt öğeleri görüntülemek için koleksiyona Columns nesne eklemeniz ColumnHeader gerekir. Kutucuktaki her alt bölüm bir sütun başlığına karşılık gelir. Hangi alt öğelerin görüntüleneceğini ve bunların görüntülenme sırasını denetlemek için, her öğenin özelliğini ve ColumnHeader.Name her üst bilginin özelliğini ayarlamanız ListViewItem.ListViewSubItem.Name gerekir. Daha sonra istediğiniz sonucu elde etmek için koleksiyona Columns üst bilgiler ekleyebilir, kaldırabilir ve yeniden düzenleyebilirsiniz.

Kutucuk görünümündeki kutucukların boyutunu denetlemek için özelliğini ayarlayın TileSize . Bu, alt metin tek bir satır için çok uzun olduğunda satır kaydırmayı önlemek için yararlıdır.

Kutucuk görünümü örneği için özelliğine TileSize bakın.

Not

Sütunlar yalnızca ayrıntılar görünümünde görüntülense de, sütun üst bilgileri olmayan alt öğeler ayrıntılar görünümünde veya kutucuk görünümünde görüntülenmez.

Kutucuk görünümü yalnızca uygulamanız yöntemini çağırdığında Windows XP ve Windows Server 2003'te Application.EnableVisualStyles kullanılabilir. Önceki işletim sistemlerinde kutucuk görünümüyle ilgili herhangi bir kodun hiçbir etkisi yoktur ve ListView denetim büyük simge görünümünde görüntülenir. Sonuç olarak, kutucuk görünümüne bağımlı olan kodlar düzgün çalışmayabilir.

Kutucuk görünümünün kullanılabilir olup olmadığını belirleyen kod eklemek ve kullanılamadığında alternatif işlevler sağlamak isteyebilirsiniz. Örneğin, kutucuk görünümündeki öğelerin görünümünü özelleştirmek için sahip çizimini ListView kullandığınızda, kutucuk görünümünü desteklemeyen işletim sistemlerinde çalışırken büyük simge görünümüne uygun çizim kodunu kullanmak isteyebilirsiniz.

Kutucuk görünümü özelliği, işletim sistemi temaları özelliğini sağlayan kitaplık tarafından sağlanır. Bu kitaplığın kullanılabilirliğini denetlemek için yöntem aşırı yüklemesini çağırın FeatureSupport.IsPresent(Object) ve değerini geçirin OSFeature.Themes .

Şunlara uygulanır