DataGridTextColumn 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示一个 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 数据的详细信息,请参阅 如何:使用 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 元素。
可以通过设置属性(如 、、 HeaderFontSize和 IsReadOnly)Width来自定义 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 |
获取 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) |
方法
事件
CopyingCellClipboardContent |
在单元格剪贴板内容准备好之后发生。 (继承自 DataGridColumn) |
PastingCellClipboardContent |
在剪贴板内容传输到单元格之前发生。 (继承自 DataGridColumn) |
适用于
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