DataGridTextColumn Klasa

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Reprezentuje kolumnę DataGrid, która hostuje zawartość tekstową w komórkach.

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

Dziedziczenie

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn

DataGridTextColumn

Przykłady

Poniższy przykład tworzy DataGrid, który ma dostosowane kolumny tekstowe i używa danych XML jako źródła. Ilustracja wcześniej w tym temacie pokazuje sposób wyświetlania tego kodu. Aby uzyskać więcej informacji na temat powiązania z danymi XML, zobacz 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>

Uwagi

Użyj DataGridTextColumn, aby wyświetlić kolumny danych jako tekst. Na poniższej ilustracji przedstawiono przykład dwóch typów DataGridTextColumn.

DataGridTextColumns

Aby utworzyć kolumnę, dodaj ją do kolekcji Columns. Aby wypełnić kolumnę, powiąż kolumnę z danymi przy użyciu właściwości Binding. Właściwość Binding jest stosowana do elementu TextBlock lub TextBox utworzonego w kolumnie. DataContext elementu w każdej komórce jest elementem danych dla wiersza, w których znajduje się komórka. W związku z tym aby skonfigurować powiązanie, należy ustawić tylko Binding.Path. Opcjonalnie możesz określić Binding.Converter, jeśli chcesz przekonwertować dane lub StringFormat. Aby uzyskać więcej informacji na temat powiązania danych, zobacz Powiązanie danych (WPF).

UwagaDataGridTextColumn tworzy element TextBlock w trybie nieedytowania i element TextBox w trybie edycji.

Można dostosować DataGridTextColumn, ustawiając właściwości, takie jak Width, Header, FontSizei IsReadOnly.

Jeśli chcesz wyświetlić inne typy danych, DataGrid udostępnia następujące typy kolumn:

Typ kolumny	Wyświetlanie danych
DataGridHyperlinkColumn	Służy do wyświetlania danych identyfikatora URI.
DataGridComboBoxColumn	Służy do wyświetlania danych wyliczenia.
DataGridCheckBoxColumn	Służy do wyświetlania danych logicznych.

Jeśli chcesz użyć innych kontrolek w DataGrid, możesz utworzyć własne typy kolumn przy użyciu DataGridTemplateColumn.

Konstruktory

DataGridTextColumn()

Inicjuje nowe wystąpienie klasy DataGridTextColumn.

Pola

FontFamilyProperty	Identyfikuje właściwość zależności FontFamily.
FontSizeProperty	Identyfikuje właściwość zależności FontSize.
FontStyleProperty	Identyfikuje właściwość zależności FontStyle.
FontWeightProperty	Identyfikuje właściwość zależności FontWeight.
ForegroundProperty	Identyfikuje właściwość zależności Foreground.

Właściwości

ActualWidth	Pobiera bieżącą szerokość kolumny w jednostkach niezależnych od urządzenia (1/96 cala na jednostkę). (Odziedziczone po DataGridColumn)
Binding	Pobiera lub ustawia powiązanie, które kojarzy kolumnę z właściwością w źródle danych. (Odziedziczone po DataGridBoundColumn)
CanUserReorder	Pobiera lub ustawia wartość wskazującą, czy użytkownik może zmienić położenie wyświetlania kolumny, przeciągając nagłówek kolumny. (Odziedziczone po DataGridColumn)
CanUserResize	Pobiera lub ustawia wartość wskazującą, czy użytkownik może dostosować szerokość kolumny przy użyciu myszy. (Odziedziczone po DataGridColumn)
CanUserSort	Pobiera lub ustawia wartość wskazującą, czy użytkownik może sortować kolumnę, klikając nagłówek kolumny. (Odziedziczone po DataGridColumn)
CellStyle	Pobiera lub ustawia styl używany do renderowania komórek w kolumnie. (Odziedziczone po DataGridColumn)
ClipboardContentBinding	Pobiera lub ustawia obiekt powiązania do użycia podczas pobierania lub ustawiania zawartości komórki dla schowka. (Odziedziczone po DataGridBoundColumn)
DataGridOwner	Pobiera kontrolkę DataGrid zawierającą tę kolumnę. (Odziedziczone po DataGridColumn)
DefaultEditingElementStyle	Wartość domyślna właściwości EditingElementStyle.
DefaultElementStyle	Wartość domyślna właściwości ElementStyle.
DependencyObjectType	Pobiera DependencyObjectType, który opakowuje typ CLR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Pobiera Dispatcher jest skojarzony z tym DispatcherObject. (Odziedziczone po DispatcherObject)
DisplayIndex	Pobiera lub ustawia położenie wyświetlania kolumny względem innych kolumn w DataGrid. (Odziedziczone po DataGridColumn)
DragIndicatorStyle	Pobiera lub ustawia obiekt stylu, który ma być stosowany do nagłówka kolumny podczas operacji przeciągania. (Odziedziczone po DataGridColumn)
EditingElementStyle	Pobiera lub ustawia styl używany podczas renderowania elementu wyświetlanego przez kolumnę dla komórki w trybie edycji. (Odziedziczone po DataGridBoundColumn)
ElementStyle	Pobiera lub ustawia styl używany podczas renderowania elementu wyświetlanego w kolumnie dla komórki, która nie jest w trybie edycji. (Odziedziczone po DataGridBoundColumn)
FontFamily	Pobiera lub ustawia rodzinę czcionek dla zawartości komórek w kolumnie.
FontSize	Pobiera lub ustawia rozmiar czcionki dla zawartości komórek w kolumnie.
FontStyle	Pobiera lub ustawia styl czcionki dla zawartości komórek w kolumnie.
FontWeight	Pobiera lub ustawia wagę czcionki dla zawartości komórek w kolumnie.
Foreground	Pobiera lub ustawia Brush używane do malowania zawartości tekstowej komórek w kolumnie.
Header	Pobiera lub ustawia zawartość nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderStringFormat	Pobiera lub ustawia wzorzec formatu, który ma być stosowany do zawartości nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderStyle	Pobiera lub ustawia styl używany podczas renderowania nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderTemplate	Pobiera lub ustawia szablon, który definiuje wizualną reprezentację nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderTemplateSelector	Pobiera lub ustawia obiekt, który wybiera szablon do użycia dla nagłówka kolumny. (Odziedziczone po DataGridColumn)
IsAutoGenerated	Pobiera wartość wskazującą, czy kolumna jest generowana automatycznie. (Odziedziczone po DataGridColumn)
IsFrozen	Pobiera wartość wskazującą, czy kolumna nie może przewijać się w poziomie. (Odziedziczone po DataGridColumn)
IsReadOnly	Pobiera lub ustawia wartość wskazującą, czy komórki w kolumnie można edytować. (Odziedziczone po DataGridColumn)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
MaxWidth	Pobiera lub ustawia ograniczenie maksymalnej szerokości kolumny. (Odziedziczone po DataGridColumn)
MinWidth	Pobiera lub ustawia ograniczenie minimalnej szerokości kolumny. (Odziedziczone po DataGridColumn)
SortDirection	Pobiera lub ustawia kierunek sortowania (rosnąco lub malejąco) kolumny. (Odziedziczone po DataGridColumn)
SortMemberPath	Pobiera lub ustawia nazwę właściwości lub rozdzielaną kropką hierarchię nazw właściwości, która wskazuje element członkowski do sortowania według. (Odziedziczone po DataGridColumn)
Visibility	Pobiera lub ustawia widoczność kolumny. (Odziedziczone po DataGridColumn)
Width	Pobiera lub ustawia szerokość kolumny lub tryb automatycznego określania rozmiaru. (Odziedziczone po DataGridColumn)

