DataGridViewRow クラス

定義

DataGridView コントロールの行を表します。

public ref class DataGridViewRow : System::Windows::Forms::DataGridViewBand
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))]
public class DataGridViewRow : System.Windows.Forms.DataGridViewBand
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataGridViewRowConverter))>]
type DataGridViewRow = class
    inherit DataGridViewBand
Public Class DataGridViewRow
Inherits DataGridViewBand
継承
属性

次のコード例は、この型の使用方法を示しています。 この例は、「方法: Windows フォーム DataGridView コントロールの行を操作する」で使用できる大きな例の一部です。

// Set row labels.
void Button6_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{

   int rowNumber = 1;
   System::Collections::IEnumerator^ myEnum = safe_cast<System::Collections::IEnumerable^>(dataGridView->Rows)->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      DataGridViewRow^ row = safe_cast<DataGridViewRow^>(myEnum->Current);
      if ( row->IsNewRow )
               continue;
      row->HeaderCell->Value = String::Format( L"Row {0}", rowNumber );

      rowNumber = rowNumber + 1;
   }

   dataGridView->AutoResizeRowHeadersWidth( DataGridViewRowHeadersWidthSizeMode::AutoSizeToAllHeaders );
}
// Set row labels.
private void Button6_Click(object sender, System.EventArgs e)
{

    int rowNumber = 1;
    foreach (DataGridViewRow row in dataGridView.Rows)
    {
        if (row.IsNewRow) continue;
        row.HeaderCell.Value = "Row " + rowNumber;
        rowNumber = rowNumber + 1;
    }
    dataGridView.AutoResizeRowHeadersWidth(
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders);
}
' Set row labels.
Private Sub Button6_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button6.Click

    Dim rowNumber As Integer = 1
    For Each row As DataGridViewRow In dataGridView.Rows
        If row.IsNewRow Then Continue For
        row.HeaderCell.Value = "Row " & rowNumber
        rowNumber = rowNumber + 1
    Next
    dataGridView.AutoResizeRowHeadersWidth( _
        DataGridViewRowHeadersWidthSizeMode.AutoSizeToAllHeaders)
End Sub

注釈

クラスは DataGridViewRow 、コントロール内の行を DataGridView 表します。 コントロールの コレクションと SelectedRows コレクションをRows使用して行を取得できます。

とは異なり、 DataGridViewColumnDataGridViewRow には、その行のすべてのセルのコレクションが物理的に含まれています。 このコレクションには、 プロパティを Cells 使用してアクセスできます。

クラスは DataGridViewRow 、個々のセル要素にアクセスしたり、高さやセル スタイルなどの行ユーザー インターフェイス (UI) の外観と動作を調整したりするために使用されます。 通常、コントロール内のすべての行またはほとんどの行で同じ特性を共有する必要があります。 コントロール内のすべての行のセル スタイルを設定するには、 プロパティによって返されるオブジェクトのプロパティを DataGridView.RowsDefaultCellStyle 設定します。 交互の行のスタイルを設定するには、 プロパティを DataGridView.AlternatingRowsDefaultCellStyle 使用します。 セル スタイルの詳細については、「Windows フォーム DataGridView コントロールでのセルのスタイル」を参照してください。 プロパティを DataGridView.RowTemplate 使用して、コントロールに追加されたすべての行の基礎として使用される行を定義することもできます。

コントロールは DataGridView 、パフォーマンスの低下を避けるために、可能な限り複数のデータ行間でオブジェクトを共有 DataGridViewRow します。 大量のデータを操作し、パフォーマンスの問題が発生している場合を除き、通常は行共有を無視できます。 共有行は、プロパティ値 -1 で Index 示されます。 クラスの一部の DataGridViewRow メンバーは共有行で使用できませんが、 プロパティを使用して行にアクセスすることで行の共有を DataGridViewRowCollection.Item[] 解除できます。 行は、他の方法でも共有解除される可能性があります。 共有を解除せずに行にアクセスするには、 メソッドを使用します DataGridViewRowCollection.SharedRow 。 大量のデータを操作する場合は、パフォーマンスの低下を避けるために、行の共有方法と共有解除方法に注意する必要があります。 詳細については、「 Windows フォーム DataGridView コントロールを拡張するための推奨される手順」を参照してください。

注意 (継承者)

から DataGridViewRow 派生し、派生クラスに新しいプロパティを追加するときは、必ず メソッドを Clone() オーバーライドして、複製操作中に新しいプロパティをコピーしてください。 基底クラスの Clone() プロパティが新しいセルにコピーされるように、基底クラスの メソッドも呼び出す必要があります。

コンストラクター

DataGridViewRow()

テンプレートを使用せずに、DataGridViewRow クラスの新しいインスタンスを初期化します。

