DataGridTextColumn Kelas

Referensi

Definisi

Ruang nama:: System.Windows.Controls

Rakitan:: PresentationFramework.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mewakili kolom DataGrid yang menghosting konten tekstual dalam selnya.

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

Warisan: Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn
DataGridTextColumn

Contoh

Contoh berikut membuat DataGrid yang memiliki kolom teks yang dikustomisasi dan menggunakan data XML sebagai sumbernya. Ilustrasi sebelumnya dalam topik ini menunjukkan bagaimana kode ini ditampilkan. Untuk informasi selengkapnya tentang pengikatan ke data XML, lihat Cara: Mengikat ke Data XML Menggunakan Kueri XMLDataProvider dan XPath.

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

Keterangan

Gunakan DataGridTextColumn untuk menampilkan kolom data sebagai teks. Ilustrasi berikut menunjukkan contoh dua jenis DataGridTextColumn.

Dua DataGridTextColumns

Untuk membuat kolom, tambahkan ke koleksi Columns. Untuk mengisi kolom, ikat kolom ke data dengan menggunakan properti Binding. Properti Binding diterapkan ke elemen TextBlock atau TextBox yang dibuat di kolom. DataContext untuk elemen di setiap sel adalah item data untuk baris tempat sel berada. Oleh karena itu, untuk menyiapkan pengikatan, Anda hanya perlu mengatur Binding.Path. Secara opsional, Anda dapat menentukan Binding.Converter jika Anda ingin mengonversi data atau StringFormat. Untuk informasi selengkapnya tentang pengikatan data, lihat Data Binding (WPF).

NoteDataGridTextColumn membuat elemen TextBlock dalam mode non-pengeditan dan elemen TextBox dalam mode pengeditan.

Anda dapat menyesuaikan DataGridTextColumn dengan mengatur properti, seperti Width, Header, FontSize, dan IsReadOnly.

Jika Anda ingin menampilkan jenis data lain, DataGrid menyediakan jenis kolom berikut:

Tipe Kolom	Tampilan Data
DataGridHyperlinkColumn	Gunakan untuk menampilkan data URI.
DataGridComboBoxColumn	Gunakan untuk menampilkan data enumerasi.
DataGridCheckBoxColumn	Gunakan untuk menampilkan data Boolean.

Jika Anda ingin menggunakan kontrol lain di DataGrid, Anda dapat membuat jenis kolom Anda sendiri dengan menggunakan DataGridTemplateColumn.

Konstruktor

DataGridTextColumn()

Menginisialisasi instans baru kelas DataGridTextColumn.

Bidang

FontFamilyProperty	Mengidentifikasi properti dependensi FontFamily.
FontSizeProperty	Mengidentifikasi properti dependensi FontSize.
FontStyleProperty	Mengidentifikasi properti dependensi FontStyle.
FontWeightProperty	Mengidentifikasi properti dependensi FontWeight.
ForegroundProperty	Mengidentifikasi properti dependensi Foreground.

Properti

