ListView.TopItem-Eigenschaft

Ruft das erste sichtbare Element im Steuerelement ab oder legt das Element fest.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property TopItem As ListViewItem
'Usage
Dim instance As ListView
Dim value As ListViewItem

value = instance.TopItem

instance.TopItem = value

public ListViewItem TopItem { get; set; }

public:
property ListViewItem^ TopItem {
    ListViewItem^ get ();
    void set (ListViewItem^ value);
}

/** @property */
public ListViewItem get_TopItem ()

/** @property */
public void set_TopItem (ListViewItem value)

public function get TopItem () : ListViewItem

public function set TopItem (value : ListViewItem)

Eigenschaftenwert

Ein ListViewItem, das das erste sichtbare Element im Steuerelement darstellt.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Die View-Eigenschaft ist auf LargeIcon, SmallIcon oder Tile festgelegt.

Hinweise

Anfänglich befindet sich das Element mit der Indexposition null (0) im ListView-Steuerelement an der obersten Position. Bei einem Bildlauf durch den Inhalt des ListView-Steuerelements kann sich ein anderes Element im Steuerelement an der obersten Position befinden. Mithilfe dieser Eigenschaft können Sie angeben oder bestimmen, welches Element im oberen Teil des ListView-Steuerelements sichtbar ist. Je nach der Position des gewünschten oberen Elements in der Listenansicht wird der Wert der TopItem-Eigenschaft wird nicht permanent beibehalten.

Die Anzahl der in einem ListView-Steuerelement sichtbaren Elemente hängt stets von der Höhe der Listenansicht und der Größe der darin enthaltenen Elemente ab. Wenn die Elemente die Höhe der Listenansicht überschreiten, umfassen die Elemente mitunter mehrere Seiten, durch die die Benutzer einen Bildlauf durchführen können. Wenn Sie die TopItem-Eigenschaft auf ein Element auf der letzten Seite der ListView festlegen, wird das Element automatisch durch einen Bildlauf sichtbar gemacht. TopItem wird jedoch auf das tatsächliche obere Element der letzten Seite festgelegt.

Verwenden Sie die EnsureVisible-Methode, um sicherzustellen, dass sich ein bestimmtes Element im sichtbaren Bereich des Steuerelements (jedoch nicht unbedingt an der oberen Position) befindet.

Hinweis

Das Festlegen dieser Eigenschaft hat keine Auswirkungen, wenn der Scrollable-Eigenschaftenwert false ist.

Das Festlegen dieser Eigenschaft wird in Versionen vor .NET Framework, Version 2.0, nicht unterstützt.

Beispiel

Im folgenden Codebeispiel wird das Zurücksetzen des Formats der Unterelemente eines ListViewItem-Objekts mithilfe der TopItem-Eigenschaft und der ListViewItem.ListViewSubItem.ResetStyle-Methode veranschaulicht. Fügen Sie zum Ausführen dieses Beispiels folgenden Code in ein Formular ein, das die Schaltfläche Button1 enthält, und rufen Sie die InitializeListView-Methode im Konstruktor oder im Load-Ereignishandler des Formulars auf.

' Declare the Listview object.
Friend WithEvents myListView As System.Windows.Forms.ListView

