DataGridViewCheckBoxCell Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewCheckBoxCell.cs

Отображает флажок пользовательского интерфейса для использования в элементе DataGridView управления.

public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCell

[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell

[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell

Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell

Наследование

Object

DataGridViewElement

DataGridViewCell

DataGridViewCheckBoxCell

Атрибуты

DynamicallyAccessedMembersAttribute

Реализации

IDataGridViewEditingCell

Примеры

В следующем примере кода используется DataGridViewCheckBoxColumn для отслеживания того, какие сотрудники находятся в офисе. Столбец состоит из DataGridViewCheckBoxCell объектов. Этот пример является частью более крупного примера, доступного в DataGridViewComboBoxColumn разделе обзора класса.

private:
    void AddOutOfOfficeColumn()
    {
        DataGridViewCheckBoxColumn^ column = gcnew DataGridViewCheckBoxColumn();
        {
            column->HeaderText = ColumnName::OutOfOffice.ToString();
            column->Name = ColumnName::OutOfOffice.ToString();
            column->AutoSizeMode = 
                DataGridViewAutoSizeColumnMode::DisplayedCells;
            column->FlatStyle = FlatStyle::Standard;
            column->ThreeState = true;
            column->CellTemplate = gcnew DataGridViewCheckBoxCell();
            column->CellTemplate->Style->BackColor = Color::Beige;
        }

        DataGridView1->Columns->Insert(0, column);
    }

private void AddOutOfOfficeColumn()
{
    DataGridViewCheckBoxColumn column = new DataGridViewCheckBoxColumn();
    {
        column.HeaderText = ColumnName.OutOfOffice.ToString();
        column.Name = ColumnName.OutOfOffice.ToString();
        column.AutoSizeMode = 
            DataGridViewAutoSizeColumnMode.DisplayedCells;
        column.FlatStyle = FlatStyle.Standard;
        column.ThreeState = true;
        column.CellTemplate = new DataGridViewCheckBoxCell();
        column.CellTemplate.Style.BackColor = Color.Beige;
    }

    DataGridView1.Columns.Insert(0, column);
}

Private Sub AddOutOfOfficeColumn()
    Dim column As New DataGridViewCheckBoxColumn()
    With column
        .HeaderText = ColumnName.OutOfOffice.ToString()
        .Name = ColumnName.OutOfOffice.ToString()
        .AutoSizeMode = DataGridViewAutoSizeColumnMode.DisplayedCells
        .FlatStyle = FlatStyle.Standard
        .CellTemplate = New DataGridViewCheckBoxCell()
        .CellTemplate.Style.BackColor = Color.Beige
    End With

    DataGridView1.Columns.Insert(0, column)
End Sub

Комментарии

Класс DataGridViewCheckBoxCell — это специализированный тип, используемый для отображения двоичных или тернарных DataGridViewCell сведений, представленных с помощью пользовательского интерфейса флажка. В двоичном режиме по умолчанию ячейки могут содержать значения true или false. В тернарном режиме ячейки принимают одно из значений CheckState . Свойство ThreeState определяет, действует ли двоичный или тернарный режим.

Тип DataGridViewCheckBoxColumn столбца, специализированный для хранения ячеек этого типа. По умолчанию инициализируется DataGridViewCheckBoxColumn.CellTemplate в новое DataGridViewCheckBoxCell. Чтобы шаблонировать ячейки в столбце после существующего DataGridViewCheckBoxCell, задайте свойству столбца CellTemplate значение ячейки, используемой в качестве шаблона.

Свойства, связанные с ячейками столбца, являются оболочками для аналогичных именованных свойств ячейки шаблона. Изменение значений свойств ячейки шаблона повлияет только на ячейки на основе шаблона, добавляемого после изменения. Однако изменение значений свойств, связанных с ячейками столбца, при необходимости обновит ячейку шаблона и все остальные ячейки в столбце и обновит отображение столбца.

Если текущая ячейка является текущей DataGridViewCheckBoxCell, DataGridView.IsCurrentCellInEditMode свойство всегда true.

Как правило, значения ячеек флажка предназначены либо для хранения, как и для других данных, либо для выполнения массовых операций. Если вы хотите немедленно ответить, когда пользователи щелкают ячейку флажка, можно обработать DataGridView.CellClick событие, но это событие возникает перед обновлением значения ячейки. Если вам нужно новое значение во время нажатия кнопки, один из вариантов — вычислить ожидаемое значение на основе текущего значения. Другой подход заключается в том, чтобы немедленно зафиксировать изменение и обработать DataGridView.CellValueChanged событие для реагирования на него. Чтобы зафиксировать изменение при щелчке ячейки, необходимо обработать DataGridView.CurrentCellDirtyStateChanged событие. В обработчике, если текущая ячейка является ячейкой флажка, вызовите DataGridView.CommitEdit метод и передайте Commit значение.

Примечания для тех, кто наследует этот метод

При получении и DataGridViewCheckBoxCell добавлении новых свойств в производный класс обязательно переопределите Clone() метод для копирования новых свойств во время клонирования. Необходимо также вызвать метод базового класса, чтобы свойства базового класса Clone() копировались в новую ячейку.

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

Имя	Описание
DataGridViewCheckBoxCell()	Инициализирует новый экземпляр DataGridViewCheckBoxCell класса в его состоянии по умолчанию.
DataGridViewCheckBoxCell(Boolean)	Инициализирует новый экземпляр DataGridViewCheckBoxCell класса, включив двоичное или тернарное состояние.

Свойства

Имя	Описание
AccessibilityObject	Возвращает назначенный DataGridViewCell.DataGridViewCellAccessibleObject объекту DataGridViewCell. (Унаследовано от DataGridViewCell)
ColumnIndex	Возвращает индекс столбца для этой ячейки. (Унаследовано от DataGridViewCell)
ContentBounds	Возвращает ограничивающий прямоугольник, который заключает область содержимого ячейки. (Унаследовано от DataGridViewCell)
ContextMenuStrip	Возвращает или задает контекстное меню, связанное с ячейкой. (Унаследовано от DataGridViewCell)
DataGridView	Возвращает элемент управления, связанный с этим элементом DataGridView . (Унаследовано от DataGridViewElement)
DefaultNewRowValue	Возвращает значение по умолчанию для ячейки в строке для новых записей. (Унаследовано от DataGridViewCell)
Displayed	Возвращает значение, указывающее, отображается ли ячейка на экране. (Унаследовано от DataGridViewCell)
EditedFormattedValue	Возвращает текущее форматируемое значение ячейки независимо от того, находится ли ячейка в режиме редактирования и значение не зафиксировано. (Унаследовано от DataGridViewCell)
EditingCellFormattedValue	Возвращает или задает форматируемое значение элемента управления, размещенного ячейкой, когда он находится в режиме редактирования.
EditingCellValueChanged	Возвращает или задает флаг, указывающий, что значение было изменено для этой ячейки.
EditType	Возвращает тип размещенного элемента управления редактирования ячейки.
ErrorIconBounds	Возвращает границы значка ошибки для ячейки. (Унаследовано от DataGridViewCell)
ErrorText	Возвращает или задает текст, описывающий условие ошибки, связанное с ячейкой. (Унаследовано от DataGridViewCell)
FalseValue	Возвращает или задает базовое значение, соответствующее значению ячейки false.
FlatStyle	Возвращает или задает внешний вид неструктурированного стиля пользовательского интерфейса флажка.
FormattedValue	Возвращает значение ячейки в формате отформатированного для отображения. (Унаследовано от DataGridViewCell)
FormattedValueType	Возвращает тип отображаемого значения ячейки.
Frozen	Возвращает значение, указывающее, заморожена ли ячейка. (Унаследовано от DataGridViewCell)
HasStyle	Возвращает значение, указывающее, задано ли Style свойство. (Унаследовано от DataGridViewCell)
IndeterminateValue	Возвращает или задает базовое значение, соответствующее неопределенной или null ячейке.
InheritedState	Возвращает текущее состояние ячейки, унаследованное от состояния строки и столбца. (Унаследовано от DataGridViewCell)
InheritedStyle	Возвращает стиль, применяемый к ячейке. (Унаследовано от DataGridViewCell)
IsInEditMode	Возвращает значение, указывающее, редактируется ли в данный момент эта ячейка. (Унаследовано от DataGridViewCell)
OwningColumn	Возвращает столбец, содержащий эту ячейку. (Унаследовано от DataGridViewCell)
OwningRow	Возвращает строку, содержащую эту ячейку. (Унаследовано от DataGridViewCell)
PreferredSize	Получает размер в пикселях прямоугольной области, в которой ячейка может поместиться. (Унаследовано от DataGridViewCell)
ReadOnly	Возвращает или задает значение, указывающее, можно ли изменять данные ячейки. (Унаследовано от DataGridViewCell)
Resizable	Возвращает значение, указывающее, можно ли изменить размер ячейки. (Унаследовано от DataGridViewCell)
RowIndex	Возвращает индекс родительской строки ячейки. (Унаследовано от DataGridViewCell)
Selected	Возвращает или задает значение, указывающее, выбрана ли ячейка. (Унаследовано от DataGridViewCell)
Size	Возвращает размер ячейки. (Унаследовано от DataGridViewCell)
State	Возвращает состояние пользовательского интерфейса элемента. (Унаследовано от DataGridViewElement)
Style	Возвращает или задает стиль ячейки. (Унаследовано от DataGridViewCell)
Tag	Возвращает или задает объект, содержащий дополнительные данные о ячейке. (Унаследовано от DataGridViewCell)
ThreeState	Возвращает или задает значение, указывающее, включен ли тернарный режим для размещенного элемента управления флажка.
ToolTipText	Возвращает или задает текст подсказки, связанный с этой ячейкой. (Унаследовано от DataGridViewCell)
TrueValue	Возвращает или задает базовое значение, соответствующее значению ячейки true.
Value	Возвращает или задает значение, связанное с этой ячейкой. (Унаследовано от DataGridViewCell)
ValueType	Возвращает тип данных значений в ячейке.
Visible	Возвращает значение, указывающее, находится ли ячейка в строке или столбце, который был скрыт. (Унаследовано от DataGridViewCell)

Методы

Имя	Описание
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Изменяет стиль границы входной ячейки в соответствии с указанными критериями. (Унаследовано от DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Rectangle Возвращает значение, представляющее ширину всех полей ячейки. (Унаследовано от DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли строка ячейки не совместно использоваться при щелчке ячейки. (Унаследовано от DataGridViewCell)
Clone()	Создает точную копию этой ячейки.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли строка, содержащая ячейку, отменить общий доступ при щелчке содержимого ячейки.
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли строка, содержащая ячейку, не совместно использоваться при двойном щелчке содержимого ячейки.
CreateAccessibilityInstance()	Создает новый объект со специальными возможностями для объекта DataGridViewCheckBoxCell.
DetachEditingControl()	Удаляет элемент управления редактирования ячейки из DataGridViewэлемента управления . (Унаследовано от DataGridViewCell)
Dispose()	Освобождает все ресурсы, используемые параметром DataGridViewCell. (Унаследовано от DataGridViewCell)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые DataGridViewCell и при необходимости освобождает управляемые ресурсы. (Унаследовано от DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли строка ячейки не совместно использоваться при двойном щелчке ячейки. (Унаследовано от DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Указывает, будет ли родительская строка не совместно использоваться при перемещении фокуса в ячейку. (Унаследовано от DataGridViewCell)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Извлекает форматируемое значение ячейки для копирования Clipboardв . (Унаследовано от DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Возвращает ограничивающий прямоугольник, который заключает область содержимого ячейки, которая вычисляется с помощью указанного Graphics и стиля ячейки.
GetContentBounds(Int32)	Возвращает ограничивающий прямоугольник, который заключает область содержимого ячейки с использованием стиля ячеек по умолчанию Graphics и ячейки, действующего в настоящее время для ячейки. (Унаследовано от DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Возвращает текущее форматируемое значение ячейки независимо от того, находится ли ячейка в режиме редактирования и значение не зафиксировано. (Унаследовано от DataGridViewCell)
GetEditingCellFormattedValue(DataGridViewDataErrorContexts)	Возвращает форматируемое значение ячейки во время его редактирования.
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Возвращает ограничивающий прямоугольник, который заключает значок ошибки ячейки, если он отображается.
GetErrorText(Int32)	Возвращает строку, представляющую ошибку ячейки. (Унаследовано от DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Возвращает форматируемое значение данных ячейки.
GetInheritedContextMenuStrip(Int32)	Возвращает унаследованное контекстное меню для текущей ячейки. (Унаследовано от DataGridViewCell)
GetInheritedState(Int32)	Возвращает значение, указывающее текущее состояние ячейки, унаследованное от состояния строки и столбца. (Унаследовано от DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Возвращает стиль, применяемый к ячейке. (Унаследовано от DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Вычисляет предпочтительный размер ячейки в пикселях.
GetSize(Int32)	Возвращает размер ячейки. (Унаследовано от DataGridViewCell)
GetValue(Int32)	Возвращает значение ячейки. (Унаследовано от DataGridViewCell)
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Инициализирует элемент управления, используемый для изменения ячейки. (Унаследовано от DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Указывает, не используется ли строка, содержащая ячейку, при нажатии клавиши во время фокуса ячейки.
KeyEntersEditMode(KeyEventArgs)	Определяет, следует ли запускать режим редактирования на основе заданного ключа. (Унаследовано от DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Указывает, будет ли строка не совместно использоваться, если нажатие клавиши при нажатии ячейки в строке имеет фокус. (Унаследовано от DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Указывает, не используется ли строка, содержащая ячейку, при освобождении ключа во время фокуса ячейки.
LeaveUnsharesRow(Int32, Boolean)	Указывает, будет ли строка не совместно использоваться при выходе фокуса из ячейки в строке. (Унаследовано от DataGridViewCell)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли строка не совместно использоваться, если пользователь нажимает кнопку мыши, пока указатель находится в ячейке в строке. (Унаследовано от DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли строка не совместно использоваться, если пользователь дважды щелкает ячейку в строке. (Унаследовано от DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли строка, содержащая ячейку, не совместно использоваться при нажатии кнопки мыши при нажатии указателя на ячейку.
MouseEnterUnsharesRow(Int32)	Указывает, будет ли строка, содержащая ячейку, не совместно использоваться при перемещении указателя мыши по ячейке.
MouseLeaveUnsharesRow(Int32)	Указывает, будет ли строка, содержащая ячейку, не совместно использоваться, когда указатель мыши покидает ячейку.
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли строка не совместно использоваться при перемещении указателя мыши по ячейке в строке. (Унаследовано от DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли строка, содержащая ячейку, отключена при освобождении кнопки мыши, пока указатель находится над ячейкой.
OnClick(DataGridViewCellEventArgs)	Вызывается при щелчке ячейки. (Унаследовано от DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Вызывается при щелчке содержимого ячейки.
OnContentDoubleClick(DataGridViewCellEventArgs)	Вызывается при двойном щелчке содержимого ячейки.
OnDataGridViewChanged()	Вызывается при DataGridView изменении свойства ячейки. (Унаследовано от DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Вызывается при двойном щелчке ячейки. (Унаследовано от DataGridViewCell)
OnEnter(Int32, Boolean)	Вызывается при перемещении фокуса в ячейку. (Унаследовано от DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Вызывается при нажатии клавиши символа, пока фокус находится на ячейке.
OnKeyPress(KeyPressEventArgs, Int32)	Вызывается при нажатии клавиши, пока фокус находится на ячейке. (Унаследовано от DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Вызывается при освобождении ключа символа во время фокуса в ячейке.
OnLeave(Int32, Boolean)	Вызывается при перемещении фокуса из ячейки.
OnMouseClick(DataGridViewCellMouseEventArgs)	Вызывается, когда пользователь нажимает кнопку мыши, пока указатель находится в ячейке. (Унаследовано от DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Вызывается, когда пользователь дважды щелкает кнопку мыши, пока указатель находится в ячейке. (Унаследовано от DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Вызывается, когда кнопка мыши удерживается, пока указатель находится в ячейке.
OnMouseEnter(Int32)	Вызывается, когда указатель мыши перемещается по ячейке. (Унаследовано от DataGridViewCell)
OnMouseLeave(Int32)	Вызывается, когда указатель мыши перемещается из ячейки.
OnMouseMove(DataGridViewCellMouseEventArgs)	Вызывается, когда указатель мыши перемещается в ячейку.
OnMouseUp(DataGridViewCellMouseEventArgs)	Вызывается при освобождении кнопки мыши, пока указатель находится в ячейке.
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Рисует текущий DataGridViewCheckBoxCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Красит границу текущего DataGridViewCell. (Унаследовано от DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Закрашивает значок ошибки текущего DataGridViewCell. (Унаследовано от DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Преобразует значение, отформатированный для отображения в фактическое значение ячейки.
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Задает расположение и размер элемента управления редактирования, размещенного ячейкой в элементе DataGridView управления. (Унаследовано от DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Задает расположение и размер панели редактирования, размещенной ячейкой, и возвращает обычные границы элемента управления редактирования на панели редактирования. (Унаследовано от DataGridViewCell)
PrepareEditingCellForEdit(Boolean)	Этот метод не имеет значения для этого типа.
RaiseCellClick(DataGridViewCellEventArgs)	Вызывает событие CellClick. (Унаследовано от DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Вызывает событие CellContentClick. (Унаследовано от DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Вызывает событие CellContentDoubleClick. (Унаследовано от DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Вызывает событие CellValueChanged. (Унаследовано от DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Вызывает событие DataError. (Унаследовано от DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Вызывает событие MouseWheel. (Унаследовано от DataGridViewElement)
SetValue(Int32, Object)	Задает значение ячейки. (Унаследовано от DataGridViewCell)
ToString()	Возвращает строковое представление ячейки.

См. также раздел

• DataGridView
• DataGridViewCell
• DataGridViewCheckBoxColumn
• CellTemplate