プロパティ

AccessibilityObject

DataGridViewRow.DataGridViewRowAccessibleObject に割り当てられた DataGridViewRow を取得します。

Cells

行に設定されるセルのコレクションを取得します。

ContextMenuStrip

行のショートカット メニューを取得または設定します。

DataBoundItem

行に値を読み込むデータ バインド オブジェクトを取得します。

DataGridView

この要素に関連付けられている DataGridView コントロールを取得します。

(継承元 DataGridViewElement)
DefaultCellStyle

スタイルがオーバーライドされない限り、行内のセルを描画する際に使用される、行の既定のスタイルを取得または設定します。

DefaultHeaderCellType

既定のヘッダー セルのランタイム型を取得または設定します。

(継承元 DataGridViewBand)
Displayed

この行が画面上に表示されるかどうかを示す値を取得または設定します。

DividerHeight

行の区分線の高さをピクセル単位で取得または設定します。

ErrorText

行レベルのエラーのエラー メッセージ テキストを取得または設定します。

Frozen

行が固定された状態かどうかを示す値を取得または設定します。

HasDefaultCellStyle

DefaultCellStyle プロパティが設定されているかどうかを示す値を取得します。

(継承元 DataGridViewBand)
HeaderCell

行のヘッダー セルを取得または設定します。

HeaderCellCore

DataGridViewBand のヘッダー セルを取得または設定します。

(継承元 DataGridViewBand)
Height

行の現在の高さを取得または設定します。

Index

DataGridView コントロール内のバンドの相対位置を取得します。

(継承元 DataGridViewBand)
InheritedStyle

行に対して有効なセル スタイルを取得します。

IsNewRow

行が新しいレコードの行かどうかを示す値を取得します。

IsRow

バンドが行を表すかどうかを示す値を取得します。

(継承元 DataGridViewBand)
MinimumHeight

行の最小の高さを取得または設定します。

ReadOnly

行が読み取り専用かどうかを示す値を取得または設定します。

Resizable

ユーザーが行のサイズを変更できるかどうかを示す値、または動作が AllowUserToResizeRows プロパティから継承されることを示す値を取得または設定します。

Selected

行が選択されているかどうかを示す値を取得または設定します。

State

行の現在の状態を取得します。

Tag

バンドに関連付けられているデータを含むオブジェクトを取得または設定します。

(継承元 DataGridViewBand)
Visible

行を表示するかどうかを示す値を取得または設定します。

メソッド

AdjustRowHeaderBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)

指定した条件に従って、入力行ヘッダー境界線スタイルを変更します。

Clone()

この行の同一コピーを作成します。

CreateAccessibilityInstance()

DataGridViewRow の新しいユーザー補助オブジェクトを作成します。

CreateCells(DataGridView)

既存のセルをクリアし、指定された DataGridView テンプレートに従って、セルのテンプレートを設定します。

CreateCells(DataGridView, Object[])

既存のセルをクリアし、そのテンプレートと値を設定します。

CreateCellsInstance()

この行に基づいて、セルの新しいコレクションを構築します。

Dispose()

DataGridViewBand によって使用されているすべてのリソースを解放します。

(継承元 DataGridViewBand)
Dispose(Boolean)

DataGridViewBand によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。

(継承元 DataGridViewBand)
DrawFocus(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, DataGridViewCellStyle, Boolean)

指定した境界の周囲に、フォーカスを表す四角形を描画します。

Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetContextMenuStrip(Int32)

行のショートカット メニューを取得します。

GetErrorText(Int32)

指定したインデックス位置の行のエラー テキストを取得します。

GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetPreferredHeight(Int32, DataGridViewAutoSizeRowMode, Boolean)

指定した基準に基づいて、指定した行の適切な高さを計算します。

GetState(Int32)

行の現在の状態を示す値を返します。

GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
OnDataGridViewChanged()

バンドが別の DataGridView に関連付けられている場合に呼び出されます。

(継承元 DataGridViewBand)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean)

現在の行を描画します。

PaintCells(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

現在の行内のセルを描画します。

PaintHeader(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Boolean, Boolean, DataGridViewPaintParts)

現在の行のヘッダー セルを描画します。

RaiseCellClick(DataGridViewCellEventArgs)

CellClick イベントを発生させます。

(継承元 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick イベントを発生させます。

(継承元 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick イベントを発生させます。

(継承元 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged イベントを発生させます。

(継承元 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError イベントを発生させます。

(継承元 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel イベントを発生させます。

(継承元 DataGridViewElement)
SetValues(Object[])

行のセルの値を設定します。

ToString()

行を説明する文字列をユーザーが判読できる形式で取得します。

適用対象

こちらもご覧ください