DataGridCheckBoxColumn Klasa

Definicja

Przedstawia DataGrid kolumnę, która hostuje CheckBox kontrolki w jej komórkach.Represents a DataGrid column that hosts CheckBox controls in its cells.

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

Przykłady

Poniższy przykład pokazuje, jak dodać DataGridCheckBoxColumn .The following example shows how to add a DataGridCheckBoxColumn. Ten przykład używa bazy danych jako źródła i wyświetla kolumnę danych logicznych.This example uses a database as the source and displays a column of Boolean data.

<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 .Use DataGridCheckBoxColumn to display columns of Boolean data as a CheckBox. Na poniższej ilustracji przedstawiono przykład DataGridCheckBoxColumn .The following illustration shows an example of DataGridCheckBoxColumn.

Kolumna DataGridCheckBoxA DataGridCheckBox column

Aby wypełnić kolumnę, powiąż kolumnę z danymi przy użyciu Binding właściwości.To populate the column, bind the column to the data by using the Binding property. BindingWłaściwość jest stosowana do CheckBox elementu utworzonego w kolumnie.The Binding property is applied to the CheckBox element created in the column. DataContextElement dla elementu w każdej komórce to element danych dla wiersza, w którym znajduje się komórka.The DataContext for the element in each cell is the data item for the row the cell is in. W związku z tym, aby skonfigurować powiązanie, należy ustawić tylko Binding.Path .Therefore, to set up the binding you only have to set the Binding.Path. Opcjonalnie można określić, Binding.Converter czy źródło danych i cel są różnymi typami.Optionally, you can specify a Binding.Converter if your data source and target are different types. Aby uzyskać więcej informacji na temat powiązania danych, zobacz powiązanie danych (WPF).For more information about data binding, see Data Binding (WPF).

Można dostosować DataGridCheckBoxColumn Ustawienia przez ustawienie właściwości, takie jak Width ,, Header IsThreeState , i IsReadOnly .You can customize the DataGridCheckBoxColumn by setting properties, such as Width, Header, IsThreeState, and IsReadOnly.

Jeśli chcesz wyświetlić inne typy danych, program DataGrid udostępnia następujące typy kolumn:If you want to display other types of data, DataGrid provides the following column types:

Typ kolumnyColumn Type Wyświetlanie danychData Display
DataGridHyperlinkColumn Służy do wyświetlania danych identyfikatora URI.Use to display URI data.
DataGridComboBoxColumn Służy do wyświetlania danych wyliczania.Use to display enumeration data.
DataGridTextColumn Użyj, aby wyświetlić tekst.Use to display text.

Jeśli chcesz użyć innych kontrolek w programie DataGrid , możesz utworzyć własne typy kolumn za pomocą polecenia DataGridTemplateColumn .If you want to use other controls in your DataGrid, you can create your own column types by using DataGridTemplateColumn.

Konstruktory

DataGridCheckBoxColumn()

Inicjuje nowe wystąpienie klasy DataGridCheckBoxColumn.Initializes a new instance of the DataGridCheckBoxColumn class.

Pola

IsThreeStateProperty

Identyfikuje IsThreeState Właściwość zależności.Identifies the IsThreeState dependency property.

Właściwości

ActualWidth

Pobiera bieżącą szerokość kolumny w jednostki miary niezależne od urządzenia (1/96 cala na jednostkę)device-independent units (1/96th inch per unit) .Gets the current width of the column, in jednostki miary niezależne od urządzenia (1/96 cala na jednostkę)device-independent units (1/96th inch per unit).

(Odziedziczone po DataGridColumn)
Binding

Pobiera lub ustawia powiązanie, które kojarzy kolumnę z właściwością w źródle danych.Gets or sets the binding that associates the column with a property in the data source.

(Odziedziczone po DataGridBoundColumn)
CanUserReorder

Pobiera lub ustawia wartość wskazującą, czy użytkownik może zmienić położenie wyświetlania kolumny przez przeciągnięcie nagłówka kolumny.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(Odziedziczone po DataGridColumn)
CanUserResize

