DataGridViewCell クラス

定義

DataGridView コントロールの個別のセルを表します。Represents an individual cell in a DataGridView control.

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
type DataGridViewCell = class
    inherit DataGridViewElement
    interface ICloneable
    interface IDisposable
Public MustInherit Class DataGridViewCell
Inherits DataGridViewElement
Implements ICloneable, IDisposable
継承
DataGridViewCell
派生
属性
実装

この型の使用方法を次のコード例に示します。The following code example illustrates the use of this type. この例の詳細については、「方法:Windows フォーム DataGridView コントロール内の個々のセルにツールヒントを追加します。For more information about this example, see How to: Add ToolTips to Individual Cells in a Windows Forms DataGridView Control.

// 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 コントロール内の個々のセルを表します。The DataGridViewCell class represents an individual cell in a DataGridView control. セルは、DataGridViewRowCells コレクションを通じて取得できます。You can retrieve cells through the Cells collection of a DataGridViewRow.

DataGridViewCell の行と列は、DataGridView内のセルの位置を識別します。The row and column for a DataGridViewCell identify the cell's location in the DataGridView. 一般的なセルには、それが含まれている行と列に固有のデータが含まれています。A typical cell contains data specific to the row and column in which it is contained. このセルは、プロパティを設定し、それに関連付けられているイベントを処理することによって、さまざまな方法でカスタマイズできます。The cell can be customized in a number of ways by setting its properties and handling the events associated with it.

注意 (実装者)

DataGridViewCell から派生し、派生クラスに新しいプロパティを追加する場合は、Clone() メソッドをオーバーライドして、複製操作中に新しいプロパティをコピーするようにしてください。When you derive from DataGridViewCell and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. また、基本クラスの Clone() メソッドを呼び出して、基底クラスのプロパティが新しいセルにコピーされるようにする必要があります。You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

コンストラクター

DataGridViewCell()

DataGridViewCell クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataGridViewCell class.

プロパティ

AccessibilityObject

DataGridViewCell.DataGridViewCellAccessibleObject に割り当てられた DataGridViewCell を取得します。Gets the DataGridViewCell.DataGridViewCellAccessibleObject assigned to the DataGridViewCell.

ColumnIndex

このセルの列インデックスを取得します。Gets the column index for this cell.

ContentBounds

セルの内容領域を囲んだ外接する四角形を取得します。Gets the bounding rectangle that encloses the cell's content area.

ContextMenuStrip

セルに関連付けられたショートカット メニューを取得または設定します。Gets or sets the shortcut menu associated with the cell.

DataGridView

この要素に関連付けられている DataGridView コントロールを取得します。Gets the DataGridView control associated with this element.

(継承元 DataGridViewElement)
DefaultNewRowValue

新しいレコードの行のセルに対する既定値を取得します。Gets the default value for a cell in the row for new records.

Displayed

セルが現在画面上に表示されているかどうかを示す値を取得します。Gets a value that indicates whether the cell is currently displayed on-screen.

EditedFormattedValue

セルが編集モードであるかどうか、および値がコミットされているかどうかに関係なく、セルの現在の書式指定済みの値を取得します。Gets the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

EditType

セルのホストされる編集コントロールの型を取得します。Gets the type of the cell's hosted editing control.

ErrorIconBounds

セルのエラー アイコンの境界を取得します。Gets the bounds of the error icon for the cell.

ErrorText

セルに関連付けられたエラー条件を記述するテキストを取得または設定します。Gets or sets the text describing an error condition associated with the cell.

FormattedValue

表示用に書式指定済みのセル値を取得します。Gets the value of the cell as formatted for display.

FormattedValueType

セルに関連付けられている、書式設定された値の型を取得します。Gets the type of the formatted value associated with the cell.

Frozen

セルが固定された状態かどうかを示す値を取得します。Gets a value indicating whether the cell is frozen.

HasStyle

Style プロパティが設定されているかどうかを示す値を取得します。Gets a value indicating whether the Style property has been set.

InheritedState

行と列の状態から継承されたセルの現在の状態を取得します。Gets the current state of the cell as inherited from the state of its row and column.

InheritedStyle

セルに現在適用されているスタイルを取得します。Gets the style currently applied to the cell.

IsInEditMode

このセルが現在編集されているかどうかを示す値を取得します。Gets a value indicating whether this cell is currently being edited.

OwningColumn

セルを格納している列を取得します。Gets the column that contains this cell.

OwningRow

セルを格納している行を取得します。Gets the row that contains this cell.

PreferredSize

