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，该 DataGrid 具有自定义文本列，并将 XML 数据用作源。 本主题前面的插图显示了此代码的显示方式。 有关绑定到 XML 数据的详细信息，请参阅 如何：使用 XMLDataProvider 和 XPath 查询绑定到 XML 数据。

<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 属性应用于在列中创建的 TextBlock 或 TextBox 元素。 每个单元格中元素的 DataContext 是单元格所属行的数据项。 因此，若要设置绑定，只需设置 Binding.Path。 （可选）如果要转换数据或 StringFormat，可以指定 Binding.Converter。 有关数据绑定的详细信息，请参阅 数据绑定（WPF）。

注释DataGridTextColumn 在非编辑模式下创建 TextBlock 元素，并在编辑模式下创建 TextBox 元素。

可以通过设置属性（如 Width、Header、FontSize和 IsReadOnly）来自定义 DataGridTextColumn。

如果要显示其他类型的数据，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	获取包装此实例的 CLR 类型的 DependencyObjectType。 (继承自 DependencyObject)
Dispatcher	获取与此 DispatcherObject 关联的 Dispatcher。 (继承自 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)	强制指定依赖属性的值。 这是通过在调用 DependencyObject上调用依赖属性的属性元数据中指定的任何 CoerceValueCallback 函数来实现的。 (继承自 DependencyObject)
CommitCellEdit(FrameworkElement)	在退出编辑模式之前执行任何必需的验证。
Equals(Object)	确定提供的 DependencyObject 是否等效于当前 DependencyObject。 (继承自 DependencyObject)
GenerateEditingElement(DataGridCell, Object)	获取绑定到列的 Binding 属性值的 TextBox 控件。
GenerateElement(DataGridCell, Object)	获取绑定到列 Binding 属性值的只读 TextBlock 控件。
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)	当 Binding 属性的值发生更改时通知 DataGrid。 (继承自 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)