ListView.View Özellik
Tanım
Ö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, setPublic Property View As ViewÖzellik Değeri
Değerlerden View biri. Varsayılan değer: LargeIcon.
Özel durumlar
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 nesnelere yönelik görüntüler sağlamak için 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, kodu bir Form öğesine eklemenizi ve örnekte oluşturulan yöntemi oluşturucudan veya formdaki başka bir yöntemden çağırmanızı gerektirir. Ö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, büyük veya küçük simgeler içeren her öğeyi görüntüleyecek veya öğeleri dikey bir listede görüntüleyecek şekilde ayarlayabilirsiniz View . 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ütunda görüntülenir ve sütun başlıklarıyla birlikte görüntülenir. Ayrıntılar görünümü, veritabanı bilgilerini kullanıcıya görüntülemenin mükemmel bir yoludur. Windows XP ve Windows Server 2003 ile, seçtiğiniz alt öğe bilgilerinin yanı sıra büyük bir simge 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 simge 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 SmallImageList öğesinin ImageList özelliği tarafından ImageSize belirtilir.
Uyarı
Küçük ve büyük simge görünümü için bir ListView denetimle birden çok resim listesi kullanıyorsanız, ilgili görüntü listelerinde görüntünün küçük ve büyük sürümlerini aynı dizin konumuna yerleştirmeniz gerekir. Görünümler arasında geçiş yaparken, belirtilen anahtar değerinden bağımsız olarak, bir listedeki görüntünün dizin konumu 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 özellikler yalnızca özelliği olarak MultiSelectView.Detailsayarlandığında, View ve CheckBoxes özellikleri ise tüm görünümlerde FullRowSelect yararlıdır.
Aşağıdaki tabloda bazı ListView üyeler ve geçerli oldukları görünümler gösterilmektedir.
| ListView üyesi | View |
|---|---|
| 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 etkinlik | Details |
| FindItemWithText yöntemi | Details, List veya 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, SmallIcon veya Tile |
özelliğini kullanarak uygulamanızdaki verilerin farklı görünümlerini sağlayabilir View veya belirli bir görünümü kilitleyip bu görünümün avantajlarını 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 .
Uyarı
Denetiminizde ListView herhangi bir sütun üst bilgisi belirtilmemişse ve özelliğini olarak View.DetailsListView 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.TileListView ayarlarsanızView, denetim herhangi bir alt öğe görüntülemez.
Kutucuk görünümü, her öğeyi solda büyük bir simge ve sağda metinsel bilgilerle görüntüler. 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 üst bilgisine 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.
Uyarı
Sütunlar yalnızca ayrıntılar görünümünde görüntülense de, sütun üst bilgisi 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ğlı olan kodlar düzgün çalışmayabilir.
Kutucuk görünümünün kullanılabilir olup olmadığını belirleyen ve kullanılamadığında alternatif işlevler sağlayan kod eklemek isteyebilirsiniz. Örneğin, kutucuk görünümündeki öğelerin görünümünü ListView özelleştirmek için sahip çizimini 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 aynı 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 .
