DataGridCheckBoxColumn Klasa

Definicja

Przestrzeń nazw:

System.Windows.Controls

Zestaw:

PresentationFramework.dll

Reprezentuje kolumnę DataGrid , która hostuje CheckBox kontrolki w komórkach.

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

Dziedziczenie

Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn

DataGridCheckBoxColumn

Przykłady

W poniższym przykładzie pokazano, jak dodać element DataGridCheckBoxColumn. W tym przykładzie użyto bazy danych jako źródła i zostanie wyświetlona kolumna danych logicznych.

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

Uwagi

Służy DataGridCheckBoxColumn do wyświetlania kolumn danych logicznych jako CheckBox. Na poniższej ilustracji przedstawiono przykład .DataGridCheckBoxColumn

kolumna

Aby wypełnić kolumnę, powiąż kolumnę z danymi przy użyciu Binding właściwości . Właściwość Binding jest stosowana do elementu utworzonego CheckBox w kolumnie. Element DataContext dla elementu w każdej komórce jest elementem danych dla wiersza, w których znajduje się komórka. W związku z tym, aby skonfigurować powiązanie, musisz ustawić Binding.Pathtylko element . Opcjonalnie możesz określić Binding.Converter , czy źródło danych i obiekt docelowy są różnymi typami. Aby uzyskać więcej informacji na temat powiązania danych, zobacz Powiązanie danych (WPF).

Można dostosować, DataGridCheckBoxColumn ustawiając właściwości, takie jak Width, Header, IsThreeStatei IsReadOnly.

Jeśli chcesz wyświetlić inne typy danych, DataGrid udostępnia następujące typy kolumn:

Typ kolumny	Wyświetlanie danych
DataGridHyperlinkColumn	Służy do wyświetlania danych identyfikatora URI.
DataGridComboBoxColumn	Służy do wyświetlania danych wyliczenia.
DataGridTextColumn	Służy do wyświetlania tekstu.

Jeśli chcesz użyć innych kontrolek w programie DataGrid, możesz utworzyć własne typy kolumn przy użyciu polecenia DataGridTemplateColumn.

Konstruktory

DataGridCheckBoxColumn()

Inicjuje nowe wystąpienie klasy DataGridCheckBoxColumn.

Pola

IsThreeStateProperty

Identyfikuje IsThreeState właściwość zależności.

Właściwości