Pobiera lub ustawia wartość wskazującą, czy użytkownik może dostosować szerokość kolumny za pomocą myszy.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Odziedziczone po DataGridColumn)
CanUserSort

Pobiera lub ustawia wartość wskazującą, czy użytkownik może sortować kolumnę przez kliknięcie nagłówka kolumny.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Odziedziczone po DataGridColumn)
CellStyle

Pobiera lub ustawia styl używany do renderowania komórek w kolumnie.Gets or sets the style that is used to render cells in the column.

(Odziedziczone po DataGridColumn)
ClipboardContentBinding

Pobiera lub ustawia obiekt powiązania do użycia podczas pobierania lub ustawiania zawartości komórki dla Schowka.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Odziedziczone po DataGridBoundColumn)
DataGridOwner

Pobiera DataGrid formant, który zawiera tę kolumnę.Gets the DataGrid control that contains this column.

(Odziedziczone po DataGridColumn)
DefaultEditingElementStyle

Pobiera wartość domyślną EditingElementStyle właściwości.Gets the default value of the EditingElementStyle property.

DefaultElementStyle

Pobiera wartość domyślną ElementStyle właściwości.Gets the default value of the ElementStyle property.

DependencyObjectType

Pobiera DependencyObjectType , który zawija CLRCLR Typ tego wystąpienia.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Odziedziczone po DependencyObject)
Dispatcher

Pobiera Dispatcher ten DispatcherObject program jest skojarzony z.Gets the Dispatcher this DispatcherObject is associated with.

(Odziedziczone po DispatcherObject)
DisplayIndex

Pobiera lub ustawia pozycję wyświetlania kolumny względem innych kolumn w DataGrid .Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Odziedziczone po DataGridColumn)
DragIndicatorStyle

Pobiera lub ustawia obiekt Style, który ma zostać zastosowany do nagłówka kolumny podczas operacji przeciągania.Gets or sets the style object to apply to the column header during a drag operation.

(Odziedziczone po DataGridColumn)
EditingElementStyle

Pobiera lub ustawia styl używany podczas renderowania elementu wyświetlanego w kolumnie dla komórki w trybie edycji.Gets or sets the style that is used when rendering the element that the column displays for a cell in editing mode.

(Odziedziczone po DataGridBoundColumn)
ElementStyle

Pobiera lub ustawia styl używany podczas renderowania elementu wyświetlanego w kolumnie dla komórki, która nie jest w trybie edycji.Gets or sets the style that is used when rendering the element that the column displays for a cell that is not in editing mode.

(Odziedziczone po DataGridBoundColumn)
Header

Pobiera lub ustawia zawartość nagłówka kolumny.Gets or sets the content of the column header.

(Odziedziczone po DataGridColumn)
HeaderStringFormat

Pobiera lub ustawia wzorzec formatu, który ma zostać zastosowany do zawartości nagłówka kolumny.Gets or sets the format pattern to apply to the content of the column header.

(Odziedziczone po DataGridColumn)
HeaderStyle

Pobiera lub ustawia styl używany podczas renderowania nagłówka kolumny.Gets or sets the style that is used when rendering the column header.

(Odziedziczone po DataGridColumn)
HeaderTemplate

Pobiera lub ustawia szablon definiujący wizualną reprezentację nagłówka kolumny.Gets or sets the template that defines the visual representation of the column header.

(Odziedziczone po DataGridColumn)
HeaderTemplateSelector

Pobiera lub ustawia obiekt, który wybiera szablon do użycia w nagłówku kolumny.Gets or sets the object that selects which template to use for the column header.

(Odziedziczone po DataGridColumn)
IsAutoGenerated

Pobiera wartość wskazującą, czy kolumna jest generowana automatycznie.Gets a value that indicates whether the column is auto-generated.

(Odziedziczone po DataGridColumn)
IsFrozen

Pobiera wartość wskazującą, czy kolumna jest nieblokowana pod kątem przewijania w poziomie.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Odziedziczone po DataGridColumn)
IsReadOnly

