DataGridTextColumn DataGridTextColumn DataGridTextColumn DataGridTextColumn Class

定義

セルのテキスト コンテンツをホストする DataGrid 列を表します。Represents a DataGrid column that hosts textual content in its cells.

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 データのソースとして使用します。The following example creates a DataGrid that has customized text columns and uses XML data as the source. このトピックの前の図は、このコードの表示方法を示します。The illustration earlier in this topic shows how this code is displayed. XML データにバインドする方法の詳細については、次を参照してください。方法。XMLDataProvider と XPath クエリを使用して XML データにバインドします。For more information about binding to XML data, see How to: Bind to XML Data Using an XMLDataProvider and XPath Queries.

<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列のデータをテキストとして表示します。Use DataGridTextColumn to display columns of data as text. 次の図は、2 つの例を示しています。DataGridTextColumn型。The following illustration shows an example of two DataGridTextColumn types.

2 つの DatagridtextcolumnTwo DataGridTextColumns

列を作成するには、追加して、Columnsコレクション。To create a column, add it to the Columns collection. 列を設定する列データにバインドを使用して、Bindingプロパティ。To populate the column, bind the column to the data by using the Binding property. Bindingプロパティに適用、TextBlockまたはTextBox要素の列を作成します。The Binding property is applied to the TextBlock or TextBox element created in the column. DataContextセルが行のデータ項目は各セル内の要素。The DataContext for the element in each cell is the data item for the row the cell is in. そのため、バインドを設定するだけに設定しておく、Binding.Pathします。Therefore, to set up the binding you only have to set the Binding.Path. 必要に応じて、指定、Binding.Converterデータを変換する場合、またはStringFormatします。Optionally, you can specify a Binding.Converter if you want to convert the data or the StringFormat. データ バインディングの詳細については、次を参照してください。データ バインド (WPF)します。For more information about data binding, see Data Binding (WPF).

DataGridTextColumnを作成、TextBlock非編集モードでの要素とTextBox編集モードでの要素。Note DataGridTextColumn creates a TextBlock element in the non-editing mode and a TextBox element in the editing mode.

カスタマイズすることができます、DataGridTextColumnなどのプロパティを設定してWidthHeaderFontSize、およびIsReadOnlyします。You can customize the DataGridTextColumn by setting properties, such as Width, Header, FontSize, and IsReadOnly.

その他の種類のデータを表示したい場合DataGrid次の列の型を提供します。If you want to display other types of data, DataGrid provides the following column types:

列の型Column Type データ表示Data Display
DataGridHyperlinkColumn URI データを表示する場合に使用します。Use to display URI data.
DataGridComboBoxColumn 使用すると、列挙型のデータを表示します。Use to display enumeration data.
DataGridCheckBoxColumn 使用すると、ブール型のデータを表示します。Use to display Boolean data.

他のコントロールを使用する場合、DataGridを使用して列の型を作成するDataGridTemplateColumnします。If you want to use other controls in your DataGrid, you can create your own column types by using DataGridTemplateColumn.

コンストラクター

DataGridTextColumn() DataGridTextColumn() DataGridTextColumn() DataGridTextColumn()

DataGridTextColumn クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataGridTextColumn class.

フィールド

FontFamilyProperty FontFamilyProperty FontFamilyProperty FontFamilyProperty

FontFamily 依存関係プロパティを識別します。Identifies the FontFamily dependency property.

FontSizeProperty FontSizeProperty FontSizeProperty FontSizeProperty

FontSize 依存関係プロパティを識別します。Identifies the FontSize dependency property.

FontStyleProperty FontStyleProperty FontStyleProperty FontStyleProperty

FontStyle 依存関係プロパティを識別します。Identifies the FontStyle dependency property.

FontWeightProperty FontWeightProperty FontWeightProperty FontWeightProperty

FontWeight 依存関係プロパティを識別します。Identifies the FontWeight dependency property.

