DataGridViewCheckBoxCell 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
DataGridView 컨트롤에서 사용할 확인란 UI(사용자 인터페이스)를 표시합니다.
public ref class DataGridViewCheckBoxCell : System::Windows::Forms::DataGridViewCell, System::Windows::Forms::IDataGridViewEditingCellpublic class DataGridViewCheckBoxCell : System.Windows.Forms.DataGridViewCell, System.Windows.Forms.IDataGridViewEditingCelltype DataGridViewCheckBoxCell = class
inherit DataGridViewCell
interface IDataGridViewEditingCellPublic Class DataGridViewCheckBoxCell
Inherits DataGridViewCell
Implements IDataGridViewEditingCell- 상속
- 구현
예제
다음 코드 예제에서는 를 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 검사 상자 UI를 통해 제공되는 이진 또는 삼항 정보를 표시하는 데 사용되는 특수 형식 DataGridViewCell 입니다. 기본 이진 모드에서 셀은 또는 false의 true 값을 보유할 수 있습니다. 3차원 모드에서 셀은 값 중 CheckState 하나를 사용합니다. 속성은 이 ThreeState 진 모드 또는 3항 모드가 적용되는지 여부를 결정합니다.
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 |
|
| FlatStyle |
확인란 UI(사용자 인터페이스)의 평면 스타일 모양을 가져오거나 설정합니다. |
| FormattedValue |
표시를 위해 형식이 지정된 셀 값을 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| FormattedValueType |
셀 표시 값의 형식을 가져옵니다. |
| Frozen |
셀이 고정되어 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| HasStyle |
Style 속성이 설정되었는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| IndeterminateValue |
비활성화된 셀 값이나 |
| InheritedState |
해당 행과 열의 상태에서 상속된 셀의 현재 상태를 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| InheritedStyle |
셀에 현재 적용된 스타일을 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| IsInEditMode |
이 셀을 현재 편집하고 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| OwningColumn |
이 셀을 포함하는 열을 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| OwningRow |
이 셀을 포함하는 행을 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| PreferredSize |
셀이 들어갈 수 있는 사각형 영역의 크기(픽셀)를 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| ReadOnly |
셀의 데이터를 편집할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataGridViewCell) |
| Resizable |
셀의 크기를 조정할 수 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| RowIndex |
셀의 부모 행의 인덱스를 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| Selected |
셀이 선택되었는지 여부를 나타내는 값을 가져오거나 설정합니다. (다음에서 상속됨 DataGridViewCell) |
| Size |
셀의 크기를 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
| State |
요소의 UI(사용자 인터페이스) 상태를 가져옵니다. (다음에서 상속됨 DataGridViewElement) |
| Style |
셀의 스타일을 가져오거나 설정합니다. (다음에서 상속됨 DataGridViewCell) |
| Tag |
셀에 대한 추가 데이터를 포함하는 개체를 가져오거나 설정합니다. (다음에서 상속됨 DataGridViewCell) |
| ThreeState |
호스팅된 확인란 컨트롤에 대해 삼진 모드가 활성화되었는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| ToolTipText |
이 셀과 연결된 도구 설명 텍스트를 가져오거나 설정합니다. (다음에서 상속됨 DataGridViewCell) |
| TrueValue |
|
| Value |
이 셀과 연결된 값을 가져오거나 설정합니다. (다음에서 상속됨 DataGridViewCell) |
| ValueType |
셀에 있는 값의 데이터 형식을 가져옵니다. |
| Visible |
셀이 숨겨진 행이나 열에 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 DataGridViewCell) |
메서드
적용 대상
추가 정보
.NET