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.

Исключения

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

Комментарии

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

Применяется к

Дополнительно