ActualWidth	Pobiera bieżącą szerokość kolumny w jednostkach niezależnych od urządzenia (1/96 cala na jednostkę). (Odziedziczone po DataGridColumn)
Binding	Pobiera lub ustawia powiązanie, które kojarzy kolumnę z właściwością w źródle danych. (Odziedziczone po DataGridBoundColumn)
CanUserReorder	Pobiera lub ustawia wartość wskazującą, czy użytkownik może zmienić położenie wyświetlania kolumny, przeciągając nagłówek kolumny. (Odziedziczone po DataGridColumn)
CanUserResize	Pobiera lub ustawia wartość wskazującą, czy użytkownik może dostosować szerokość kolumny przy użyciu myszy. (Odziedziczone po DataGridColumn)
CanUserSort	Pobiera lub ustawia wartość wskazującą, czy użytkownik może sortować kolumnę, klikając nagłówek kolumny. (Odziedziczone po DataGridColumn)
CellStyle	Pobiera lub ustawia styl używany do renderowania komórek w kolumnie. (Odziedziczone po DataGridColumn)
ClipboardContentBinding	Pobiera lub ustawia obiekt powiązania do użycia podczas pobierania lub ustawiania zawartości komórki dla schowka. (Odziedziczone po DataGridBoundColumn)
DataGridOwner	Pobiera kontrolkę zawierającą tę kolumnę DataGrid . (Odziedziczone po DataGridColumn)
DefaultEditingElementStyle	Pobiera wartość domyślną EditingElementStyle właściwości.
DefaultElementStyle	Pobiera wartość domyślną ElementStyle właściwości.
DependencyObjectType	DependencyObjectType Pobiera opakowujący typ clR tego wystąpienia. (Odziedziczone po DependencyObject)
Dispatcher	Dispatcher Pobiera tę DispatcherObject wartość skojarzona z. (Odziedziczone po DispatcherObject)
DisplayIndex	Pobiera lub ustawia położenie wyświetlania kolumny względem innych kolumn w elemecie DataGrid. (Odziedziczone po DataGridColumn)
DragIndicatorStyle	Pobiera lub ustawia obiekt stylu, który ma być stosowany do nagłówka kolumny podczas operacji przeciągania. (Odziedziczone po DataGridColumn)
EditingElementStyle	Pobiera lub ustawia styl używany podczas renderowania elementu wyświetlanego przez kolumnę dla komórki w trybie edycji. (Odziedziczone po DataGridBoundColumn)
ElementStyle	Pobiera lub ustawia styl używany podczas renderowania elementu wyświetlanego przez kolumnę dla komórki, która nie jest w trybie edycji. (Odziedziczone po DataGridBoundColumn)
Header	Pobiera lub ustawia zawartość nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderStringFormat	Pobiera lub ustawia wzorzec formatu, który ma być stosowany do zawartości nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderStyle	Pobiera lub ustawia styl używany podczas renderowania nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderTemplate	Pobiera lub ustawia szablon, który definiuje wizualną reprezentację nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderTemplateSelector	Pobiera lub ustawia obiekt, który wybiera szablon do użycia dla nagłówka kolumny. (Odziedziczone po DataGridColumn)
IsAutoGenerated	Pobiera wartość wskazującą, czy kolumna jest generowana automatycznie. (Odziedziczone po DataGridColumn)
IsFrozen	Pobiera wartość wskazującą, czy kolumna nie może przewijać się w poziomie. (Odziedziczone po DataGridColumn)
IsReadOnly	Pobiera lub ustawia wartość wskazującą, czy komórki w kolumnie można edytować. (Odziedziczone po DataGridColumn)
IsSealed	Pobiera wartość wskazującą, czy to wystąpienie jest obecnie zapieczętowane (tylko do odczytu). (Odziedziczone po DependencyObject)
IsThreeState	Pobiera lub ustawia wartość wskazującą, czy hostowane CheckBox kontrolki włączają trzy stany, czy dwa.
MaxWidth	Pobiera lub ustawia ograniczenie maksymalnej szerokości kolumny. (Odziedziczone po DataGridColumn)
MinWidth	Pobiera lub ustawia ograniczenie minimalnej szerokości kolumny. (Odziedziczone po DataGridColumn)
SortDirection	Pobiera lub ustawia kierunek sortowania (rosnąco lub malejąco) kolumny. (Odziedziczone po DataGridColumn)
SortMemberPath	Pobiera lub ustawia nazwę właściwości lub hierarchię rozdzielaną kropką nazw właściwości, która wskazuje element członkowski do sortowania według. (Odziedziczone po DataGridColumn)
Visibility	Pobiera lub ustawia widoczność kolumny. (Odziedziczone po DataGridColumn)
Width	Pobiera lub ustawia szerokość kolumny lub tryb automatycznego określania rozmiaru. (Odziedziczone po DataGridColumn)

Metody