セルが収まる四角形領域のサイズをピクセル単位で取得します。Gets the size, in pixels, of a rectangular area into which the cell can fit.

ReadOnly

セルのデータを編集できるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the cell's data can be edited.

Resizable

セルのサイズを変更できるかどうかを示す値を取得します。Gets a value indicating whether the cell can be resized.

RowIndex

セルの親行のインデックスを取得します。Gets the index of the cell's parent row.

Selected

セルが選択されているかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the cell has been selected.

Size

セルのサイズを取得します。Gets the size of the cell.

State

要素のユーザー インターフェイス (UI) の状態を取得します。Gets the user interface (UI) state of the element.

(継承元 DataGridViewElement)
Style

セルのスタイルを取得または設定します。Gets or sets the style for the cell.

Tag

セルに関する補足的なデータを格納するオブジェクトを取得または設定します。Gets or sets the object that contains supplemental data about the cell.

ToolTipText

このセルに関連付けられているツールヒント テキストを取得または設定します。Gets or sets the ToolTip text associated with this cell.

Value

このセルに関連付けられている値を取得または設定します。Gets or sets the value associated with this cell.

ValueType

セル内の値のデータ型を取得または設定します。Gets or sets the data type of the values in the cell.

Visible

非表示にされた行または列にセルが含まれるかどうかを示す値を取得します。Gets a value indicating whether the cell is in a row or column that has been hidden.

メソッド

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

指定した条件に従って、入力セルの境界線スタイルを変更します。Modifies the input cell border style according to the specified criteria.

BorderWidths(DataGridViewAdvancedBorderStyle)

すべてのセル マージンの幅を表す Rectangle を返します。Returns a Rectangle that represents the widths of all the cell margins.

ClickUnsharesRow(DataGridViewCellEventArgs)

セルがクリックされたときに、セルの行の共有を解除するかどうかを示します。Indicates whether the cell's row will be unshared when the cell is clicked.

Clone()

対象のセルの同一コピーを作成します。Creates an exact copy of this cell.

ContentClickUnsharesRow(DataGridViewCellEventArgs)

セルの内容がクリックされたときに、セルの行の共有を解除するかどうかを示します。Indicates whether the cell's row will be unshared when the cell's content is clicked.

ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)

セルの内容がダブルクリックされたときに、セルの行の共有を解除するかどうかを示します。Indicates whether the cell's row will be unshared when the cell's content is double-clicked.

CreateAccessibilityInstance()

DataGridViewCell の新しいユーザー補助オブジェクトを作成します。Creates a new accessible object for the DataGridViewCell.

DetachEditingControl()

セルの編集コントロールを DataGridView から削除します。Removes the cell's editing control from the DataGridView.

Dispose()

DataGridViewCell によって使用されているすべてのリソースを解放します。Releases all resources used by the DataGridViewCell.

Dispose(Boolean)

DataGridViewCell によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the DataGridViewCell and optionally releases the managed resources.

DoubleClickUnsharesRow(DataGridViewCellEventArgs)

セルがダブルクリックされたときに、セルの行の共有を解除するかどうかを示します。Indicates whether the cell's row will be unshared when the cell is double-clicked.

EnterUnsharesRow(Int32, Boolean)

フォーカスがセルに移動したときに、親の行を非共有にするかどうかを示します。Indicates whether the parent row will be unshared when the focus moves to the cell.

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
Finalize()

DataGridViewCell がガベージ コレクションによって収集される前に、アンマネージ リソースを解放し、その他のクリーンアップ操作を実行します。Releases the unmanaged resources and performs other cleanup operations before the DataGridViewCell is reclaimed by garbage collection.

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

Clipboard にコピーするセルの書式指定済みの値を取得します。Retrieves the formatted value of the cell to copy to the Clipboard.

GetContentBounds(Graphics, DataGridViewCellStyle, Int32)

セルの内容領域を囲む外接する四角形を返します。これは、指定された Graphics とセル スタイルを使用して計算されます。Returns the bounding rectangle that encloses the cell's content area, which is calculated using the specified Graphics and cell style.

GetContentBounds(Int32)

既定の Graphics、およびセルに現在有効なセル スタイルを使用して、セルの内容領域を囲む外接する四角形を返します。Returns the bounding rectangle that encloses the cell's content area using a default Graphics and cell style currently in effect for the cell.

GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)

セルが編集モードであるかどうか、および値がコミットされているかどうかに関係なく、セルの現在の書式指定済みの値を返します。Returns the current, formatted value of the cell, regardless of whether the cell is in edit mode and the value has not been committed.

GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)

