DataGridTemplateColumn Класс

Определение

Пространство имен:: System.Windows.Controls

Сборка:: PresentationFramework.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Представляет столбец, на котором размещается содержимое, указанное шаблоном 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

Наследование: Object

DispatcherObject

DependencyObject

DataGridColumn
DataGridTemplateColumn

Примеры

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

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

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

DataGrid

Обратная связь

Были ли сведения на этой странице полезными?

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