Metody

CancelCellEdit(FrameworkElement, Object)	Powoduje, że komórka kolumny jest edytowana, aby przywrócić określoną wartość.
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject. (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez identyfikator DependencyProperty. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKey. (Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)	Przekształca wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej funkcji CoerceValueCallback określonej w metadanych właściwości dla właściwości, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
CommitCellEdit(FrameworkElement)	Wykonuje dowolną wymaganą walidację przed zakończeniem trybu edycji.
Equals(Object)	Określa, czy podany DependencyObject jest odpowiednikiem bieżącego DependencyObject. (Odziedziczone po DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Pobiera kontrolkę TextBox powiązaną z wartością właściwości Binding kolumny.
GenerateElement(DataGridCell, Object)	Pobiera kontrolkę TextBlock tylko do odczytu, która jest powiązana z wartością właściwości Binding kolumny.
GetCellContent(DataGridRow)	Pobiera wartość właściwości Content komórki na skrzyżowaniu tej kolumny i określonego wiersza. (Odziedziczone po DataGridColumn)
GetCellContent(Object)	Pobiera wartość właściwości Content dla komórki na przecięciu tej kolumny i wiersza reprezentującego określony element danych. (Odziedziczone po DataGridColumn)
GetHashCode()	Pobiera kod skrótu dla tego DependencyObject. (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości na tym DependencyObject. (Odziedziczone po DependencyObject)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza obowiązującą wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
NotifyPropertyChanged(String)	Powiadamia DataGrid, która zawiera tę kolumnę, że właściwość kolumny została zmieniona. (Odziedziczone po DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	Powiadamia DataGrid o zmianie wartości właściwości Binding. (Odziedziczone po DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Określa wartość właściwości IsReadOnly na podstawie reguł właściwości z siatki danych zawierającej tę kolumnę. (Odziedziczone po DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)	Zgłasza zdarzenie CopyingCellClipboardContent. (Odziedziczone po DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Zgłasza zdarzenie PastingCellClipboardContent. (Odziedziczone po DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy wartość efektywna dowolnej właściwości zależności na tym DependencyObject została zaktualizowana. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w danych zdarzenia. (Odziedziczone po DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Wywoływana, gdy komórka w kolumnie przechodzi w tryb edycji.
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
RefreshCellContent(FrameworkElement, String)	Odświeża zawartość komórki w kolumnie w odpowiedzi na zmianę wartości właściwości kolumny.
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmieniania źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jej identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określoną przez identyfikator DependencyPropertyKey właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject. (Odziedziczone po DispatcherObject)

Zdarzenia

CopyingCellClipboardContent	Występuje po przygotowaniu zawartości schowka komórki. (Odziedziczone po DataGridColumn)
PastingCellClipboardContent	Występuje przed przeniesieniem zawartości schowka do komórki. (Odziedziczone po DataGridColumn)