セルのエラー アイコンが表示されている場合に、そのエラー アイコンを囲む外接する四角形を返します。Returns the bounding rectangle that encloses the cell's error icon, if one is displayed.

GetErrorText(Int32)

セルのエラーを表す文字列を返します。Returns a string that represents the error for the cell.

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

表示用に書式指定済みのセル値を取得します。Gets the value of the cell as formatted for display.

GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetInheritedContextMenuStrip(Int32)

現在のセルの継承されたショートカット メニューを取得します。Gets the inherited shortcut menu for the current cell.

GetInheritedState(Int32)

行および列の状態から継承されたセルの現在の状態を示す値を返します。Returns a value indicating the current state of the cell as inherited from the state of its row and column.

GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)

セルに適用されるスタイルを取得します。Gets the style applied to the cell.

GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)

セルの推奨されるサイズをピクセル単位で計算します。Calculates the preferred size, in pixels, of the cell.

GetSize(Int32)

セルのサイズを取得します。Gets the size of the cell.

GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
GetValue(Int32)

セルの値を取得します。Gets the value of the cell.

InitializeEditingControl(Int32, Object, DataGridViewCellStyle)

セルの編集に使用されるコントロールを初期化します。Initializes the control used to edit the cell.

KeyDownUnsharesRow(KeyEventArgs, Int32)

セルにフォーカスがある状態でキーを押したときに、親の行を非共有にするかどうかを示します。Indicates whether the parent row is unshared if the user presses a key while the focus is on the cell.

KeyEntersEditMode(KeyEventArgs)

押されたキーに基づいて編集モードを開始するかどうかを決定します。Determines if edit mode should be started based on the given key.

KeyPressUnsharesRow(KeyPressEventArgs, Int32)

行内のセルにフォーカスがあるときにキーが押された場合に、行を非共有にするかどうかを示します。Indicates whether a row will be unshared if a key is pressed while a cell in the row has focus.

KeyUpUnsharesRow(KeyEventArgs, Int32)

セルにフォーカスがある状態でキーを離したときに、親の行を非共有にするかどうかを示します。Indicates whether the parent row is unshared when the user releases a key while the focus is on the cell.

LeaveUnsharesRow(Int32, Boolean)

フォーカスが行のセルを離れたときに、その行を非共有にするかどうかを示します。Indicates whether a row will be unshared when the focus leaves a cell in the row.

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

特性を指定して、指定したテキストの高さをピクセル単位で取得します。Gets the height, in pixels, of the specified text, given the specified characteristics.

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

特性を指定して、指定したテキストの高さをピクセル単位で取得します。Gets the height, in pixels, of the specified text, given the specified characteristics. また、必要な幅が、指定された最大幅より大きいかどうかも示します。Also indicates whether the required width is greater than the specified maximum width.

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

特性を指定して、指定したテキストの最適な高さと幅を取得します。Gets the ideal height and width of the specified text given the specified characteristics.

MeasureTextSize(Graphics, String, Font, TextFormatFlags)

特性を指定して、指定したテキストの高さと幅を取得します。Gets the height and width of the specified text given the specified characteristics.

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

特性を指定して、指定したテキストの幅をピクセル単位で取得します。Gets the width, in pixels, of the specified text given the specified characteristics.

MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)

マウス ポインターを行のセルに置いた状態でマウス ボタンをクリックしたときに、その行を非共有にするかどうかを示します。Indicates whether a row will be unshared if the user clicks a mouse button while the pointer is on a cell in the row.

MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)

行内のセルをダブルクリックした場合に、その行を非共有にするかどうかを示します。Indicates whether a row will be unshared if the user double-clicks a cell in the row.

MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)

マウス ポインターを行のセルに置いた状態でマウス ボタンを押したままにしたときに、その行を非共有にするかどうかを示します。Indicates whether a row will be unshared when the user holds down a mouse button while the pointer is on a cell in the row.

MouseEnterUnsharesRow(Int32)

マウス ポインターを行のセル上に移動したときに行の共有を解除するかどうかを示します。Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.

MouseLeaveUnsharesRow(Int32)

マウス ポインターを行から離したときに行の共有を解除するかどうかを示します。Indicates whether a row will be unshared when the mouse pointer leaves the row.

MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)

マウス ポインターを行のセル上に移動したときに行の共有を解除するかどうかを示します。Indicates whether a row will be unshared when the mouse pointer moves over a cell in the row.

MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)

マウス ポインターを行のセルに置いた状態でマウス ボタンを離したときに、その行を非共有にするかどうかを示します。Indicates whether a row will be unshared when the user releases a mouse button while the pointer is on a cell in the row.

OnClick(DataGridViewCellEventArgs)

セルがクリックされたときに呼び出されます。Called when the cell is clicked.

OnContentClick(DataGridViewCellEventArgs)

セルの内容がクリックされたときに呼び出されます。Called when the cell's contents are clicked.

OnContentDoubleClick(DataGridViewCellEventArgs)

セルの内容がダブルクリックされたときに呼び出されます。Called when the cell's contents are double-clicked.

OnDataGridViewChanged()

セルの DataGridView プロパティが変更された場合に発生します。Called when the DataGridView property of the cell changes.

OnDoubleClick(DataGridViewCellEventArgs)

セルがダブルクリックされたときに呼び出されます。Called when the cell is double-clicked.

OnEnter(Int32, Boolean)

フォーカスがセルに移動するときに呼び出されます。Called when the focus moves to a cell.

OnKeyDown(KeyEventArgs, Int32)

セルにフォーカスがある状態で文字キーが押されたときに呼び出されます。Called when a character key is pressed while the focus is on a cell.

OnKeyPress(KeyPressEventArgs, Int32)

セルにフォーカスがある状態でキーが押されたときに呼び出されます。Called when a key is pressed while the focus is on a cell.

OnKeyUp(KeyEventArgs, Int32)

セルにフォーカスがある状態で文字キーを離したときに呼び出されます。Called when a character key is released while the focus is on a cell.

OnLeave(Int32, Boolean)

フォーカスがセルから離れるときに呼び出されます。Called when the focus moves from a cell.

OnMouseClick(DataGridViewCellMouseEventArgs)

マウス ポインターがセル上にあるときにマウス ボタンをクリックすると呼び出されます。Called when the user clicks a mouse button while the pointer is on a cell.

OnMouseDoubleClick(DataGridViewCellMouseEventArgs)

マウス ポインターがセル上にあるときにマウス ボタンをダブルクリックすると呼び出されます。Called when the user double-clicks a mouse button while the pointer is on a cell.

OnMouseDown(DataGridViewCellMouseEventArgs)

マウス ポインターがセル上にあるときにマウス ボタンを押したままにすると呼び出されます。Called when the user holds down a mouse button while the pointer is on a cell.

OnMouseEnter(Int32)

マウス ポインターがセル上を移動すると呼び出されます。Called when the mouse pointer moves over a cell.

OnMouseLeave(Int32)

マウス ポインターをセルから離すと呼び出されます。Called when the mouse pointer leaves the cell.

OnMouseMove(DataGridViewCellMouseEventArgs)

マウス ポインターがセル内で移動すると呼び出されます。Called when the mouse pointer moves within a cell.

OnMouseUp(DataGridViewCellMouseEventArgs)

マウス ポインターがセル上にあるときにマウス ボタンを離すと呼び出されます。Called when the user releases a mouse button while the pointer is on a cell.

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

現在の DataGridViewCell を描画します。Paints the current DataGridViewCell.

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

現在の DataGridViewCell の境界線を描画します。Paints the border of the current DataGridViewCell.

PaintErrorIcon(Graphics, Rectangle, Rectangle, String)

現在の DataGridViewCell のエラー アイコンを描画します。Paints the error icon of the current DataGridViewCell.

ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)

表示用に書式設定された値を、実際のセル値に変換します。Converts a value formatted for display to an actual cell value.

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

DataGridView コントロールのセルによってホストされる編集コントロールの位置とサイズを設定します。Sets the location and size of the editing control hosted by a cell in the DataGridView control.

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

セルによってホストされる編集パネルの位置とサイズを設定し、編集パネル内の編集コントロールの標準の境界を返します。Sets the location and size of the editing panel hosted by the cell, and returns the normal bounds of the editing control within the editing panel.

RaiseCellClick(DataGridViewCellEventArgs)

CellClick イベントを発生させます。Raises the CellClick event.

(継承元 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick イベントを発生させます。Raises the CellContentClick event.

(継承元 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick イベントを発生させます。Raises the CellContentDoubleClick event.

(継承元 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged イベントを発生させます。Raises the CellValueChanged event.

(継承元 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError イベントを発生させます。Raises the DataError event.

(継承元 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel イベントを発生させます。Raises the MouseWheel event.

(継承元 DataGridViewElement)
SetValue(Int32, Object)

セルの値を設定します。Sets the value of the cell.

ToString()

現在のオブジェクトを説明する文字列を返します。Returns a string that describes the current object.

適用対象

こちらもご覧ください