DataGrid::HitTestType Enumeration
Specifies the part of the System.Windows.Forms::DataGrid control the user has clicked.
This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Member name | Description | |
|---|---|---|
| Caption | The caption of the System.Windows.Forms::DataGrid control. | |
| Cell | A cell in the System.Windows.Forms::DataGrid control. | |
| ColumnHeader | A column header in the System.Windows.Forms::DataGrid control. | |
| ColumnResize | The column border, which is the line between column headers. It can be dragged to resize a column's width. | |
| None | The background area, visible when the control contains no table, few rows, or when a table is scrolled to its bottom. | |
| ParentRows | The parent row section of the System.Windows.Forms::DataGrid control. The parent row displays information from or about the parent table of the currently displayed child table, such as the name of the parent table, column names and values of the parent record. | |
| RowHeader | A row header in the System.Windows.Forms::DataGrid control. | |
| RowResize | The row border, which is the line between grid row headers. It can be dragged to resize a row's height. |
Use the members of this enumeration to determine which part of the grid has been clicked. The Type property of a DataGrid::HitTestInfo returns a DataGrid::HitTestType. The DataGrid::HitTestInfo is created by invoking the HitTest method of a System.Windows.Forms::DataGrid control.
The following example uses the HitTest method in a MouseDown event to return the DataGrid::HitTestInfo. The row, column, and part of the grid are then printed.
private: void dataGrid1_MouseDown( Object^ /*sender*/, System::Windows::Forms::MouseEventArgs^ e ) { String^ newLine = "\n"; Console::WriteLine( newLine ); System::Windows::Forms::DataGrid::HitTestInfo^ myHitTest; // Use the DataGrid control's HitTest method with the x and y properties. myHitTest = dataGrid1->HitTest( e->X, e->Y ); Console::WriteLine( myHitTest ); Console::WriteLine( "Column {0}", myHitTest->Column ); Console::WriteLine( "Row {0}", myHitTest->Row ); Console::WriteLine( "Type {0}", myHitTest->Type ); Console::WriteLine( "ToString {0}", myHitTest ); Console::WriteLine( "Hit {0}", ReturnHitTest( myHitTest->Type ) ); } String^ ReturnHitTest( System::Windows::Forms::DataGrid::HitTestType hit ) { // Use this function to return the part of the grid clicked. switch ( hit ) { case(System::Windows::Forms::DataGrid::HitTestType::Cell): return "Cell"; case(System::Windows::Forms::DataGrid::HitTestType::Caption): return "Caption"; case(System::Windows::Forms::DataGrid::HitTestType::ColumnHeader): return "ColumnHeader"; case(System::Windows::Forms::DataGrid::HitTestType::ColumnResize): return "Resize"; case(System::Windows::Forms::DataGrid::HitTestType::ParentRows): return "ParentRows"; case(System::Windows::Forms::DataGrid::HitTestType::RowHeader): return "RowHeader"; case(System::Windows::Forms::DataGrid::HitTestType::RowResize): return "RowResize"; case(System::Windows::Forms::DataGrid::HitTestType::None): return "None"; default: return "Unknown"; } }
Available since 1.1