Pobiera lub ustawia wartość wskazującą, czy komórki w kolumnie mogą być edytowane.Gets or sets a value that indicates whether cells in the column can be edited.

(Odziedziczone po DataGridColumn)
IsSealed

Pobiera wartość wskazującą, czy to wystąpienie jest aktualnie zapieczętowane (tylko do odczytu).Gets a value that indicates whether this instance is currently sealed (read-only).

(Odziedziczone po DependencyObject)
IsThreeState

Pobiera lub ustawia wartość wskazującą, czy formanty hostowane CheckBox włączają trzy stany czy dwa.Gets or sets a value that indicates whether the hosted CheckBox controls enable three states or two.

MaxWidth

Pobiera lub ustawia ograniczenie maksymalnej szerokości kolumny.Gets or sets the maximum width constraint of the column.

(Odziedziczone po DataGridColumn)
MinWidth

Pobiera lub ustawia ograniczenie minimalnej szerokości kolumny.Gets or sets the minimum width constraint of the column.

(Odziedziczone po DataGridColumn)
SortDirection

Pobiera lub ustawia kierunek sortowania (rosnący lub malejący) kolumny.Gets or sets the sort direction (ascending or descending) of the column.

(Odziedziczone po DataGridColumn)
SortMemberPath

Pobiera lub ustawia nazwę właściwości lub rozdzielaną kropkami hierarchię nazw właściwości, która wskazuje składową, według której ma zostać wykonane sortowanie.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Odziedziczone po DataGridColumn)
Visibility

Pobiera lub ustawia widoczność kolumny.Gets or sets the visibility of the column.

(Odziedziczone po DataGridColumn)
Width

Pobiera lub ustawia szerokość kolumny lub tryb automatycznej zmiany rozmiarów.Gets or sets the column width or automatic sizing mode.

(Odziedziczone po DataGridColumn)

Metody

CancelCellEdit(FrameworkElement, Object)

Powoduje, że edytowana komórka przywraca pierwotną, nieedytowaną wartość.Causes the cell being edited to revert to the original, unedited value.

(Odziedziczone po DataGridColumn)
CheckAccess()

Określa, czy wątek wywołujący ma dostęp do tego DispatcherObject .Determines whether the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)
ClearValue(DependencyProperty)

Czyści wartość lokalną właściwości.Clears the local value of a property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyProperty Identyfikator.The property to be cleared is specified by a DependencyProperty identifier.

(Odziedziczone po DependencyObject)
ClearValue(DependencyPropertyKey)

Czyści wartość lokalną właściwości tylko do odczytu.Clears the local value of a read-only property. Właściwość, która ma zostać wyczyszczona, jest określana przez DependencyPropertyKey .The property to be cleared is specified by a DependencyPropertyKey.

(Odziedziczone po DependencyObject)
CoerceValue(DependencyProperty)

Przekształca wartość określonej właściwości zależności.Coerces the value of the specified dependency property. 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, która istnieje w wywołaniu DependencyObject .This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Odziedziczone po DependencyObject)
CommitCellEdit(FrameworkElement)

Wykonuje wszystkie wymagane walidacje przed wyjściem z trybu edycji komórki.Performs any required validation before exiting cell editing mode.

(Odziedziczone po DataGridColumn)
Equals(Object)

Określa, czy podana DependencyObject jest równoważna z bieżącym DependencyObject .Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Odziedziczone po DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Pobiera CheckBox formant, który jest powiązany z Binding wartością właściwości kolumny.Gets a CheckBox control that is bound to the column's Binding property value.

GenerateElement(DataGridCell, Object)

Pobiera formant tylko do odczytu CheckBox , który jest powiązany z Binding wartością właściwości kolumny.Gets a read-only CheckBox control that is bound to the column's Binding property value.

GetCellContent(DataGridRow)

Pobiera Content wartość właściwości dla komórki na przecięciu tej kolumny i określonego wiersza.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Odziedziczone po DataGridColumn)
GetCellContent(Object)

Pobiera Content wartość właściwości dla komórki na przecięciu tej kolumny i wiersz reprezentujący określony element danych.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Odziedziczone po DataGridColumn)
GetHashCode()

Pobiera kod skrótu dla tego elementu DependencyObject .Gets a hash code for this DependencyObject.

(Odziedziczone po DependencyObject)
GetLocalValueEnumerator()

Tworzy wyspecjalizowany moduł wyliczający służący do określania, które właściwości zależności mają lokalnie ustawione wartości DependencyObject .Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Odziedziczone po DependencyObject)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(DependencyProperty)

Zwraca bieżącą obowiązującą wartość właściwości zależności w tym wystąpieniu DependencyObject .Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Odziedziczone po DependencyObject)
InvalidateProperty(DependencyProperty)

Ponowna ocenuje wartość efektywną dla określonej właściwości zależności.Re-evaluates the effective value for the specified dependency property.

(Odziedziczone po DependencyObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
NotifyPropertyChanged(String)

Powiadamia, DataGrid że zawiera tę kolumnę, która została zmieniona przez właściwość kolumny.Notifies the DataGrid that contains this column that a column property has changed.

(Odziedziczone po DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)

Powiadamia, DataGrid gdy wartość Binding właściwości zostanie zmieniona.Notifies the DataGrid when the value of the Binding property changes.

(Odziedziczone po DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)

Określa wartość IsReadOnly właściwości na podstawie reguł właściwości z siatki danych, która zawiera tę kolumnę.Determines the value of the IsReadOnly property based on property rules from the data grid that contains this column.

(Odziedziczone po DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)

Podnosi CopyingCellClipboardContent zdarzenie.Raises the CopyingCellClipboardContent event.

(Odziedziczone po DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Podnosi PastingCellClipboardContent zdarzenie.Raises the PastingCellClipboardContent event.

(Odziedziczone po DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wywoływana za każdym razem, gdy wartość skuteczna każdej właściwości zależności na tej stronie DependencyObject została zaktualizowana.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Określona właściwość zależności, która została zmieniona, jest raportowana w danych zdarzenia.The specific dependency property that changed is reported in the event data.

(Odziedziczone po DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Wywołuje się, gdy komórka w kolumnie przechodzi do trybu edycji.Called when a cell in the column enters editing mode.

ReadLocalValue(DependencyProperty)

Zwraca wartość lokalną właściwości zależności, jeśli istnieje.Returns the local value of a dependency property, if it exists.

(Odziedziczone po DependencyObject)
RefreshCellContent(FrameworkElement, String)

Odświeża zawartość komórki w kolumnie w odpowiedzi na zmianę wartości właściwości Column.Refreshes the contents of a cell in the column in response to a column property value change.

SetCurrentValue(DependencyProperty, Object)

Ustawia wartość właściwości zależności bez zmiany jego źródła wartości.Sets the value of a dependency property without changing its value source.

(Odziedziczone po DependencyObject)
SetValue(DependencyProperty, Object)

Ustawia wartość lokalną właściwości zależności, określoną za pomocą identyfikatora właściwości zależności.Sets the local value of a dependency property, specified by its dependency property identifier.

(Odziedziczone po DependencyObject)
SetValue(DependencyPropertyKey, Object)

Ustawia wartość lokalną właściwości zależności tylko do odczytu, określoną przez DependencyPropertyKey Identyfikator właściwości zależności.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Odziedziczone po DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Zwraca wartość wskazującą, czy procesy serializacji powinny serializować wartość dla podanej właściwości zależności.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Odziedziczone po DependencyObject)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
VerifyAccess()

Wymusza, że wątek wywołujący ma dostęp do tego DispatcherObject .Enforces that the calling thread has access to this DispatcherObject.

(Odziedziczone po DispatcherObject)

Zdarzenia

CopyingCellClipboardContent

Występuje po przygotowaniu zawartości Schowka komórki.Occurs after the cell clipboard content is prepared.

(Odziedziczone po DataGridColumn)
PastingCellClipboardContent

Występuje przed przeniesieniem zawartości schowka do komórki.Occurs before the clipboard content is moved to the cell.

(Odziedziczone po DataGridColumn)

Dotyczy

Zobacz też