DataGridViewCell 클래스

정의

DataGridView 컨트롤의 개별 셀을 나타냅니다.

public ref class DataGridViewCell abstract : System::Windows::Forms::DataGridViewElement, ICloneable, IDisposable
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))]
public abstract class DataGridViewCell : System.Windows.Forms.DataGridViewElement, ICloneable, IDisposable
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewCellConverter))>]
type DataGridViewCell = class
    inherit DataGridViewElement
    interface ICloneable
    interface IDisposable
Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable
상속
DataGridViewCell
파생
특성
구현

예제

다음 코드 예제에서는이 형식의 사용을 보여 줍니다. 이 예제에 대한 자세한 내용은 방법: Windows Forms DataGridView 컨트롤의 개별 셀에 도구 설명 추가를 참조하세요.

// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(Object^ /*sender*/, 
    DataGridViewCellFormattingEventArgs^ e)
{
    if ( (e->ColumnIndex == this->dataGridView1->Columns["Rating"]->Index)
        && e->Value != nullptr )
    {
        DataGridViewCell^ cell = 
            this->dataGridView1->Rows[e->RowIndex]->Cells[e->ColumnIndex];
        if (e->Value->Equals("*"))
        {                
            cell->ToolTipText = "very bad";
        }
        else if (e->Value->Equals("**"))
        {
            cell->ToolTipText = "bad";
        }
        else if (e->Value->Equals("***"))
        {
            cell->ToolTipText = "good";
        }
        else if (e->Value->Equals("****"))
        {
            cell->ToolTipText = "very good";
        }
    }
}
// Sets the ToolTip text for cells in the Rating column.
void dataGridView1_CellFormatting(object sender, 
    DataGridViewCellFormattingEventArgs e)
{
    if ( (e.ColumnIndex == this.dataGridView1.Columns["Rating"].Index)
        && e.Value != null )
    {
        DataGridViewCell cell = 
            this.dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];
        if (e.Value.Equals("*"))
        {                
            cell.ToolTipText = "very bad";
        }
        else if (e.Value.Equals("**"))
        {
            cell.ToolTipText = "bad";
        }
        else if (e.Value.Equals("***"))
        {
            cell.ToolTipText = "good";
        }
        else if (e.Value.Equals("****"))
        {
            cell.ToolTipText = "very good";
        }
    }
}
' Sets the ToolTip text for cells in the Rating column.
Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting

    If e.ColumnIndex = Me.dataGridView1.Columns("Rating").Index _
        AndAlso (e.Value IsNot Nothing) Then

        With Me.dataGridView1.Rows(e.RowIndex).Cells(e.ColumnIndex)

            If e.Value.Equals("*") Then
                .ToolTipText = "very bad"
            ElseIf e.Value.Equals("**") Then
                .ToolTipText = "bad"
            ElseIf e.Value.Equals("***") Then
                .ToolTipText = "good"
            ElseIf e.Value.Equals("****") Then
                .ToolTipText = "very good"
            End If

        End With

    End If

End Sub

설명

클래스는 DataGridViewCell 컨트롤의 개별 셀을 DataGridView 나타냅니다. 의 컬렉션을 통해 셀을 검색할 CellsDataGridViewRow수 있습니다.

DataGridViewCell 행과 열은 에서 셀의 위치를 식별합니다 DataGridView. 일반적인 셀에는 포함된 행 및 열과 관련된 데이터가 포함됩니다. 셀의 속성을 설정하고 연결된 이벤트를 처리하여 여러 가지 방법으로 셀을 사용자 지정할 수 있습니다.

구현자 참고

파생 하는 경우 DataGridViewCell 파생된 클래스에 새 속성 추가 재정의 해야 합니다 Clone() 복제 작업 중 새 속성을 복사 하는 방법입니다. 또한 기본 클래스를 호출 해야 Clone() 메서드는 기본 클래스의 속성이 새로운 셀에 복사 되도록 합니다.

생성자

DataGridViewCell()

DataGridViewCell 클래스의 새 인스턴스를 초기화합니다.

속성

AccessibilityObject

DataGridViewCell.DataGridViewCellAccessibleObject에 할당된 DataGridViewCell를 가져옵니다.

ColumnIndex

이 셀의 열 인덱스를 가져옵니다.