CancelCellEdit(FrameworkElement, Object)	Powoduje, że komórka jest edytowana, aby przywrócić oryginalną, nieedytowaną wartość. (Odziedziczone po DataGridColumn)
CheckAccess()	Określa, czy wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)	Czyści wartość lokalną właściwości. Właściwość do wyczyszczenia jest określana przez DependencyProperty identyfikator. (Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)	Czyści wartość lokalną właściwości tylko do odczytu. Właściwość do wyczyszczenia jest określana przez DependencyPropertyKeyelement . (Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)	Coerce wartość określonej właściwości zależności. Jest to realizowane przez wywołanie dowolnej CoerceValueCallback funkcji określonej w metadanych właściwości dla właściwości zależności, ponieważ istnieje w wywołaniu DependencyObject. (Odziedziczone po DependencyObject)
CommitCellEdit(FrameworkElement)	Wykonuje dowolną wymaganą walidację przed zamknięciem trybu edycji komórek. (Odziedziczone po DataGridColumn)
Equals(Object)	Określa, czy podany DependencyObject element jest odpowiednikiem bieżącego DependencyObjectelementu . (Odziedziczone po DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Pobiera kontrolkę CheckBox powiązaną z wartością właściwości kolumny Binding .
GenerateElement(DataGridCell, Object)	Pobiera kontrolkę tylko do CheckBox odczytu powiązaną z wartością właściwości kolumny Binding .
GetCellContent(DataGridRow)	Content Pobiera wartość właściwości komórki na skrzyżowaniu tej kolumny i określonego wiersza. (Odziedziczone po DataGridColumn)
GetCellContent(Object)	Content Pobiera wartość właściwości dla komórki na skrzyżowaniu tej kolumny i wiersza, który reprezentuje określony element danych. (Odziedziczone po DataGridColumn)
GetHashCode()	Pobiera kod skrótu dla tego pliku DependencyObject. (Odziedziczone po DependencyObject)
GetLocalValueEnumerator()	Tworzy wyspecjalizowany moduł wyliczający do określania, które właściwości zależności mają lokalnie ustawione wartości w tym DependencyObjectelemecie . (Odziedziczone po DependencyObject)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetValue(DependencyProperty)	Zwraca bieżącą obowiązującą wartość właściwości zależności dla tego wystąpienia obiektu DependencyObject. (Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)	Ponownie oblicza efektywną wartość dla określonej właściwości zależności. (Odziedziczone po DependencyObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
NotifyPropertyChanged(String)	Powiadamia o DataGrid tym, że zawiera tę kolumnę, że właściwość kolumny została zmieniona. (Odziedziczone po DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	Powiadamia o DataGrid zmianie wartości Binding właściwości. (Odziedziczone po DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Określa wartość IsReadOnly właściwości na podstawie reguł właściwości z siatki danych zawierającej tę kolumnę. (Odziedziczone po DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)	CopyingCellClipboardContent Zgłasza zdarzenie. (Odziedziczone po DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	PastingCellClipboardContent Zgłasza zdarzenie. (Odziedziczone po DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wywoływane za każdym razem, gdy obowiązująca wartość dowolnej właściwości zależności została DependencyObject zaktualizowana. Określona właściwość zależności, która uległa zmianie, jest zgłaszana w danych zdarzenia. (Odziedziczone po DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Wywoływane, gdy komórka w kolumnie wchodzi w tryb edycji.
ReadLocalValue(DependencyProperty)	Zwraca wartość lokalną właściwości zależności, jeśli istnieje. (Odziedziczone po DependencyObject)
RefreshCellContent(FrameworkElement, String)	Odświeża zawartość komórki w kolumnie w odpowiedzi na zmianę wartości właściwości kolumny.
SetCurrentValue(DependencyProperty, Object)	Ustawia wartość właściwości zależności bez zmiany źródła wartości. (Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)	Ustawia wartość lokalną właściwości zależności określonej przez jego identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)	Ustawia wartość lokalną właściwości zależności tylko do odczytu określona przez DependencyPropertyKey identyfikator właściwości zależności. (Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość podanej właściwości zależności. (Odziedziczone po DependencyObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
VerifyAccess()	Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObjectelementu . (Odziedziczone po DispatcherObject)

Zdarzenia

CopyingCellClipboardContent	Występuje po przygotowaniu zawartości schowka komórki. (Odziedziczone po DataGridColumn)
PastingCellClipboardContent	Występuje przed przeniesieniem zawartości schowka do komórki. (Odziedziczone po DataGridColumn)

Zobacz też

• CheckBox