DataGridTemplateColumn Klasse

Referenz

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine DataGrid-Spalte dar, in deren Zellen von Vorlagen angegebene Inhalte gehostet werden.

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

Vererbung: Object

DispatcherObject

DependencyObject

DataGridColumn
DataGridTemplateColumn

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein DataGridTemplateColumn erstellt wird.

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

Die folgende Abbildung zeigt die Ausgabe aus dem vorherigen XAML-Code.

Eine Spalte, die eine DataTemplate

Hinweise

Mit DataGridTemplateColumn dem Typ können Sie eigene Spaltentypen erstellen, indem Sie die Zellenvorlagen angeben, die beim Anzeigen und Bearbeiten von Werten verwendet werden sollen. Legen Sie die -Eigenschaft fest, um die Vorlage anzugeben, die zum Anzeigen des Inhalts einer Zelle verwendet wird, CellTemplate die sich nicht im Bearbeitungsmodus befindet. Um die Vorlage anzugeben, die zum Anzeigen des Inhalts einer Zelle im Bearbeitungsmodus verwendet wird, legen Sie die CellEditingTemplate -Eigenschaft fest. Weitere Informationen zu Vorlagen finden Sie unter Übersicht über Datenvorlagen und Formatieren und Vorlagen.

Stellt zur Vereinfachung DataGrid die folgenden vordefinierten Spaltentypen bereit:

Spaltentyp	Datenanzeige
DataGridHyperlinkColumn	Verwenden Sie zum Anzeigen von URI-Daten.
DataGridComboBoxColumn	Verwenden Sie zum Anzeigen von Enumerationsdaten.
DataGridTextColumn	Verwenden Sie zum Anzeigen von Text.
DataGridCheckBoxColumn	Verwenden Sie zum Anzeigen boolescher Daten.

Konstruktoren

DataGridTemplateColumn()

Initialisiert eine neue Instanz der DataGridTemplateColumn-Klasse.

Felder

CellEditingTemplateProperty	Bezeichnet die CellEditingTemplate-Abhängigkeitseigenschaft.
CellEditingTemplateSelectorProperty	Bezeichnet die CellEditingTemplateSelector-Abhängigkeitseigenschaft.
CellTemplateProperty	Bezeichnet die CellTemplate-Abhängigkeitseigenschaft.
CellTemplateSelectorProperty	Bezeichnet die CellEditingTemplateSelector-Abhängigkeitseigenschaft.

Eigenschaften

ActualWidth	Ruft die aktuelle Breite der Spalte in geräteunabhängigen Einheiten (1/96 Zoll pro Einheit) ab. (Geerbt von DataGridColumn)
CanUserReorder	Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, oder der Benutzer die Anzeigeposition von Spalten durch Ziehen der Spaltenüberschrift ändern kann. (Geerbt von DataGridColumn)
CanUserResize	Ruft einen Wert ab, der angibt, ob der Benutzer die Spaltenbreiten mithilfe der Maus anpassen kann, oder legt diesen fest. (Geerbt von DataGridColumn)
CanUserSort	Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob der Benutzer die Spalte durch Klicken auf die Spaltenüberschrift sortieren kann. (Geerbt von DataGridColumn)
CellEditingTemplate	Ruft die Vorlage ab, die zum Anzeigen des Inhalts einer Zelle verwendet werden soll, die sich im Bearbeitungsmodus befindet, oder legt diese fest.
CellEditingTemplateSelector	Ruft das Objekt ab, das festlegt, welche Vorlage zum Anzeigen der Inhalte einer Zelle im Bearbeitungsmodus verwendet wird, oder legt dieses fest.
CellStyle	Ruft die Formatvorlage ab, die zum Rendern von Zellen in der Spalte verwendet wird, oder legt sie fest. (Geerbt von DataGridColumn)
CellTemplate	Ruft die Vorlage zum Anzeigen der Inhalte einer nicht im Bearbeitungsmodus befindlichen Zelle ab, oder legt diese fest.
CellTemplateSelector	Ruft das Objekt ab, das festlegt, welche Vorlage zum Anzeigen der Inhalte einer nicht im Bearbeitungsmodus befindlichen Zelle verwendet wird, oder legt dieses fest.
ClipboardContentBinding	Ruft das Bindungsobjekt ab, das beim Abrufen oder Festlegen von Zelleninhalt für die Zwischenablage verwendet werden soll, oder legt dieses fest. (Geerbt von DataGridColumn)
DataGridOwner	Ruft das DataGrid-Steuerelement ab, das diese Spalte enthält. (Geerbt von DataGridColumn)
DependencyObjectType	Ruft die ab, die DependencyObjectType den CLR-Typ dieser instance umschließt. (Geerbt von DependencyObject)
Dispatcher	Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
DisplayIndex	Ruft die Anzeigeposition der Spalte relativ zu den anderen Spalten im DataGrid ab oder legt diese fest. (Geerbt von DataGridColumn)
DragIndicatorStyle	Ruft das Formatobjekt ab, das bei einem Ziehvorgang für den Spaltenheader übernommen werden soll, oder legt es fest. (Geerbt von DataGridColumn)
Header	Ruft den Inhalt der Spaltenüberschrift ab bzw. legt diesen fest. (Geerbt von DataGridColumn)
HeaderStringFormat	Ruft das Formatmuster ab, das auf den Inhalt des Spaltenheaders angewendet werden soll, oder legt dieses fest. (Geerbt von DataGridColumn)
HeaderStyle	Ruft den Stil ab, der beim Rendern des Spaltenheaders verwendet wird, oder legt diesen fest. (Geerbt von DataGridColumn)
HeaderTemplate	Ruft die Vorlage ab, die die optische Darstellung des Spaltenheaders festlegt, oder legt diese fest. (Geerbt von DataGridColumn)
HeaderTemplateSelector	Ruft das Objekt ab, das die für den Spaltenheader zu verwendende Vorlage festlegt, oder legt dieses fest. (Geerbt von DataGridColumn)
IsAutoGenerated	Ruft einen Wert ab, der angibt, ob die Spalte automatisch generiert wird. (Geerbt von DataGridColumn)
IsFrozen	Ruft einen Wert ab, der angibt, ob horizontale Bildläufe in der Spalte verhindert werden. (Geerbt von DataGridColumn)
IsReadOnly	Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob Zellen in der Spalte bearbeitet werden können. (Geerbt von DataGridColumn)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist. (Geerbt von DependencyObject)
MaxWidth	Ruft die Einschränkung für die maximale Breite der Spalte ab oder legt diese fest. (Geerbt von DataGridColumn)
MinWidth	Ruft die Einschränkung für die Mindestbreite der Spalte ab oder legt diese fest. (Geerbt von DataGridColumn)
SortDirection	Ruft die Sortierrichtung (auf- oder absteigend) der Spalte ab, oder legt diese fest. (Geerbt von DataGridColumn)
SortMemberPath	Ruft einen Eigenschaftennamen oder eine durch Punkte getrennte Hierarchie von Eigenschaftennamen ab, die das zu sortierende Element angibt, bzw. legt diese/n fest. (Geerbt von DataGridColumn)
Visibility	Ruft die Sichtbarkeit der Spalte ab bzw. legt diese fest. (Geerbt von DataGridColumn)
Width	Ruft die Spaltenbreite oder den Modus zum automatischen Festlegen der Größe ab bzw. legt diese/n fest. (Geerbt von DataGridColumn)

