DataGridViewCheckBoxColumn DataGridViewCheckBoxColumn DataGridViewCheckBoxColumn DataGridViewCheckBoxColumn Class

Определение

Размещает коллекцию объектов DataGridViewCheckBoxCell.Hosts a collection of DataGridViewCheckBoxCell objects.

public ref class DataGridViewCheckBoxColumn : System::Windows::Forms::DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn.bmp")]
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewCheckBoxColumn), "DataGridViewCheckBoxColumn")]
public class DataGridViewCheckBoxColumn : System.Windows.Forms.DataGridViewColumn
type DataGridViewCheckBoxColumn = class
    inherit DataGridViewColumn
Public Class DataGridViewCheckBoxColumn
Inherits DataGridViewColumn
Наследование
Атрибуты

Примеры

В следующем примере кода показано, как использовать DataGridViewCheckBoxColumn для обозначения сотрудников, находящихся за пределами офиса.The following code example demonstrates how to use a DataGridViewCheckBoxColumn to mark which employees are out of the office. Этот пример является частью большого примера, доступного в DataGridViewComboBoxColumn разделе Обзор класса.This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

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

Комментарии

Класс является специализированным типом DataGridViewColumn класса, который используется для логического размещения ячеек, указывающих на двоичное состояние. DataGridViewCheckBoxColumnThe DataGridViewCheckBoxColumn class is a specialized type of the DataGridViewColumn class used to logically host cells that indicate binary state. У DataGridViewCheckBoxColumn объекта есть связанный DataGridViewCheckBoxCell DataGridViewRow объект, который пересекает его.A DataGridViewCheckBoxColumn has an associated DataGridViewCheckBoxCell in every DataGridViewRow that intersects it. Каждая ячейка предоставляет пользовательский интерфейс, аналогичный CheckBox элементу управления.Each cell supplies a user interface (UI) that is similar to a CheckBox control.

По умолчанию для этого типа столбца используется NotSortableрежим сортировки.The default sort mode for this column type is NotSortable.

Как правило, значения ячеек флажков предназначены для хранения, например для любых других данных, или для выполнения операций с массовыми операциями.Typically, check box cell values are intended either for storage, like any other data, or for performing bulk operations. Если вы хотите ответить немедленно, когда пользователь нащелкнул ячейку флажка, можно обработать DataGridView.CellContentClick событие, но это событие происходит перед обновлением значения ячейки.If you want to respond immediately when users click a check box cell, you can handle the DataGridView.CellContentClick event, but this event occurs before the cell value is updated. Если требуется новое значение во время щелчка, можно вычислить ожидаемое значение на основе текущего значения.If you need the new value at the time of the click, one option is to calculate what the expected value will be based on the current value. Другой подход заключается в фиксации изменения немедленно и обработке DataGridView.CellValueChanged события для реагирования на него.Another approach is to commit the change immediately, and handle the DataGridView.CellValueChanged event to respond to it. Чтобы зафиксировать изменение при щелчке ячейки, необходимо выполнить обработку DataGridView.CurrentCellDirtyStateChanged события.To commit the change when the cell is clicked, you must handle the DataGridView.CurrentCellDirtyStateChanged event. Если в обработчике текущая ячейка является ячейкой флажка, вызовите DataGridView.CommitEdit метод и передайте Commit значение.In the handler, if the current cell is a check box cell, call the DataGridView.CommitEdit method and pass in the Commit value.

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

При наследовании от DataGridViewCheckBoxColumn и добавлении новых свойств в производный класс обязательно Clone() Переопределите метод, чтобы скопировать новые свойства во время операций клонирования.When you derive from DataGridViewCheckBoxColumn and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. Также следует вызвать Clone() метод базового класса, чтобы свойства базового класса копировались в новую ячейку.You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

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

DataGridViewCheckBoxColumn() DataGridViewCheckBoxColumn() DataGridViewCheckBoxColumn() DataGridViewCheckBoxColumn()

Инициализирует новый экземпляр класса DataGridViewCheckBoxColumn, устанавливая его в состояние по умолчанию.Initializes a new instance of the DataGridViewCheckBoxColumn class to the default state.

