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
継承

次の例では、カスタマイズされたテキスト列を含み、ソースとして XML データを使用する DataGrid を作成します。 このトピックの前の図は、このコードの表示方法を示しています。 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 を使用して、データの列をテキストとして表示します。 次の図は、2 つの DataGridTextColumn 型の例を示しています。

2 つの DataGridTextColumns2 つの DataGridTextColumnsする

列を作成するには、Columns コレクションに追加します。 列を設定するには、Binding プロパティを使用して列をデータにバインドします。 Binding プロパティは、列に作成された TextBlock または TextBox 要素に適用されます。 各セルの要素の DataContext は、セルが含まれる行のデータ項目です。 したがって、バインディングを設定するには、Binding.Pathを設定するだけで済むのです。 必要に応じて、データまたは StringFormatを変換する場合は、Binding.Converter を指定できます。 データ バインディングの詳細については、「データ バインディング (WPF)」を参照してください。

DataGridTextColumn は、非編集モードで TextBlock 要素を作成し、編集モードで TextBox 要素を作成します。

WidthHeaderFontSizeIsReadOnlyなどのプロパティを設定して、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)

編集中の列セルを指定した値に戻します。

CancelCellEdit(FrameworkElement, Object)

編集中のセルを元の編集されていない値に戻します。

(継承元 DataGridColumn)
CheckAccess()

呼び出し元のスレッドがこの DispatcherObjectにアクセスできるかどうかを判断します。

(継承元 DispatcherObject)
ClearValue(DependencyProperty)

プロパティのローカル値をクリアします。 クリアするプロパティは、DependencyProperty 識別子によって指定されます。

(継承元 DependencyObject)
ClearValue(DependencyPropertyKey)

読み取り専用プロパティのローカル値をクリアします。 クリアするプロパティは、DependencyPropertyKeyで指定します。

(継承元 DependencyObject)
CoerceValue(DependencyProperty)

指定した依存関係プロパティの値を強制します。 これは、呼び出し元の DependencyObjectに存在する依存関係プロパティのプロパティ メタデータで指定された CoerceValueCallback 関数を呼び出すことによって実現されます。

(継承元 DependencyObject)
CommitCellEdit(FrameworkElement)

編集モードを終了する前に、必要な検証を実行します。

CommitCellEdit(FrameworkElement)

セル編集モードを終了する前に、必要な検証を実行します。

(継承元 DataGridColumn)
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)

適用対象