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) 。
注意DataGridTextColumnTextBlock在非編輯模式中建立專案,以及 TextBox 編輯模式中的專案。
您可以藉由設定 、 Header 、 FontSize 和 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 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應