ListView.TopItem 속성

컨트롤에 가장 먼저 표시되는 항목을 가져오거나 설정합니다.

네임스페이스: System.Windows.Forms
어셈블리: System.Windows.Forms(system.windows.forms.dll)

구문

‘선언
Public Property TopItem As ListViewItem
‘사용 방법
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)

속성 값

컨트롤에서 첫째 표시 가능 항목을 나타내는 ListViewItem입니다.

예외

예외 형식	조건
InvalidOperationException	View 속성이 LargeIcon, SmallIcon 또는 Tile로 설정된 경우

설명

처음에 인덱스 위치가 0인 항목은 ListView 컨트롤의 맨 위에 있습니다. ListView 컨트롤 콘텐츠가 스크롤되면 다른 항목이 이 컨트롤의 맨 위에 올 수 있습니다. 이 속성을 사용하여 ListView 컨트롤의 맨 위에 표시되는 항목을 나타내거나 확인할 수 있습니다. TopItem 속성 값은 간단히 보기에서 원하는 최상위 항목이 있는 위치에 따라 유지되지 않을 수도 있습니다.

ListView 컨트롤에 표시되는 항목 수는 간단히 보기의 높이와 간단히 보기에 포함되는 항목의 크기에 따라 달라집니다. 전체 항목 수가 간단히 보기의 높이를 초과하면 항목이 여러 페이지에 계속 표시되므로 스크롤할 수 있습니다. TopItem 속성을 ListView의 마지막 페이지에 있는 항목으로 설정하는 경우 항목이 보기로 자동 스크롤되지만 TopItem은 마지막 페이지의 실제 최상위 항목으로 설정됩니다.

특정 항목이 컨트롤의 표시되는 영역에 속하게 하려면(반드시 위쪽 위치에 속할 필요는 없음) EnsureVisible 메서드를 사용합니다.

참고

Scrollable 속성 값이 false이면 이 속성을 설정해도 아무런 영향을 주지 않습니다.

.NET Framework 2.0 이전 버전에서는 이 속성을 설정할 수 없습니다.

예제

다음 코드 예제에서는 TopItem 속성과 ListViewItem.ListViewSubItem.ResetStyle 메서드를 사용하여 ListViewItem 개체의 하위 항목 스타일을 다시 설정하는 방법을 보여 줍니다. 이 예제를 실행하려면 Button1이라는 단추가 들어 있는 폼에 다음 코드를 붙여넣고 폼의 생성자나 Load 이벤트 처리기에서 InitializeListView 메서드를 호출합니다.

' 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

플랫폼

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

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

ListView 클래스
ListView 멤버
System.Windows.Forms 네임스페이스
ListViewItem
EnsureVisible