DataGridTemplateColumn Classe

Definizione

Spazio dei nomi:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta una DataGrid colonna che ospita il contenuto specificato dal modello nelle relative celle.

public ref class DataGridTemplateColumn : System::Windows::Controls::DataGridColumn

public class DataGridTemplateColumn : System.Windows.Controls.DataGridColumn

type DataGridTemplateColumn = class
    inherit DataGridColumn

Public Class DataGridTemplateColumn
Inherits DataGridColumn

Ereditarietà: Object

DispatcherObject

DependencyObject

DataGridColumn
DataGridTemplateColumn

Esempio

Nell'esempio seguente viene illustrato come creare un oggetto DataGridTemplateColumn.

<Grid>
    <Grid.Resources>
        <!--DataTemplate for Published Date column defined in Grid.Resources.  PublishDate is a property on the ItemsSource of type DateTime -->
        <DataTemplate x:Key="DateTemplate" >
            <StackPanel Width="20" Height="30">
                <Border Background="LightBlue" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:MMM}}" FontSize="8" HorizontalAlignment="Center" />
                </Border>
                <Border Background="White" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:yyyy}}" FontSize="8" FontWeight="Bold" HorizontalAlignment="Center" />
                </Border>
            </StackPanel>
        </DataTemplate>
        <!--DataTemplate for the Published Date column when in edit mode. -->
        <DataTemplate x:Key="EditingDateTemplate">
            <DatePicker SelectedDate="{Binding PublishDate}"  />
        </DataTemplate>
    </Grid.Resources>
    <DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
        <DataGrid.Columns>
            <!--Custom column that shows the published date-->
            <DataGridTemplateColumn Header="Publish Date" CellTemplate="{StaticResource DateTemplate}" CellEditingTemplate="{StaticResource EditingDateTemplate}" />
        </DataGrid.Columns>
    </DataGrid>
</Grid>

La figura seguente mostra l'output del codice XAML precedente.

Una colonna che usa un oggetto DataTemplate Una colonna

Commenti

Il DataGridTemplateColumn tipo consente di creare tipi di colonna personalizzati specificando i modelli di cella da usare durante la visualizzazione e la modifica dei valori. Per specificare il modello utilizzato per visualizzare il contenuto di una cella che non è in modalità di modifica, impostare la CellTemplate proprietà . Per specificare il modello utilizzato per visualizzare il contenuto di una cella in modalità di modifica, impostare la CellEditingTemplate proprietà . Per altre informazioni sui modelli, vedere Panoramica sulla creazione di modelli di dati e Applicazione di stili e modelli.

Per praticità, DataGrid fornisce i tipi di colonna predefiniti seguenti:

Tipo di colonna	Visualizzazione dati
DataGridHyperlinkColumn	Usare per visualizzare i dati URI.
DataGridComboBoxColumn	Utilizzare per visualizzare i dati di enumerazione.
DataGridTextColumn	Usare per visualizzare il testo.
DataGridCheckBoxColumn	Utilizzare per visualizzare i dati booleani.

Costruttori

Nome	Descrizione
DataGridTemplateColumn()	Inizializza una nuova istanza della classe DataGridTemplateColumn.

Campi

Nome	Descrizione
CellEditingTemplateProperty	Identifica la CellEditingTemplate proprietà di dipendenza.
CellEditingTemplateSelectorProperty	Identifica la CellEditingTemplateSelector proprietà di dipendenza.
CellTemplateProperty	Identifica la CellTemplate proprietà di dipendenza.
CellTemplateSelectorProperty	Identifica la CellEditingTemplateSelector proprietà di dipendenza.

Proprietà

