DataGridCheckBoxColumn Kelas

Definisi

Ruang nama:

System.Windows.Controls

Rakitan:

PresentationFramework.dll

DataGrid Mewakili kolom yang menghosting CheckBox kontrol dalam selnya.

public ref class DataGridCheckBoxColumn : System::Windows::Controls::DataGridBoundColumn

public class DataGridCheckBoxColumn : System.Windows.Controls.DataGridBoundColumn

type DataGridCheckBoxColumn = class
    inherit DataGridBoundColumn

Public Class DataGridCheckBoxColumn
Inherits DataGridBoundColumn

Warisan

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn

DataGridCheckBoxColumn

Contoh

Contoh berikut menunjukkan cara menambahkan DataGridCheckBoxColumn. Contoh ini menggunakan database sebagai sumber dan menampilkan kolom data Boolean.

<DataGrid Name="DG1" AutoGenerateColumns="False" ItemsSource="{Binding}">
    <DataGrid.Columns>
        <DataGridCheckBoxColumn Header="Online Order?" IsThreeState="True" Binding="{Binding OnlineOrderFlag}" />
    </DataGrid.Columns>
</DataGrid>

Keterangan

Gunakan DataGridCheckBoxColumn untuk menampilkan kolom data Boolean sebagai CheckBox. Ilustrasi berikut menunjukkan contoh DataGridCheckBoxColumn.

Untuk mengisi kolom, ikat kolom ke data dengan menggunakan Binding properti . Properti Binding diterapkan ke elemen yang CheckBox dibuat di kolom . DataContext untuk elemen di setiap sel adalah item data untuk baris tempat sel berada. Oleh karena itu, untuk mengatur pengikatan, Anda hanya perlu mengatur Binding.Path. Secara opsional, Anda dapat menentukan Binding.Converter apakah sumber data dan target Anda adalah jenis yang berbeda. Untuk informasi selengkapnya tentang pengikatan data, lihat Pengikatan Data (WPF).

Anda dapat menyesuaikan DataGridCheckBoxColumn dengan mengatur properti, seperti Width, , HeaderIsThreeState, dan IsReadOnly.

Jika Anda ingin menampilkan tipe data lain, DataGrid berikan tipe kolom berikut:

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

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

Konstruktor

DataGridCheckBoxColumn()

Menginisialisasi instans baru kelas DataGridCheckBoxColumn.

Bidang

IsThreeStateProperty

IsThreeState Mengidentifikasi properti dependensi.

Properti

ActualWidth	Mendapatkan lebar kolom saat ini, dalam 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	Mendapatkan nilai EditingElementStyle default properti .
DefaultElementStyle	Mendapatkan nilai ElementStyle default properti .
DependencyObjectType	Mendapatkan yang membungkus jenis CLR dari instans DependencyObjectType 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)
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 untuk 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)
IsThreeState	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol yang dihosting CheckBox mengaktifkan tiga status atau dua.
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 mengurutkan. (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 untuk 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)	CheckBox Mendapatkan kontrol yang terikat ke nilai properti kolomBinding.
GenerateElement(DataGridCell, Object)	Mendapatkan kontrol baca-saja CheckBox 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 memiliki nilai yang ditetapkan secara lokal pada ini DependencyObject. (Diperoleh dari DependencyObject)
GetType()	Mendapatkan dari 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 kembali nilai efektif untuk properti dependensi yang ditentukan. (Diperoleh dari DependencyObject)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (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)	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)	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 menserialisasikan 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 papan klip dipindahkan ke sel. (Diperoleh dari DataGridColumn)

Lihat juga

• CheckBox