ListView.View Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ab oder legt fest, wie Elemente im Steuerelement angezeigt werden.
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 ViewEigenschaftswert
Einer der View Werte. Der Standardwert lautet LargeIcon.
Ausnahmen
Der angegebene Wert ist keiner der View Werte.
Beispiele
Im folgenden Codebeispiel wird ein ListView Steuerelement mit drei ListViewItem angegebenen Objekten und drei ListViewItem.ListViewSubItem Für jedes Element angegebenen Objekten erstellt. Im Beispiel werden auch Objekte zum Anzeigen der Unterelemente in der Detailansicht erstellt ColumnHeader . Im Codebeispiel werden auch zwei ImageList Objekte erstellt, um Bilder für die ListViewItem Objekte bereitzustellen. Diese ImageList Objekte werden den LargeImageList Und SmallImageList Eigenschaften hinzugefügt. Im Beispiel werden die folgenden Eigenschaften zum Erstellen des Steuerelements ListView verwendet.
In diesem Beispiel müssen Sie dem Code hinzugefügt Form und die im Beispiel erstellte Methode aus dem Konstruktor oder einer anderen Methode im Formular aufrufen. Das Beispiel erfordert außerdem, dass Bilder namens MySmallImage1, MySmallImage2, MyLargeImage1, und MyLargeImage2 befinden sich im Stammverzeichnis von Laufwerk 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
Hinweise
Mit der View Eigenschaft können Sie den Typ der Anzeige angeben, die das ListView Steuerelement zum Anzeigen von Elementen verwendet. Sie können die View Eigenschaft so festlegen, dass jedes Element mit großen oder kleinen Symbolen oder Elementen in einer vertikalen Liste angezeigt wird. Die reichste Option ist die Detailansicht, mit der Sie nicht nur die Elemente, sondern alle für jedes Element angegebenen Unterelemente anzeigen können. Jedes Element wird in einem Raster angezeigt, wobei jedes Element vertikal und die Unterelemente für jedes Element, das in einer Spalte angezeigt wird, mit Spaltenüberschriften aufgeführt werden. Die Detailansicht ist eine perfekte Möglichkeit zum Anzeigen von Datenbankinformationen für einen Benutzer. Mit Windows XP und Windows Server 2003 können Sie auch Elemente als Kacheln anzeigen, die grafische und textbezogene Informationen ausgleichen, indem Sie ein großes Symbol zusammen mit Unterelementinformationen Ihrer Wahl anzeigen. Um die Kachelansicht zu aktivieren, muss Ihre Anwendung die Application.EnableVisualStyles Methode aufrufen. In der Kleinbildansicht werden die einzelnen Elemente mit einem Symbol und Textinformationen rechts neben dem Symbol angezeigt. In der Ansicht "Große Bilder" werden die einzelnen Elemente mit einem Symbol und textbezogenen Informationen unterhalb des Symbols angezeigt. Die Größe der Symbole für die Bildliste wird durch die ImageSize Eigenschaft der ImageList für die SmallImageList Eigenschaften oder LargeImageList Eigenschaften angegeben.
Hinweis
Wenn Sie mehrere Bildlisten verwenden, sollten Sie für die Ansicht mit kleinen und großen Symbolen mit einem ListView Steuerelement kleine und große Versionen des Bilds an derselben Indexposition in ihren jeweiligen Bildlisten platzieren. Beim Wechseln zwischen Ansichten wird die Indexposition des Bilds in einer Liste verwendet, um das Bild in der anderen Liste zu suchen, unabhängig vom angegebenen Schlüsselwert.
Die meisten Eigenschaften im ListView Steuerelement wirken sich darauf aus, wie sich die verschiedenen Ansichten verhalten oder angezeigt werden. Einige Eigenschaften, die sich auf die Ansichten der Elemente auswirken, sind nur nützlich, wenn die View Eigenschaft auf einen bestimmten Wert festgelegt ist, während andere in allen Ansichten nützlich sind. Eigenschaften wie GridLines z. B. und FullRowSelect sind nur dann nützlich, wenn die View Eigenschaft auf View.Details", während die MultiSelect Eigenschaften CheckBoxes in allen Ansichten nützlich sind.
In der folgenden Tabelle sind einige der ListView Elemente und ansichten aufgeführt, in denen sie gültig sind.
| ListView-Mitglied | Ansicht |
|---|---|
| Alignment-Eigenschaft | SmallIcon oder LargeIcon |
| AutoArrange-Eigenschaft | SmallIcon oder LargeIcon |
| AutoResizeColumn-Methode | Details |
| CheckBoxes | Alle Ansichten außer Tile |
| Columns-Eigenschaft | Details oder Tile |
| DrawSubItem-Ereignis | Details |
| FindItemWithText-Methode | Details, Listoder Tile |
| FindNearestItem-Methode | SmallIcon oder LargeIcon |
| GetItemAt-Methode | Details oder Tile |
| Groups-Eigenschaft | Alle Ansichten außer List |
| HeaderStyle-Eigenschaft | Details |
| InsertionMark-Eigenschaft | LargeIcon, SmallIconoder Tile |
Sie können die View Eigenschaft verwenden, um verschiedene Ansichten von Daten in Ihrer Anwendung bereitzustellen oder eine bestimmte Ansicht zu sperren, um die Vorteile dieser Ansicht zu nutzen. Die Eigenschaft ist beispielsweise häufig so festgelegtView.Details, dass die Detailansicht eine Reihe von Anzeigeoptionen bereitstellt, View die in den anderen Ansichten nicht verfügbar sind.
Hinweis
Wenn das ListView Steuerelement keine Spaltenüberschriften angegeben hat und Sie die View Eigenschaft auf View.Details festlegen, ListView werden im Steuerelement keine Elemente angezeigt. Wenn das ListView Steuerelement keine Spaltenüberschriften angegeben hat und Sie die View Eigenschaft auf View.Tile festlegen, zeigt das ListView Steuerelement keine Unterelemente an.
In der Kachelansicht werden die einzelnen Elemente mit einem großen Symbol auf der linken Seite und textbezogenen Informationen auf der rechten Seite angezeigt. Die Textinformationen bestehen aus der Elementbezeichnung, gefolgt von Unterelementen. Standardmäßig wird nur das erste Unterelement angezeigt, das der Elementbezeichnung entspricht. Um zusätzliche Unterelemente anzuzeigen, müssen Sie der Columns Auflistung Objekte hinzufügenColumnHeader. Jedes Unterelement in der Kachel entspricht einer Spaltenüberschrift. Um zu steuern, welche Unterelemente angezeigt werden, und die Reihenfolge, in der sie angezeigt werden, müssen Sie die ListViewItem.ListViewSubItem.Name Eigenschaft für jedes Element und die ColumnHeader.Name Eigenschaft für jede Kopfzeile festlegen. Anschließend können Sie Kopfzeilen in der Columns Auflistung hinzufügen, entfernen und neu anordnen, um das gewünschte Ergebnis zu erzielen.
Um die Größe der Kacheln in der Kachelansicht zu steuern, legen Sie die TileSize Eigenschaft fest. Dies ist hilfreich, um den Zeilenumbruch zu verhindern, wenn Der Unterelementtext für eine einzelne Zeile zu lang ist.
Ein Beispiel für die Kachelansicht finden Sie in der TileSize Eigenschaft.
Hinweis
Obwohl Spalten nur in der Detailansicht angezeigt werden, werden Unterelemente ohne Spaltenüberschriften weder in der Detailansicht noch in der Kachelansicht angezeigt.
Die Kachelansicht ist nur unter Windows XP und Windows Server 2003 verfügbar, wenn die Anwendung die Application.EnableVisualStyles Methode aufruft. In früheren Betriebssystemen hat jeder Code im Zusammenhang mit der Kachelansicht keine Auswirkung, und das ListView Steuerelement wird in der großen Symbolansicht angezeigt. Daher funktioniert jeder Code, der von der Kachelansicht abhängt, möglicherweise nicht ordnungsgemäß.
Möglicherweise möchten Sie Code einschließen, der bestimmt, ob die Kachelansicht verfügbar ist, und alternative Funktionen bereitstellen, wenn sie nicht verfügbar ist. Wenn Sie z. B. die Besitzerzeichnung verwenden, um die Darstellung von ListView Elementen in der Kachelansicht anzupassen, sollten Sie den Zeichnungscode verwenden, der für die große Symbolansicht geeignet ist, wenn sie auf Betriebssystemen ausgeführt wird, die die Kachelansicht nicht unterstützen.
Das Kachelansichtsfeature wird von derselben Bibliothek bereitgestellt, die das Feature "Betriebssystemdesigns" bereitstellt. Rufen Sie die FeatureSupport.IsPresent(Object) Methodenüberladung auf, und übergeben Sie den OSFeature.Themes Wert, um die Verfügbarkeit dieser Bibliothek zu überprüfen.