ContentBounds

셀의 내용 영역을 둘러싸는 경계 사각형을 가져옵니다.

ContextMenuStrip

셀과 연결된 바로 가기 메뉴를 가져오거나 설정합니다.

DataGridView

이 요소와 관련된 DataGridView 컨트롤을 가져옵니다.

(다음에서 상속됨 DataGridViewElement)
DefaultNewRowValue

새 레코드에 대한 행의 셀 기본값을 가져옵니다.

Displayed

셀이 현재 화면에 표시되는지 여부를 나타내는 값을 가져옵니다.

EditedFormattedValue

셀이 편집 모드에 있고 값이 커밋되지 않았는지 여부와 관계없이 셀의 형식이 지정된 현재 값을 가져옵니다.

EditType

셀의 호스팅된 편집 컨트롤의 형식을 가져옵니다.

ErrorIconBounds

셀에 대한 오류 아이콘의 범위를 가져옵니다.

ErrorText

셀과 연결된 오류 조건을 설명하는 텍스트를 가져오거나 설정합니다.

FormattedValue

표시를 위해 형식이 지정된 셀 값을 가져옵니다.

FormattedValueType

셀과 연결된 형식이 지정된 값의 형식을 가져옵니다.

Frozen

셀이 고정되어 있는지 여부를 나타내는 값을 가져옵니다.

HasStyle

Style 속성이 설정되었는지 여부를 나타내는 값을 가져옵니다.

InheritedState

해당 행과 열의 상태에서 상속된 셀의 현재 상태를 가져옵니다.

InheritedStyle

셀에 현재 적용된 스타일을 가져옵니다.

IsInEditMode

이 셀을 현재 편집하고 있는지 여부를 나타내는 값을 가져옵니다.

OwningColumn

이 셀을 포함하는 열을 가져옵니다.

OwningRow

이 셀을 포함하는 행을 가져옵니다.

PreferredSize

셀이 들어갈 수 있는 사각형 영역의 크기(픽셀)를 가져옵니다.

ReadOnly

셀의 데이터를 편집할 수 있는지 여부를 나타내는 값을 가져오거나 설정합니다.

Resizable

셀의 크기를 조정할 수 있는지 여부를 나타내는 값을 가져옵니다.

RowIndex

셀의 부모 행의 인덱스를 가져옵니다.

Selected

셀이 선택되었는지 여부를 나타내는 값을 가져오거나 설정합니다.

Size

셀의 크기를 가져옵니다.

State

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

(다음에서 상속됨 DataGridViewElement)
Style

셀의 스타일을 가져오거나 설정합니다.

Tag

셀에 대한 추가 데이터를 포함하는 개체를 가져오거나 설정합니다.

ToolTipText

이 셀과 연결된 도구 설명 텍스트를 가져오거나 설정합니다.

Value

이 셀과 연결된 값을 가져오거나 설정합니다.

ValueType

셀에 있는 값의 데이터 형식을 가져오거나 설정합니다.

Visible

셀이 숨겨진 행이나 열에 있는지 여부를 나타내는 값을 가져옵니다.

메서드

AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

지정된 조건에 따라 입력 셀 테두리 스타일을 수정합니다.

BorderWidths(DataGridViewAdvancedBorderStyle)

모든 셀 여백의 너비를 나타내는 Rectangle을 반환합니다.

ClickUnsharesRow(DataGridViewCellEventArgs)

셀을 클릭하는 경우 셀의 행을 공유하지 않을 것인지 여부를 나타냅니다.

Clone()

이 셀과 정확하게 일치하는 복사본을 만듭니다.

ContentClickUnsharesRow(DataGridViewCellEventArgs)

셀의 내용을 클릭하는 경우 셀의 행을 공유하지 않을 것인지 여부를 나타냅니다.

ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

셀의 내용을 두 번 클릭하는 경우 셀의 행을 공유하지 않을 것인지 여부를 나타냅니다.

CreateAccessibilityInstance()

DataGridViewCell에 대해 액세스 가능한 개체를 새로 만듭니다.

DetachEditingControl()

DataGridView에서 셀의 편집 컨트롤을 제거합니다.

Dispose()

DataGridViewCell에서 사용하는 모든 리소스를 해제합니다.

Dispose(Boolean)

