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


DataGridViewCheckBoxColumn Класс

Определение

Размещает коллекцию объектов DataGridViewCheckBoxCell.

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

Примеры

В следующем примере кода показано, как использовать DataGridViewCheckBoxColumn , чтобы пометить, какие сотрудники находятся вне офиса. Этот пример является частью более крупного примера, доступного в 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

Комментарии

Класс DataGridViewCheckBoxColumn является специализированным типом класса , используемым DataGridViewColumn для логических ячеек, указывающих двоичное состояние. Объект DataGridViewCheckBoxColumn имеет связанный DataGridViewCheckBoxCell в каждом DataGridViewRow объекте, пересекающий его. Каждая ячейка предоставляет пользовательский интерфейс, аналогичный элементу CheckBox управления.

Режим сортировки по умолчанию для этого типа столбца — NotSortable.

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

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

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

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

DataGridViewCheckBoxColumn()

Инициализирует новый экземпляр класса DataGridViewCheckBoxColumn, устанавливая его в состояние по умолчанию.

DataGridViewCheckBoxColumn(Boolean)

Инициализирует новый экземпляр класса DataGridViewCheckBoxColumn и настраивает его для отображения флажков с двумя или тремя состояниями.

Свойства

AutoSizeMode

Возвращает или задает режим, в котором автоматически изменяется ширина столбца.

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

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

CellType

Возвращает тип времени выполнения шаблона ячеек.

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

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

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

Получает элемент управления DataGridView, связанный с данным элементом.

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

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

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

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

DefaultHeaderCellType

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

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

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

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

Возвращает или задает расположение столбца относительно столбцов, отображаемых в текущий момент.

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

Возвращает или задает ширину (в пикселях) разделителя столбца.

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

Получает или задает основное значение, соответствующее значению ячейки, равному false, которое выглядит как неустановленный флажок.

FillWeight

Возвращает или задает значение, представляющее ширину столбца, находящегося в режиме заполнения, относительно ширины других столбцов элемента управления, находящихся в этом режиме.

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

Получает или задает плоский внешний вид для ячеек флажков.

Frozen

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

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

Получает значение, показывающее, было ли установлено свойство DefaultCellStyle.

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

Возвращает или задает объект DataGridViewColumnHeaderCell, представляющий заголовок столбца.

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

Получает или задает ячейку заголовка объекта DataGridViewBand.

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

Возвращает или задает текст ячейки заголовка столбца.

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

Получает или задает основное значение, соответствующее неопределенному значению или значению null ячейки, которая выглядит как снятый флажок.

Index

Получает относительную позицию диапазона в элементе управления DataGridView.

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

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

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

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

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

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

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

Получает значение, показывающее, представляет ли диапазон строку.

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

Возвращает или задает наименьшую ширину столбца (в пикселях).

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

Возвращает или задает имя столбца.

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

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

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

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

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

Получает или задает значение, показывающее, выделен ли диапазон в пользовательском интерфейсе.

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

Возвращает или задает подложку столбца.

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

Возвращает или задает режим сортировки для столбца.

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

Получает состояние пользовательского интерфейса для элемента.

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

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

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

Получает или задает значение, указывающее, допускают ли размещенные ячейки флажков три контрольных состояния, а не два.

ToolTipText

Возвращает или задает текст, используемый для подсказок.

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

Получает или задает основное значение, соответствующее значению ячейки, равному true, которое выглядит как установленный флажок.

ValueType

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

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

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

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

Возвращает или задает текущую ширину столбца.

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

Методы

Clone()

Создает точную копию данного диапазона.

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

Освобождает все ресурсы, занятые модулем DataGridViewBand.

(Унаследовано от DataGridViewBand)
Dispose(Boolean)

Освобождает неуправляемые ресурсы, используемые объектом DataGridViewBand, а при необходимости освобождает также управляемые ресурсы.

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

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

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

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

(Унаследовано от Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

Вычисляет оптимальную ширину столбца на основе указанных критериев.

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

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

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

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

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

Вызывается, когда диапазон связан с другим элементом управления DataGridView.

(Унаследовано от DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)

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

(Унаследовано от DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

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

(Унаследовано от DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

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

(Унаследовано от DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

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

(Унаследовано от DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

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

(Унаследовано от DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

Вызывает событие MouseWheel.

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

Возвращает строку, описывающую столбец.

События

Disposed

Происходит при удалении объекта DataGridViewColumn.

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

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

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