Freigeben über


DataGridTextColumn Klasse

Definition

Stellt eine DataGrid Spalte dar, die Textinhalte in ihren Zellen hostet.

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 eine DataGrid erstellt, die 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.

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

Two DataGridTextColumns

Um eine Spalte zu erstellen, fügen Sie sie der Columns Auflistung hinzu. Um die Spalte aufzufüllen, binden Sie die Spalte mithilfe der Binding-Eigenschaft an die Daten. Die Binding-Eigenschaft wird auf das in der Spalte erstellte TextBlock- oder TextBox-Element angewendet. Die DataContext für das Element in jeder Zelle ist das Datenelement für die Zeile, in der sich die Zelle befindet. Um die Bindung einzurichten, müssen Sie daher nur die Binding.Pathfestlegen. Optional können Sie eine Binding.Converter angeben, wenn Sie die Daten oder die StringFormatkonvertieren möchten. Weitere Informationen zur Datenbindung finden Sie unter Data Binding (WPF).

Hinweis erstelltDataGridTextColumn 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, stellt DataGrid die folgenden Spaltentypen bereit:

Spaltentyp Datenanzeige
DataGridHyperlinkColumn Wird zum Anzeigen von URI-Daten verwendet.
DataGridComboBoxColumn Wird zum Anzeigen von Enumerationsdaten verwendet.
DataGridCheckBoxColumn Wird verwendet, um boolesche Daten anzuzeigen.

Wenn Sie andere Steuerelemente in Ihrer DataGridverwenden möchten, können Sie eigene Spaltentypen mithilfe von DataGridTemplateColumnerstellen.

Konstruktoren

DataGridTextColumn()

Initialisiert eine neue Instanz der DataGridTextColumn Klasse.

Felder

FontFamilyProperty

Identifies the FontFamily dependency property.

FontSizeProperty

Identifies the FontSize dependency property.

FontStyleProperty

Identifies the FontStyle dependency property.

FontWeightProperty

Identifies the FontWeight dependency property.

ForegroundProperty

Identifies the Foreground dependency property.

Eigenschaften

ActualWidth

Ruft die aktuelle Breite der Spalte in geräteunabhängigen Einheiten (1/96. Zoll pro Einheit) ab.

(Geerbt von DataGridColumn)
Binding

Dient zum Abrufen oder Festlegen der Bindung, die die Spalte einer Eigenschaft in der Datenquelle zuordnet.

(Geerbt von DataGridBoundColumn)
CanUserReorder

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer die Position der Spaltenanzeige ändern kann, indem die Spaltenüberschrift gezogen wird.

(Geerbt von DataGridColumn)
CanUserResize

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer die Spaltenbreite mithilfe der Maus anpassen kann.

(Geerbt von DataGridColumn)
CanUserSort

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer die Spalte sortieren kann, indem er auf die Spaltenüberschrift klickt.

(Geerbt von DataGridColumn)
CellStyle

Dient zum Abrufen oder Festlegen der Formatvorlage, die zum Rendern von Zellen in der Spalte verwendet wird.

(Geerbt von DataGridColumn)
ClipboardContentBinding

Dient zum Abrufen oder Festlegen des Bindungsobjekts, das beim Abrufen oder Festlegen von Zellinhalten für die Zwischenablage verwendet werden soll.

(Geerbt von DataGridBoundColumn)
DataGridOwner

Ruft das DataGrid-Steuerelement ab, das diese Spalte enthält.

(Geerbt von DataGridColumn)
DefaultEditingElementStyle

Der Standardwert der eigenschaft EditingElementStyle.

DefaultElementStyle

Der Standardwert der eigenschaft ElementStyle.

DependencyObjectType

Ruft die DependencyObjectType ab, die den CLR-Typ dieser Instanz umschließt.

(Geerbt von DependencyObject)
Dispatcher

Ruft die Dispatcher dieser DispatcherObject zugeordnet ist.

(Geerbt von DispatcherObject)
DisplayIndex

Dient zum Abrufen oder Festlegen der Anzeigeposition der Spalte relativ zu den anderen Spalten im DataGrid.

(Geerbt von DataGridColumn)
DragIndicatorStyle

Dient zum Abrufen oder Festlegen des Formatvorlagenobjekts, das während eines Ziehvorgangs auf die Spaltenüberschrift angewendet werden soll.

(Geerbt von DataGridColumn)
EditingElementStyle

Ruft die Formatvorlage ab, die beim Rendern des Elements, das in der Spalte für eine Zelle im Bearbeitungsmodus angezeigt wird, verwendet wird, oder legt diese fest.

(Geerbt von DataGridBoundColumn)
ElementStyle

Dient zum Abrufen oder Festlegen der Formatvorlage, die beim Rendern des Elements verwendet wird, das in der Spalte für eine Zelle angezeigt wird, die sich nicht im Bearbeitungsmodus befindet.

(Geerbt von DataGridBoundColumn)
FontFamily

Dient zum Abrufen oder Festlegen der Schriftfamilie für den Inhalt von Zellen in der Spalte.

FontSize

Dient zum Abrufen oder Festlegen des Schriftgrads für den Inhalt von Zellen in der Spalte.

FontStyle

Dient zum Abrufen oder Festlegen des Schriftschnitts für den Inhalt von Zellen in der Spalte.

FontWeight

Dient zum Abrufen oder Festlegen der Schriftbreite für den Inhalt von Zellen in der Spalte.

Foreground

Dient zum Abrufen oder Festlegen der Brush, die zum Zeichnen des Textinhalts von Zellen in der Spalte verwendet wird.

Header

Dient zum Abrufen oder Festlegen des Inhalts der Spaltenüberschrift.

