DataGridViewColumn.AutoSizeMode 속성

정의

열의 너비를 자동으로 조정하는 모드를 가져오거나 설정합니다.Gets or sets the mode by which the column automatically adjusts its width.

public:
 property System::Windows::Forms::DataGridViewAutoSizeColumnMode AutoSizeMode { System::Windows::Forms::DataGridViewAutoSizeColumnMode get(); void set(System::Windows::Forms::DataGridViewAutoSizeColumnMode value); };
public System.Windows.Forms.DataGridViewAutoSizeColumnMode AutoSizeMode { get; set; }
member this.AutoSizeMode : System.Windows.Forms.DataGridViewAutoSizeColumnMode with get, set
Public Property AutoSizeMode As DataGridViewAutoSizeColumnMode

속성 값

열의 너비가 자동으로 조정되는지 여부와 열의 기본 설정 너비를 결정하는 방법을 나타내는 DataGridViewAutoSizeColumnMode 값입니다.A DataGridViewAutoSizeColumnMode value that determines whether the column will automatically adjust its width and how it will determine its preferred width. 기본값은 NotSet입니다.The default is NotSet.

예외

이 속성을 설정할 때 지정된 값이 잘못된 DataGridViewAutoSizeColumnMode인 경우The specified value when setting this property is a DataGridViewAutoSizeColumnMode that is not valid.

이 속성을 설정할 때 지정된 값으로 인해 열 머리글이 숨겨질 때 표시되는 열의 InheritedAutoSizeMode 값이 ColumnHeader가 되는 경우The specified value when setting this property results in an InheritedAutoSizeMode value of ColumnHeader for a visible column when column headers are hidden.

-또는--or- 이 속성을 설정할 때 지정된 값으로 인해 고정되어 있는 표시되는 열의 InheritedAutoSizeMode 값이 Fill이 되는 경우The specified value when setting this property results in an InheritedAutoSizeMode value of Fill for a visible column that is frozen.

예제

다음 코드 예제에서는 열 내용에 맞게 너비가 자동으로 조정 되도록 합니다.The following code example forces a column to automatically resize its width to fit its contents. 이 코드 예제는에 대해 제공 된 큰 예제의 일부는 DataGridViewColumn 클래스입니다.This code example is part of a larger example provided for the DataGridViewColumn class.

// AutoSize the third column.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
   DataGridViewColumn^ column = dataGridView->Columns[ 2 ];
   column->AutoSizeMode = DataGridViewAutoSizeColumnMode::DisplayedCells;
}


// AutoSize the third column.
private void Button6_Click(object sender,
    System.EventArgs e)
{
    DataGridViewColumn column = dataGridView.Columns[2];
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells;
}
' AutoSize the third column.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim column As DataGridViewColumn = dataGridView.Columns(2)
    column.AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
End Sub

설명

열의 자동 크기 조정 동작은 InheritedAutoSizeMode 속성 값에 의해 결정 됩니다 .이 값은 NotSet를 제외한 모든 값에 대 한 AutoSizeMode 속성의 값과 동일 합니다 .이 값은 값이 DataGridView.AutoSizeColumnsMode 속성에서 상속 됨을 나타냅니다.The automatic sizing behavior of the column is determined by the value of the InheritedAutoSizeMode property, which is the same as the value of the AutoSizeMode property for all values except NotSet, which indicates that the value is inherited from the DataGridView.AutoSizeColumnsMode property instead.

InheritedAutoSizeMode 속성 값을 Fill하면 해당 모드의 다른 열과 함께 열의 크기가 조정 됩니다.When the InheritedAutoSizeMode property value is Fill, the column is resized along with other columns in that mode. 컨트롤의 모든 채우기 모드 열은 사용 가능한 공간을 해당 FillWeight 속성 값에 따라 결정 되는 비율로 나눕니다.All fill-mode columns in the control divide the available space in proportions determined by their FillWeight property values. 채우기 모드에 대 한 사용 가능한 너비는 컨트롤의 클라이언트 영역 너비에서 다른 모든 열의 너비를 뺀 값으로 결정 됩니다.The width available for fill mode is determined by subtracting the widths of all other columns from the width of the client area of the control. 이 너비가 모든 채우기 모드 열의 결합 된 MinimumWidth 값 보다 작으면 가로 스크롤 막대가 표시 되 고 모든 채우기 모드 열이 최소 너비와 함께 표시 되며 사용자 열 크기 조정을 사용할 수 없습니다.If this width is smaller than the combined MinimumWidth values of all fill-mode columns, the horizontal scroll bar is displayed, all fill-mode columns are shown with their minimum widths, and user column-resizing is disabled. 열 채우기 모드에 대 한 자세한 내용은 Windows Forms DataGridView 컨트롤의 열 채우기 모드를 참조 하세요.For more information about column fill mode, see Column Fill Mode in the Windows Forms DataGridView Control.

None를 제외 하 고 InheritedAutoSizeMode 속성이 다른 값으로 설정 된 경우 해당 열은 해당 셀 값이 잘리지 않고 완전히 표시 되도록 너비를 관리 합니다.When the InheritedAutoSizeMode property is set to any other value except None, the column will manage its width so that its cell values are fully displayed without clipping. 내용 기반 크기 조정 모드에서 크기 조정은 셀 내용이 변경 될 때마다 또는 행 높이가 변경 될 때마다 WrapMode 사용 하도록 설정 된 경우에 발생 합니다.In content-based sizing modes, size adjustments occur whenever cell contents change or, if WrapMode is enabled, whenever row heights change. 일부 콘텐츠 기반 크기 조정 모드 성능을 높이기 위해 크기 조정 하면 현재 표시 된 행을 제한할 수 있습니다.Some content-based sizing modes let you limit the size adjustment to the currently displayed rows in order to increase performance.

Visible 속성 값이 true 인 열만 크기가 조정 되 고 열의 표시 유형을 변경 해도 크기 조정을 발생 시 키 지 않습니다.Only columns with a Visible property value of true are resized, and changing the visibility of a column does not cause resizing to occur. 또한 자동으로 크기를 조정 하려면 열을 설정 하는 경우 사용자는 마우스를 사용 하 여 열 너비를 조정할 수 없습니다.Additionally, when columns are set to automatically resize, the user cannot adjust the column widths with the mouse.

열 너비를 프로그래밍 방식으로 조정 하려면 DataGridView 컨트롤의 AutoResizeColumn 또는 AutoResizeColumns 메서드를 사용 하거나 열 Width 속성을 설정 합니다.To adjust column widths programmatically, use the DataGridView control's AutoResizeColumn or AutoResizeColumns methods or set the column Width property.

내용 기반 자동 크기 조정에 대 한 자세한 내용은 Windows Forms DataGridView 컨트롤의 크기 조정 옵션을 참조 하세요.For more information about content-based automatic sizing, see Sizing Options in the Windows Forms DataGridView Control.

적용 대상

추가 정보