DataGridTemplateColumn Klasa

Definicja

Przedstawia DataGrid kolumnę, która hostuje zawartość określoną przez szablon w jej komórkach.Represents a DataGrid column that hosts template-specified content in its cells.

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

Poniższy przykład pokazuje, jak utworzyć DataGridTemplateColumn .The following example shows how to create a 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 XAML.The following illustration shows the output from the previous XAML.

Kolumna używająca elementu DataTemplateA column using a DataTemplate

Uwagi

DataGridTemplateColumnTyp umożliwia tworzenie własnych typów kolumn przez określenie szablonów komórek, które mają być używane podczas wyświetlania i edytowania wartości.The DataGridTemplateColumn type enables you to create your own column types by specifying the cell templates to use when displaying and editing values. Aby określić szablon, który jest używany do wyświetlania zawartości komórki, która nie jest w trybie edycji, ustaw CellTemplate Właściwość.To specify the template that is used to display the contents of a cell that is not in editing mode, set the CellTemplate property. Aby określić szablon, który jest używany do wyświetlania zawartości komórki znajdującej się w trybie edycji, ustaw CellEditingTemplate Właściwość.To specify the template that is used to display the contents of a cell that is in editing mode, set the CellEditingTemplate property. Aby uzyskać więcej informacji na temat szablonów, zobacz Omówienie tworzenia szablonów danych i Style oraz tworzenia szablonów.For more information about templates, see Data Templating Overview and Styling and Templating.

Dla wygody program DataGrid udostępnia następujące wstępnie zdefiniowane typy kolumn:For convenience, DataGrid provides the following pre-defined column types:

Typ kolumnyColumn Type Wyświetlanie danychData Display
DataGridHyperlinkColumn Służy do wyświetlania danych identyfikatora URI.Use to display URI data.
DataGridComboBoxColumn Służy do wyświetlania danych wyliczania.Use to display enumeration data.
DataGridTextColumn Użyj, aby wyświetlić tekst.Use to display text.
DataGridCheckBoxColumn Służy do wyświetlania danych logicznych.Use to display Boolean data.

Konstruktory

DataGridTemplateColumn()

Inicjuje nowe wystąpienie klasy DataGridTemplateColumn.Initializes a new instance of the DataGridTemplateColumn class.

Pola

CellEditingTemplateProperty

Identyfikuje CellEditingTemplate Właściwość zależności.Identifies the CellEditingTemplate dependency property.

CellEditingTemplateSelectorProperty

Identyfikuje CellEditingTemplateSelector Właściwość zależności.Identifies the CellEditingTemplateSelector dependency property.

CellTemplateProperty

Identyfikuje CellTemplate Właściwość zależności.Identifies the CellTemplate dependency property.

CellTemplateSelectorProperty

Identyfikuje CellEditingTemplateSelector Właściwość zależności.Identifies the CellEditingTemplateSelector dependency property.

Właściwości

ActualWidth

Pobiera bieżącą szerokość kolumny w jednostki miary niezależne od urządzenia (1/96 cala na jednostkę)device-independent units (1/96th inch per unit) .Gets the current width of the column, in jednostki miary niezależne od urządzenia (1/96 cala na jednostkę)device-independent units (1/96th inch per unit).

(Odziedziczone po DataGridColumn)
CanUserReorder

Pobiera lub ustawia wartość wskazującą, czy użytkownik może zmienić położenie wyświetlania kolumny przez przeciągnięcie nagłówka kolumny.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(Odziedziczone po DataGridColumn)
CanUserResize

Pobiera lub ustawia wartość wskazującą, czy użytkownik może dostosować szerokość kolumny za pomocą myszy.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Odziedziczone po DataGridColumn)
CanUserSort

Pobiera lub ustawia wartość wskazującą, czy użytkownik może sortować kolumnę przez kliknięcie nagłówka kolumny.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Odziedziczone po DataGridColumn)
CellEditingTemplate

Pobiera lub ustawia szablon, który zostanie użyty do wyświetlenia zawartości komórki znajdującej się w trybie edycji.Gets or sets the template to use to display the contents of a cell that is in editing mode.

CellEditingTemplateSelector

Pobiera lub ustawia obiekt określający, który szablon zostanie użyty do wyświetlenia zawartości komórki znajdującej się w trybie edycji.Gets or sets the object that determines which template to use to display the contents of a cell that is in editing mode.

CellStyle

Pobiera lub ustawia styl używany do renderowania komórek w kolumnie.Gets or sets the style that is used to render cells in the column.

(Odziedziczone po DataGridColumn)
CellTemplate

Pobiera lub ustawia szablon, który zostanie użyty do wyświetlenia zawartości komórki, która nie jest w trybie edycji.Gets or sets the template to use to display the contents of a cell that is not in editing mode.

CellTemplateSelector

Pobiera lub ustawia obiekt określający, który szablon zostanie użyty do wyświetlenia zawartości komórki, która nie jest w trybie edycji.Gets or sets the object that determines which template to use to display the contents of a cell that is not in editing mode.

ClipboardContentBinding

Pobiera lub ustawia obiekt powiązania do użycia podczas pobierania lub ustawiania zawartości komórki dla Schowka.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Odziedziczone po DataGridColumn)
DataGridOwner

Pobiera DataGrid formant, który zawiera tę kolumnę.Gets the DataGrid control that contains this column.

(Odziedziczone po DataGridColumn)
DependencyObjectType

Pobiera DependencyObjectType , który zawija CLRCLR Typ tego wystąpienia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Pobiera Dispatcher ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
DisplayIndex

Pobiera lub ustawia pozycję wyświetlania kolumny względem innych kolumn w DataGrid .Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Odziedziczone po DataGridColumn)
DragIndicatorStyle

Pobiera lub ustawia obiekt Style, który ma zostać zastosowany do nagłówka kolumny podczas operacji przeciągania.Gets or sets the style object to apply to the column header during a drag operation.

(Odziedziczone po DataGridColumn)
Header

Pobiera lub ustawia zawartość nagłówka kolumny.Gets or sets the content of the column header.

(Odziedziczone po DataGridColumn)
HeaderStringFormat

Pobiera lub ustawia wzorzec formatu, który ma zostać zastosowany do zawartości nagłówka kolumny.Gets or sets the format pattern to apply to the content of the column header.

(Odziedziczone po DataGridColumn)
HeaderStyle

Pobiera lub ustawia styl używany podczas renderowania nagłówka kolumny.Gets or sets the style that is used when rendering the column header.

(Odziedziczone po DataGridColumn)
HeaderTemplate

Pobiera lub ustawia szablon definiujący wizualną reprezentację nagłówka kolumny.Gets or sets the template that defines the visual representation of the column header.

(Odziedziczone po DataGridColumn)
HeaderTemplateSelector

Pobiera lub ustawia obiekt, który wybiera szablon do użycia w nagłówku kolumny.Gets or sets the object that selects which template to use for the column header.

(Odziedziczone po DataGridColumn)
IsAutoGenerated

Pobiera wartość wskazującą, czy kolumna jest generowana automatycznie.Gets a value that indicates whether the column is auto-generated.

(Odziedziczone po DataGridColumn)
IsFrozen

Pobiera wartość wskazującą, czy kolumna jest nieblokowana pod kątem przewijania w poziomie.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Odziedziczone po DataGridColumn)
IsReadOnly

Pobiera lub ustawia wartość wskazującą, czy komórki w kolumnie mogą być edytowane.Gets or sets a value that indicates whether cells in the column can be edited.

(Odziedziczone po DataGridColumn)
IsSealed

Pobiera wartość wskazującą, czy to wystąpienie jest aktualnie zapieczętowane (tylko do odczytu).Gets a value that indicates whether this instance is currently sealed (read-only).

(Odziedziczone po DependencyObject)
MaxWidth

Pobiera lub ustawia ograniczenie maksymalnej szerokości kolumny.Gets or sets the maximum width constraint of the column.

(Odziedziczone po DataGridColumn)
MinWidth

Pobiera lub ustawia ograniczenie minimalnej szerokości kolumny.Gets or sets the minimum width constraint of the column.

(Odziedziczone po DataGridColumn)
SortDirection

Pobiera lub ustawia kierunek sortowania (rosnący lub malejący) kolumny.Gets or sets the sort direction (ascending or descending) of the column.

(Odziedziczone po DataGridColumn)
SortMemberPath

Pobiera lub ustawia nazwę właściwości lub rozdzielaną kropkami hierarchię nazw właściwości, która wskazuje składową, według której ma zostać wykonane sortowanie.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Odziedziczone po DataGridColumn)
Visibility

Pobiera lub ustawia widoczność kolumny.Gets or sets the visibility of the column.

(Odziedziczone po DataGridColumn)
Width

Pobiera lub ustawia szerokość kolumny lub tryb automatycznej zmiany rozmiarów.Gets or sets the column width or automatic sizing mode.

(Odziedziczone po DataGridColumn)

Metody

CancelCellEdit(FrameworkElement, Object)

Powoduje, że edytowana komórka przywraca pierwotną, nieedytowaną wartość.Causes the cell being edited to revert to the original, unedited value.

(Odziedziczone po DataGridColumn)
CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyProperty Identyfikator.The property to be cleared is specified by a DependencyProperty identifier.

(Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)

Przekształca wartość określonej właściwości zależności.Coerces the value of the specified dependency property. 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, która istnieje w wywołaniu DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Odziedziczone po DependencyObject)
CommitCellEdit(FrameworkElement)

Wykonuje wszystkie wymagane walidacje przed wyjściem z trybu edycji komórki.Performs any required validation before exiting cell editing mode.

(Odziedziczone po DataGridColumn)
Equals(Object)

Określa, czy podana DependencyObject jest równoważna z bieżącym DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Odziedziczone po DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Pobiera element zdefiniowany przez CellEditingTemplate , który jest powiązany z Binding wartością właściwości kolumny.Gets an element defined by the CellEditingTemplate that is bound to the column's Binding property value.

GenerateElement(DataGridCell, Object)

Pobiera element zdefiniowany przez CellTemplate , który jest powiązany z Binding wartością właściwości kolumny.Gets an element defined by the CellTemplate that is bound to the column's Binding property value.

GetCellContent(DataGridRow)

Pobiera Content wartość właściwości dla komórki na przecięciu tej kolumny i określonego wiersza.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Odziedziczone po DataGridColumn)
GetCellContent(Object)

Pobiera Content wartość właściwości dla komórki na przecięciu tej kolumny i wiersz reprezentujący określony element danych.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Odziedziczone po DataGridColumn)
GetHashCode()

Pobiera kod skrótu dla tego elementu DependencyObject .Gets a hash code for this DependencyObject.

(Odziedziczone po DependencyObject)
GetLocalValueEnumerator()

Tworzy wyspecjalizowany moduł wyliczający służący do określania, które właściwości zależności mają lokalnie ustawione wartości DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności w tym wystąpieniu DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)

Ponowna ocenuje wartość efektywną dla określonej właściwości zależności.Re-evaluates the effective value for the specified dependency property.

(Odziedziczone po DependencyObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
NotifyPropertyChanged(String)

Powiadamia, DataGrid że zawiera tę kolumnę, która została zmieniona przez właściwość kolumny.Notifies the DataGrid that contains this column that a column property has changed.

(Odziedziczone po DataGridColumn)
OnCoerceIsReadOnly(Boolean)

Określa wartość IsReadOnly właściwości na podstawie reguł właściwości DataGrid , które zawierają tę kolumnę.Determines the value of the IsReadOnly property based on the property rules of the DataGrid that contains this column.

(Odziedziczone po DataGridColumn)
OnCopyingCellClipboardContent(Object)

Podnosi CopyingCellClipboardContent zdarzenie.Raises the CopyingCellClipboardContent event.

(Odziedziczone po DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Podnosi PastingCellClipboardContent zdarzenie.Raises the PastingCellClipboardContent event.

(Odziedziczone po DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wywoływana za każdym razem, gdy wartość skuteczna każdej właściwości zależności na tej stronie DependencyObject została zaktualizowana.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Określona właściwość zależności, która została zmieniona, jest raportowana w danych zdarzenia.The specific dependency property that changed is reported in the event data.

(Odziedziczone po DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Gdy jest zastępowany w klasie pochodnej, ustawia zawartość komórki zgodnie z wymaganiami do edycji.When overridden in a derived class, sets cell content as needed for editing.

(Odziedziczone po DataGridColumn)
ReadLocalValue(DependencyProperty)

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.Returns the local value of a dependency property, if it exists.

(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.Refreshes the contents of a cell in the column in response to a template property value change.

SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany jego źródła wartości.Sets the value of a dependency property without changing its value source.

(Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności, określoną za pomocą identyfikatora właściwości zależności.Sets the local value of a dependency property, specified by its dependency property identifier.

(Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu, określoną przez DependencyPropertyKey Identyfikator właściwości zależności.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Odziedziczone po DependencyObject)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)

Zdarzenia

CopyingCellClipboardContent

Występuje po przygotowaniu zawartości Schowka komórki.Occurs after the cell clipboard content is prepared.

(Odziedziczone po DataGridColumn)
PastingCellClipboardContent

Występuje przed przeniesieniem zawartości schowka do komórki.Occurs before the clipboard content is moved to the cell.

(Odziedziczone po DataGridColumn)

Dotyczy

Zobacz też