DataGridTextColumn Klasse
Definition
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 dessen Zellen Textinhalte gehostet werden.
public ref class DataGridTextColumn : System::Windows::Controls::DataGridBoundColumn
public class DataGridTextColumn : System.Windows.Controls.DataGridBoundColumn
type DataGridTextColumn = class
inherit DataGridBoundColumn
Public Class DataGridTextColumn
Inherits DataGridBoundColumn
- Vererbung
Beispiele
Im folgenden Beispiel wird ein DataGrid erstellt, das benutzerdefinierte Textspalten enthält und XML-Daten als Quelle verwendet. Die Abbildung weiter oben in diesem Thema zeigt, wie dieser Code angezeigt wird. Weitere Informationen zum Binden an XML-Daten finden Sie unter How to: Bind to XML Data Using an XMLDataProvider and XPath Queries.For more information about binding to XML data, see How to: Bind to XML Data Using an XMLDataProvider and XPath Queries.
<Window.Resources>
<XmlDataProvider x:Key="customerdata" Source="customers.xml" XPath="Data" />
</Window.Resources>
<Grid>
<DataGrid AutoGenerateColumns="False" ItemsSource="{Binding Source={StaticResource customerdata}, XPath=Customer}">
<DataGrid.Columns>
<DataGridTextColumn Header="First Name" Binding="{Binding XPath=@FirstName}" FontFamily="Arial" FontStyle="Italic" />
<DataGridTextColumn Header="Last Name" Binding="{Binding XPath=@LastName}" FontFamily="Arial" FontWeight="Bold" />
</DataGrid.Columns>
</DataGrid>
</Grid>
Hinweise
Verwenden Sie DataGridTextColumn , um Datenspalten als Text anzuzeigen. Die folgende Abbildung zeigt ein Beispiel für zwei DataGridTextColumn Typen.
Um eine Spalte zu erstellen, fügen Sie sie der Columns Auflistung hinzu. Binden Sie die Spalte mithilfe der -Eigenschaft an die Daten, um die Spalte aufzufüllen Binding . Die Binding -Eigenschaft wird auf das TextBlockTextBox oder -Element angewendet, das in der Spalte erstellt wurde. Der DataContext für das Element in jeder Zelle ist das Datenelement für die Zeile, in der sich die Zelle befindet. Daher müssen Sie zum Einrichten der Bindung nur die Binding.Pathfestlegen. Optional können Sie einen Binding.Converter angeben, wenn Sie die Daten oder konvertieren StringFormatmöchten. Weitere Informationen zur Datenbindung finden Sie unter Datenbindung (WPF).
HinweisDataGridTextColumn erstellt ein TextBlock Element im Nichtbearbeitungsmodus und ein TextBox Element im Bearbeitungsmodus.
Sie können die DataGridTextColumn anpassen, indem Sie Eigenschaften wie Width, Header, FontSizeund IsReadOnlyfestlegen.
Wenn Sie andere Datentypen anzeigen möchten, DataGrid stellen Sie die folgenden Spaltentypen bereit:
Spaltentyp | Datenanzeige |
---|---|
DataGridHyperlinkColumn | Verwenden Sie zum Anzeigen von URI-Daten. |
DataGridComboBoxColumn | Verwenden Sie zum Anzeigen von Enumerationsdaten. |
DataGridCheckBoxColumn | Verwenden Sie zum Anzeigen boolescher Daten. |
Wenn Sie andere Steuerelemente in Verwenden DataGridmöchten, können Sie eigene Spaltentypen erstellen, indem Sie verwenden DataGridTemplateColumn.
Konstruktoren
DataGridTextColumn() |
Initialisiert eine neue Instanz der DataGridTextColumn-Klasse. |
Felder
FontFamilyProperty |
Bezeichnet die FontFamily-Abhängigkeitseigenschaft. |
FontSizeProperty |
Bezeichnet die FontSize-Abhängigkeitseigenschaft. |
FontStyleProperty |
Bezeichnet die FontStyle-Abhängigkeitseigenschaft. |
FontWeightProperty |
Bezeichnet die FontWeight-Abhängigkeitseigenschaft. |
ForegroundProperty |
Bezeichnet die Foreground-Abhängigkeitseigenschaft. |
Eigenschaften
ActualWidth |
Ruft die aktuelle Breite der Spalte in geräteunabhängigen Einheiten (1/96 Zoll pro Einheit) ab. (Geerbt von DataGridColumn) |
Binding |
Ruft die Bindung ab bzw. legt die Bindung fest, die der Spalte eine Eigenschaft in der Datenquelle zuordnet. (Geerbt von DataGridBoundColumn) |
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) |
CellStyle |
Ruft die Formatvorlage ab, die zum Rendern von Zellen in der Spalte verwendet wird, oder legt sie fest. (Geerbt von DataGridColumn) |
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 DataGridBoundColumn) |
DataGridOwner |
Ruft das DataGrid-Steuerelement ab, das diese Spalte enthält. (Geerbt von DataGridColumn) |
DefaultEditingElementStyle |
Der Standardwert der EditingElementStyle-Eigenschaft. |
DefaultElementStyle |
Der Standardwert der ElementStyle-Eigenschaft. |
DependencyObjectType |
Ruft den ab, der DependencyObjectType den CLR-Typ dieses 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) |
EditingElementStyle |
Ruft den Stil zum Rendern des Elements ab, das in der Spalte für eine Zelle im Bearbeitungsmodus angezeigt wird, oder legt diesen fest. (Geerbt von DataGridBoundColumn) |
ElementStyle |
Ruft den Stil zum Rendern des Elements ab, das in der Spalte für eine Zelle angezeigt wird, die sich nicht im Bearbeitungsmodus befindet, oder legt diesen fest. (Geerbt von DataGridBoundColumn) |
FontFamily |
Ruft die Schriftfamilie für den Inhalt der Zellen in der Spalte ab oder legt diese fest. |
FontSize |
Ruft den Schriftgrad für den Inhalt der Zellen in der Spalte ab oder legt diesen fest. |
FontStyle |
Ruft den Schriftschnitt für den Inhalt der Zellen in der Spalte ab oder legt diesen fest. |
FontWeight |
Ruft die Schriftbreite für den Inhalt der Zellen in der Spalte ab oder legt diese fest. |
Foreground |
Ruft die Brush-Klasse ab, die zum Zeichnen des Textinhalts für die Zellen in der Spalte verwendet wird, oder legt diesen fest. |
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 Spaltenzelle auf den angegebenen Wert zurückgesetzt wird. |
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 Bearbeitungsmodus aus. |
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 TextBox-Steuerelement ab, das an den Binding-Eigenschaftswert der Spalte gebunden wird. |
GenerateElement(DataGridCell, Object) |
Ruft ein schreibgeschütztes TextBlock-Steuerelement ab, das an den Binding-Eigenschaftswert der Spalte gebunden wird. |
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) |
OnBindingChanged(BindingBase, BindingBase) |
Benachrichtigt das DataGrid, wenn der Wert der Binding-Eigenschaft geändert wird. (Geerbt von DataGridBoundColumn) |
OnCoerceIsReadOnly(Boolean) |
Bestimmt den Wert der IsReadOnly-Eigenschaft auf der Grundlage von Eigenschaftsregeln für das Datenraster, das diese Spalte enthält. (Geerbt von DataGridBoundColumn) |
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) |
Wird aufgerufen, wenn eine Zelle in der Spalte in den Bearbeitungsmodus wechselt. |
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 Spalteneigenschaftswerts. |
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:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für