DataGridTemplateColumn DataGridTemplateColumn DataGridTemplateColumn DataGridTemplateColumn Class

定義

テンプレートで指定されるセルの内容をホストする DataGrid 列を表します。Represents a DataGrid column that hosts template-specified content in its cells.

public ref class DataGridTemplateColumn : System::Windows::Controls::DataGridColumn
public class DataGridTemplateColumn : System.Windows.Controls.DataGridColumn
type DataGridTemplateColumn = class
    inherit DataGridColumn
Public Class DataGridTemplateColumn
Inherits DataGridColumn
継承

DataGridTemplateColumn を作成する方法を次のコード サンプルに示します。The following example shows how to create a DataGridTemplateColumn.

<Grid>
    <Grid.Resources>
        <!--DataTemplate for Published Date column defined in Grid.Resources.  PublishDate is a property on the ItemsSource of type DateTime -->
        <DataTemplate x:Key="DateTemplate" >
            <StackPanel Width="20" Height="30">
                <Border Background="LightBlue" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:MMM}}" FontSize="8" HorizontalAlignment="Center" />
                </Border>
                <Border Background="White" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:yyyy}}" FontSize="8" FontWeight="Bold" HorizontalAlignment="Center" />
                </Border>
            </StackPanel>
        </DataTemplate>
        <!--DataTemplate for the Published Date column when in edit mode. -->
        <DataTemplate x:Key="EditingDateTemplate">
            <DatePicker SelectedDate="{Binding PublishDate}"  />
        </DataTemplate>
    </Grid.Resources>
    <DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
        <DataGrid.Columns>
            <!--Custom column that shows the published date-->
            <DataGridTemplateColumn Header="Publish Date" CellTemplate="{StaticResource DateTemplate}" CellEditingTemplate="{StaticResource EditingDateTemplate}" />
        </DataGrid.Columns>
    </DataGrid>
</Grid>

次の図は、前の XAML からの出力を示しています。The following illustration shows the output from the previous XAML.

System.windows.datatemplate> を使用する列A column using a DataTemplate

注釈

DataGridTemplateColumn型を使用すると、値を表示および編集するときに使用するセルテンプレートを指定することで、独自の列の型を作成できます。The DataGridTemplateColumn type enables you to create your own column types by specifying the cell templates to use when displaying and editing values. 編集モードではないセルの内容を表示するために使用するテンプレートを指定するには、 CellTemplateプロパティを設定します。To specify the template that is used to display the contents of a cell that is not in editing mode, set the CellTemplate property. 編集モードのセルの内容を表示するために使用するテンプレートを指定するには、 CellEditingTemplateプロパティを設定します。To specify the template that is used to display the contents of a cell that is in editing mode, set the CellEditingTemplate property. テンプレートの詳細については、「データテンプレートの概要」と「スタイルとテンプレート」を参照してください。For more information about templates, see Data Templating Overview and Styling and Templating.

便宜上、にDataGridは次の定義済み列型が用意されています。For convenience, DataGrid provides the following pre-defined column types:

列の型Column Type データ表示Data Display
DataGridHyperlinkColumn URI データを表示するには、を使用します。Use to display URI data.
DataGridComboBoxColumn 列挙データを表示するには、を使用します。Use to display enumeration data.
DataGridTextColumn テキストの表示に使用します。Use to display text.
DataGridCheckBoxColumn ブール型のデータを表示するには、を使用します。Use to display Boolean data.

コンストラクター

DataGridTemplateColumn() DataGridTemplateColumn() DataGridTemplateColumn() DataGridTemplateColumn()

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

フィールド

CellEditingTemplateProperty CellEditingTemplateProperty CellEditingTemplateProperty CellEditingTemplateProperty

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

CellEditingTemplateSelectorProperty CellEditingTemplateSelectorProperty CellEditingTemplateSelectorProperty CellEditingTemplateSelectorProperty

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

CellTemplateProperty CellTemplateProperty CellTemplateProperty CellTemplateProperty

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

CellTemplateSelectorProperty CellTemplateSelectorProperty CellTemplateSelectorProperty CellTemplateSelectorProperty

CellEditingTemplateSelector 依存関係プロパティを識別します。Identifies the CellEditingTemplateSelector 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)
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)
CellEditingTemplate CellEditingTemplate CellEditingTemplate CellEditingTemplate

編集モードのセルの内容を表示するために使用するテンプレートを取得または設定します。Gets or sets the template to use to display the contents of a cell that is in editing mode.

CellEditingTemplateSelector CellEditingTemplateSelector CellEditingTemplateSelector CellEditingTemplateSelector

編集モードのセルの内容を表示するために、どのテンプレートを使用するかを決定するオブジェクトを取得または設定します。Gets or sets the object that determines which template to use to display the contents of a cell that is in editing mode.

CellStyle CellStyle CellStyle CellStyle

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

(Inherited from DataGridColumn)
CellTemplate CellTemplate CellTemplate CellTemplate

編集モードではないセルの内容を表示するために使用されるテンプレートを取得または設定します。Gets or sets the template to use to display the contents of a cell that is not in editing mode.

CellTemplateSelector CellTemplateSelector CellTemplateSelector CellTemplateSelector

編集モードではないセルの内容を表示するために、どのテンプレートを使用するかを決定するオブジェクトを取得または設定します。Gets or sets the object that determines which template to use to display the contents of a cell that is not in editing mode.

ClipboardContentBinding ClipboardContentBinding ClipboardContentBinding ClipboardContentBinding

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

(Inherited from DataGridColumn)
DataGridOwner DataGridOwner DataGridOwner DataGridOwner

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

(Inherited from DataGridColumn)
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)
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 cell being edited to revert to the original, unedited value.

(Inherited from DataGridColumn)
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 cell editing mode.

(Inherited from DataGridColumn)
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)

列の CellEditingTemplate プロパティ値にバインドされた Binding によって定義される要素を取得します。Gets an element defined by the CellEditingTemplate that is bound to the column's Binding property value.

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

列の CellTemplate プロパティ値にバインドされた Binding によって定義される要素を取得します。Gets an element defined by the CellTemplate 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)
OnCoerceIsReadOnly(Boolean) OnCoerceIsReadOnly(Boolean) OnCoerceIsReadOnly(Boolean) OnCoerceIsReadOnly(Boolean)

この列を格納する IsReadOnly のプロパティ規則に基づいて DataGrid プロパティの値を決定します。Determines the value of the IsReadOnly property based on the property rules of the DataGrid that contains this column.

(Inherited from DataGridColumn)
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)

派生クラスでオーバーライドされた場合、編集の必要に応じてセルの内容を設定します。When overridden in a derived class, sets cell content as needed for editing.

(Inherited from DataGridColumn)
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 template 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)

適用対象

こちらもご覧ください