Поделиться через


DataGridTemplateColumn Класс

Определение

Представляет столбец DataGrid, в ячейках которого размещается содержимое, определяемое шаблоном.

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
Наследование

Примеры

В следующем примере показано, как создать 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>

На следующем рисунке показаны выходные данные предыдущего XAML.

Столбец, использующий объект DataTemplate

Комментарии

Тип DataGridTemplateColumn позволяет создавать собственные типы столбцов, указывая шаблоны ячеек, которые будут использоваться при отображении и изменении значений. Чтобы указать шаблон, используемый для отображения содержимого ячейки, которая не находится в режиме CellTemplate редактирования, задайте свойство . Чтобы указать шаблон, используемый для отображения содержимого ячейки в режиме CellEditingTemplate редактирования, задайте свойство . Дополнительные сведения о шаблонах см. в разделах Общие сведения о шаблоне данных и Стилизация и шаблонов.

Для удобства DataGrid предоставляет следующие предварительно определенные типы столбцов:

Тип столбца Отображение данных
DataGridHyperlinkColumn Используйте для отображения данных URI.
DataGridComboBoxColumn Используется для отображения данных перечисления.
DataGridTextColumn Используется для отображения текста.
DataGridCheckBoxColumn Используется для отображения логических данных.

Конструкторы

DataGridTemplateColumn()

Инициализирует новый экземпляр класса DataGridTemplateColumn.

Поля

CellEditingTemplateProperty

Идентифицирует свойство зависимостей CellEditingTemplate.

CellEditingTemplateSelectorProperty

Идентифицирует свойство зависимостей CellEditingTemplateSelector.

CellTemplateProperty

Идентифицирует свойство зависимостей CellTemplate.

CellTemplateSelectorProperty

Идентифицирует свойство зависимостей CellEditingTemplateSelector.

Свойства

ActualWidth

Возвращает текущую ширину столбца в аппаратно-независимых единицах (1/96 дюйма на единицу).

(Унаследовано от DataGridColumn)
CanUserReorder

Получение или установка значения, определяющего, может ли пользователь изменять позицию столбца, перетаскивая его заголовок мышью.

(Унаследовано от DataGridColumn)
CanUserResize

Получает или задает значение, указывающее, может ли пользователь изменять ширину столбца с помощью мыши.

(Унаследовано от DataGridColumn)
CanUserSort

Получение или установка значения, определяющего, может ли пользователь сортировать столбец, щелкая его заголовок.

(Унаследовано от DataGridColumn)
CellEditingTemplate

Получает или задает шаблон, который нужно использовать для отображения содержимого ячейки, которая находится в режиме правки.

CellEditingTemplateSelector

Получает или задает объект, определяющий шаблон, который должен использоваться для отображения содержимого ячейки, находящейся в режиме редактирования.

CellStyle

Получает или задает стиль, используемый при визуализации ячеек в столбце.

(Унаследовано от DataGridColumn)
CellTemplate

Получает или задает шаблон, используемый для отображения содержимого ячейки, находящейся не в режиме редактирования.

CellTemplateSelector

Получает или задает объект, определяющий шаблон, который должен использоваться для отображения содержимого ячейки, находящейся не в режиме редактирования.

ClipboardContentBinding

Получает или задает объект привязки, который должен использоваться при получении или задании содержимого ячейки для буфера обмена.

(Унаследовано от DataGridColumn)
DataGridOwner

Получает элемент управления DataGrid, содержащий этот столбец.

(Унаследовано от DataGridColumn)
DependencyObjectType

Возвращает объект , DependencyObjectType который заключает в оболочку тип СРЕДЫ CLR данного экземпляра.

(Унаследовано от DependencyObject)
Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.

(Унаследовано от DispatcherObject)
DisplayIndex

Получает или задает позицию отображения столбца по отношению к другим столбцам в элементе управления DataGrid.

(Унаследовано от DataGridColumn)
DragIndicatorStyle

Получает или задает объект стиля для применения к заголовку столбца во время операции перетаскивания.

(Унаследовано от DataGridColumn)
Header

Получение или установка содержимого заголовка столбца.

(Унаследовано от DataGridColumn)
HeaderStringFormat

Получает или задает шаблон формата, применяемый к содержимому заголовка столбца.

(Унаследовано от DataGridColumn)
HeaderStyle

Получает или задает стиль, используемый при отображении заголовка столбца.

(Унаследовано от DataGridColumn)
HeaderTemplate

Получает или задает шаблон, определяющий визуальное представление заголовка столбца.

(Унаследовано от DataGridColumn)
HeaderTemplateSelector

Получает или задает объект, который выбирает, какой шаблон должен использоваться для заголовка столбца.