ForegroundProperty ForegroundProperty ForegroundProperty ForegroundProperty

Foreground 依存関係プロパティを識別します。Identifies the Foreground dependency property.

プロパティ

ActualWidth ActualWidth ActualWidth ActualWidth

列の現在の幅を デバイスに依存しない単位 (1 単位は 1/96 インチ)device-independent units (1/96th inch per unit) 単位で取得します。Gets the current width of the column, in デバイスに依存しない単位 (1 単位は 1/96 インチ)device-independent units (1/96th inch per unit).

(Inherited from DataGridColumn)
Binding Binding Binding Binding

列とデータソースのプロパティを関連付けるバインドを取得または設定します。Gets or sets the binding that associates the column with a property in the data source.

(Inherited from DataGridBoundColumn)
CanUserReorder CanUserReorder CanUserReorder CanUserReorder

ユーザーが列見出しをドラッグして列の表示位置を変更できるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(Inherited from DataGridColumn)
CanUserResize CanUserResize CanUserResize CanUserResize

ユーザーがマウスを使用して列幅を調整できるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Inherited from DataGridColumn)
CanUserSort CanUserSort CanUserSort CanUserSort

ユーザーが列見出しをクリックして項目を並べ替えられるかどうかを示す値を取得または設定します。Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Inherited from DataGridColumn)
CellStyle CellStyle CellStyle CellStyle

列に含まれるセルを表示するときに使用するスタイルを取得または設定します。Gets or sets the style that is used to render cells in the column.

(Inherited from DataGridColumn)
ClipboardContentBinding ClipboardContentBinding ClipboardContentBinding ClipboardContentBinding

クリップボードのセルの内容を取得または設定するときに使用するバインディング オブジェクトを取得または設定します。Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Inherited from DataGridBoundColumn)
DataGridOwner DataGridOwner DataGridOwner DataGridOwner

この列を格納している DataGrid コントロールを取得します。Gets the DataGrid control that contains this column.

(Inherited from DataGridColumn)
DefaultEditingElementStyle DefaultEditingElementStyle DefaultEditingElementStyle DefaultEditingElementStyle

EditingElementStyle プロパティの既定値。The default value of the EditingElementStyle property.

DefaultElementStyle DefaultElementStyle DefaultElementStyle DefaultElementStyle

ElementStyle プロパティの既定値。The default value of the ElementStyle property.

DependencyObjectType DependencyObjectType DependencyObjectType DependencyObjectType

このインスタンスの CLRCLR 型をラップする DependencyObjectType を取得します。Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Inherited from DependencyObject)
Dispatcher Dispatcher Dispatcher Dispatcher

取得、DispatcherこのDispatcherObjectに関連付けられています。Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
DisplayIndex DisplayIndex DisplayIndex DisplayIndex

DataGrid 内の他の列を基準とした列の表示位置を設定または取得します。Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Inherited from DataGridColumn)
DragIndicatorStyle DragIndicatorStyle DragIndicatorStyle DragIndicatorStyle

ドラッグ操作中に列ヘッダーに適用するスタイル オブジェクトを取得または設定します。Gets or sets the style object to apply to the column header during a drag operation.

(Inherited from DataGridColumn)
EditingElementStyle EditingElementStyle EditingElementStyle EditingElementStyle

編集モードのセルに列で表示される要素のレンダリングに使用するスタイルを取得または設定します。Gets or sets the style that is used when rendering the element that the column displays for a cell in editing mode.

(Inherited from DataGridBoundColumn)
ElementStyle ElementStyle ElementStyle ElementStyle

編集モードではないセルに列で表示される要素のレンダリングに使用するスタイルを取得または設定します。Gets or sets the style that is used when rendering the element that the column displays for a cell that is not in editing mode.

(Inherited from DataGridBoundColumn)
FontFamily FontFamily FontFamily FontFamily

列内のセルのコンテンツのフォント ファミリを取得または設定します。Gets or sets the font family for the content of cells in the column.

