Teilen über


ListView.View Eigenschaft

Definition

Ruft ab, wie Elemente im Steuerelement angezeigt werden, oder legt dieses fest.

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

Eigenschaftswert

Einer der View-Werte. Der Standardwert ist 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 Objekten erstellt, die für jedes Element angegeben sind. Im Beispiel werden auch Objekte erstellt ColumnHeader , um die Unterelemente in der Detailansicht anzuzeigen. Im Codebeispiel werden auch zwei ImageList Objekte erstellt, um Bilder für die ListViewItem Objekte bereitzustellen. Diese ImageList Objekte werden den LargeImageList Eigenschaften und SmallImageList hinzugefügt. Im Beispiel werden die folgenden Eigenschaften zum Erstellen des Steuerelements ListView verwendet.

Dieses Beispiel erfordert, dass Sie den Code zu einer Form hinzugefügt haben und die im Beispiel erstellte Methode aus dem Konstruktor oder einer anderen Methode im Formular aufrufen. Das Beispiel erfordert außerdem, dass sich Images mit den Namen MySmallImage1, MySmallImage2, MyLargeImage1und MyLargeImage2 im Stammverzeichnis von Laufwerk C befinden.

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 View der -Eigenschaft können Sie den Anzeigetyp angeben, den das Steuerelement zum Anzeigen von ListView Elementen verwendet. Sie können die View -Eigenschaft festlegen, um jedes Element mit großen oder kleinen Symbolen anzuzeigen oder Elemente in einer vertikalen Liste anzuzeigen. 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 in einer Spalte mit Spaltenüberschriften angezeigt 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 Elemente auch als Kacheln anzeigen, die grafische und Textinformationen 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. Die Kleinbildansicht zeigt jedes Element mit einem Symbol und Textinformationen rechts neben dem Symbol an. In der Großbildansicht werden jedes Element mit einem Symbol und Textinformationen unterhalb des Symbols angezeigt. Die Größe der Symbole für die Bildliste wird durch die ImageSize -Eigenschaft von ImageList für oder SmallImageListLargeImageList angegeben.

Hinweis

Wenn Sie mehrere Bildlisten verwenden, sollten Sie für kleine und große Symbolansichten 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 unabhängig vom angegebenen Schlüsselwert in der anderen Liste zu suchen.

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. Beispielsweise sind Eigenschaften wie GridLines und FullRowSelect nur nützlich, wenn die View Eigenschaft auf View.Detailsfestgelegt ist, während die MultiSelect Eigenschaften und CheckBoxes in allen Ansichten nützlich sind.

In der folgenden Tabelle sind einige elemente ListView und die Ansichten aufgeführt, in denen sie gültig sind.

ListView-Member 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 unterschiedliche Ansichten von Daten in Ihrer Anwendung bereitzustellen oder eine bestimmte Ansicht zu sperren, um die Vorteile dieser Ansicht zu nutzen. Beispielsweise wird die View Eigenschaft häufig auf View.Details festgelegt, da die Detailansicht eine Reihe von Anzeigeoptionen bereitstellt, die in den anderen Ansichten nicht verfügbar sind.

Hinweis

Wenn für Ihr ListView Steuerelement keine Spaltenüberschriften angegeben sind und Sie die View Eigenschaft auf View.Detailsfestlegen, zeigt das ListView Steuerelement keine Elemente an. Wenn für Ihr ListView Steuerelement keine Spaltenüberschriften angegeben sind und Sie die View -Eigenschaft auf View.Tilefestlegen, zeigt das ListView Steuerelement keine Unterelemente an.

In der Kachelansicht werden jedes Element mit einem großen Symbol links und Textinformationen 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 in welcher Reihenfolge sie angezeigt werden, müssen Sie die ListViewItem.ListViewSubItem.Name -Eigenschaft für jedes Element und die ColumnHeader.Name -Eigenschaft für jeden Header festlegen. Sie können dann Kopfzeilen in der Columns Auflistung hinzufügen, entfernen und neu anordnen, um das gewünschte Ergebnis zu erzielen.

Legen Sie die -Eigenschaft fest TileSize , um die Größe der Kacheln in der Kachelansicht zu steuern. Dies ist nützlich, um Zeilenumbrüche 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 Spaltenheader weder in der Detailansicht noch in der Kachelansicht angezeigt.

Die Kachelansicht ist nur unter Windows XP und Windows Server 2003 verfügbar, wenn Ihre Anwendung die Application.EnableVisualStyles -Methode aufruft. Unter älteren Betriebssystemen hat Code in Bezug auf die Ansicht "Nebeneinander" keine Auswirkungen, und das ListView-Steuerelement wird in der Ansicht "Große Symbole" angezeigt. Daher funktioniert jeder Code, der von der Kachelansicht abhängig ist, 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 bei der Ausführung unter Betriebssystemen, die die Kachelansicht nicht unterstützen, Zeichnungscode verwenden, der der großen Symbolansicht entspricht.

Das Kachelansichtsfeature wird von derselben Bibliothek bereitgestellt, die das Feature betriebssystemdesigns bereitstellt. Um die Verfügbarkeit dieser Bibliothek zu überprüfen, rufen Sie die FeatureSupport.IsPresent(Object) Methodenüberladung auf, und übergeben Sie den OSFeature.Themes Wert.

Gilt für:

Weitere Informationen