Nome	Descrizione
ActualWidth	Ottiene la larghezza corrente della colonna, in unità indipendenti dal dispositivo (1/96 pollici per unità). (Ereditato da DataGridColumn)
CanUserReorder	Ottiene o imposta un valore che indica se l'utente può modificare la posizione di visualizzazione della colonna trascinando l'intestazione di colonna. (Ereditato da DataGridColumn)
CanUserResize	Ottiene o imposta un valore che indica se l'utente può regolare la larghezza della colonna utilizzando il mouse. (Ereditato da DataGridColumn)
CanUserSort	Ottiene o imposta un valore che indica se l'utente può ordinare la colonna facendo clic sull'intestazione di colonna. (Ereditato da DataGridColumn)
CellEditingTemplate	Ottiene o imposta il modello da utilizzare per visualizzare il contenuto di una cella in modalità di modifica.
CellEditingTemplateSelector	Ottiene o imposta l'oggetto che determina il modello da utilizzare per visualizzare il contenuto di una cella in modalità di modifica.
CellStyle	Ottiene o imposta lo stile utilizzato per il rendering delle celle nella colonna. (Ereditato da DataGridColumn)
CellTemplate	Ottiene o imposta il modello da utilizzare per visualizzare il contenuto di una cella che non è in modalità di modifica.
CellTemplateSelector	Ottiene o imposta l'oggetto che determina il modello da utilizzare per visualizzare il contenuto di una cella che non è in modalità di modifica.
ClipboardContentBinding	Ottiene o imposta l'oggetto di associazione da utilizzare per ottenere o impostare il contenuto della cella per gli Appunti. (Ereditato da DataGridColumn)
DataGridOwner	Ottiene il DataGrid controllo che contiene questa colonna. (Ereditato da DataGridColumn)
DependencyObjectType	Ottiene l'oggetto DependencyObjectType che esegue il wrapping del tipo CLR di questa istanza. (Ereditato da DependencyObject)
Dispatcher	Ottiene l'oggetto Dispatcher DispatcherObject a cui è associato. (Ereditato da DispatcherObject)
DisplayIndex	Ottiene o imposta la posizione di visualizzazione della colonna rispetto alle altre colonne dell'oggetto DataGrid. (Ereditato da DataGridColumn)
DragIndicatorStyle	Ottiene o imposta l'oggetto stile da applicare all'intestazione di colonna durante un'operazione di trascinamento. (Ereditato da DataGridColumn)
Header	Ottiene o imposta il contenuto dell'intestazione di colonna. (Ereditato da DataGridColumn)
HeaderStringFormat	Ottiene o imposta il modello di formato da applicare al contenuto dell'intestazione di colonna. (Ereditato da DataGridColumn)
HeaderStyle	Ottiene o imposta lo stile utilizzato per il rendering dell'intestazione di colonna. (Ereditato da DataGridColumn)
HeaderTemplate	Ottiene o imposta il modello che definisce la rappresentazione visiva dell'intestazione di colonna. (Ereditato da DataGridColumn)
HeaderTemplateSelector	Ottiene o imposta l'oggetto che seleziona il modello da utilizzare per l'intestazione di colonna. (Ereditato da DataGridColumn)
IsAutoGenerated	Ottiene un valore che indica se la colonna viene generata automaticamente. (Ereditato da DataGridColumn)
IsFrozen	Ottiene un valore che indica se la colonna non può scorrere orizzontalmente. (Ereditato da DataGridColumn)
IsReadOnly	Ottiene o imposta un valore che indica se è possibile modificare le celle della colonna. (Ereditato da DataGridColumn)
IsSealed	Ottiene un valore che indica se questa istanza è attualmente sealed (sola lettura). (Ereditato da DependencyObject)
MaxWidth	Ottiene o imposta il vincolo di larghezza massima della colonna. (Ereditato da DataGridColumn)
MinWidth	Ottiene o imposta il vincolo di larghezza minima della colonna. (Ereditato da DataGridColumn)
SortDirection	Ottiene o imposta la direzione di ordinamento (crescente o decrescente) della colonna. (Ereditato da DataGridColumn)
SortMemberPath	Ottiene o imposta un nome di proprietà o una gerarchia delimitata da punti di nomi di proprietà, che indica il membro da ordinare. (Ereditato da DataGridColumn)
Visibility	Ottiene o imposta la visibilità della colonna. (Ereditato da DataGridColumn)
Width	Ottiene o imposta la larghezza della colonna o la modalità di ridimensionamento automatico. (Ereditato da DataGridColumn)

Metodi

