Export (0) Print
Expand All

DataGrid::Navigate Event

Occurs when the user navigates to a new table.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

 event NavigateEventHandler^ Navigate {
	void add (NavigateEventHandler^ value);
	void remove (NavigateEventHandler^ value);

Use the Navigate event to reset individual column properties, such as width, as appropriate to the table.

For more information about handling events, see Consuming Events.

The following code example demonstrates the use of this member.

   // Instantiate the 'Navigate' NavigateEventHandler. 
   void CallNavigate()
      myDataGrid->Navigate += gcnew NavigateEventHandler( this, &MyDataGrid::Grid_Navigate );

   // Raise the event when navigating to another table. 
   void Grid_Navigate( Object^ /*sender*/, NavigateEventArgs^ /*e*/ )
      // String variable used to show message.
      String^ myString = "Navigate event raised, moved to another table";

      // Show the message when navigating to another table.
      MessageBox::Show( myString, "Table navigation information" );

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft