DataGridCheckBoxColumn Класс

Определение

Представляет столбец DataGrid, в ячейках которого размещаются элементы управления CheckBox.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
Наследование

Примеры

В следующем примере показано, как добавить DataGridCheckBoxColumn.The following example shows how to add a DataGridCheckBoxColumn. В этом примере используется база данных в качестве источника и отображается столбец логических данных.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>

Комментарии

Используйте DataGridCheckBoxColumn для вывода столбцов логических данных в CheckBoxвиде.Use DataGridCheckBoxColumn to display columns of Boolean data as a CheckBox. На следующем рисунке показан пример DataGridCheckBoxColumn.The following illustration shows an example of DataGridCheckBoxColumn.

![Столбец датагридчеккбокс] (~/add/media/wpf-datagrid-checkbox.png "Столбец датагридчеккбокс")A DataGridCheckBox column

Чтобы заполнить столбец, привяжите столбец к данным с помощью Binding свойства.To populate the column, bind the column to the data by using the Binding property. Binding Свойство применяется CheckBox к элементу, созданному в столбце.The Binding property is applied to the CheckBox element created in the column. DataContext Для элемента в каждой ячейке находится элемент данных для строки, в которой находится ячейка.The DataContext for the element in each cell is the data item for the row the cell is in. Таким образом, чтобы настроить привязку, необходимо установить Binding.Path.Therefore, to set up the binding you only have to set the Binding.Path. При необходимости можно указать Binding.Converter , если источник данных и целевой объект имеют разные типы.Optionally, you can specify a Binding.Converter if your data source and target are different types. Дополнительные сведения о привязке данных см. в разделе Привязка данных (WPF).For more information about data binding, see Data Binding (WPF).

Можно DataGridCheckBoxColumn настроить, задав свойства, такие как Width, Header IsThreeState, и IsReadOnly.You can customize the DataGridCheckBoxColumn by setting properties, such as Width, Header, IsThreeState, and IsReadOnly.

Если требуется отобразить другие типы данных, DataGrid предоставляет следующие типы столбцов:If you want to display other types of data, DataGrid provides the following column types:

Тип столбцаColumn Type Отображение данныхData Display
DataGridHyperlinkColumn Используется для вывода данных URI.Use to display URI data.
DataGridComboBoxColumn Используйте для вывода данных перечисления.Use to display enumeration data.
DataGridTextColumn Используется для вывода текста.Use to display text.

Если вы хотите использовать другие элементы управления в DataGrid, можно создать собственные типы столбцов с помощью. DataGridTemplateColumnIf you want to use other controls in your DataGrid, you can create your own column types by using DataGridTemplateColumn.

Конструкторы

DataGridCheckBoxColumn()

Инициализирует новый экземпляр класса DataGridCheckBoxColumn.Initializes a new instance of the DataGridCheckBoxColumn class.

Поля

IsThreeStateProperty

Идентифицирует свойство зависимостей IsThreeState.Identifies the IsThreeState dependency property.

Свойства

ActualWidth

Получает текущую ширину столбца в пикселях в аппаратно-независимые единицы (1/96 дюйма на единицу)device-independent units (1/96th inch per unit).Gets the current width of the column, in аппаратно-независимые единицы (1/96 дюйма на единицу)device-independent units (1/96th inch per unit).

(Унаследовано от DataGridColumn)
Binding

Получение или установка привязки, которая связывает столбец со свойством источника данных.Gets or sets the binding that associates the column with a property in the data source.

(Унаследовано от DataGridBoundColumn)
CanUserReorder

Получение или установка значения, определяющего, может ли пользователь изменять позицию столбца, перетаскивая его заголовок мышью.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(Унаследовано от DataGridColumn)
CanUserResize

Получает или задает значение, указывающее, может ли пользователь изменять ширину столбца с помощью мыши.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Унаследовано от DataGridColumn)
CanUserSort

Получение или установка значения, определяющего, может ли пользователь сортировать столбец, щелкая его заголовок.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Унаследовано от DataGridColumn)
CellStyle

Получает или задает стиль, используемый при визуализации ячеек в столбце.Gets or sets the style that is used to render cells in the column.

(Унаследовано от DataGridColumn)
ClipboardContentBinding

Получает или задает объект привязки, который должен использоваться при получении или задании содержимого ячейки для буфера обмена.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Унаследовано от DataGridBoundColumn)
DataGridOwner

Получает элемент управления DataGrid, содержащий этот столбец.Gets the DataGrid control that contains this column.

(Унаследовано от DataGridColumn)
DefaultEditingElementStyle

Получает значение по умолчанию свойства EditingElementStyle.Gets the default value of the EditingElementStyle property.

DefaultElementStyle

Получает значение по умолчанию свойства ElementStyle.Gets the default value of the ElementStyle property.

DependencyObjectType

Возвращает DependencyObjectType, который создает обертку для типа CLRCLR данного экземпляра.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Унаследовано от DependencyObject)
Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Унаследовано от DispatcherObject)
DisplayIndex

Получает или задает позицию отображения столбца по отношению к другим столбцам в элементе управления DataGrid.Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Унаследовано от DataGridColumn)
DragIndicatorStyle

Получает или задает объект стиля для применения к заголовку столбца во время операции перетаскивания.Gets or sets the style object to apply to the column header during a drag operation.

(Унаследовано от DataGridColumn)
EditingElementStyle

Получает или задает стиль, используемый при визуализации элемента, который отображается в столбце для ячейки, находящейся в режиме правки.Gets or sets the style that is used when rendering the element that the column displays for a cell in editing mode.

(Унаследовано от DataGridBoundColumn)
ElementStyle

Получает или задает стиль, используемый при визуализации элемента, который отображается в столбце для ячейки, не находящейся в режиме правки.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.

(Унаследовано от DataGridBoundColumn)
Header

Получение или установка содержимого заголовка столбца.Gets or sets the content of the column header.

(Унаследовано от DataGridColumn)
HeaderStringFormat

Получает или задает шаблон формата, применяемый к содержимому заголовка столбца.Gets or sets the format pattern to apply to the content of the column header.

(Унаследовано от DataGridColumn)
HeaderStyle

Получает или задает стиль, используемый при отображении заголовка столбца.Gets or sets the style that is used when rendering the column header.

(Унаследовано от DataGridColumn)
HeaderTemplate

Получает или задает шаблон, определяющий визуальное представление заголовка столбца.Gets or sets the template that defines the visual representation of the column header.

(Унаследовано от DataGridColumn)
HeaderTemplateSelector

Получает или задает объект, который выбирает, какой шаблон должен использоваться для заголовка столбца.Gets or sets the object that selects which template to use for the column header.

(Унаследовано от DataGridColumn)
IsAutoGenerated

Получает значение, указывающее, создается ли столбец автоматически.Gets a value that indicates whether the column is auto-generated.

(Унаследовано от DataGridColumn)
IsFrozen

Получает значение, указывающее, запрещена ли горизонтальная прокрутка столбца.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Унаследовано от DataGridColumn)
IsReadOnly

Получение или установка значения, определяющего возможность редактирования ячеек в столбце.Gets or sets a value that indicates whether cells in the column can be edited.

(Унаследовано от DataGridColumn)
IsSealed

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения).Gets a value that indicates whether this instance is currently sealed (read-only).

(Унаследовано от DependencyObject)
IsThreeState

Получает или задает значение, указывающее, сколько состояний разрешают размещенные элементы управления CheckBox — три или два.Gets or sets a value that indicates whether the hosted CheckBox controls enable three states or two.

MaxWidth

Получает или задает максимальное ограничение ширины столбца.Gets or sets the maximum width constraint of the column.

(Унаследовано от DataGridColumn)
MinWidth

Получает или задает минимальное ограничение ширины столбца.Gets or sets the minimum width constraint of the column.

(Унаследовано от DataGridColumn)
SortDirection

Получает или задает направление сортировки столбца (по возрастанию или по убыванию).Gets or sets the sort direction (ascending or descending) of the column.

(Унаследовано от DataGridColumn)
SortMemberPath

Получение или установка имени свойства либо иерархии имен свойств, разделенных точками, которые определяют член, по которому будет выполняться сортировка.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Унаследовано от DataGridColumn)
Visibility

Получение или установка видимости столбца.Gets or sets the visibility of the column.

(Унаследовано от DataGridColumn)
Width

Получение или установка ширины столбца либо режима автоматического изменения размера.Gets or sets the column width or automatic sizing mode.

(Унаследовано от DataGridColumn)

Методы

CancelCellEdit(FrameworkElement, Object)

Приводит к восстановлению исходного неизмененного значения в изменяемой ячейке.Causes the cell being edited to revert to the original, unedited value.

(Унаследовано от DataGridColumn)
CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)

Очищает локальное значение свойства.Clears the local value of a property. Очищаемое свойство задается идентификатором DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)

Очищает локальное значение доступного только для чтения свойства.Clears the local value of a read-only property. Очищаемое свойство задается ключом DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Унаследовано от DependencyObject)
CoerceValue(DependencyProperty)

Приводит значение указанного свойства зависимостей.Coerces the value of the specified dependency property. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Унаследовано от DependencyObject)
CommitCellEdit(FrameworkElement)

Выполняет любую необходимую проверку перед выходом из режима правки ячейки.Performs any required validation before exiting cell editing mode.

(Унаследовано от DataGridColumn)
Equals(Object)

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Унаследовано от DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Получает элемент управления CheckBox, привязанный к значению свойства Binding столбца.Gets a CheckBox control that is bound to the column's Binding property value.

GenerateElement(DataGridCell, Object)

Получает доступный только для чтения элемент управления CheckBox, привязанный к значению свойства Binding столбца.Gets a read-only CheckBox control that is bound to the column's Binding property value.

GetCellContent(DataGridRow)

Извлекает значение свойства Content для ячейки, расположенной на пересечении данного столбца и указанной строки.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Унаследовано от DataGridColumn)
GetCellContent(Object)

Получает значение свойства Content для ячейки, которая расположена на пересечении данного столбца и строки, представляющей указанный элемент данных.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Унаследовано от DataGridColumn)
GetHashCode()

Возвращает хэш-код для данного объекта DependencyObject.Gets a hash code for this DependencyObject.

(Унаследовано от DependencyObject)
GetLocalValueEnumerator()

Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Унаследовано от DependencyObject)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)

Повторно вычисляет действующее значение для указанного свойства зависимостей.Re-evaluates the effective value for the specified dependency property.

(Унаследовано от DependencyObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
NotifyPropertyChanged(String)

Уведомляет DataGrid, содержащий этот столбец, об изменении свойства столбца.Notifies the DataGrid that contains this column that a column property has changed.

(Унаследовано от DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)

Уведомляет объект DataGrid при изменении значения свойства Binding.Notifies the DataGrid when the value of the Binding property changes.

(Унаследовано от DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)

Определяет значение свойства IsReadOnly на основе правил свойств из сетки данных, в которой содержится этот столбец.Determines the value of the IsReadOnly property based on property rules from the data grid that contains this column.

(Унаследовано от DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)

Порождает событие CopyingCellClipboardContent.Raises the CopyingCellClipboardContent event.

(Унаследовано от DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Порождает событие PastingCellClipboardContent.Raises the PastingCellClipboardContent event.

(Унаследовано от DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Вызывается каждый раз, когда обновляется действительное значение любого свойства зависимостей для данного DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Конкретное измененное свойство зависимостей сообщается в данных события.The specific dependency property that changed is reported in the event data.

(Унаследовано от DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Вызывается, когда ячейка в столбце переходит в режим правки.Called when a cell in the column enters editing mode.

ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если таковое существует.Returns the local value of a dependency property, if it exists.

(Унаследовано от DependencyObject)
RefreshCellContent(FrameworkElement, String)

Обновляет содержимое ячейки в столбце в ответ на изменение значения свойства столбца.Refreshes the contents of a cell in the column in response to a column property value change.

SetCurrentValue(DependencyProperty, Object)

Задает значение свойства зависимостей, не меняя источник значения.Sets the value of a dependency property without changing its value source.

(Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства.Sets the local value of a dependency property, specified by its dependency property identifier.

(Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Унаследовано от DependencyObject)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)

События

CopyingCellClipboardContent

Происходит после подготовки содержимого буфера обмена ячейки.Occurs after the cell clipboard content is prepared.

(Унаследовано от DataGridColumn)
PastingCellClipboardContent

Происходит перед перемещением содержимого буфера обмена в ячейку.Occurs before the clipboard content is moved to the cell.

(Унаследовано от DataGridColumn)

Применяется к

Дополнительно