(Унаследовано от DataGridColumn)
IsAutoGenerated

Получает значение, указывающее, создается ли столбец автоматически.

(Унаследовано от DataGridColumn)
IsFrozen

Получает значение, указывающее, запрещена ли горизонтальная прокрутка столбца.

(Унаследовано от DataGridColumn)
IsReadOnly

Получение или установка значения, определяющего возможность редактирования ячеек в столбце.

(Унаследовано от DataGridColumn)
IsSealed

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения).

(Унаследовано от DependencyObject)
MaxWidth

Получает или задает максимальное ограничение ширины столбца.

(Унаследовано от DataGridColumn)
MinWidth

Получает или задает минимальное ограничение ширины столбца.

(Унаследовано от DataGridColumn)
SortDirection

Получает или задает направление сортировки столбца (по возрастанию или по убыванию).

(Унаследовано от DataGridColumn)
SortMemberPath

Получение или установка имени свойства либо иерархии имен свойств, разделенных точками, которые определяют член, по которому будет выполняться сортировка.

(Унаследовано от DataGridColumn)
Visibility

Получение или установка видимости столбца.

(Унаследовано от DataGridColumn)
Width

Получение или установка ширины столбца либо режима автоматического изменения размера.

(Унаследовано от DataGridColumn)

Методы

CancelCellEdit(FrameworkElement, Object)

Приводит к восстановлению исходного неизмененного значения в изменяемой ячейке.

(Унаследовано от DataGridColumn)
CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.

(Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)

Очищает локальное значение свойства. Очищаемое свойство задается идентификатором DependencyProperty.

(Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)

Очищает локальное значение доступного только для чтения свойства. Очищаемое свойство задается ключом DependencyPropertyKey.

(Унаследовано от DependencyObject)
CoerceValue(DependencyProperty)

Приводит значение указанного свойства зависимостей. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject.

(Унаследовано от DependencyObject)
CommitCellEdit(FrameworkElement)

Выполняет любую необходимую проверку перед выходом из режима правки ячейки.

(Унаследовано от DataGridColumn)
Equals(Object)

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject.

(Унаследовано от DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Получает элемент, определяемый шаблоном CellEditingTemplate, привязанный к значению свойства Binding столбца.

GenerateElement(DataGridCell, Object)

Получает элемент, определяемый шаблоном CellTemplate, привязанный к значению свойства Binding столбца.

GetCellContent(DataGridRow)

Извлекает значение свойства Content для ячейки, расположенной на пересечении данного столбца и указанной строки.

(Унаследовано от DataGridColumn)
GetCellContent(Object)

Получает значение свойства Content для ячейки, которая расположена на пересечении данного столбца и строки, представляющей указанный элемент данных.

(Унаследовано от DataGridColumn)
GetHashCode()

Возвращает хэш-код для данного объекта DependencyObject.

(Унаследовано от DependencyObject)
GetLocalValueEnumerator()

Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject.

(Унаследовано от DependencyObject)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject.

(Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)

Повторно вычисляет действующее значение для указанного свойства зависимостей.

(Унаследовано от DependencyObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
NotifyPropertyChanged(String)

Уведомляет DataGrid, содержащий этот столбец, об изменении свойства столбца.

(Унаследовано от DataGridColumn)
OnCoerceIsReadOnly(Boolean)

Определяет значение свойства IsReadOnly на основе правил свойств объекта DataGrid, в котором содержится этот столбец.

(Унаследовано от DataGridColumn)
OnCopyingCellClipboardContent(Object)

Вызывает событие CopyingCellClipboardContent.

(Унаследовано от DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Вызывает событие PastingCellClipboardContent.

(Унаследовано от DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного DependencyObject. Конкретное измененное свойство зависимостей сообщается в данных события.

(Унаследовано от DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

При переопределении в производном классе задает содержимое ячейки, которое требуется изменить.

(Унаследовано от DataGridColumn)
ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если таковое существует.

(Унаследовано от DependencyObject)
RefreshCellContent(FrameworkElement, String)

Обновляет содержимое ячейки в столбце в ответ на изменение значения свойства шаблона.

SetCurrentValue(DependencyProperty, Object)

Задает значение свойства зависимостей, не меняя источник значения.

(Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства.

(Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей.

(Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей.

(Унаследовано от DependencyObject)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)
VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.

(Унаследовано от DispatcherObject)

События

CopyingCellClipboardContent

Происходит после подготовки содержимого буфера обмена ячейки.

(Унаследовано от DataGridColumn)
PastingCellClipboardContent

Происходит перед перемещением содержимого буфера обмена в ячейку.

(Унаследовано от DataGridColumn)

Применяется к

См. также раздел