DataGridTemplateColumn Klasa

Definicja

Reprezentuje kolumnę DataGrid , która hostuje zawartość określoną przez szablon w komórkach.

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
Dziedziczenie

Przykłady

W poniższym przykładzie pokazano, jak utworzyć element 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>

Na poniższej ilustracji przedstawiono dane wyjściowe z poprzedniego kodu XAML.

Kolumna używająca kolumny DataTemplate

Uwagi

Typ DataGridTemplateColumn umożliwia tworzenie własnych typów kolumn przez określenie szablonów komórek do użycia podczas wyświetlania i edytowania wartości. Aby określić szablon używany do wyświetlania zawartości komórki, która nie jest w trybie edycji, ustaw CellTemplate właściwość . Aby określić szablon używany do wyświetlania zawartości komórki, która jest w trybie edycji, ustaw CellEditingTemplate właściwość . Aby uzyskać więcej informacji na temat szablonów, zobacz Szablony danych — omówieniei stylizowanie i tworzenie szablonów.

Dla wygody DataGrid udostępnia następujące wstępnie zdefiniowane 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.
DataGridTextColumn Służy do wyświetlania tekstu.
DataGridCheckBoxColumn Służy do wyświetlania danych logicznych.

Konstruktory

DataGridTemplateColumn()

Inicjuje nowe wystąpienie klasy DataGridTemplateColumn.

Pola

CellEditingTemplateProperty

Identyfikuje CellEditingTemplate właściwość zależności.

CellEditingTemplateSelectorProperty

Identyfikuje CellEditingTemplateSelector właściwość zależności.

CellTemplateProperty

Identyfikuje CellTemplate właściwość zależności.

CellTemplateSelectorProperty

Identyfikuje CellEditingTemplateSelector właściwość zależności.

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

Pobiera lub ustawia szablon do użycia w celu wyświetlenia zawartości komórki, która jest w trybie edycji.

CellEditingTemplateSelector

Pobiera lub ustawia obiekt, który określa, który szablon ma być używany do wyświetlania zawartości komórki, która jest w trybie edycji.

CellStyle

Pobiera lub ustawia styl używany do renderowania komórek w kolumnie.

(Odziedziczone po DataGridColumn)
CellTemplate

Pobiera lub ustawia szablon do użycia w celu wyświetlenia zawartości komórki, która nie jest w trybie edycji.

CellTemplateSelector

Pobiera lub ustawia obiekt, który określa, który szablon ma być używany do wyświetlania zawartości komórki, która nie jest w trybie edycji.

ClipboardContentBinding

Pobiera lub ustawia obiekt powiązania do użycia podczas pobierania lub ustawiania zawartości komórki dla schowka.

(Odziedziczone po DataGridColumn)
DataGridOwner

Pobiera kontrolkę zawierającą tę kolumnę DataGrid .

(Odziedziczone po DataGridColumn)
DependencyObjectType

DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia.

(Odziedziczone po DependencyObject)
Dispatcher

Dispatcher Pobiera tę DispatcherObject wartość skojarzona z.

(Odziedziczone po DispatcherObject)
DisplayIndex

Pobiera lub ustawia położenie wyświetlania kolumny względem innych kolumn w elemecie 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)
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 hierarchię rozdzielaną kropką 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 jest edytowana, aby przywrócić oryginalną, nieedytowaną wartość.

(Odziedziczone po DataGridColumn)
CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu .

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator.

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

(Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)

Coerce wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject.

(Odziedziczone po DependencyObject)
CommitCellEdit(FrameworkElement)

Wykonuje dowolną wymaganą walidację przed zamknięciem trybu edycji komórek.

(Odziedziczone po DataGridColumn)
Equals(Object)

Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu .

(Odziedziczone po DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Pobiera element zdefiniowany przez CellEditingTemplate element powiązany z wartością właściwości kolumny Binding .

GenerateElement(DataGridCell, Object)

Pobiera element zdefiniowany przez CellTemplate element powiązany z wartością właściwości kolumny Binding .

GetCellContent(DataGridRow)

Content Pobiera wartość właściwości komórki na skrzyżowaniu tej kolumny i określonego wiersza.

(Odziedziczone po DataGridColumn)
GetCellContent(Object)

Content Pobiera wartość właściwości dla komórki na skrzyżowaniu tej kolumny i wiersza, który reprezentuje określony element danych.

(Odziedziczone po DataGridColumn)
GetHashCode()

Pobiera kod skrótu dla tego pliku 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 w tym DependencyObjectelemecie .

(Odziedziczone po DependencyObject)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject.

(Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)

Ponownie oblicza efektywną wartość dla określonej właściwości zależności.

(Odziedziczone po DependencyObject)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
NotifyPropertyChanged(String)

Powiadamia o DataGrid tym, że zawiera tę kolumnę, że właściwość kolumny została zmieniona.

(Odziedziczone po DataGridColumn)
OnCoerceIsReadOnly(Boolean)

Określa wartość IsReadOnly właściwości na podstawie reguł DataGrid właściwości, które zawierają tę kolumnę.

(Odziedziczone po DataGridColumn)
OnCopyingCellClipboardContent(Object)

CopyingCellClipboardContent Zgłasza zdarzenie.

(Odziedziczone po DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

PastingCellClipboardContent Zgłasza zdarzenie.

(Odziedziczone po DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wywoływane za każdym razem, gdy obowiązująca wartość dowolnej właściwości zależności została DependencyObject 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)

Po przesłonięciu w klasie pochodnej ustawia zawartość komórki zgodnie z potrzebami do edycji.

(Odziedziczone po DataGridColumn)
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 szablonu.

SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany źródła wartości.

(Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności określonej przez jego 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ślona przez DependencyPropertyKey identyfikator 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 DispatcherObjectelementu .

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

Dotyczy

Zobacz też