DataGrid.RowDetailsTemplate Propriété

Définition

Obtient ou définit le modèle utilisé pour afficher les détails des lignes.Gets or sets the template that is used to display the row details.

public:
 property System::Windows::DataTemplate ^ RowDetailsTemplate { System::Windows::DataTemplate ^ get(); void set(System::Windows::DataTemplate ^ value); };
public System.Windows.DataTemplate RowDetailsTemplate { get; set; }
member this.RowDetailsTemplate : System.Windows.DataTemplate with get, set
Public Property RowDetailsTemplate As DataTemplate

Valeur de propriété

DataTemplate

Modèle utilisé pour afficher les détails des lignes.The template that is used to display the row details. La valeur par défaut enregistrée est null.The registered default is null. Pour plus d'informations sur ce qui peut influencer la valeur, consultez DependencyProperty.For more information about what can influence the value, see DependencyProperty.

Exemples

L’exemple suivant montre un DataGrid avec un RowDetailsTemplate défini inline.The following example shows a DataGrid with a RowDetailsTemplate defined inline. Le DataGrid affiche trois valeurs dans chaque ligne et trois valeurs supplémentaires dans la section des détails lorsque la ligne est sélectionnée.The DataGrid displays three values in each row and three more values in the details section when the row is selected. Cet exemple fait partie d’un exemple plus complet disponible dans la rubrique Comment : ajouter des détails de ligne à un contrôle DataGrid .This example is part of a larger example available in the How to: Add Row Details to a DataGrid Control topic.

<Window x:Class="WpfApplication1.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="MainWindow" Height="350" Width="525" 
        Loaded="Window_Loaded">
    <Grid>
        <DataGrid Name="dataGrid1" IsReadOnly="True" AutoGenerateColumns="False" >
            <DataGrid.Columns>
                <DataGridTextColumn Header="Company Name" Binding="{Binding CompanyName}"></DataGridTextColumn>
                <DataGridTextColumn Header="Contact First Name" Binding="{Binding FirstName}"></DataGridTextColumn>
                <DataGridTextColumn Header="Contact Last Name" Binding="{Binding LastName}"></DataGridTextColumn>
            </DataGrid.Columns>
            <DataGrid.RowDetailsTemplate>
                <DataTemplate>
                    <Border BorderThickness="0" Background="BlanchedAlmond" Padding="10">
                        <StackPanel Orientation="Vertical">
                            <StackPanel Orientation="Horizontal">
                                <TextBlock FontSize="12" Text="Email: " VerticalAlignment="Center" />
                                <TextBlock FontSize="16" Foreground="MidnightBlue" Text="{Binding EmailAddress}" VerticalAlignment="Center" />
                            </StackPanel>
                            <StackPanel Orientation="Horizontal">
                                <TextBlock FontSize="12" Text="Phone: " VerticalAlignment="Center" />
                                <TextBlock FontSize="16" Foreground="MidnightBlue" Text="{Binding Phone}" VerticalAlignment="Center" />
                            </StackPanel>
                            <StackPanel Orientation="Horizontal">
                                <TextBlock FontSize="12" Text="Sales Person: " VerticalAlignment="Center" />
                                <TextBlock FontSize="16" Foreground="MidnightBlue" Text="{Binding SalesPerson}" VerticalAlignment="Center" />
                            </StackPanel>
                        </StackPanel>
                    </Border>
                </DataTemplate>
            </DataGrid.RowDetailsTemplate>
        </DataGrid>
    </Grid>
</Window>

Remarques

Vous pouvez personnaliser la présentation des données dans la DataGrid section en ajoutant une ligne de détails.You can customize the data presentation in the DataGrid by adding a row details section. L’ajout d’une section de détails de ligne vous permet de regrouper des données dans un modèle qui est éventuellement visible ou réduit.Adding a row details section enables you to group some data in a template that is optionally visible or collapsed.

Vous définissez le modèle de détails de ligne en tant que XAML inline ou en tant que ressource.You define the row details template as either inline XAML or as a resource. Un modèle de données qui est ajouté en tant que ressource peut être utilisé dans tout le projet sans recréer le modèle.A data template that is added as a resource can be used throughout the project without re-creating the template. Un modèle de données ajouté en tant que code XAML inline est uniquement accessible à partir du contrôle dans lequel il est défini.A data template that is added as inline XAML is only accessible from the control where it is defined.

Vous pouvez modifier le RowDetailsTemplate avant qu’il ne soit affiché en gérant l' LoadingRowDetails événement.You can modify the RowDetailsTemplate before it is displayed by handling the LoadingRowDetails event. Vous devez gérer l' UnloadingRowDetails événement pour annuler les modifications apportées lors du chargement des détails de la ligne.You should handle the UnloadingRowDetails event to undo changes that are made while loading the row details.

S’applique à

Voir aussi