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

설명

합니다 DataGridViewCheckBoxColumn 클래스는 특수 한 유형의 DataGridViewColumn 논리적으로 이진 상태를 나타내는 호스트 셀에 사용 되는 클래스입니다.The DataGridViewCheckBoxColumn class is a specialized type of the DataGridViewColumn class used to logically host cells that indicate binary state. A DataGridViewCheckBoxColumn 에 연결 된 DataGridViewCheckBoxCell 에서 모든 DataGridViewRow 과 교차 하는 합니다.A DataGridViewCheckBoxColumn has an associated DataGridViewCheckBoxCell in every DataGridViewRow that intersects it. 유사한 사용자 인터페이스 (UI)를 제공 하는 각 셀을 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

밴드가 선택한 UI(사용자 인터페이스) 상태에 있는지 여부를 나타내는 값을 가져오거나 설정합니다.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

요소의 UI(사용자 인터페이스) 상태를 가져옵니다.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)

적용 대상

추가 정보