FontSize FontSize FontSize FontSize

列内のセルのコンテンツのフォント サイズを取得または設定します。Gets or sets the font size for the content of cells in the column.

FontStyle FontStyle FontStyle FontStyle

列内のセルのコンテンツのフォント スタイルを取得または設定します。Gets or sets the font style for the content of cells in the column.

FontWeight FontWeight FontWeight FontWeight

列内のセルのコンテンツのフォントの太さを取得または設定します。Gets or sets the font weight for the content of cells in the column.

Foreground Foreground Foreground Foreground

列内のセルのテキスト コンテンツの描画に使用する Brush を取得または設定します。Gets or sets the Brush that is used to paint the text contents of cells in the column.

Header Header Header Header

列見出しのコンテンツを取得または設定します。Gets or sets the content of the column header.

(Inherited from DataGridColumn)
HeaderStringFormat HeaderStringFormat HeaderStringFormat HeaderStringFormat

列ヘッダーの内容に適用される書式パターンを取得または設定します。Gets or sets the format pattern to apply to the content of the column header.

(Inherited from DataGridColumn)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

列ヘッダーの描画に使用されるスタイルを取得または設定します。Gets or sets the style that is used when rendering the column header.

(Inherited from DataGridColumn)
HeaderTemplate HeaderTemplate HeaderTemplate HeaderTemplate

列ヘッダーの視覚表示を定義するテンプレートを取得または設定します。Gets or sets the template that defines the visual representation of the column header.

(Inherited from DataGridColumn)
HeaderTemplateSelector HeaderTemplateSelector HeaderTemplateSelector HeaderTemplateSelector

列ヘッダーに使用するテンプレートを選択するオブジェクトを取得または設定します。Gets or sets the object that selects which template to use for the column header.

(Inherited from DataGridColumn)
IsAutoGenerated IsAutoGenerated IsAutoGenerated IsAutoGenerated

列が自動生成されるかどうかを示す値を取得します。Gets a value that indicates whether the column is auto-generated.

(Inherited from DataGridColumn)
IsFrozen IsFrozen IsFrozen IsFrozen

列の水平方向のスクロールが禁止されているかどうかを示す値を取得します。Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Inherited from DataGridColumn)
IsReadOnly IsReadOnly IsReadOnly IsReadOnly

列のセルが編集可能かどうかを示す値を取得または設定します。Gets or sets a value that indicates whether cells in the column can be edited.

(Inherited from DataGridColumn)
IsSealed IsSealed IsSealed IsSealed

このインスタンスが現在シールされている (読み取り専用である) かどうかを示す値を取得します。Gets a value that indicates whether this instance is currently sealed (read-only).

(Inherited from DependencyObject)
MaxWidth MaxWidth MaxWidth MaxWidth

列の幅の上限を取得または設定します。Gets or sets the maximum width constraint of the column.

(Inherited from DataGridColumn)
MinWidth MinWidth MinWidth MinWidth

列の幅の下限を取得または設定します。Gets or sets the minimum width constraint of the column.

(Inherited from DataGridColumn)
SortDirection SortDirection SortDirection SortDirection

列の並べ替え方向 (昇順または降順) を取得または設定します。Gets or sets the sort direction (ascending or descending) of the column.

(Inherited from DataGridColumn)
SortMemberPath SortMemberPath SortMemberPath SortMemberPath

メンバーの並べ替えの基準にするプロパティ名、または階層をピリオドで区切ったプロパティ名を取得または設定します。Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Inherited from DataGridColumn)
Visibility Visibility Visibility Visibility

列の可視性を取得または設定します。Gets or sets the visibility of the column.

(Inherited from DataGridColumn)
Width Width Width Width

列の幅または自動サイズ調整モードを取得または設定します。Gets or sets the column width or automatic sizing mode.

(Inherited from DataGridColumn)

メソッド

CancelCellEdit(FrameworkElement, Object) CancelCellEdit(FrameworkElement, Object) CancelCellEdit(FrameworkElement, Object) CancelCellEdit(FrameworkElement, Object)

