DataGrid.FrozenColumnCount Propriedade

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtém ou define o número de colunas que não rolam.

public:
 property int FrozenColumnCount { int get(); void set(int value); };

public int FrozenColumnCount { get; set; }

member this.FrozenColumnCount : int with get, set

Public Property FrozenColumnCount As Integer

Valor da propriedade

Int32

O número de colunas que não rolam. O padrão registrado é 0. Para obter mais informações sobre o que pode influenciar o valor, consulte DependencyProperty.

Exemplos

O exemplo a seguir mostra como tornar uma coluna congelada quando "Congelar Coluna" é selecionado na ContextMenu. As colunas são movidas para a esquerda para serem incluídas nas colunas congeladas.

<!--Defines the handlers for when the FreezeColumnCommand is executed-->
<Window.CommandBindings>
    <CommandBinding Command="{x:Static local:Window1.FreezeColumnCommand}" Executed="CommandBinding_Executed" />
</Window.CommandBindings>
<!--Defines the context menu for the ColumnHeaders and attaches the FreezeColumnCommand-->
<Window.Resources>
    <ContextMenu x:Key="ColumnHeaderMenu" IsEnabled="True"  >
        <MenuItem Header="Freeze Column" IsEnabled="True" Command="{x:Static local:Window1.FreezeColumnCommand}"
                  CommandTarget="{Binding RelativeSource={RelativeSource AncestorType=Popup}, Path=PlacementTarget}" 
                  CommandParameter="{Binding ElementName=DG1, Path=CurrentColumn.DisplayIndex}" />
    </ContextMenu>
</Window.Resources>

<Grid>
    <!--Creates a new DataGrid with a context menu for the column headers-->
    <DataGrid Name="DG1" ItemsSource="{Binding}"  >
        <DataGrid.ColumnHeaderStyle >
            <Style TargetType="DataGridColumnHeader">
                <Setter Property="ContextMenu" Value="{StaticResource ColumnHeaderMenu}" />
            </Style>
        </DataGrid.ColumnHeaderStyle>
    </DataGrid>
</Grid>

public partial class Window1 : Window
{
    
    public static RoutedUICommand FreezeColumnCommand = new RoutedUICommand();

    public Window1()
    {
        InitializeComponent();
        //GetData connects to the database and returns the data in a table.
        AdventureWorksLT2008DataSet.SalesOrderDetailDataTable dt = GetData();

        DG1.DataContext = dt;
    }

Class Window1
    Public Shared FreezeColumnCommand As New RoutedUICommand()

    Public Sub New()
        InitializeComponent()

        'GetData connects to the database and returns the data in a table.
        Dim dt As AdventureWorksLT2008DataSet.SalesOrderDetailDataTable = GetData()

        DG1.DataContext = dt
    End Sub

    private void CommandBinding_Executed(object sender, ExecutedRoutedEventArgs e)
    {
       //Get the column header that started the command and move that column left to freeze it.
       System.Windows.Controls.Primitives.DataGridColumnHeader header = (System.Windows.Controls.Primitives.DataGridColumnHeader)e.OriginalSource;
       if (header.Column.IsFrozen ==true)
       {
           return;
       }
       else
       {
           header.Column.DisplayIndex = DG1.FrozenColumnCount;
           DG1.FrozenColumnCount++;
       }
    }
}

Private Sub CommandBinding_Executed(ByVal sender As Object, ByVal e As ExecutedRoutedEventArgs)
    'Get the column header that started the command and move that column left to freeze it.
    Dim header As System.Windows.Controls.Primitives.DataGridColumnHeader = DirectCast(e.OriginalSource, System.Windows.Controls.Primitives.DataGridColumnHeader)
    If header.Column.IsFrozen = True Then
        Exit Sub
    Else
        header.Column.DisplayIndex = DG1.FrozenColumnCount
        DG1.FrozenColumnCount += 1


    End If
End Sub

Comentários

As colunas congeladas são colunas que são sempre exibidas e não podem ser roladas para fora da visibilidade. As colunas congeladas são sempre as colunas mais à esquerda na ordem de exibição. Não é possível arrastar colunas congeladas para o grupo de colunas descongeladas ou arrastar colunas descongeladas para o grupo de colunas congeladas.

Para congelar colunas, defina a FrozenColumnCount propriedade. As colunas mais à esquerda especificadas pelo FrozenColumnCount número ficarão congeladas. Por exemplo, se você definir como FrozenColumnCount 2, as duas colunas esquerdas na exibição serão congeladas. Para determinar se uma coluna já está congelada, verifique a IsFrozen propriedade no DataGridColumn.

Confira também

• IsFrozen
• DataGridColumn