DataGridViewCell에서 사용하는 관리되지 않는 리소스를 해제하고, 관리되는 리소스를 선택적으로 해제할 수 있습니다.

DoubleClickUnsharesRow(DataGridViewCellEventArgs)

셀을 두 번 클릭하는 경우 셀의 행을 공유하지 않을 것인지 여부를 나타냅니다.

EnterUnsharesRow(Int32, Boolean)

포커스가 셀로 이동하는 경우 부모 행을 공유하지 않을 것인지 여부를 나타냅니다.

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
Finalize()

가비지 수집에 의해 DataGridViewCell가 회수되기 전에 관리되지 않는 리소스를 해제하고 기타 정리 작업을 수행합니다.

GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)

서식이 지정된 셀 값을 검색하여 Clipboard에 복사합니다.

GetContentBounds(Graphics, DataGridViewCellStyle, Int32)

지정된 Graphics 와 셀 스타일을 사용하여 계산된 셀의 콘텐츠 영역을 둘러싸는 경계 사각형을 반환합니다.

GetContentBounds(Int32)

현재 셀에 적용되는 셀 스타일과 기본 Graphics를 사용하여 셀의 내용 영역을 둘러싸는 경계 사각형을 반환합니다.

GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)

셀이 편집 모드에 있고 값이 커밋되지 않았는지 여부와 관계없이 셀의 형식이 지정된 현재 값을 반환합니다.

GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)

셀의 오류 아이콘이 표시되면 이 아이콘을 둘러싸는 경계 사각형을 반환합니다.

GetErrorText(Int32)

셀의 오류를 나타내는 문자열을 반환합니다.

GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)

표시를 위해 형식이 지정된 셀 값을 가져옵니다.

GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetInheritedContextMenuStrip(Int32)

현재 셀의 상속된 바로 가기 메뉴를 가져옵니다.

GetInheritedState(Int32)

해당 행과 열의 상태에서 상속된 셀의 현재 상태를 나타내는 값을 반환합니다.

GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

셀에 적용된 스타일을 가져옵니다.

GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

셀의 기본 크기를 픽셀 단위로 계산합니다.

GetSize(Int32)

셀의 크기를 가져옵니다.

GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
GetValue(Int32)

셀의 값을 가져옵니다.

InitializeEditingControl(Int32, Object, DataGridViewCellStyle)

셀을 편집하는 데 사용되는 컨트롤을 초기화합니다.

KeyDownUnsharesRow(KeyEventArgs, Int32)

포커스가 셀에 있는 동안 키를 누르는 경우 부모 행을 공유하지 않을 것인지 여부를 나타냅니다.

KeyEntersEditMode(KeyEventArgs)

지정된 키에 따라 편집 모드를 시작할지 여부를 결정합니다.

KeyPressUnsharesRow(KeyPressEventArgs, Int32)

포커스가 행의 셀에 있는 동안 키를 누르는 경우 행을 공유하지 않을 것인지 여부를 나타냅니다.

KeyUpUnsharesRow(KeyEventArgs, Int32)

포커스가 셀에 있는 동안 키를 놓는 경우 부모 행을 공유하지 않을 것인지 여부를 나타냅니다.

LeaveUnsharesRow(Int32, Boolean)

포커스가 행의 셀을 벗어난 경우 행을 공유하지 않을 것인지 여부를 나타냅니다.

MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags)

지정된 특성이 주어진 경우 지정된 텍스트의 높이(픽셀)를 가져옵니다.

MeasureTextHeight(Graphics, String, Font, Int32, TextFormatFlags, Boolean)

지정된 특성이 주어진 경우 지정된 텍스트의 높이(픽셀)를 가져옵니다. 필요한 너비가 지정된 최대 너비보다 큰지 여부도 나타냅니다.

MeasureTextPreferredSize(Graphics, String, Font, Single, TextFormatFlags)

지정된 특성이 주어진 경우 지정된 텍스트의 이상적인 높이와 너비를 가져옵니다.

MeasureTextSize(Graphics, String, Font, TextFormatFlags)

지정된 특성이 주어진 경우 지정된 텍스트의 높이와 너비를 가져옵니다.

MeasureTextWidth(Graphics, String, Font, Int32, TextFormatFlags)

