DataGridTemplateColumn Kelas

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

Mewakili kolom yang menghosting DataGrid konten yang ditentukan templat dalam selnya.

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

Warisan

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridTemplateColumn

Contoh

Contoh berikut menunjukkan cara membuat 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>

Ilustrasi berikut menunjukkan output dari XAML sebelumnya.

Keterangan

Jenis ini DataGridTemplateColumn memungkinkan Anda membuat jenis kolom Anda sendiri dengan menentukan templat sel yang akan digunakan saat menampilkan dan mengedit nilai. Untuk menentukan templat yang digunakan untuk menampilkan konten sel yang tidak dalam mode pengeditan, atur CellTemplate properti . Untuk menentukan templat yang digunakan untuk menampilkan konten sel yang berada dalam mode pengeditan, atur CellEditingTemplate properti . Untuk informasi selengkapnya tentang templat, lihat Gambaran Umum Templat Data dan Gaya dan Templat.

Untuk kenyamanan, DataGrid berikan jenis kolom yang telah ditentukan sebelumnya berikut:

Jenis Kolom	Tampilan Data
DataGridHyperlinkColumn	Gunakan untuk menampilkan data URI.
DataGridComboBoxColumn	Gunakan untuk menampilkan data enumerasi.
DataGridTextColumn	Gunakan untuk menampilkan teks.
DataGridCheckBoxColumn	Gunakan untuk menampilkan data Boolean.

Konstruktor

DataGridTemplateColumn()

Menginisialisasi instans baru kelas DataGridTemplateColumn.

Bidang

CellEditingTemplateProperty	CellEditingTemplate Mengidentifikasi properti dependensi.
CellEditingTemplateSelectorProperty	CellEditingTemplateSelector Mengidentifikasi properti dependensi.
CellTemplateProperty	CellTemplate Mengidentifikasi properti dependensi.
CellTemplateSelectorProperty	CellEditingTemplateSelector Mengidentifikasi properti dependensi.

Properti

ActualWidth	Mendapatkan lebar kolom saat ini, di unit independen perangkat (1/96 inci per unit). (Diperoleh dari DataGridColumn)
CanUserReorder	Mendapatkan atau mengatur nilai yang menunjukkan apakah pengguna dapat mengubah posisi tampilan kolom dengan menyeret header kolom. (Diperoleh dari DataGridColumn)
CanUserResize	Mendapatkan atau mengatur nilai yang menunjukkan apakah pengguna dapat menyesuaikan lebar kolom dengan menggunakan mouse. (Diperoleh dari DataGridColumn)
CanUserSort	Mendapatkan atau mengatur nilai yang menunjukkan apakah pengguna dapat mengurutkan kolom dengan mengklik header kolom. (Diperoleh dari DataGridColumn)
CellEditingTemplate	Mendapatkan atau mengatur templat yang akan digunakan untuk menampilkan konten sel yang berada dalam mode pengeditan.
CellEditingTemplateSelector	Mendapatkan atau mengatur objek yang menentukan templat mana yang akan digunakan untuk menampilkan konten sel yang berada dalam mode pengeditan.
CellStyle	Mendapatkan atau mengatur gaya yang digunakan untuk merender sel dalam kolom. (Diperoleh dari DataGridColumn)
CellTemplate	Mendapatkan atau mengatur templat yang akan digunakan untuk menampilkan konten sel yang tidak dalam mode pengeditan.
CellTemplateSelector	Mendapatkan atau mengatur objek yang menentukan templat mana yang akan digunakan untuk menampilkan konten sel yang tidak dalam mode pengeditan.
ClipboardContentBinding	Mendapatkan atau mengatur objek pengikatan yang akan digunakan saat mendapatkan atau mengatur konten sel untuk clipboard. (Diperoleh dari DataGridColumn)
DataGridOwner	DataGrid Mendapatkan kontrol yang berisi kolom ini. (Diperoleh dari DataGridColumn)
DependencyObjectType	Mendapatkan yang membungkus jenis CLR instans DependencyObjectType ini. (Diperoleh dari DependencyObject)
Dispatcher	Mendapatkan ini DispatcherDispatcherObject dikaitkan dengan. (Diperoleh dari DispatcherObject)
DisplayIndex	Mendapatkan atau mengatur posisi tampilan kolom relatif terhadap kolom lain di DataGrid. (Diperoleh dari DataGridColumn)
DragIndicatorStyle	Mendapatkan atau mengatur objek gaya untuk diterapkan ke header kolom selama operasi seret. (Diperoleh dari DataGridColumn)
Header	Mendapatkan atau mengatur konten header kolom. (Diperoleh dari DataGridColumn)
HeaderStringFormat	Mendapatkan atau mengatur pola format untuk diterapkan ke konten header kolom. (Diperoleh dari DataGridColumn)
HeaderStyle	Mendapatkan atau mengatur gaya yang digunakan saat merender header kolom. (Diperoleh dari DataGridColumn)
HeaderTemplate	Mendapatkan atau mengatur templat yang menentukan representasi visual header kolom. (Diperoleh dari DataGridColumn)
HeaderTemplateSelector	Mendapatkan atau mengatur objek yang memilih templat mana yang akan digunakan untuk header kolom. (Diperoleh dari DataGridColumn)
IsAutoGenerated	Mendapatkan nilai yang menunjukkan apakah kolom dibuat secara otomatis. (Diperoleh dari DataGridColumn)
IsFrozen	Mendapatkan nilai yang menunjukkan apakah kolom dicegah menggulir secara horizontal. (Diperoleh dari DataGridColumn)
IsReadOnly	Mendapatkan atau mengatur nilai yang menunjukkan apakah sel dalam kolom dapat diedit. (Diperoleh dari DataGridColumn)
IsSealed	Mendapatkan nilai yang menunjukkan apakah instans ini saat ini disegel (baca-saja). (Diperoleh dari DependencyObject)
MaxWidth	Mendapatkan atau mengatur batasan lebar maksimum kolom. (Diperoleh dari DataGridColumn)
MinWidth	Mendapatkan atau mengatur batasan lebar minimum kolom. (Diperoleh dari DataGridColumn)
SortDirection	Mendapatkan atau mengatur arah pengurutan (naik atau turun) kolom. (Diperoleh dari DataGridColumn)
SortMemberPath	Mendapatkan atau mengatur nama properti, atau hierarki nama properti yang dibatasi titik, yang menunjukkan anggota untuk diurutkan. (Diperoleh dari DataGridColumn)
Visibility	Mendapatkan atau mengatur visibilitas kolom. (Diperoleh dari DataGridColumn)
Width	Mendapatkan atau mengatur lebar kolom atau mode ukuran otomatis. (Diperoleh dari DataGridColumn)

