DataGridViewColumn.FillWeight Eigenschaft

Definition

Ruft einen Wert ab, der die Breite der Spalte im Füllmodus relativ zur Breite anderer im Steuerelement vorhandener Spalten im Füllmodus darstellt, oder legt diesen Wert fest.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

Eigenschaftswert

Ein Single, der die Breite der Spalte im Füllmodus relativ zur Breite anderer Spalten im Füllmodus darstellt.A Single representing the width of the column when it is in fill mode relative to the widths of other fill-mode columns. Der Standardwert ist 100.The default is 100.

Ausnahmen

Der beim Festlegen dieser Eigenschaft angegebene Wert ist kleiner oder gleich 0 (null).The specified value when setting this property is less than or equal to 0.

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft veranschaulicht.The following code example illustrates the use of this property. Dieses Beispiel ist Teil eines größeren Beispiels, das in Gewusst wie: Festlegen der Größen Anpassungs Modi des Windows Forms DataGridView-SteuerElements verfügbar ist.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

Hinweise

Wenn der InheritedAutoSizeMode-Eigenschafts Wert Fillist, wird die Größe der Spalte zusammen mit anderen Spalten in diesem Modus geändert, sodass alle sichtbaren Spalten im-Steuerelement genau die horizontale Breite des verfügbaren Anzeige Bereichs ausfüllen.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. Alle Spalten im Füllmodus im Steuerelement dividieren den verfügbaren Platz in Proportionen, die durch ihre FillWeight Eigenschaftswerte bestimmt werden.All fill-mode columns in the control divide the available space in proportions determined by their FillWeight property values. Weitere Informationen zum Spalten Füll Modus finden Sie unter Spalten Füll Modus im Windows Forms DataGridView-SteuerElement.For more information about column fill mode, see Column Fill Mode in the Windows Forms DataGridView Control.

Die maximale Summe der FillWeight Werte für alle Spalten in einem DataGridView-Steuerelement ist 65535.The maximum sum of FillWeight values for all columns in a DataGridView control is 65535.

Gilt für:

Siehe auch