DataGridView.UserAddedRow イベント

.NET Framework クラス ライブラリ リファレンス

DataGridView.UserAddedRow イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーが DataGridView コントロールへの行の追加を完了したときに発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event UserAddedRow As
 DataGridViewRowEventHandler

Visual Basic (使用法)

Dim instance As DataGridView
Dim handler As DataGridViewRowEventHandler

AddHandler instance.UserAddedRow, handler

C#

public event DataGridViewRowEventHandler UserAddedRow

C++

public:
event DataGridViewRowEventHandler^ UserAddedRow {
    void add (DataGridViewRowEventHandler^ value);
    void remove (DataGridViewRowEventHandler^ value);
}

J#

/** @event */
public void add_UserAddedRow (DataGridViewRowEventHandler
 value)

/** @event */
public void remove_UserAddedRow (DataGridViewRowEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

UserAddedRow イベントを使用して、DataGridView 内のエントリ数の合計を表示するラベルを更新するコード例を次に示します。

Visual Basic

Private Sub UserAddedRow(ByVal
 sender As Object, _
    ByVal e As DataGridViewRowEventArgs) _
    Handles DataGridView1.UserAddedRow

    ' Update the labels to reflect changes to the number of entries.
    UpdateLabelText()
End Sub

Private Sub UpdateLabelText()
    Dim WithdrawalTotal As Integer
 = 0
    Dim DepositTotal As Integer
 = 0
    Dim SelectedCellTotal As Integer
 = 0
    Dim counter As Integer

    ' Iterate through all the rows and sum up the appropriate columns.
    For counter = 0 To (DataGridView1.Rows.Count
 - 1)
        If Not DataGridView1.Rows(counter)
 _
            .Cells("Withdrawals").Value Is
 Nothing Then

            If Not DataGridView1.Rows(counter)
 _
                .Cells("Withdrawals").Value.ToString().Length
 = 0 Then

                WithdrawalTotal += _
                    Integer.Parse(DataGridView1.Rows(counter)
 _
                    .Cells("Withdrawals").Value.ToString())
            End If
        End If

        If Not DataGridView1.Rows(counter)
 _
            .Cells("Deposits").Value Is
 Nothing Then

            If Not DataGridView1.Rows(counter)
 _
                .Cells("Deposits").Value.ToString().Length
 = 0 Then

                DepositTotal += _
                    Integer.Parse(DataGridView1.Rows(counter)
 _
                    .Cells("Deposits").Value.ToString())
            End If
        End If
    Next

    ' Iterate through the SelectedCells collection and sum up the values.
    For counter = 0 To (DataGridView1.SelectedCells.Count
 - 1)
        If DataGridView1.SelectedCells(counter).FormattedValueType
 Is _
        Type.GetType("System.String") Then

            Dim value As String
 = Nothing

            ' If the cell contains a value that has not been commited
,
            ' use the modified value.
            If (DataGridView1.IsCurrentCellDirty = True)
 Then

                value = DataGridView1.SelectedCells(counter) _
                    .EditedFormattedValue.ToString()
            Else

                value = DataGridView1.SelectedCells(counter) _
                    .FormattedValue.ToString()
            End If

            If Not value Is
 Nothing Then

                ' Ignore cells in the Description column.
                If Not DataGridView1.SelectedCells(counter).ColumnIndex
 = _
                    DataGridView1.Columns("Description").Index
 Then

                    If Not value.Length = 0
 Then
                        SelectedCellTotal += Integer.Parse(value)
                    End If
                End If
            End If
        End If

    Next

    ' Set the labels to reflect the current state of the DataGridView.
    Label1.Text = "Withdrawals Total: " & WithdrawalTotal.ToString()
    Label2.Text = "Deposits Total: " & DepositTotal.ToString()
    Label3.Text = "Selected Cells Total: " & SelectedCellTotal.ToString()
    Label4.Text = "Total entries: " & DataGridView1.RowCount.ToString()
End Sub

C#

private void DataGridView1_UserAddedRow(
    object sender, DataGridViewRowEventArgs e)
{
    // Update the labels to reflect changes to the number of entries.
    UpdateLabelText();
}

private void UpdateLabelText()
{
    int WithdrawalTotal = 0;
    int DepositTotal = 0;
    int SelectedCellTotal = 0;
    int counter;

    // Iterate through all the rows and sum up the appropriate columns.
    for (counter = 0; counter < (DataGridView1.Rows.Count);
        counter++)
    {
        if (DataGridView1.Rows[counter].Cells["Withdrawals"].Value
            != null)
        {
            if (DataGridView1.Rows[counter].
                Cells["Withdrawals"].Value.ToString().Length != 0)
            {
                WithdrawalTotal += int.Parse(DataGridView1.Rows[counter].
                    Cells["Withdrawals"].Value.ToString());
            }
        }

        if (DataGridView1.Rows[counter].Cells["Deposits"].Value
 != null)
        {
            if (DataGridView1.Rows[counter]
                .Cells["Deposits"].Value.ToString().Length != 0)
            {
                DepositTotal += int.Parse(DataGridView1.Rows[counter]
                    .Cells["Deposits"].Value.ToString());
            }
        }
    }

    // Iterate through the SelectedCells collection and sum up the values.
    for (counter = 0;
        counter < (DataGridView1.SelectedCells.Count); counter++)
    {
        if (DataGridView1.SelectedCells[counter].FormattedValueType
 ==
            Type.GetType("System.String"))
        {
            string value = null;

            // If the cell contains a value that has not been commited
,
            // use the modified value.
            if (DataGridView1.IsCurrentCellDirty == true)
            {

                value = DataGridView1.SelectedCells[counter]
                    .EditedFormattedValue.ToString();
            }
            else
            {
                value = DataGridView1.SelectedCells[counter]
                    .FormattedValue.ToString();
            }
            if (value != null)
            {
                // Ignore cells in the Description column.
                if (DataGridView1.SelectedCells[counter].ColumnIndex
 !=
                    DataGridView1.Columns["Description"].Index)
                {
                    if (value.Length != 0)
                    {
                        SelectedCellTotal += int.Parse(value);
                    }
                }
            }
        }
    }

    // Set the labels to reflect the current state of the DataGridView.
    Label1.Text = "Withdrawals Total: " + WithdrawalTotal.ToString();
    Label2.Text = "Deposits Total: " + DepositTotal.ToString();
    Label3.Text = "Selected Cells Total: " + SelectedCellTotal.ToString();
    Label4.Text = "Total entries: " + DataGridView1.RowCount.ToString();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
その他の技術情報
DataGridView コントロール (Windows フォーム)