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 типов.
Чтобы создать столбец, добавьте его в коллекцию 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) |
Приводит к восстановлению указанного значения в изменяемой ячейке столбца. |
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) |
Применяется к
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по