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 フォーム 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 コントロール内の個々のセルを表します。 セルは、DataGridViewRowCells コレクションを通じて取得できます。

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, Boolean)

指定した特性に基づく、指定したテキストの高さをピクセル単位で取得します。 また、必要な幅が指定された最大幅より大きいかどうかを示します。

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

指定した特性に基づく、指定したテキストの高さをピクセル単位で取得します。

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()

現在のオブジェクトを記述する文字列を返します。

適用対象

こちらもご覧ください