(Geerbt von DataGridColumn)
HeaderStringFormat

Dient zum Abrufen oder Festlegen des Formatmusters, das auf den Inhalt der Spaltenüberschrift angewendet werden soll.

(Geerbt von DataGridColumn)
HeaderStyle

Ruft die Formatvorlage ab, die beim Rendern der Spaltenüberschrift verwendet wird, oder legt diese fest.

(Geerbt von DataGridColumn)
HeaderTemplate

Dient zum Abrufen oder Festlegen der Vorlage, die die visuelle Darstellung der Spaltenüberschrift definiert.

(Geerbt von DataGridColumn)
HeaderTemplateSelector

Dient zum Abrufen oder Festlegen des Objekts, das auswählt, welche Vorlage für die Spaltenüberschrift verwendet werden soll.

(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 die Spalte daran gehindert wird, horizontal zu scrollen.

(Geerbt von DataGridColumn)
IsReadOnly

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Zellen in der Spalte bearbeitet werden können.

(Geerbt von DataGridColumn)
IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt).

(Geerbt von DependencyObject)
MaxWidth

Ruft die Maximale Breiteeinschränkung der Spalte ab oder legt sie fest.

(Geerbt von DataGridColumn)
MinWidth

Dient zum Abrufen oder Festlegen der Minimalbreiteneinschränkung der Spalte.

(Geerbt von DataGridColumn)
SortDirection

Dient zum Abrufen oder Festlegen der Sortierrichtung (aufsteigend oder absteigend) der Spalte.

(Geerbt von DataGridColumn)
SortMemberPath

Dient zum Abrufen oder Festlegen eines Eigenschaftsnamens oder einer durch Punkt getrennten Hierarchie von Eigenschaftsnamen, die das Element angibt, nach dem sortiert werden soll.

(Geerbt von DataGridColumn)
Visibility

Ruft die Sichtbarkeit der Spalte ab oder legt sie fest.

(Geerbt von DataGridColumn)
Width

Dient zum Abrufen oder Festlegen der Spaltenbreite oder des automatischen Größenanpassungsmodus.

(Geerbt von DataGridColumn)

Methoden

CancelCellEdit(FrameworkElement, Object)

Bewirkt, dass die bearbeitete Spaltenzelle auf den angegebenen Wert zurückgesetzt wird.

CancelCellEdit(FrameworkElement, Object)

Bewirkt, dass die bearbeitete Zelle auf den ursprünglichen, unbearbeiteten Wert zurückgesetzt wird.

(Geerbt von DataGridColumn)
CheckAccess()

Bestimmt, ob der aufrufende Thread Zugriff auf diese DispatcherObjecthat.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKeyangegeben.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen CoerceValueCallback Funktion aufgerufen werden, wie sie für die aufrufende DependencyObjectvorhanden ist.

(Geerbt von DependencyObject)
CommitCellEdit(FrameworkElement)

Führt vor dem Beenden des Bearbeitungsmodus alle erforderlichen Überprüfungen aus.

CommitCellEdit(FrameworkElement)

Führt vor dem Beenden des Zellbearbeitungsmodus eine erforderliche Überprüfung durch.

(Geerbt von DataGridColumn)
Equals(Object)

Bestimmt, ob eine angegebene DependencyObject dem aktuellen DependencyObjectentspricht.

(Geerbt von DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Ruft ein TextBox-Steuerelement ab, das an den Binding Eigenschaftswert der Spalte gebunden ist.

GenerateElement(DataGridCell, Object)

Ruft ein schreibgeschütztes TextBlock-Steuerelement ab, das an den Binding Eigenschaftswert der Spalte gebunden ist.

GetCellContent(DataGridRow)

Ruft den wert der Content Eigenschaft für die Zelle am Schnittpunkt dieser Spalte und der angegebenen Zeile ab.

(Geerbt von DataGridColumn)
GetCellContent(Object)

Ruft den Content Eigenschaftswert für die Zelle an der Schnittmenge dieser Spalte und die Zeile ab, die das angegebene Datenelement darstellt.

(Geerbt von DataGridColumn)
GetHashCode()

Ruft einen Hashcode für diese DependencyObjectab.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen speziellen Enumerator zum Bestimmen, welche Abhängigkeitseigenschaften lokal für dieses DependencyObjectfestgelegt sind.

(Geerbt von DependencyObject)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObjectzurü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 der aktuellen Object.

(Geerbt von Object)
NotifyPropertyChanged(String)

Benachrichtigt die DataGrid, die diese Spalte enthält, dass eine Spalteneigenschaft geändert wurde.

(Geerbt von DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)

Benachrichtigt den DataGrid, wenn sich der Wert der Binding Eigenschaft ändert.

(Geerbt von DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)

Bestimmt den Wert der IsReadOnly -Eigenschaft basierend auf Eigenschaftsregeln aus dem 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 aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für diese DependencyObject aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, 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, sofern vorhanden.

(Geerbt von DependencyObject)
RefreshCellContent(FrameworkElement, String)

Aktualisiert den Inhalt einer Zelle in der Spalte als Reaktion auf eine Änderung des Spalteneigenschaftswerts.

SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird.

(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 wird.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte 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 Zugriff auf diese DispatcherObjecthat.

(Geerbt von DispatcherObject)

Ereignisse

CopyingCellClipboardContent

Tritt auf, nachdem der Inhalt der Zellenablage vorbereitet wurde.

(Geerbt von DataGridColumn)
PastingCellClipboardContent

Tritt auf, bevor der Inhalt der Zwischenablage in die Zelle verschoben wird.

(Geerbt von DataGridColumn)

Gilt für: