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


DataGridTextColumn Класс

Определение

Представляет столбец 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
Наследование

Примеры

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

Два DataGridTextColumns

Чтобы создать столбец, добавьте его в коллекцию Columns. Чтобы заполнить столбец, привязать столбец к данным с помощью свойства Binding. Свойство Binding применяется к элементу TextBlock или TextBox, созданному в столбце. 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)

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

CancelCellEdit(FrameworkElement, Object)

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

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

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

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

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

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

Очищает локальное значение свойства только для чтения. Свойство для очистки указывается DependencyPropertyKey.

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

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

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

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

CommitCellEdit(FrameworkElement)

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

(Унаследовано от DataGridColumn)
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)

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