DataGridViewColumn.FillWeight Eigenschaft

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

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

Single

Ein Single, der die Breite der Spalte im Füllmodus relativ zur Breite anderer Spalten im Füllmodus darstellt. Der Standardwert ist 100.

Ausnahmen

ArgumentOutOfRangeException

Der beim Festlegen dieser Eigenschaft angegebene Wert ist kleiner oder gleich 0 (null).

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieser Eigenschaft veranschaulicht. Dieses Beispiel ist Teil eines größeren Beispiels, das unter Gewusst wie: Festlegen der Größenmodi des Windows Forms DataGridView-Steuerelements verfügbar ist.

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 Eigenschaftswert ist Fill, 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 Anzeigebereichs ausfüllen. Alle Füllmodusspalten im Steuerelement teilen den verfügbaren Raum in Proportionen, die durch ihre FillWeight Eigenschaftswerte bestimmt werden. Weitere Informationen zum Spaltenfüllmodus finden Sie unter Spaltenfüllmodus im Windows Forms DataGridView-Steuerelement.

Die maximale Summe der FillWeight Werte für alle Spalten in einem DataGridView Steuerelement ist 65535.

Gilt für:

Freigeben über