DataGridViewColumn.FillWeight Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define um valor que representa a largura da coluna quando ela está no modo de preenchimento em relação à largura das outras colunas de modo de preenchimento no controle.

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

Valor da propriedade

Single

Um Single que representa a largura da coluna quando ela está no modo de preenchimento em relação à largura das outras colunas de modo de preenchimento. O padrão é 100.

Exceções

ArgumentOutOfRangeException

O valor especificado ao definir essa propriedade é menor ou igual a 0.

Exemplos

O exemplo de código a seguir ilustra o uso dessa propriedade. Este exemplo faz parte de um exemplo maior disponível em 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

Comentários

Quando o valor da InheritedAutoSizeMode propriedade é Fill, a coluna é redimensionada junto com outras colunas nesse modo para que todas as colunas visíveis no controle preencham exatamente a largura horizontal da área de exibição disponível. Todas as colunas de modo de preenchimento no controle dividem o espaço disponível em proporções determinadas por seus FillWeight valores de propriedade. Para obter mais informações sobre o modo de preenchimento de coluna, consulte o Modo de Preenchimento de Coluna no controle Windows Forms DataGridView.

A soma máxima de FillWeight valores para todas as colunas em um DataGridView controle é 65535.

Aplica-se a

Confira também