' Initialize the ListView object with subitems of a different
' style than the default styles for the ListView.
Private Sub InitializeListView()

    ' Set the Location, View and Width properties for the 
    ' ListView object. 
    myListView = New ListView
    With (myListView)
        .Location = New System.Drawing.Point(20, 20)

        ' The View property must be set to Details for the 
        ' subitems to be visible.
        .View = View.Details
        .Width = 250
    End With

    ' Each SubItem object requires a column, so add three columns.
    Me.myListView.Columns.Add("Key", 50, HorizontalAlignment.Left)
    Me.myListView.Columns.Add("A", 100, HorizontalAlignment.Left)
    Me.myListView.Columns.Add("B", 100, HorizontalAlignment.Left)

    ' Add a ListItem object to the ListView.
    Dim entryListItem As ListViewItem = myListView.Items.Add("Items")

    ' Set UseItemStyleForSubItems property to false to change 
    ' look of subitems.
    entryListItem.UseItemStyleForSubItems = False

    ' Add the expense subitem.
    Dim expenseItem As ListViewItem.ListViewSubItem = _
        entryListItem.SubItems.Add("Expense")

    ' Change the expenseItem object's color and font.
    expenseItem.ForeColor = System.Drawing.Color.Red
    expenseItem.Font = New System.Drawing.Font _
        ("Arial", 10, System.Drawing.FontStyle.Italic)

    ' Add a subitem called revenueItem 
    Dim revenueItem As ListViewItem.ListViewSubItem = _
        entryListItem.SubItems.Add("Revenue")

    ' Change the revenueItem object's color and font.
    revenueItem.ForeColor = System.Drawing.Color.Blue
    revenueItem.Font = New System.Drawing.Font _
        ("Times New Roman", 10, System.Drawing.FontStyle.Bold)

    ' Add the ListView to the form.
    Me.Controls.Add(Me.myListView)
End Sub

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click

    ' Use the ListView.TopItem property to access the SubItems
    ' and then reset their appearance.
    myListView.TopItem.SubItems(1).ResetStyle()
    myListView.TopItem.SubItems(2).ResetStyle()
End Sub

// Declare the Listview object.
internal System.Windows.Forms.ListView myListView;

// Initialize the ListView object with subitems of a different
// style than the default styles for the ListView.
private void InitializeListView()
{

    // Set the Location, View and Width properties for the 
    // ListView object. 
    myListView = new ListView();
    myListView.Location = new System.Drawing.Point(20, 20);
    myListView.Width = 250;

    // The View property must be set to Details for the 
    // subitems to be visible.
    myListView.View = View.Details;
    
    // Each SubItem object requires a column, so add three columns.
    this.myListView.Columns.Add("Key", 50, HorizontalAlignment.Left);
    this.myListView.Columns.Add("A", 100, HorizontalAlignment.Left);
    this.myListView.Columns.Add("B", 100, HorizontalAlignment.Left);

    // Add a ListItem object to the ListView.
    ListViewItem entryListItem = myListView.Items.Add("Items");

    // Set UseItemStyleForSubItems property to false to change 
    // look of subitems.
    entryListItem.UseItemStyleForSubItems = false;

    // Add the expense subitem.
    ListViewItem.ListViewSubItem expenseItem = 
        entryListItem.SubItems.Add("Expense");

    // Change the expenseItem object's color and font.
    expenseItem.ForeColor = System.Drawing.Color.Red;
    expenseItem.Font = new System.Drawing.Font(
        "Arial", 10, System.Drawing.FontStyle.Italic);

    // Add a subitem called revenueItem 
    ListViewItem.ListViewSubItem revenueItem = 
        entryListItem.SubItems.Add("Revenue");

    // Change the revenueItem object's color and font.
    revenueItem.ForeColor = System.Drawing.Color.Blue;
    revenueItem.Font = new System.Drawing.Font(
        "Times New Roman", 10, System.Drawing.FontStyle.Bold);

    // Add the ListView to the form.
    this.Controls.Add(this.myListView);
}

private void Button1_Click(System.Object sender, System.EventArgs e)
{

    // Use the ListView.TopItem property to access the SubItems
    // and then reset their appearance.
    myListView.TopItem.SubItems[1].ResetStyle();
    myListView.TopItem.SubItems[2].ResetStyle();
}

internal:
   // Declare the Listview object.
   System::Windows::Forms::ListView^ myListView;

