DataGridViewColumn.Frozen Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se uma coluna será movida quando um usuário rolar o controle DataGridView horizontalmente.
public:
virtual property bool Frozen { bool get(); void set(bool value); };
public override bool Frozen { get; set; }
member this.Frozen : bool with get, set
Public Overrides Property Frozen As Boolean
Valor da propriedade
true
para congelar a coluna; caso contrário, false
.
Exemplos
O exemplo de código a seguir demonstra como usar a DataGridViewBand.Frozen propriedade, que é quase idêntica à Frozen propriedade da DataGridViewColumn classe. Este exemplo de código faz parte de um exemplo maior fornecido para a DataGridViewBand classe.
// Freeze the first row.
void Button4_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
FreezeBand( dataGridView->Rows[ 0 ] );
}
void Button5_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
FreezeBand( dataGridView->Columns[ 1 ] );
}
void FreezeBand( DataGridViewBand^ band )
{
band->Frozen = true;
DataGridViewCellStyle^ style = gcnew DataGridViewCellStyle;
style->BackColor = Color::WhiteSmoke;
band->DefaultCellStyle = style;
}
// Freeze the first row.
private void Button4_Click(object sender, System.EventArgs e)
{
FreezeBand(dataGridView.Rows[0]);
}
private void Button5_Click(object sender, System.EventArgs e)
{
FreezeBand(dataGridView.Columns[1]);
}
private static void FreezeBand(DataGridViewBand band)
{
band.Frozen = true;
DataGridViewCellStyle style = new DataGridViewCellStyle();
style.BackColor = Color.WhiteSmoke;
band.DefaultCellStyle = style;
}
' Freeze the first row.
Private Sub Button4_Click(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button4.Click
FreezeBand(dataGridView.Rows(0))
End Sub
Private Sub FreezeColumn(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles Button5.Click
FreezeBand(dataGridView.Columns(1))
End Sub
Private Shared Sub FreezeBand(ByVal band As DataGridViewBand)
band.Frozen = True
Dim style As DataGridViewCellStyle = New DataGridViewCellStyle()
style.BackColor = Color.WhiteSmoke
band.DefaultCellStyle = style
End Sub
Comentários
Quando uma coluna é congelada, todas as colunas à esquerda (ou à direita em idiomas da direita para a esquerda) também são congeladas. As colunas congeladas e descongeladas formam dois grupos. Se o repositório de colunas estiver habilitado definindo a AllowUserToOrderColumns propriedade como true
, o usuário não poderá arrastar uma coluna de um grupo para o outro.