Поделиться через


DataGridViewCheckBoxCell Класс

Определение

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

public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCell
public class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCell
type DataGridViewCheckBoxCell = class
    inherit DataGridViewCell
    interface IDataGridViewEditingCell
Public Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell
Наследование
DataGridViewCheckBoxCell
Реализации

Примеры

В следующем примере кода используется для 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)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
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)

Получает форматированное значение данных ячейки.

GetHashCode()

Служит хэш-функцией по умолчанию.

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

Возвращает наследуемое контекстное меню для текущей ячейки.

(Унаследовано от DataGridViewCell)
GetInheritedState(Int32)

Возвращает значение, указывающее текущее состояние ячейки, как наследуемое от состояния ее строки и столбца.

(Унаследовано от DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

Получает стиль, примененный к ячейке.

(Унаследовано от DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

Вычисляет предпочтительный размер ячейки в пикселях.

GetSize(Int32)

Возвращает размер ячейки.

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

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

(Унаследовано от Object)
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)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
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()

Возвращает строковое представление ячейки.

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

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