Metode

CancelCellEdit(FrameworkElement, Object)	Menyebabkan sel diedit kembali ke nilai asli yang tidak diedit. (Diperoleh dari DataGridColumn)
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dibersihkan ditentukan oleh DependencyProperty pengidentifikasi. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dibersihkan ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
CoerceValue(DependencyProperty)	Memaksakan nilai properti dependensi yang ditentukan. Ini dicapai dengan memanggil fungsi apa pun CoerceValueCallback yang ditentukan dalam metadata properti untuk properti dependensi seperti yang ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
CommitCellEdit(FrameworkElement)	Melakukan validasi yang diperlukan sebelum keluar dari mode pengeditan sel. (Diperoleh dari DataGridColumn)
Equals(Object)	Menentukan apakah yang disediakan DependencyObject setara dengan saat ini DependencyObject. (Diperoleh dari DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Mendapatkan elemen yang ditentukan oleh CellEditingTemplate yang terikat ke nilai properti kolom Binding .
GenerateElement(DataGridCell, Object)	Mendapatkan elemen yang ditentukan oleh CellTemplate yang terikat ke nilai properti kolom Binding .
GetCellContent(DataGridRow)	Content Mengambil nilai properti untuk sel di persimpangan kolom ini dan baris yang ditentukan. (Diperoleh dari DataGridColumn)
GetCellContent(Object)	Content Mendapatkan nilai properti untuk sel di persimpangan kolom ini dan baris yang mewakili item data yang ditentukan. (Diperoleh dari DataGridColumn)
GetHashCode()	Mendapatkan kode hash untuk ini DependencyObject. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans ini dari DependencyObject. (Diperoleh dari DependencyObject)
InvalidateProperty(DependencyProperty)	Mengevaluasi ulang nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
NotifyPropertyChanged(String)	Memberi tahu DataGrid yang berisi kolom ini bahwa properti kolom telah berubah. (Diperoleh dari DataGridColumn)
OnCoerceIsReadOnly(Boolean)	Menentukan nilai IsReadOnly properti berdasarkan aturan DataGrid properti yang berisi kolom ini. (Diperoleh dari DataGridColumn)
OnCopyingCellClipboardContent(Object)	Memunculkan kejadian CopyingCellClipboardContent. (Diperoleh dari DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Memunculkan kejadian PastingCellClipboardContent. (Diperoleh dari DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Dipanggil setiap kali nilai efektif dari properti dependensi apa pun pada ini DependencyObject telah diperbarui. Properti dependensi tertentu yang berubah dilaporkan dalam data peristiwa. (Diperoleh dari DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Saat ditimpa di kelas turunan, mengatur konten sel sesuai kebutuhan untuk pengeditan. (Diperoleh dari DataGridColumn)
ReadLocalValue(DependencyProperty)	Mengembalikan nilai lokal properti dependensi, jika ada. (Diperoleh dari DependencyObject)
RefreshCellContent(FrameworkElement, String)	Merefresh konten sel dalam kolom sebagai respons terhadap perubahan nilai properti templat.
SetCurrentValue(DependencyProperty, Object)	Mengatur nilai properti dependensi tanpa mengubah sumber nilainya. (Diperoleh dari DependencyObject)
SetValue(DependencyProperty, Object)	Mengatur nilai lokal properti dependensi, yang ditentukan oleh pengidentifikasi properti dependensinya. (Diperoleh dari DependencyObject)
SetValue(DependencyPropertyKey, Object)	Mengatur nilai lokal properti dependensi baca-saja, yang ditentukan oleh DependencyPropertyKey pengidentifikasi properti dependensi. (Diperoleh dari DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Mengembalikan nilai yang menunjukkan apakah proses serialisasi harus membuat serialisasi nilai untuk properti dependensi yang disediakan. (Diperoleh dari DependencyObject)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
VerifyAccess()	Memberlakukan bahwa utas panggilan memiliki akses ke ini DispatcherObject. (Diperoleh dari DispatcherObject)

Acara

CopyingCellClipboardContent	Terjadi setelah konten clipboard sel disiapkan. (Diperoleh dari DataGridColumn)
PastingCellClipboardContent	Terjadi sebelum konten clipboard dipindahkan ke sel. (Diperoleh dari DataGridColumn)

Lihat juga

• DataGrid