DataGridViewCheckBoxColumn(Boolean) DataGridViewCheckBoxColumn(Boolean) DataGridViewCheckBoxColumn(Boolean) DataGridViewCheckBoxColumn(Boolean)

Инициализирует новый экземпляр класса DataGridViewCheckBoxColumn и настраивает его для отображения флажков с двумя или тремя состояниями.Initializes a new instance of the DataGridViewCheckBoxColumn and configures it to display check boxes with two or three states.

Свойства

AutoSizeMode AutoSizeMode AutoSizeMode AutoSizeMode

Возвращает или задает режим, в котором автоматически изменяется ширина столбца.Gets or sets the mode by which the column automatically adjusts its width.

(Inherited from DataGridViewColumn)
CellTemplate CellTemplate CellTemplate CellTemplate

Получает или задает шаблон, используемый для создания новых ячеек.Gets or sets the template used to create new cells.

CellType CellType CellType CellType

Получает тип времени выполнения шаблона ячеек.Gets the run-time type of the cell template.

(Inherited from DataGridViewColumn)
ContextMenuStrip ContextMenuStrip ContextMenuStrip ContextMenuStrip

Возвращает или задает контекстное меню для столбца.Gets or sets the shortcut menu for the column.

(Inherited from DataGridViewColumn)
DataGridView DataGridView DataGridView DataGridView

Получает элемент управления DataGridView, связанный с данным элементом.Gets the DataGridView control associated with this element.

(Inherited from DataGridViewElement)
DataPropertyName DataPropertyName DataPropertyName DataPropertyName

Возвращает или задает имя того свойства данных или столбца базы данных в источнике данных, с которым связан столбец DataGridViewColumn.Gets or sets the name of the data source property or database column to which the DataGridViewColumn is bound.

(Inherited from DataGridViewColumn)
DefaultCellStyle DefaultCellStyle DefaultCellStyle DefaultCellStyle

Получает или задает стиль по умолчанию для ячеек столбца.Gets or sets the column's default cell style.

DefaultHeaderCellType DefaultHeaderCellType DefaultHeaderCellType DefaultHeaderCellType

Получает или задает тип времени выполнения для ячейки заголовка по умолчанию.Gets or sets the run-time type of the default header cell.

(Inherited from DataGridViewBand)
Displayed Displayed Displayed Displayed

Получает значение, показывающее, отображается ли диапазон на экране в данный момент.Gets a value indicating whether the band is currently displayed onscreen.

(Inherited from DataGridViewBand)
DisplayIndex DisplayIndex DisplayIndex DisplayIndex

Возвращает или задает расположение столбца относительно столбцов, отображаемых в текущий момент.Gets or sets the display order of the column relative to the currently displayed columns.

(Inherited from DataGridViewColumn)
DividerWidth DividerWidth DividerWidth DividerWidth

Возвращает или задает ширину (в пикселях) разделителя столбца.Gets or sets the width, in pixels, of the column divider.

(Inherited from DataGridViewColumn)
FalseValue FalseValue FalseValue FalseValue

Получает или задает основное значение, соответствующее значению ячейки, равному false, которое выглядит как неустановленный флажок.Gets or sets the underlying value corresponding to a cell value of false, which appears as an unchecked box.

FillWeight FillWeight FillWeight FillWeight

Возвращает или задает значение, представляющее ширину столбца, находящегося в режиме заполнения, относительно ширины других столбцов элемента управления, находящихся в этом режиме.Gets or sets a value that represents the width of the column when it is in fill mode relative to the widths of other fill-mode columns in the control.

(Inherited from DataGridViewColumn)
FlatStyle FlatStyle FlatStyle FlatStyle

Получает или задает плоский внешний вид для ячеек флажков.Gets or sets the flat style appearance of the check box cells.

Frozen Frozen Frozen Frozen

Возвращает или задает значение, указывающее, перемещается ли столбец, когда пользователь выполняет горизонтальную прокрутку элемента управления DataGridView.Gets or sets a value indicating whether a column will move when a user scrolls the DataGridView control horizontally.

