DataGrid.FrozenColumnCount Свойство

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

Получает или задает количество непрокручиваемых столбцов.

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

Значение свойства

Int32

Число непрокручиваемых столбцов. Зарегистрированный по умолчанию — 0. Дополнительные сведения о факторах, которые влияют на данное значение, см. в описании объекта DependencyProperty.

Примеры

В следующем примере показано, как сделать столбец замороженным при выборе ContextMenuпараметра "Закрепить столбец". Столбцы перемещаются слева, чтобы включить их в замороженные столбцы.

<!--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

Комментарии

Замороженные столбцы — это столбцы, которые всегда отображаются и не могут быть прокручены вне видимости. Замороженные столбцы всегда являются крайними левыми столбцами в порядке отображения. Вы не можете перетащить замороженные столбцы в группу неоцененных столбцов или перетащить столбцы unfrozen в группу замороженных столбцов.

Чтобы закрепить столбцы, задайте FrozenColumnCount свойство. Крайние левые столбцы, указанные числом, FrozenColumnCount будут заморожены. Например, если задать значение FrozenColumnCount 2, два левых столбца на экране заморожены. Чтобы определить, является ли столбец уже замороженным, проверьте IsFrozen свойство в свойстве DataGridColumn.

См. также раздел

• IsFrozen
• DataGridColumn