列の編集中のセルの値を、指定した値に戻します。Causes the column cell being edited to revert to the specified value.

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

呼び出し元のスレッドが、これに対するアクセス権を持つかどうかを判断しますDispatcherObjectします。Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty) ClearValue(DependencyProperty)

プロパティのローカル値をクリアします。Clears the local value of a property. クリアするプロパティは DependencyProperty 識別子で指定されます。The property to be cleared is specified by a DependencyProperty identifier.

(Inherited from DependencyObject)
ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey) ClearValue(DependencyPropertyKey)

読み取り専用プロパティのローカル値を消去します。Clears the local value of a read-only property. 消去するプロパティは、DependencyPropertyKey で指定します。The property to be cleared is specified by a DependencyPropertyKey.

(Inherited from DependencyObject)
CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty) CoerceValue(DependencyProperty)

指定した依存関係プロパティの値を強制します。Coerces the value of the specified dependency property. これは、呼び出し元の DependencyObject の依存関係プロパティのプロパティ メタデータで指定されている CoerceValueCallback 関数を呼び出すことによって実現されます。This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Inherited from DependencyObject)
CommitCellEdit(FrameworkElement) CommitCellEdit(FrameworkElement) CommitCellEdit(FrameworkElement) CommitCellEdit(FrameworkElement)

編集モードを終了する前に、必要な検証を実行します。Performs any required validation before exiting the edit mode.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定した DependencyObject が現在の DependencyObject と等しいかどうかを判断します。Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Inherited from DependencyObject)
GenerateEditingElement(DataGridCell, Object) GenerateEditingElement(DataGridCell, Object) GenerateEditingElement(DataGridCell, Object) GenerateEditingElement(DataGridCell, Object)

列の TextBox プロパティ値にバインドされた Binding コントロールを取得します。Gets a TextBox control that is bound to the column's Binding property value.

GenerateElement(DataGridCell, Object) GenerateElement(DataGridCell, Object) GenerateElement(DataGridCell, Object) GenerateElement(DataGridCell, Object)

列の TextBlock プロパティ値にバインドされた読み取り専用の Binding コントロールを取得します。Gets a read-only TextBlock control that is bound to the column's Binding property value.

GetCellContent(DataGridRow) GetCellContent(DataGridRow) GetCellContent(DataGridRow) GetCellContent(DataGridRow)

この列と指定された行の交差位置にあるセルの Content プロパティ値を取得します。Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Inherited from DataGridColumn)
GetCellContent(Object) GetCellContent(Object) GetCellContent(Object) GetCellContent(Object)

この列と指定されたデータ項目を表す行の交差位置にあるセルの Content プロパティ値を取得します。Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Inherited from DataGridColumn)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

この DependencyObject のハッシュ コードを取得します。Gets a hash code for this DependencyObject.

(Inherited from DependencyObject)
GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator() GetLocalValueEnumerator()

どの依存関係プロパティがこの DependencyObject 上にローカルに設定された値を持つかを確認するための、専用の列挙子を作成します。Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Inherited from DependencyObject)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty) GetValue(DependencyProperty)

DependencyObject のこのインスタンスにある依存関係プロパティの現在の有効値を返します。Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Inherited from DependencyObject)
InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty) InvalidateProperty(DependencyProperty)

指定した依存関係プロパティの有効値を再評価します。Re-evaluates the effective value for the specified dependency property

