DataGridViewColumn.FillWeight Property

Definition

Возвращает или задает значение, представляющее ширину столбца, находящегося в режиме заполнения, относительно ширины других столбцов элемента управления, находящихся в этом режиме.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

Property Value

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.

Exceptions

Указанное значение при задании этого свойства меньше или равно нулю.The specified value when setting this property is less than or equal to 0.

Examples

В следующем примере кода показано использование этого свойства.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

Remarks

Если значение свойства 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.

Applies to

See also