다음을 통해 공유


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 논리적으로 호스트하는 데 사용되는 특수 형식의 클래스입니다. A DataGridViewCheckBoxColumn 에 연결 된 DataGridViewCheckBoxCell 에서 모든 DataGridViewRow 과 교차 하는 합니다. 각 셀은 컨트롤과 유사한 UI(사용자 인터페이스)를 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

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

(다음에서 상속됨 DataGridViewBand)
Site

열의 사이트를 가져오거나 설정합니다.

(다음에서 상속됨 DataGridViewColumn)
SortMode

열의 정렬 모드를 가져오거나 설정합니다.

(다음에서 상속됨 DataGridViewColumn)
State

요소의 UI(사용자 인터페이스) 상태를 가져옵니다.

(다음에서 상속됨 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)

적용 대상

추가 정보