지정된 특성이 주어진 경우 지정된 텍스트의 너비(픽셀)를 가져옵니다.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)

포인터가 행의 셀에 있는 동안 마우스 단추를 클릭하는 경우 행을 공유하지 않을 것인지 여부를 나타냅니다.

MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

행의 셀을 두 번 클릭하는 경우 행을 공유하지 않을 것인지 여부를 나타냅니다.

MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)

포인터가 행의 셀에 있는 동안 마우스 단추를 누르고 있는 경우 행을 공유하지 않을 것인지 여부를 나타냅니다.

MouseEnterUnsharesRow(Int32)

마우스 포인터가 행의 셀 위로 이동할 경우 행을 공유하지 않을 것인지 여부를 나타냅니다.

MouseLeaveUnsharesRow(Int32)

마우스 포인터가 행을 벗어난 경우 행을 공유하지 않을 것인지 여부를 나타냅니다.

MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

마우스 포인터가 행의 셀 위로 이동할 경우 행을 공유하지 않을 것인지 여부를 나타냅니다.

MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)

포인터가 행의 셀에 있는 동안 마우스 단추를 놓는 경우 행을 공유하지 않을 것인지 여부를 나타냅니다.

OnClick(DataGridViewCellEventArgs)

셀을 클릭하면 호출됩니다.

OnContentClick(DataGridViewCellEventArgs)

셀의 내용을 클릭하면 호출됩니다.

OnContentDoubleClick(DataGridViewCellEventArgs)

셀의 내용을 두 번 클릭하면 호출됩니다.

OnDataGridViewChanged()

셀의 DataGridView 속성이 변경되면 호출됩니다.

OnDoubleClick(DataGridViewCellEventArgs)

셀을 두 번 클릭하면 호출됩니다.

OnEnter(Int32, Boolean)

포커스가 셀로 이동하면 호출됩니다.

OnKeyDown(KeyEventArgs, Int32)

셀에 포커스가 있는 동안 문자 키를 누르면 호출됩니다.

OnKeyPress(KeyPressEventArgs, Int32)

포커스가 셀에 있는 동안 키를 누르면 호출됩니다.

OnKeyUp(KeyEventArgs, Int32)

포커스가 셀에 있는 동안 문자 키를 놓으면 호출됩니다.

OnLeave(Int32, Boolean)

포커스가 셀에서 이동하면 호출됩니다.

OnMouseClick(DataGridViewCellMouseEventArgs)

포인터가 셀에 있는 동안 마우스 단추를 클릭하면 호출됩니다.

OnMouseDoubleClick(DataGridViewCellMouseEventArgs)

포인터가 셀에 있는 동안 마우스 단추를 두 번 클릭하면 호출됩니다.

OnMouseDown(DataGridViewCellMouseEventArgs)

포인터가 셀에 있는 동안 마우스 단추를 누르고 있으면 호출됩니다.

OnMouseEnter(Int32)

마우스 포인터가 셀 위로 이동하면 호출됩니다.

OnMouseLeave(Int32)

마우스 포인터가 셀을 벗어나면 호출됩니다.

OnMouseMove(DataGridViewCellMouseEventArgs)

마우스 포인터가 셀 안에서 이동하면 호출됩니다.

OnMouseUp(DataGridViewCellMouseEventArgs)

포인터가 셀에 있는 동안 마우스 단추를 놓으면 호출됩니다.

Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)

현재 DataGridViewCell을 그립니다.

PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)

현재 DataGridViewCell의 테두리를 그립니다.

PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

현재 DataGridViewCell의 오류 아이콘을 그립니다.

ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

형식이 지정된 표시 값을 실제 셀 값으로 변환합니다.

PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

DataGridView 컨트롤의 셀에서 호스팅하는 편집 컨트롤의 위치와 크기를 설정합니다.

PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)

셀에서 호스팅하는 편집 패널의 위치와 크기를 설정하고 편집 패널에 있는 편집 컨트롤의 일반 범위를 반환합니다.

RaiseCellClick(DataGridViewCellEventArgs)

CellClick 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel 이벤트를 발생시킵니다.

(다음에서 상속됨 DataGridViewElement)
SetValue(Int32, Object)

셀의 값을 설정합니다.

ToString()

현재 개체를 설명하는 문자열을 반환합니다.

적용 대상

추가 정보