(Inherited from DependencyObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
NotifyPropertyChanged(String) NotifyPropertyChanged(String) NotifyPropertyChanged(String) NotifyPropertyChanged(String)

この列を含んでいる DataGrid に、列プロパティが変更されたことを通知します。Notifies the DataGrid that contains this column that a column property has changed.

(Inherited from DataGridColumn)
OnBindingChanged(BindingBase, BindingBase) OnBindingChanged(BindingBase, BindingBase) OnBindingChanged(BindingBase, BindingBase) OnBindingChanged(BindingBase, BindingBase)

DataGrid プロパティの値が変更された場合に、Binding に通知します。Notifies the DataGrid when the value of the Binding property changes.

(Inherited from DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean) OnCoerceIsReadOnly(Boolean) OnCoerceIsReadOnly(Boolean) OnCoerceIsReadOnly(Boolean)

この列を格納するデータ グリッドのプロパティ規則に基づいて IsReadOnly プロパティの値を決定します。Determines the value of the IsReadOnly property based on property rules from the data grid that contains this column.

(Inherited from DataGridBoundColumn)
OnCopyingCellClipboardContent(Object) OnCopyingCellClipboardContent(Object) OnCopyingCellClipboardContent(Object) OnCopyingCellClipboardContent(Object)

CopyingCellClipboardContent イベントを発生させます。Raises the CopyingCellClipboardContent event.

(Inherited from DataGridColumn)
OnPastingCellClipboardContent(Object, Object) OnPastingCellClipboardContent(Object, Object) OnPastingCellClipboardContent(Object, Object) OnPastingCellClipboardContent(Object, Object)

PastingCellClipboardContent イベントを発生させます。Raises the PastingCellClipboardContent event.

(Inherited from DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs) OnPropertyChanged(DependencyPropertyChangedEventArgs)

この DependencyObject の依存関係プロパティの有効値が更新された場合に必ず呼び出されます。Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. 変更が発生した特定の依存関係プロパティがイベント データで報告されます。The specific dependency property that changed is reported in the event data.

(Inherited from DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs) PrepareCellForEdit(FrameworkElement, RoutedEventArgs) PrepareCellForEdit(FrameworkElement, RoutedEventArgs) PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

列内のセルが編集モードになるとき呼び出されます。Called when a cell in the column enters editing mode.

ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty) ReadLocalValue(DependencyProperty)

ローカルの依存関係プロパティの値を返します (存在する場合)。Returns the local value of a dependency property, if it exists.

(Inherited from DependencyObject)
RefreshCellContent(FrameworkElement, String) RefreshCellContent(FrameworkElement, String) RefreshCellContent(FrameworkElement, String) RefreshCellContent(FrameworkElement, String)

列のプロパティ値の変更に応じて、列内のセルのコンテンツを更新します。Refreshes the contents of a cell in the column in response to a column property value change.

SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object) SetCurrentValue(DependencyProperty, Object)

依存関係プロパティ値のソースを変更せずにその値を設定します。Sets the value of a dependency property without changing its value source.

(Inherited from DependencyObject)
SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object) SetValue(DependencyProperty, Object)

依存関係プロパティ識別子を指定して、該当する依存関係プロパティのローカル値を設定します。Sets the local value of a dependency property, specified by its dependency property identifier.

(Inherited from DependencyObject)
SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object) SetValue(DependencyPropertyKey, Object)

依存関係プロパティの DependencyPropertyKey 識別子で指定した読み取り専用の依存関係プロパティのローカル値を設定します。Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Inherited from DependencyObject)
ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty) ShouldSerializeProperty(DependencyProperty)

シリアル化プロセスが、指定された依存関係プロパティの値をシリアル化する必要があるかどうかを示す値を返します。Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Inherited from DependencyObject)
ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

呼び出し元のスレッドがこのへのアクセスを強制DispatcherObjectします。Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

イベント

CopyingCellClipboardContent CopyingCellClipboardContent CopyingCellClipboardContent CopyingCellClipboardContent

セルのクリップボードの内容が準備された後に発生します。Occurs after the cell clipboard content is prepared.

(Inherited from DataGridColumn)
PastingCellClipboardContent PastingCellClipboardContent PastingCellClipboardContent PastingCellClipboardContent

クリップボードの内容がセルに移動される前に発生します。Occurs before the clipboard content is moved to the cell.

(Inherited from DataGridColumn)

適用対象