DataGridViewColumn.FillWeight Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia wartość reprezentującą szerokość kolumny, gdy jest ona w trybie wypełniania względem szerokości innych kolumn trybu wypełnienia w kontrolce.

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

Wartość właściwości

Single

Reprezentująca Single szerokość kolumny, gdy jest ona w trybie wypełnienia względem szerokości innych kolumn trybu wypełnienia. Wartość domyślna to 100.

Wyjątki

ArgumentOutOfRangeException

Określona wartość podczas ustawiania tej właściwości jest mniejsza lub równa 0.

Przykłady

Poniższy przykład kodu ilustruje użycie tej właściwości. Ten przykład jest częścią większego przykładu dostępnego w temacie Instrukcje: ustawianie trybów określania rozmiaru kontrolki Windows Forms DataGridView.

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

Uwagi

InheritedAutoSizeMode Gdy wartość właściwości to Fill, kolumna jest zmieniana wraz z innymi kolumnami w tym trybie, aby wszystkie widoczne kolumny w kontrolce dokładnie wypełniały poziomą szerokość dostępnego obszaru wyświetlania. Wszystkie kolumny trybu wypełnienia w kontrolce dzielą dostępne miejsce w proporcjach określonych przez ich FillWeight wartości właściwości. Aby uzyskać więcej informacji na temat trybu wypełniania kolumn, zobacz Tryb wypełniania kolumn w kontrolce DataGridView Windows Forms.

Maksymalna suma FillWeight wartości dla wszystkich kolumn w kontrolce DataGridView wynosi 65535.

Dotyczy

Zobacz też