DataGrid.OnMouseDown(MouseEventArgs) Method

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Raises the MouseDown event.

protected:
 override void OnMouseDown(System::Windows::Forms::MouseEventArgs ^ e);

protected override void OnMouseDown (System.Windows.Forms.MouseEventArgs e);

override this.OnMouseDown : System.Windows.Forms.MouseEventArgs -> unit

Protected Overrides Sub OnMouseDown (e As MouseEventArgs)

Parameters

e

MouseEventArgs

A MouseEventArgs that contains data about the OnMouseDown(MouseEventArgs) event.

Examples

The following code example demonstrates the use of this member.

public ref class MyDataGrid: public DataGrid
{
protected:

   // Override the OnMouseDown event to select the whole row
   // when the user clicks anywhere on a row.
   virtual void OnMouseDown( MouseEventArgs^ e ) override
   {
      
      // Get the HitTestInfo to return the row and pass
      // that value to the IsSelected property of the DataGrid.
      DataGrid::HitTestInfo ^ hit = this->HitTest( e->X, e->Y );
      if ( hit->Row < 0 )
               return;

      if ( this->IsSelected( hit->Row ) )
               UnSelect( hit->Row );
      else
               Select(hit->Row);
   }
};

public class MyDataGrid : DataGrid 
{
    // Override the OnMouseDown event to select the whole row
    // when the user clicks anywhere on a row.
    protected override void OnMouseDown(MouseEventArgs e) 
    {
        // Get the HitTestInfo to return the row and pass
        // that value to the IsSelected property of the DataGrid.
        DataGrid.HitTestInfo hit = this.HitTest(e.X, e.Y);
        if (hit.Row < 0)
            return;
        if (this.IsSelected(hit.Row))
            UnSelect(hit.Row);
        else
            Select(hit.Row);
    }
}

Public Class MyDataGrid
    Inherits DataGrid

    ' Override the OnMouseDown event to select the whole row
    ' when the user clicks anywhere on a row.

    Protected Overrides Sub OnMouseDown(ByVal e As MouseEventArgs)
    ' Get the HitTestInfo to return the row and pass
    ' that value to the IsSelected property of the DataGrid.
        Dim hit As DataGrid.HitTestInfo = Me.HitTest(e.X, e.Y)
        If hit.Row < 0 Then
            Return
        End If
        If IsSelected(hit.Row) Then
            UnSelect(hit.Row)
        Else
            [Select](hit.Row)
        End If
    End Sub
End Class

Remarks

Raising an event invokes the event handler through a delegate. For an overview, see Handling and Raising Events.

Notes to Inheritors

When overriding OnMouseDown(MouseEventArgs) in a derived class, be sure to call the base class's OnMouseDown(MouseEventArgs) method.