ListView.TopItem ListView.TopItem ListView.TopItem ListView.TopItem Property

정의

컨트롤에 가장 먼저 표시되는 항목을 가져오거나 설정합니다.Gets or sets the first visible item in the control.

public:
 property System::Windows::Forms::ListViewItem ^ TopItem { System::Windows::Forms::ListViewItem ^ get(); void set(System::Windows::Forms::ListViewItem ^ value); };
[System.ComponentModel.Browsable(false)]
public System.Windows.Forms.ListViewItem TopItem { get; set; }
member this.TopItem : System.Windows.Forms.ListViewItem with get, set
Public Property TopItem As ListViewItem

속성 값

ListViewItem 컨트롤에 표시 되는 첫 번째 항목을 나타내는입니다.A ListViewItem that represents the first visible item in the control.

예외

예제

다음 코드 예제에서는 스타일을 다시 설정 하는 방법을 보여 줍니다는 ListViewItem 사용 하 여 개체의 하위 항목을 TopItem 속성 및 ListViewItem.ListViewSubItem.ResetStyle 메서드.The following code example demonstrates resetting the style of a ListViewItem object's subitems through the use of the TopItem property and the ListViewItem.ListViewSubItem.ResetStyle method. 예제를 실행 하 라는 단추가 포함 된 형식으로 다음 코드를 붙여 넣습니다 Button1 호출을 InitializeListView 양식의 생성자 또는 Load 이벤트 처리기입니다.To run the example, paste the following code into a form containing a button named Button1 and call the InitializeListView method in the form's constructor or Load event handler.

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.
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();
}

' 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

설명

영 (0)의 인덱스 위치를 사용 하 여 항목의 맨 처음에는 ListView 제어 합니다.Initially, the item with the index position of zero (0) is at the top of the ListView control. 경우는 ListView 컨트롤 콘텐츠가 스크롤 되, 컨트롤의 맨 위에 있는 다른 항목을 수 있습니다.If the ListView control contents are scrolled, a different item can be at the top of the control. 나타내거나 위쪽에 표시 되는 항목을 확인 하려면이 속성을 사용할 수는 ListView 제어 합니다.You can use this property to indicate or determine which item is visible at the top of the ListView control. 값을 TopItem 속성 유지 되지 않을, 목록 보기에서 원하는 맨 위 항목 위치에 따라 합니다.The value of the TopItem property will not always persist, depending on where the desired top item is in the list view.

에 표시 되는 항목의 수를 ListView 언제 든 지 컨트롤 목록 보기의 높이 및 포함 된 항목의 크기에 따라 달라 집니다.The number of items visible in a ListView control at any time depends on the height of the list view and the size of the items it contains. 항목 목록 보기의 높이 초과 하는 경우 사용자가 스크롤할 수 있는 여러 페이지에 항목을 계속 됩니다.If the items exceed the height of the list view, the items will continue onto multiple pages, which the user can scroll through. 설정 하는 경우는 TopItem 속성의 마지막 페이지의 항목에는 ListView, 항목은 자동으로 스크롤하여 볼 수 있습니다; 그러나 TopItem 마지막 페이지의 실제 맨 위 항목으로 설정 됩니다.If you set the TopItem property to an item in the last page of the ListView, the item will automatically be scrolled into view; however, TopItem will be set to the actual top item of the last page.

되도록 특정 항목에 컨트롤의 표시 영역 (반드시 위쪽 위치에)를 사용 하 여는 EnsureVisible 메서드.To ensure that a specific item is in the visible region of the control (but not necessarily in the top position), use the EnsureVisible method.

참고

가 없으면이이 속성을 설정 하면 적용 된 Scrollable 속성 값이 false합니다.Setting this property has no effect when the Scrollable property value is false.

이 속성을 설정의 버전에서 지원 되지 않습니다는 .NET Framework.NET Framework 버전 2.0 이전 합니다.Setting this property is not supported in versions of the .NET Framework.NET Framework prior to version 2.0.

적용 대상

추가 정보