(Inherited from DataGridViewColumn)
HasDefaultCellStyle HasDefaultCellStyle HasDefaultCellStyle HasDefaultCellStyle

Получает значение, показывающее, было ли установлено свойство DefaultCellStyle.Gets a value indicating whether the DefaultCellStyle property has been set.

(Inherited from DataGridViewBand)
HeaderCell HeaderCell HeaderCell HeaderCell

Возвращает или задает объект DataGridViewColumnHeaderCell, представляющий заголовок столбца.Gets or sets the DataGridViewColumnHeaderCell that represents the column header.

(Inherited from DataGridViewColumn)
HeaderCellCore HeaderCellCore HeaderCellCore HeaderCellCore

Получает или задает ячейку заголовка объекта DataGridViewBand.Gets or sets the header cell of the DataGridViewBand.

(Inherited from DataGridViewBand)
HeaderText HeaderText HeaderText HeaderText

Возвращает или задает текст ячейки заголовка столбца.Gets or sets the caption text on the column's header cell.

(Inherited from DataGridViewColumn)
IndeterminateValue IndeterminateValue IndeterminateValue IndeterminateValue

Получает или задает основное значение, соответствующее неопределенному значению или значению null ячейки, которая выглядит как снятый флажок.Gets or sets the underlying value corresponding to an indeterminate or null cell value, which appears as a disabled checkbox.

Index Index Index Index

Получает относительную позицию диапазона в элементе управления DataGridView.Gets the relative position of the band within the DataGridView control.

(Inherited from DataGridViewBand)
InheritedAutoSizeMode InheritedAutoSizeMode InheritedAutoSizeMode InheritedAutoSizeMode

Возвращает или задает режим изменения размера, действующий для столбца.Gets the sizing mode in effect for the column.

(Inherited from DataGridViewColumn)
InheritedStyle InheritedStyle InheritedStyle InheritedStyle

Получает стиль ячейки, применяемый в текущий момент к столбцу.Gets the cell style currently applied to the column.

(Inherited from DataGridViewColumn)
IsDataBound IsDataBound IsDataBound IsDataBound

Получает значение, указывающее, связан ли столбец с источником данных.Gets a value indicating whether the column is bound to a data source.

(Inherited from DataGridViewColumn)
IsRow IsRow IsRow IsRow

Получает значение, показывающее, представляет ли диапазон строку.Gets a value indicating whether the band represents a row.

(Inherited from DataGridViewBand)
MinimumWidth MinimumWidth MinimumWidth MinimumWidth

Возвращает или задает наименьшую ширину столбца (в пикселях).Gets or sets the minimum width, in pixels, of the column.

(Inherited from DataGridViewColumn)
Name Name Name Name

Возвращает или задает имя столбца.Gets or sets the name of the column.

(Inherited from DataGridViewColumn)
ReadOnly ReadOnly ReadOnly ReadOnly

Возвращает или задает значение, указывающее, может ли пользователь изменять ячейки столбца.Gets or sets a value indicating whether the user can edit the column's cells.

(Inherited from DataGridViewColumn)
Resizable Resizable Resizable Resizable

Возвращает или задает значение, указывающее, возможно ли изменение размера столбца.Gets or sets a value indicating whether the column is resizable.

(Inherited from DataGridViewColumn)
Selected Selected Selected Selected

Получает или задает значение, показывающее, выделен ли диапазон в пользовательском интерфейсе.Gets or sets a value indicating whether the band is in a selected user interface (UI) state.

(Inherited from DataGridViewBand)
Site Site Site Site

Возвращает или задает подложку столбца.Gets or sets the site of the column.

(Inherited from DataGridViewColumn)
SortMode SortMode SortMode SortMode

Получает или задает режим сортировки для столбца.Gets or sets the sort mode for the column.

(Inherited from DataGridViewColumn)
State State State State

Получает состояние пользовательского интерфейса для элемента.Gets the user interface (UI) state of the element.

(Inherited from DataGridViewElement)
Tag Tag Tag Tag

Получает или задает объект, содержащий данные, связанные с диапазоном.Gets or sets the object that contains data to associate with the band.

(Inherited from DataGridViewBand)
ThreeState ThreeState ThreeState ThreeState

