DataGridViewColumn.FillWeight Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define um valor que representa a largura da coluna quando esta está em modo de preenchimento relativamente às larguras de outras colunas em modo de preenchimento no controlo.
public:
property float FillWeight { float get(); void set(float value); };public float FillWeight { get; set; }member this.FillWeight : single with get, setPublic Property FillWeight As SingleValor de Propriedade
A Single representa a largura da coluna quando está em modo de preenchimento relativamente às larguras de outras colunas em modo de preenchimento. O padrão é 100.
Exceções
O valor especificado ao definir esta propriedade é menor ou igual a 0.
Exemplos
O seguinte exemplo de código ilustra a utilização desta propriedade. Este exemplo faz parte de um exemplo mais amplo disponível em Como: Definir os Modos de Dimensionamento do Windows Forms Controlo 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
Observações
Quando o valor da InheritedAutoSizeMode propriedade é Fill, a coluna é redimensionada juntamente com outras colunas nesse modo, de modo que todas as colunas visíveis no controlo preencham exatamente a largura horizontal da área de exibição disponível. Todas as colunas de preenchimento no controlo dividem o espaço disponível em proporções determinadas pelos seus FillWeight valores de propriedade. Para mais informações sobre o modo de preenchimento de colunas, consulte Modo de Preenchimento de Coluna no Windows Forms Controlo DataGridView.
A soma máxima de FillWeight valores para todas as colunas num DataGridView controlo é 65535.