DataGridTextColumn Kelas

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 yang menghosting DataGrid 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 kolom teks yang telah 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 XMLDataProvider dan Kueri 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 DataGridTextColumn jenis.

Dua DataGridTextColumns

Untuk membuat kolom, tambahkan ke Columns koleksi. Untuk mengisi kolom, ikat kolom ke data dengan menggunakan Binding properti . Properti Binding diterapkan ke elemen atau TextBox yang TextBlock 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 Pengikatan Data (WPF).

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

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

Jika Anda ingin menampilkan tipe data lain, DataGrid berikan tipe 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

Nama	Deskripsi
DataGridTextColumn()	Menginisialisasi instans baru dari kelas DataGridTextColumn.

Bidang

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

Properti

Nama	Deskripsi
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	DataGrid Mendapatkan kontrol yang berisi kolom ini. (Diperoleh dari DataGridColumn)
DefaultEditingElementStyle	Nilai EditingElementStyle default properti .
DefaultElementStyle	Nilai ElementStyle default properti .
DependencyObjectType	DependencyObjectType Mendapatkan yang membungkus jenis CLR instans ini. (Diperoleh dari DependencyObject)
Dispatcher	Dispatcher Mendapatkan ini DispatcherObject 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)
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

Nama	Deskripsi
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 ini DispatcherObject. (Diperoleh dari DispatcherObject)
ClearValue(DependencyProperty)	Menghapus nilai lokal properti. Properti yang akan dihapus ditentukan oleh DependencyProperty pengidentifikasi. (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 dilakukan 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 edit.
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)	TextBox Mendapatkan kontrol yang terikat ke nilai properti kolomBinding.
GenerateElement(DataGridCell, Object)	Mendapatkan kontrol baca-saja TextBlock 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 Type instans 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 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 kapan nilai Binding properti berubah. (Diperoleh dari DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Menentukan nilai IsReadOnly properti berdasarkan aturan properti dari kisi data yang berisi kolom ini. (Diperoleh dari DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)	Menaikkan CopyingCellClipboardContent acara. (Diperoleh dari DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Menaikkan PastingCellClipboardContent acara. (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)	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 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

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

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?