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 表します。 のコレクションを Cells 使用してセルを DataGridViewRow取得できます。

の行と列は、 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()

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

適用対象

こちらもご覧ください