Получает или задает значение, указывающее, допускают ли размещенные ячейки флажков три контрольных состояния, а не два.Gets or sets a value indicating whether the hosted check box cells will allow three check states rather than two.

ToolTipText ToolTipText ToolTipText ToolTipText

Возвращает или задает текст, используемый для подсказок.Gets or sets the text used for ToolTips.

(Inherited from DataGridViewColumn)
TrueValue TrueValue TrueValue TrueValue

Получает или задает основное значение, соответствующее значению ячейки, равному true, которое выглядит как установленный флажок.Gets or sets the underlying value corresponding to a cell value of true, which appears as a checked box.

ValueType ValueType ValueType ValueType

Возвращает или задает тип данных для значений в ячейках столбца.Gets or sets the data type of the values in the column's cells.

(Inherited from DataGridViewColumn)
Visible Visible Visible Visible

Возвращает или задает значение, указывающее, является ли столбец видимым.Gets or sets a value indicating whether the column is visible.

(Inherited from DataGridViewColumn)
Width Width Width Width

Возвращает или задает текущую ширину столбца.Gets or sets the current width of the column.

(Inherited from DataGridViewColumn)

Методы

Clone() Clone() Clone() Clone()

Создает точную копию данного диапазона.Creates an exact copy of this band.

(Inherited from DataGridViewColumn)
Dispose() Dispose() Dispose() Dispose()

Освобождает все ресурсы, занятые модулем DataGridViewBand.Releases all resources used by the DataGridViewBand.

(Inherited from DataGridViewBand)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом DataGridViewBand, а при необходимости освобождает также управляемые ресурсы.Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources.

(Inherited from DataGridViewColumn)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean) GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

Вычисляет оптимальную ширину столбца на основе указанных критериев.Calculates the ideal width of the column based on the specified criteria.

(Inherited from DataGridViewColumn)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnDataGridViewChanged() OnDataGridViewChanged() OnDataGridViewChanged() OnDataGridViewChanged()

Вызывается, когда диапазон связан с другим элементом управления DataGridView.Called when the band is associated with a different DataGridView.

(Inherited from DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs) RaiseCellClick(DataGridViewCellEventArgs) RaiseCellClick(DataGridViewCellEventArgs) RaiseCellClick(DataGridViewCellEventArgs)

Вызывает событие CellClick.Raises the CellClick event.

(Inherited from DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs) RaiseCellContentClick(DataGridViewCellEventArgs) RaiseCellContentClick(DataGridViewCellEventArgs) RaiseCellContentClick(DataGridViewCellEventArgs)

Вызывает событие CellContentClick.Raises the CellContentClick event.

(Inherited from DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs) RaiseCellContentDoubleClick(DataGridViewCellEventArgs) RaiseCellContentDoubleClick(DataGridViewCellEventArgs) RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

Вызывает событие CellContentDoubleClick.Raises the CellContentDoubleClick event.

(Inherited from DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs) RaiseCellValueChanged(DataGridViewCellEventArgs) RaiseCellValueChanged(DataGridViewCellEventArgs) RaiseCellValueChanged(DataGridViewCellEventArgs)

Вызывает событие CellValueChanged.Raises the CellValueChanged event.

(Inherited from DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs) RaiseDataError(DataGridViewDataErrorEventArgs) RaiseDataError(DataGridViewDataErrorEventArgs) RaiseDataError(DataGridViewDataErrorEventArgs)

Вызывает событие DataError.Raises the DataError event.

(Inherited from DataGridViewElement)
RaiseMouseWheel(MouseEventArgs) RaiseMouseWheel(MouseEventArgs) RaiseMouseWheel(MouseEventArgs) RaiseMouseWheel(MouseEventArgs)

Создает событие MouseWheel.Raises the MouseWheel event.

(Inherited from DataGridViewElement)
ToString() ToString() ToString() ToString()

Получает строку, описывающую столбец.Gets a string that describes the column.

События

Disposed Disposed Disposed Disposed

Происходит при удалении объекта DataGridViewColumn.Occurs when the DataGridViewColumn is disposed.

(Inherited from DataGridViewColumn)

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

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