DataGridViewColumn.FillWeight 속성

정의

열이 컨트롤에 있는 다른 채우기 모드 열의 너비에 상대적인 채우기 모드에 있는 경우 열의 너비를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value that represents the width of the column when it is in fill mode relative to the widths of other fill-mode columns in the control.

public:
 property float FillWeight { float get(); void set(float value); };
public float FillWeight { get; set; }
member this.FillWeight : single with get, set
Public Property FillWeight As Single

속성 값

열이 다른 채우기 모드 열의 너비에 상대적인 채우기 모드에 있는 경우 열의 너비를 나타내는 Single입니다.A Single representing the width of the column when it is in fill mode relative to the widths of other fill-mode columns. 기본값은 100입니다.The default is 100.

예외

이 속성을 설정할 때 지정된 값이 0보다 작거나 같은 경우The specified value when setting this property is less than or equal to 0.

예제

다음 코드 예제에서는이 속성의 사용을 보여 줍니다.The following code example illustrates the use of this property. 이 예제는에서 사용할 수 있는 보다 큰 예제의 일부 방법: Windows Forms DataGridView 컨트롤의 크기 조정 모드 설정합니다.This example is part of a larger example available in How to: Set the Sizing Modes of the Windows Forms DataGridView Control.

dataGridView1.AutoSizeColumnsMode =
    DataGridViewAutoSizeColumnsMode.Fill;

DataGridViewTextBoxColumn subTitleColumn =
    new DataGridViewTextBoxColumn();
subTitleColumn.HeaderText = "Subtitle";
subTitleColumn.MinimumWidth = 50;
subTitleColumn.FillWeight = 100;

DataGridViewTextBoxColumn summaryColumn =
    new DataGridViewTextBoxColumn();
summaryColumn.HeaderText = "Summary";
summaryColumn.MinimumWidth = 50;
summaryColumn.FillWeight = 200;

DataGridViewTextBoxColumn contentColumn =
    new DataGridViewTextBoxColumn();
contentColumn.HeaderText = "Content";
contentColumn.MinimumWidth = 50;
contentColumn.FillWeight = 300;
dataGridView1.AutoSizeColumnsMode = _
    DataGridViewAutoSizeColumnsMode.Fill

Dim subTitleColumn As new DataGridViewTextBoxColumn()
subTitleColumn.HeaderText = "Subtitle"
subTitleColumn.MinimumWidth = 50
subTitleColumn.FillWeight = 100

Dim summaryColumn As new DataGridViewTextBoxColumn()
summaryColumn.HeaderText = "Summary"
summaryColumn.MinimumWidth = 50
summaryColumn.FillWeight = 200

Dim contentColumn As new DataGridViewTextBoxColumn()
contentColumn.HeaderText = "Content"
contentColumn.MinimumWidth = 50
contentColumn.FillWeight = 300

설명

경우는 InheritedAutoSizeMode 속성 값이 Fill를 컨트롤에 표시 되는 모든 열에는 정확 하 게 사용 가능한 표시 영역의 가로 너비를 채우도록 열이 모드에서 다른 열과 함께 크기가 조정 됩니다.When the InheritedAutoSizeMode property value is Fill, the column is resized along with other columns in that mode so that all visible columns in the control exactly fill the horizontal width of the available display area. 컨트롤의 모든 채우기 모드 열 분할 사용 가능한 공간 비율에 따른 해당 FillWeight 속성 값입니다.All fill-mode columns in the control divide the available space in proportions determined by their FillWeight property values. 열 채우기 모드에 대 한 자세한 내용은 참조 하세요. Windows Forms DataGridView 컨트롤의 열 채우기 모드합니다.For more information about column fill mode, see Column Fill Mode in the Windows Forms DataGridView Control.

최대 합계 FillWeight 의 모든 열에 대 한 값을 DataGridView 컨트롤은 65535입니다.The maximum sum of FillWeight values for all columns in a DataGridView control is 65535.

적용 대상

추가 정보