RequestBringIntoViewEventHandler Delegate


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Represents the method that will handle the FrameworkElement.RequestBringIntoView routed event.

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

type RequestBringIntoViewEventHandler = 
    delegate of 
        sender:Object *
        e:RequestBringIntoViewEventArgs -> unit


Type: System.Object

The object where the event handler is attached.

Type: System.Windows.RequestBringIntoViewEventArgs

The event data.

Handling this event is typically only done within elements that support a scrollable region, or otherwise deliberately set their rendering size smaller than the combined desired size of their child element content, and is only done by deliberately handling the event once it has routed upwards in the element tree and has reached the first parent that offers scrolling region support. An existing implementation that handles scrolling regions in a manner that is typically desirable for user controls is ScrollViewer. If you derive from ScrollViewer, you can register a class handler for FrameworkElement.RequestBringIntoView and supplement the base class handling of the event. You should also consider using or class-handling the class-defined ScrollChanged event instead of FrameworkElement.RequestBringIntoView. Alternatively, if you create an entirely custom class that does not derive from ScrollViewer, you can still add class handling by calling EventManager.RegisterClassHandler in your class instantiation. For details on class handling, see Marking Routed Events as Handled, and Class Handling.

Content elements can cause the event to be raised by their content hosts (through calling BringIntoView and raising FrameworkElement.RequestBringIntoView from the content host). Similarly, you can request logical tree elements to be brought into view with the helper method LogicalTreeHelper.BringIntoView.

A ListBox implements a related but different method ScrollIntoView.

.NET Framework
Available since 3.0
Return to top