DataGridTextColumn Класс

Определение

Пространство имен:

System.Windows.Controls

Сборка:

PresentationFramework.dll

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

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

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

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn

DataGridTextColumn

Примеры

В следующем примере создается объект , DataGrid который имеет настроенные текстовые столбцы и использует XML-данные в качестве источника. На рисунке выше в этом разделе показано, как отображается этот код. Дополнительные сведения о привязке к XML-данным см. в разделе Практическое руководство. Привязка к XML-данным с помощью XMLDataProvider и запросов XPath.

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

Комментарии

Используется DataGridTextColumn для отображения столбцов данных в виде текста. На следующем рисунке показан пример двух DataGridTextColumn типов.

Чтобы создать столбец, добавьте его в коллекцию Columns . Чтобы заполнить столбец, привяжите столбец к данным с помощью Binding свойства . Свойство Binding применяется к элементу или TextBox , TextBlock созданному в столбце. Элемент DataContext для элемента в каждой ячейке является элементом данных для строки, в которых находится ячейка. Поэтому для настройки привязки необходимо задать Binding.Pathтолько . При необходимости можно указать Binding.Converter , если требуется преобразовать данные или StringFormat. Дополнительные сведения о привязке данных см. в разделе Привязка данных (WPF).

ПримечаниеDataGridTextColumn создает TextBlock элемент в режиме без редактирования и TextBox элемент в режиме редактирования.

Можно настроить , DataGridTextColumn задав свойства, такие как Width, Header, FontSizeи IsReadOnly.

Если вы хотите отобразить другие типы данных, DataGrid предоставляет следующие типы столбцов:

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

Если вы хотите использовать другие элементы управления в DataGrid, можно создать собственные типы столбцов с помощью DataGridTemplateColumn.

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

DataGridTextColumn()

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

Поля

FontFamilyProperty	Идентифицирует свойство зависимостей FontFamily.
FontSizeProperty	Идентифицирует свойство зависимостей FontSize.
FontStyleProperty	Идентифицирует свойство зависимостей FontStyle.
FontWeightProperty	Идентифицирует свойство зависимостей FontWeight.
ForegroundProperty	Идентифицирует свойство зависимостей Foreground.

Свойства

ActualWidth	Возвращает текущую ширину столбца в аппаратно-независимых единицах (1/96 дюйма на единицу). (Унаследовано от DataGridColumn)
Binding	Получение или установка привязки, которая связывает столбец со свойством источника данных. (Унаследовано от DataGridBoundColumn)
CanUserReorder	Получение или установка значения, определяющего, может ли пользователь изменять позицию столбца, перетаскивая его заголовок мышью. (Унаследовано от DataGridColumn)
CanUserResize	Получает или задает значение, указывающее, может ли пользователь изменять ширину столбца с помощью мыши. (Унаследовано от DataGridColumn)
CanUserSort	Получение или установка значения, определяющего, может ли пользователь сортировать столбец, щелкая его заголовок. (Унаследовано от DataGridColumn)
CellStyle	Получает или задает стиль, используемый при визуализации ячеек в столбце. (Унаследовано от DataGridColumn)
ClipboardContentBinding	Получает или задает объект привязки, который должен использоваться при получении или задании содержимого ячейки для буфера обмена. (Унаследовано от DataGridBoundColumn)
DataGridOwner	Получает элемент управления DataGrid, содержащий этот столбец. (Унаследовано от DataGridColumn)
DefaultEditingElementStyle	Значение по умолчанию для свойства EditingElementStyle.
DefaultElementStyle	Значение по умолчанию для свойства ElementStyle.
DependencyObjectType	Возвращает объект , DependencyObjectType который заключает в оболочку тип СРЕДЫ CLR данного экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject. (Унаследовано от DispatcherObject)
DisplayIndex	Получает или задает позицию отображения столбца по отношению к другим столбцам в элементе управления DataGrid. (Унаследовано от DataGridColumn)
DragIndicatorStyle	Получает или задает объект стиля для применения к заголовку столбца во время операции перетаскивания. (Унаследовано от DataGridColumn)
EditingElementStyle	Получает или задает стиль, используемый при визуализации элемента, который отображается в столбце для ячейки, находящейся в режиме правки. (Унаследовано от DataGridBoundColumn)
ElementStyle	Получает или задает стиль, используемый при визуализации элемента, который отображается в столбце для ячейки, не находящейся в режиме правки. (Унаследовано от DataGridBoundColumn)
FontFamily	Получает или задает семейство шрифтов для содержимого ячеек в столбце.
FontSize	Получает или задает размер шрифта для содержимого ячеек в столбце.
FontStyle	Получает или задает начертание шрифта для содержимого ячеек в столбце.
FontWeight	Получает или задает насыщенность шрифта для содержимого ячеек в столбце.
Foreground	Получает или задает объект Brush, используемый для окрашивания текстового содержимого ячеек в столбце.
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)	Приводит к восстановлению указанного значения в изменяемой ячейке столбца.
CheckAccess()	Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)	Очищает локальное значение свойства. Очищаемое свойство задается идентификатором DependencyProperty. (Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)	Очищает локальное значение доступного только для чтения свойства. Очищаемое свойство задается ключом DependencyPropertyKey. (Унаследовано от DependencyObject)
CoerceValue(DependencyProperty)	Приводит значение указанного свойства зависимостей. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject. (Унаследовано от DependencyObject)
CommitCellEdit(FrameworkElement)	Выполняет любую необходимую проверку перед выходом из режима правки.
Equals(Object)	Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject. (Унаследовано от DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Получает элемент управления TextBox, привязанный к значению свойства Binding столбца.
GenerateElement(DataGridCell, Object)	Получает доступный только для чтения элемент управления TextBlock, привязанный к значению свойства 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)
OnBindingChanged(BindingBase, BindingBase)	Уведомляет объект DataGrid при изменении значения свойства Binding. (Унаследовано от DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Определяет значение свойства IsReadOnly на основе правил свойств из сетки данных, в которой содержится этот столбец. (Унаследовано от DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)	Вызывает событие CopyingCellClipboardContent. (Унаследовано от DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Вызывает событие PastingCellClipboardContent. (Унаследовано от DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного DependencyObject. Конкретное измененное свойство зависимостей сообщается в данных события. (Унаследовано от DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Вызывается, когда ячейка в столбце переходит в режим правки.
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)