ActualWidth	Mendapatkan lebar kolom saat ini, di unit independen perangkat (1/96 inci per unit). (Diperoleh dari DataGridColumn)
Binding	Mendapatkan atau mengatur pengikatan yang mengaitkan kolom dengan properti di sumber data. (Diperoleh dari DataGridBoundColumn)
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)
CellStyle	Mendapatkan atau mengatur gaya yang digunakan untuk merender sel dalam kolom. (Diperoleh dari DataGridColumn)
ClipboardContentBinding	Mendapatkan atau mengatur objek pengikatan yang akan digunakan saat mendapatkan atau mengatur konten sel untuk clipboard. (Diperoleh dari DataGridBoundColumn)
DataGridOwner	Mendapatkan kontrol DataGrid yang berisi kolom ini. (Diperoleh dari DataGridColumn)
DefaultEditingElementStyle	Nilai default properti EditingElementStyle.
DefaultElementStyle	Nilai default properti ElementStyle.
DependencyObjectType	Mendapatkan DependencyObjectType yang membungkus jenis CLR instans ini. (Diperoleh dari DependencyObject)
Dispatcher	Mendapatkan Dispatcher DispatcherObject ini dikaitkan. (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)
EditingElementStyle	Mendapatkan atau mengatur gaya yang digunakan saat merender elemen yang ditampilkan kolom untuk sel dalam mode pengeditan. (Diperoleh dari DataGridBoundColumn)
ElementStyle	Mendapatkan atau mengatur gaya yang digunakan saat merender elemen yang ditampilkan kolom untuk sel yang tidak dalam mode pengeditan. (Diperoleh dari DataGridBoundColumn)
FontFamily	Mendapatkan atau mengatur keluarga font untuk konten sel dalam kolom.
FontSize	Mendapatkan atau mengatur ukuran font untuk konten sel dalam kolom.
FontStyle	Mendapatkan atau mengatur gaya font untuk konten sel dalam kolom.
FontWeight	Mendapatkan atau mengatur bobot font untuk konten sel dalam kolom.
Foreground	Mendapatkan atau mengatur Brush yang digunakan untuk melukis isi teks sel dalam kolom.
Header	Mendapatkan atau mengatur konten header kolom. (Diperoleh dari DataGridColumn)
HeaderStringFormat	Mendapatkan atau mengatur pola format yang akan 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 kolom diedit kembali ke nilai yang ditentukan.
CancelCellEdit(FrameworkElement, Object)	Menyebabkan sel diedit kembali ke nilai asli yang tidak diedit. (Diperoleh dari DataGridColumn)
CheckAccess()	Menentukan apakah utas panggilan memiliki akses ke DispatcherObjectini. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dihapus ditentukan oleh pengidentifikasi DependencyProperty. (Diperoleh dari DependencyObject)
ClearValue(DependencyPropertyKey)	Menghapus nilai lokal properti baca-saja. Properti yang akan dihapus ditentukan oleh DependencyPropertyKey. (Diperoleh dari DependencyObject)
CoerceValue(DependencyProperty)	Memaksa nilai properti dependensi yang ditentukan. Ini dicapai dengan memanggil fungsi CoerceValueCallback apa pun yang ditentukan dalam metadata properti untuk properti dependensi karena ada pada panggilan DependencyObject. (Diperoleh dari DependencyObject)
CommitCellEdit(FrameworkElement)	Melakukan validasi yang diperlukan sebelum keluar dari mode edit.
CommitCellEdit(FrameworkElement)	Melakukan validasi yang diperlukan sebelum keluar dari mode pengeditan sel. (Diperoleh dari DataGridColumn)
Equals(Object)	Menentukan apakah DependencyObject yang disediakan setara dengan DependencyObjectsaat ini. (Diperoleh dari DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Mendapatkan kontrol TextBox yang terikat ke nilai properti Binding kolom.
GenerateElement(DataGridCell, Object)	Mendapatkan kontrol TextBlock baca-saja yang terikat ke nilai properti Binding kolom.
GetCellContent(DataGridRow)	Mengambil nilai properti Content untuk sel di persimpangan kolom ini dan baris yang ditentukan. (Diperoleh dari DataGridColumn)
GetCellContent(Object)	Mendapatkan nilai properti Content untuk sel di persimpangan kolom ini dan baris yang mewakili item data yang ditentukan. (Diperoleh dari DataGridColumn)
GetHashCode()	Mendapatkan kode hash untuk DependencyObjectini. (Diperoleh dari DependencyObject)
GetLocalValueEnumerator()	Membuat enumerator khusus untuk menentukan properti dependensi mana yang telah mengatur nilai secara lokal pada DependencyObjectini. (Diperoleh dari DependencyObject)
GetType()	Mendapatkan Type instans saat ini. (Diperoleh dari Object)
GetValue(DependencyProperty)	Mengembalikan nilai efektif properti dependensi saat ini pada instans DependencyObjectini. (Diperoleh dari DependencyObject)
InvalidateProperty(DependencyProperty)	Mengevaluasi kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
NotifyPropertyChanged(String)	Memberi tahu DataGrid yang berisi kolom ini bahwa properti kolom telah berubah. (Diperoleh dari DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	Memberi tahu DataGrid saat nilai properti Binding berubah. (Diperoleh dari DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Menentukan nilai properti IsReadOnly berdasarkan aturan properti dari kisi data yang berisi kolom ini. (Diperoleh dari DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)	Menaikkan peristiwa CopyingCellClipboardContent. (Diperoleh dari DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Menaikkan peristiwa PastingCellClipboardContent. (Diperoleh dari DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Dipanggil setiap kali nilai efektif dari properti dependensi apa pun pada DependencyObject ini telah diperbarui. Properti dependensi tertentu yang berubah dilaporkan dalam data peristiwa. (Diperoleh dari DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Dipanggil saat sel dalam kolom memasuki mode pengeditan.
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 kolom.
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 pengidentifikasi DependencyPropertyKey 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 DispatcherObjectini . (Diperoleh dari DispatcherObject)

Acara

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

Berlaku untuk

Bagikan melalui