private:

   // Initialize the ListView object with subitems of a different
   // style than the default styles for the ListView.
   void InitializeListView()
   {
      // Set the Location, View and Width properties for the 
      // ListView object. 
      myListView = gcnew ListView;
      myListView->Location = System::Drawing::Point( 20, 20 );
      myListView->Width = 250;
      
      // The View property must be set to Details for the 
      // subitems to be visible.
      myListView->View = View::Details;
      
      // Each SubItem object requires a column, so add three columns.
      this->myListView->Columns->Add( "Key", 50, HorizontalAlignment::Left );
      this->myListView->Columns->Add( "A", 100, HorizontalAlignment::Left );
      this->myListView->Columns->Add( "B", 100, HorizontalAlignment::Left );
      
      // Add a ListItem object to the ListView.
      ListViewItem^ entryListItem = myListView->Items->Add( "Items" );
      
      // Set UseItemStyleForSubItems property to false to change 
      // look of subitems.
      entryListItem->UseItemStyleForSubItems = false;
      
      // Add the expense subitem.
      ListViewItem::ListViewSubItem ^ expenseItem = entryListItem->SubItems->Add( "Expense" );
      
      // Change the expenseItem object's color and font.
      expenseItem->ForeColor = System::Drawing::Color::Red;
      expenseItem->Font = gcnew System::Drawing::Font( "Arial",10,System::Drawing::FontStyle::Italic );
      
      // Add a subitem called revenueItem 
      ListViewItem::ListViewSubItem ^ revenueItem = entryListItem->SubItems->Add( "Revenue" );
      
      // Change the revenueItem object's color and font.
      revenueItem->ForeColor = System::Drawing::Color::Blue;
      revenueItem->Font = gcnew System::Drawing::Font( "Times New Roman",10,System::Drawing::FontStyle::Bold );
      
      // Add the ListView to the form.
      this->Controls->Add( this->myListView );
   }

   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Use the ListView.TopItem property to access the SubItems
      // and then reset their appearance.
      myListView->TopItem->SubItems[ 1 ]->ResetStyle();
      myListView->TopItem->SubItems[ 2 ]->ResetStyle();
   }

// Declare the Listview object.
System.Windows.Forms.ListView myListView;

// Initialize the ListView object with subitems of a different
// style than the default styles for the ListView.
private void InitializeListView()
{
    // Set the Location, View and Width properties for the 
    // ListView object. 
    myListView = new ListView();
    myListView.set_Location(new System.Drawing.Point(20, 20));
    myListView.set_Width(250);
    // The View property must be set to Details for the 
    // subitems to be visible.
    myListView.set_View(View.Details);
    // Each SubItem object requires a column, so add three columns.
    this.myListView.get_Columns().Add("Key", 50, HorizontalAlignment.Left);
    this.myListView.get_Columns().Add("A", 100, HorizontalAlignment.Left);
    this.myListView.get_Columns().Add("B", 100, HorizontalAlignment.Left);
    // Add a ListItem object to the ListView.
    ListViewItem entryListItem = myListView.get_Items().Add("Items");
    // Set UseItemStyleForSubItems property to false to change 
    // look of subitems.
    entryListItem.set_UseItemStyleForSubItems(false);
    // Add the expense subitem.
    ListViewItem.ListViewSubItem expenseItem =
        entryListItem.get_SubItems().Add("Expense");
    // Change the expenseItem object's color and font.
    expenseItem.set_ForeColor(System.Drawing.Color.get_Red());
    expenseItem.set_Font(new System.Drawing.Font("Arial", 10,
        System.Drawing.FontStyle.Italic));
    // Add a subitem called revenueItem 
    ListViewItem.ListViewSubItem revenueItem =
        entryListItem.get_SubItems().Add("Revenue");
    // Change the revenueItem object's color and font.
    revenueItem.set_ForeColor(System.Drawing.Color.get_Blue());
    revenueItem.set_Font(new System.Drawing.Font("Times New Roman", 10,
        System.Drawing.FontStyle.Bold));
    // Add the ListView to the form.
    this.get_Controls().Add(this.myListView);
} //InitializeListView

private void button1_Click(Object sender, System.EventArgs e)
{
    // Use the ListView.TopItem property to access the SubItems
    // and then reset their appearance.
    myListView.get_TopItem().get_SubItems().get_Item(1).ResetStyle();
    myListView.get_TopItem().get_SubItems().get_Item(2).ResetStyle();
} //button1_Click

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ListView-Klasse
ListView-Member
System.Windows.Forms-Namespace
ListViewItem
EnsureVisible