Nome	Descrizione
CancelCellEdit(FrameworkElement, Object)	Fa sì che la cella venga modificata ripristinando il valore originale non modificato. (Ereditato da DataGridColumn)
CheckAccess()	Determina se il thread chiamante ha accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject)
ClearValue(DependencyProperty)	Cancella il valore locale di una proprietà. La proprietà da cancellare viene specificata da un DependencyProperty identificatore. (Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)	Cancella il valore locale di una proprietà di sola lettura. La proprietà da cancellare viene specificata da un oggetto DependencyPropertyKey. (Ereditato da DependencyObject)
CoerceValue(DependencyProperty)	Forza il valore della proprietà di dipendenza specificata. A tale scopo, richiamare qualsiasi CoerceValueCallback funzione specificata nei metadati della proprietà per la proprietà di dipendenza così come esiste nella chiamata DependencyObjectdi . (Ereditato da DependencyObject)
CommitCellEdit(FrameworkElement)	Esegue qualsiasi convalida necessaria prima di uscire dalla modalità di modifica delle celle. (Ereditato da DataGridColumn)
Equals(Object)	Determina se un oggetto specificato DependencyObject è equivalente all'oggetto corrente DependencyObject. (Ereditato da DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Ottiene un elemento definito dall'oggetto CellEditingTemplate associato al valore della proprietà della Binding colonna.
GenerateElement(DataGridCell, Object)	Ottiene un elemento definito dall'oggetto CellTemplate associato al valore della proprietà della Binding colonna.
GetCellContent(DataGridRow)	Recupera il Content valore della proprietà per la cella all'intersezione di questa colonna e della riga specificata. (Ereditato da DataGridColumn)
GetCellContent(Object)	Ottiene il Content valore della proprietà per la cella all'intersezione di questa colonna e la riga che rappresenta l'elemento di dati specificato. (Ereditato da DataGridColumn)
GetHashCode()	Ottiene un codice hash per l'oggetto DependencyObject. (Ereditato da DependencyObject)
GetLocalValueEnumerator()	Crea un enumeratore specializzato per determinare quali proprietà di dipendenza hanno valori impostati localmente in questo DependencyObjectoggetto . (Ereditato da DependencyObject)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetValue(DependencyProperty)	Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di un oggetto DependencyObject. (Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)	Rivaluta il valore effettivo per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
NotifyPropertyChanged(String)	Notifica all'oggetto DataGrid che contiene questa colonna che una proprietà di colonna è stata modificata. (Ereditato da DataGridColumn)
OnCoerceIsReadOnly(Boolean)	Determina il valore della IsReadOnly proprietà in base alle regole delle proprietà dell'oggetto DataGrid che contiene questa colonna. (Ereditato da DataGridColumn)
OnCopyingCellClipboardContent(Object)	Genera l'evento CopyingCellClipboardContent. (Ereditato da DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Genera l'evento PastingCellClipboardContent. (Ereditato da DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Richiamato ogni volta che il valore effettivo di qualsiasi proprietà di dipendenza in questo DependencyObject oggetto è stato aggiornato. La proprietà di dipendenza specifica modificata viene segnalata nei dati dell'evento. (Ereditato da DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Quando sottoposto a override in una classe derivata, imposta il contenuto della cella in base alle esigenze per la modifica. (Ereditato da DataGridColumn)
ReadLocalValue(DependencyProperty)	Restituisce il valore locale di una proprietà di dipendenza, se esistente. (Ereditato da DependencyObject)
RefreshCellContent(FrameworkElement, String)	Aggiorna il contenuto di una cella nella colonna in risposta a una modifica del valore della proprietà del modello.
SetCurrentValue(DependencyProperty, Object)	Imposta il valore di una proprietà di dipendenza senza modificarne l'origine del valore. (Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)	Imposta il valore locale di una proprietà di dipendenza, specificato dall'identificatore della proprietà di dipendenza. (Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)	Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza. (Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore per la proprietà di dipendenza specificata. (Ereditato da DependencyObject)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
VerifyAccess()	Impone che il thread chiamante abbia accesso a questo DispatcherObjectoggetto . (Ereditato da DispatcherObject)

Eventi

Nome	Descrizione
CopyingCellClipboardContent	Si verifica dopo la preparazione del contenuto degli Appunti delle celle. (Ereditato da DataGridColumn)
PastingCellClipboardContent	Si verifica prima che il contenuto degli Appunti venga spostato nella cella. (Ereditato da DataGridColumn)

Si applica a

Vedi anche

DataGrid

Commenti e suggerimenti

Questa pagina è stata utile?