ListView.AutoResizeColumn(Int32, ColumnHeaderAutoResizeStyle) 메서드

정의

크기 조정 스타일이 나타내는 대로 주어진 열의 너비를 조정합니다.Resizes the width of the given column as indicated by the resize style.

public:
 void AutoResizeColumn(int columnIndex, System::Windows::Forms::ColumnHeaderAutoResizeStyle headerAutoResize);
public void AutoResizeColumn (int columnIndex, System.Windows.Forms.ColumnHeaderAutoResizeStyle headerAutoResize);
member this.AutoResizeColumn : int * System.Windows.Forms.ColumnHeaderAutoResizeStyle -> unit
Public Sub AutoResizeColumn (columnIndex As Integer, headerAutoResize As ColumnHeaderAutoResizeStyle)

매개 변수

columnIndex
Int32

크기를 조정할 열의 0부터 시작하는 인덱스입니다.The zero-based index of the column to resize.

headerAutoResize
ColumnHeaderAutoResizeStyle

ColumnHeaderAutoResizeStyle 값 중 하나입니다.One of the ColumnHeaderAutoResizeStyle values.

예외

Columnsnull일 때 columnIndex가 0보다 큰 경우columnIndex is greater than 0 when Columns is null

또는-or-

columnIndex가 0보다 작거나 설정된 열 수보다 큰 경우columnIndex is less than 0 or greater than the number of columns set.

headerAutoResizeColumnHeaderAutoResizeStyle 열거형의 멤버가 아닌 경우headerAutoResize is not a member of the ColumnHeaderAutoResizeStyle enumeration.

예제

다음 예제에서는 ListView 자세히 보기에서을 초기화 하 고 메서드를 사용 하 여 자동으로 열의 크기를 조정 합니다 AutoResizeColumn .The following example initializes a ListView in detail view and automatically resizes the columns using the AutoResizeColumn method. 이 예제를 실행 하려면이 코드를 Windows Form에 붙여넣고 InitializeResizingListView 폼의 생성자 또는 이벤트 처리기에서 메서드를 호출 Load 합니다.To run this example, paste this code into a Windows Form and call the InitializeResizingListView method from the form's constructor or Load event handler.

private ListView resizingListView = new ListView();
private Button button1 = new Button();

private void InitializeResizingListView()
{
    // Set location and text for button.
    button1.Location = new Point(100, 15);
    button1.Text = "Resize";
    button1.Click += new EventHandler(button1_Click);

    // Set the ListView to details view.
    resizingListView.View = View.Details;

    //Set size, location and populate the ListView.
    resizingListView.Size = new Size(200, 100);
    resizingListView.Location = new Point(40, 40);
    resizingListView.Columns.Add("HeaderSize");
    resizingListView.Columns.Add("ColumnContent");
    ListViewItem listItem1 = new ListViewItem("Short");
    ListViewItem listItem2 = new ListViewItem("Tiny");
    listItem1.SubItems.Add(new ListViewItem.ListViewSubItem( 
            listItem1, "Something longer"));
    listItem2.SubItems.Add(new ListViewItem.ListViewSubItem(
        listItem2, "Something even longer"));
    resizingListView.Items.Add(listItem1);
    resizingListView.Items.Add(listItem2);

    // Add the ListView and the Button to the form.
    this.Controls.Add(resizingListView);
    this.Controls.Add(button1);
}

private void button1_Click(object sender, EventArgs e)
{
    resizingListView.AutoResizeColumn(0, 
        ColumnHeaderAutoResizeStyle.HeaderSize);
    resizingListView.AutoResizeColumn(1, 
        ColumnHeaderAutoResizeStyle.ColumnContent);
}

Private resizingListView As New ListView()
Private WithEvents button1 As New Button()


Private Sub InitializeResizingListView()
    ' Set location and text for button.
    button1.Location = New Point(100, 15)
    button1.Text = "Resize"
    AddHandler button1.Click, AddressOf button1_Click

    ' Set the ListView to details view.
    resizingListView.View = View.Details

    'Set size, location and populate the ListView.
    resizingListView.Size = New Size(200, 100)
    resizingListView.Location = New Point(40, 40)
    resizingListView.Columns.Add("HeaderSize")
    resizingListView.Columns.Add("ColumnContent")
    Dim listItem1 As New ListViewItem("Short")
    Dim listItem2 As New ListViewItem("Tiny")
    listItem1.SubItems.Add(New ListViewItem.ListViewSubItem(listItem1, _
        "Something longer"))
    listItem2.SubItems.Add(New ListViewItem.ListViewSubItem(listItem2, _
        "Something even longer"))
    resizingListView.Items.Add(listItem1)
    resizingListView.Items.Add(listItem2)

    ' Add the ListView and the Button to the form.
    Me.Controls.Add(resizingListView)
    Me.Controls.Add(button1)

End Sub


Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
    Handles button1.Click

    ' Resize the first column to the header size.
    resizingListView.AutoResizeColumn(0, _
        ColumnHeaderAutoResizeStyle.HeaderSize)

    ' Resize the second column to the column content.
    resizingListView.AutoResizeColumn(1, _
        ColumnHeaderAutoResizeStyle.ColumnContent)

End Sub

설명

이 메서드 호출은 및를 포함 하는가 생성 된 후에만 적용 ListView Form 되며 ListView 열 머리글과 열이 항목으로 채워집니다.Calling this method is only effective once the ListView and containing Form have been constructed, and the ListView column headers and columns are populated with items. 에 새 항목이 추가 되는 경우를 ListView 다시 호출 하지 않으면 열의 크기가 조정 되지 않습니다 AutoResizeColumn .If new items are added to the ListView, the columns will not resize unless AutoResizeColumn is called again.

적용 대상