DataGridView.AutoSizeColumnsMode DataGridView.AutoSizeColumnsMode DataGridView.AutoSizeColumnsMode DataGridView.AutoSizeColumnsMode Property

정의

열 너비의 결정 방식을 지정하는 값을 가져오거나 설정합니다.Gets or sets a value indicating how column widths are determined.

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

속성 값

예외

이 속성을 설정할 때 지정된 값이 유효한 DataGridViewAutoSizeColumnsMode 값이 아닙니다.The specified value when setting this property is not a valid DataGridViewAutoSizeColumnsMode value.

이 속성을 설정할 때 지정된 값이 ColumnHeader이고, 열 머리글이 숨겨져 있고, 표시된 하나 이상의 열이 AutoSizeMode 속성 값 NotSet을 갖습니다.The specified value when setting this property is ColumnHeader, column headers are hidden, and at least one visible column has an AutoSizeMode property value of NotSet.

또는-or- 이 속성을 설정할 때 지정된 값이 Fill이고 AutoSizeMode 속성 값 NotSet을 갖는 표시된 하나 이상의 열이 고정되어 있습니다.The specified value when setting this property is Fill and at least one visible column with an AutoSizeMode property value of NotSet is frozen.

예제

다음 코드 예제에 있는 마스터-세부 시나리오에서이 속성을 사용 하는 방법을 보여 줍니다 DataGridView 컨트롤이 부모/자식 관계에서 두 테이블에서 데이터를 표시 합니다.The following code example illustrates how to use this property in a master/detail scenario where two DataGridView controls display data from two tables in a parent/child relationship. 이 예제에서 마스터 컨트롤에 대 한 열 크기 조정 모드는 None, 하 고 열 너비 로드 된 값에 맞게 프로그래밍 방식으로 초기화 됩니다.In this example, the column sizing mode for the master control is None, and the column widths are programmatically initialized to fit the loaded values. 세부 컨트롤 (예를 들어 사용자가 변경할 때 부모 테이블의 현재 행) 값이 변경 될 때마다 열이 자동으로 조정 되도록 열 자동 크기 조정 모드로 설정 됩니다.The details control is set to an automatic column sizing mode so that columns will adjust automatically whenever the values change (for example, when the user changes the current row in the parent table). 이 예제는에서 사용할 수 있는 보다 큰 예제의 일부 방법:는 마스터/세부 폼 사용 하 여 두 개의 Windows Forms DataGridView 컨트롤 만들기합니다.This example is part of a larger example available in How to: Create a Master/Detail Form Using Two Windows Forms DataGridView Controls.

private void Form1_Load(object sender, System.EventArgs e)
{
    // Bind the DataGridView controls to the BindingSource
    // components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource;
    detailsDataGridView.DataSource = detailsBindingSource;
    GetData();

    // Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns();

    // Configure the details DataGridView so that its columns automatically
    // adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = 
        DataGridViewAutoSizeColumnsMode.AllCells;
}
Private Sub Form1_Load(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Load

    ' Bind the DataGridView controls to the BindingSource
    ' components and load the data from the database.
    masterDataGridView.DataSource = masterBindingSource
    detailsDataGridView.DataSource = detailsBindingSource
    GetData()

    ' Resize the master DataGridView columns to fit the newly loaded data.
    masterDataGridView.AutoResizeColumns()

    ' Configure the details DataGridView so that its columns automatically
    ' adjust their widths when the data changes.
    detailsDataGridView.AutoSizeColumnsMode = _
        DataGridViewAutoSizeColumnsMode.AllCells

End Sub

설명

이 속성에는 컨트롤을 입력 하거나 셀 내용에 맞도록 열 너비가 자동으로 조정 됩니다 있도록 컨트롤을 구성할 수 있습니다.This property lets you configure the control so that column widths are automatically adjusted either to fill the control or to fit cell contents. 컨트롤의 너비 변경 될 때마다 크기 조정 채우기 모드에 발생 합니다.Size adjustments occur in fill mode whenever the width of the control changes. 콘텐츠 기반 크기 조정 모드에서는 크기 조정 셀 내용이 변경 될 때마다 또는 경우에 발생할 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.

개별 열에 대 한 크기 조정 모드를 변경 하려면 설정 해당 AutoSizeMode 속성입니다.To change the sizing mode for an individual column, set its AutoSizeMode property. 이 속성의 기본값은 NotSet, 해당 동작을 상속 하는 열을 나타내는 고 InheritedAutoSizeMode 컨트롤에서 속성 값입니다.The default value of this property is NotSet, indicating that the column inherits its behavior and its InheritedAutoSizeMode property value from the control.

채우기 모드에서 열 분할 하 여 지정 된 비율로에서 사용할 수 있는 컨트롤 너비를 해당 FillWeight 속성 값입니다.Columns in fill mode divide the available control width in proportions indicated 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.

열만을 Visible 속성 값의 true 자동으로 크기가 조정 됩니다 열의 표시 유형을 변경 해도 크기 조정이 발생 하지 않습니다.Only columns with a Visible property value of true are resized automatically, 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.

열 너비를 프로그래밍 방식으로 조정 하려면 사용 합니다 AutoResizeColumn 또는 AutoResizeColumns 메서드 또는 열 집합 Width 속성입니다.To adjust column widths programmatically, use the 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.

적용 대상

추가 정보