Methoden

CancelCellEdit(FrameworkElement, Object)	Führt dazu, dass die zu bearbeitende Zelle auf den originalen, unbearbeiteten Wert zurückgesetzt wird. (Geerbt von DataGridColumn)
CheckAccess()	Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben. (Geerbt von DependencyObject)
CoerceValue(DependencyProperty)	Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird. (Geerbt von DependencyObject)
CommitCellEdit(FrameworkElement)	Führt jede erforderliche Validierung vor dem Beenden des Zellbearbeitungsmodus aus. (Geerbt von DataGridColumn)
Equals(Object)	Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht. (Geerbt von DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Ruft ein Element ab, das von der CellEditingTemplate definiert wird, die an den Binding-Eigenschaftswert der Spalte gebunden ist.
GenerateElement(DataGridCell, Object)	Ruft ein Element ab, das von der CellTemplate definiert wird, die an den Binding-Eigenschaftswert der Spalte gebunden ist.
GetCellContent(DataGridRow)	Ruft den Content-Eigenschaftswert der Zelle an der Schnittstelle dieser Spalte und der angegebenen Zeile ab. (Geerbt von DataGridColumn)
GetCellContent(Object)	Ruft den Content-Eigenschaftswert der Zelle an der Schnittstelle dieser Spalte und der Zeile ab, die das angegebene Datenelement darstellt. (Geerbt von DataGridColumn)
GetHashCode()	Ruft einen Hashcode für diese DependencyObject ab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen. (Geerbt von DependencyObject)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück. (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
NotifyPropertyChanged(String)	Benachrichtigt DataGrid, das diese Spalte enthält, dass sich eine Spalteneigenschaft geändert hat. (Geerbt von DataGridColumn)
OnCoerceIsReadOnly(Boolean)	Bestimmt den Wert der IsReadOnly-Eigenschaft auf der Grundlage der Eigenschaftsregeln für das DataGrid, das diese Spalte enthält. (Geerbt von DataGridColumn)
OnCopyingCellClipboardContent(Object)	Löst das CopyingCellClipboardContent-Ereignis aus. (Geerbt von DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Löst das PastingCellClipboardContent-Ereignis aus. (Geerbt von DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Legt beim Überschreiben in einer abgeleiteten Klasse den Bearbeitungsbedarf entsprechend dem Zelleninhalt fest. (Geerbt von DataGridColumn)
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist. (Geerbt von DependencyObject)
RefreshCellContent(FrameworkElement, String)	Aktualisiert den Inhalt einer Zelle in der Spalte als Reaktion auf die Änderung eines Vorlageneigenschaftswerts.
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist. (Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)	Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
VerifyAccess()	Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann. (Geerbt von DispatcherObject)

Ereignisse

CopyingCellClipboardContent	Tritt auf, nachdem der Inhalt der Zellenzwischenablage vorbereitet wurde. (Geerbt von DataGridColumn)
PastingCellClipboardContent	Tritt auf, bevor der Zwischenablageinhalt in die Zelle verschoben wird. (Geerbt von DataGridColumn)

Gilt für:

Weitere Informationen

DataGrid

Freigeben über