FrameworkElement.BringIntoView Méthode

Définition

Essaie de mettre cet élément en vue, dans toutes régions déroulantes dans lesquelles il est contenu.Attempts to bring this element into view, within any scrollable regions it is contained within.

Surcharges

BringIntoView(Rect)

Tente de mettre en vue les dimensions de la région indiquée de cet élément, incluse dans toute région déroulante que ce soit qui le contient.Attempts to bring the provided region size of this element into view, within any scrollable regions it is contained within.

BringIntoView()

Essaie de mettre cet élément en vue, dans toutes régions déroulantes dans lesquelles il est contenu.Attempts to bring this element into view, within any scrollable regions it is contained within.

BringIntoView(Rect)

Tente de mettre en vue les dimensions de la région indiquée de cet élément, incluse dans toute région déroulante que ce soit qui le contient.Attempts to bring the provided region size of this element into view, within any scrollable regions it is contained within.

public:
 void BringIntoView(System::Windows::Rect targetRectangle);
public void BringIntoView (System.Windows.Rect targetRectangle);
member this.BringIntoView : System.Windows.Rect -> unit
Public Sub BringIntoView (targetRectangle As Rect)

Paramètres

targetRectangle
Rect

Taille spécifiée de l'élément qui doit également être mis en vue.Specified size of the element that should also be brought into view.

Exemples

L’exemple suivant présente un graphique volumineux dans une zone de défilement restreinte.The following example has a large graphic in a constrained scrolling region. Un bouton sur la page comporte un gestionnaire qui fait défiler la vue vers une région particulière du grand graphique.A button on the page has a handler that scrolls the view to a particular region of the large graphic.

<ScrollViewer Width="300" Height="300" HorizontalScrollBarVisibility="Visible" VerticalScrollBarVisibility="Visible">
  <Image Name="mapframe" ScrollViewer.CanContentScroll="True"  >
    <Image.Source>
      <BitmapImage UriSource="treasuremap.bmp"/>
    </Image.Source>
  </Image>
</ScrollViewer>
<StackPanel>
  <Button Click="GoToLake">Go to Lake</Button>

</StackPanel>
void GoToLake(object sender, RoutedEventArgs e)
{
    mapframe.BringIntoView(new Rect(800, 400, 200, 200));
}
Private Sub GoToLake(ByVal sender As Object, ByVal e As RoutedEventArgs)
    mapframe.BringIntoView(New Rect(800, 400, 200, 200))
End Sub

Remarques

En appelant cette méthode, vous déclenchez un événement RequestBringIntoView qui provient de l’élément actuel.By calling this method, you raise a RequestBringIntoView event that originates from the current element. Cet événement est déclenché afin qu’il puisse être géré par un ScrollViewerou une classe dérivée ou similaire.This event is raised so that it can be handled by a ScrollViewer, or a derived or similar class. Le comportement attendu est que l’événement est géré par l’élément parent, marqué comme géré dans les données d’événement et que la source de l’événement est affichée via la logique incorporée dans le contrôle de ScrollViewer.The expected behavior is that the event is handled by the parent element, marked handled in the event data, and the source of the event is brought into view through the logic embedded in the ScrollViewer control. Ni l’événement RequestBringIntoView, ni la méthode BringIntoView transmettent des informations sur la réussite ou l’échec, à l’exception du fait que l’événement est généralement marqué comme géré en cas de réussite.Neither the RequestBringIntoView event nor the BringIntoView method transmit any information about success or failure, other than that the event is typically marked handled on success. Les raisons de l’échec peuvent inclure les paramètres d’élément, tels que la Visibility d’une valeur autre que Visible.Reasons for failure can include the element settings, such as Visibility being some value other than Visible.

Si vous utilisez la signature qui ne spécifie pas de targetRectangle, la taille totale de l’élément (son RenderSize) sera visible.If you use the signature that does not specify a targetRectangle, then the entire element size (its RenderSize) will be made visible.

En appelant cette méthode, vous appelez potentiellement MakeVisible sur toute zone défilante parente qui contient l’élément.By calling this method, you potentially will call MakeVisible on any parent scrollable area that contains the element. Si cet élément n’est pas contenu dans une zone à défilement, l’événement RequestBringIntoView est toujours déclenché, mais il n’y a aucun effet, car il n’y a pas d’écouteurs d’événements.If this element is not contained in a scrollable area, the RequestBringIntoView event is still raised, but there will be no effect because there are no event listeners.

Voir aussi

BringIntoView()

Essaie de mettre cet élément en vue, dans toutes régions déroulantes dans lesquelles il est contenu.Attempts to bring this element into view, within any scrollable regions it is contained within.

public:
 void BringIntoView();
public void BringIntoView ();
member this.BringIntoView : unit -> unit
Public Sub BringIntoView ()

Exemples

L’exemple suivant implémente un gestionnaire pour un événement de navigation d’application qui répond chaque fois que l’URI (Uniform Resource Identifier) dans lequel la navigation est effectuée comprend un fragment.The following example implements a handler for an application navigation event that responds whenever the uniform resource identifier (URI) being navigated to includes a fragment. Le fragment est nommé dans l’URI suivant le signe dièse (#), et le comportement implémenté fait en sorte que l’élément fasse défiler l’affichage dans le frame.The fragment is named in the URI following the hash sign (#), and the implemented behavior causes the element to scroll into view within the frame. BringIntoView et RequestBringIntoView demander le comportement de défilement dans l’exemple.BringIntoView and RequestBringIntoView request that scrolling behavior in the example.

void browserFrame_FragmentNavigation(object sender, FragmentNavigationEventArgs e)
{
    object content = ((ContentControl)e.Navigator).Content;
    FrameworkElement fragmentElement = LogicalTreeHelper.FindLogicalNode((DependencyObject)content, e.Fragment) as FrameworkElement;
    if (fragmentElement == null)
    {
        // Redirect to error page
        // Note - You can't navigate from within a FragmentNavigation event handler,
        //        hence creation of an async dispatcher work item
        this.Dispatcher.BeginInvoke(
            DispatcherPriority.Send,
            (DispatcherOperationCallback) delegate(object unused) 
            {
                this.browserFrame.Navigate(new Uri("FragmentNotFoundPage.xaml", UriKind.Relative));
                return null;
            },
            null);
        e.Handled = true;
    }
}
Private Sub browserFrame_FragmentNavigation(ByVal sender As Object, ByVal e As FragmentNavigationEventArgs)
    Dim element As FrameworkElement = TryCast(LogicalTreeHelper.FindLogicalNode(DirectCast(DirectCast(e.Navigator, ContentControl).Content, DependencyObject), e.Fragment), FrameworkElement)
    If (element Is Nothing) Then
        ' Redirect to error page
        ' Note - You can't navigate from within a FragmentNavigation event handler,
        '        hence creation of an async dispatcher work item
        Dim callback As New DispatcherOperationCallback(AddressOf Me.FragmentNotFoundNavigationRedirect)
        Me.Dispatcher.BeginInvoke(DispatcherPriority.Normal, callback, Nothing)
    End If
    e.Handled = True
End Sub

Function FragmentNotFoundNavigationRedirect(ByVal unused As Object) As Object
    Me.browserFrame.Navigate(New Uri("FragmentNotFoundPage.xaml", UriKind.Relative))
    Return Nothing
End Function

Remarques

En appelant cette méthode, vous déclenchez un événement RequestBringIntoView qui provient de l’élément actuel.By calling this method, you raise a RequestBringIntoView event that originates from the current element. Cet événement est déclenché afin qu’il puisse être géré par un ScrollViewerou une classe dérivée ou similaire.This event is raised so that it can be handled by a ScrollViewer, or a derived or similar class. Le comportement attendu est que l’événement est géré par l’élément parent, marqué comme géré dans les données d’événement et que la source de l’événement est affichée via la logique incorporée dans le contrôle de ScrollViewer.The expected behavior is that the event is handled by the parent element, marked handled in the event data, and the source of the event is brought into view through the logic embedded in the ScrollViewer control. Ni l’événement RequestBringIntoView, ni la méthode BringIntoView transmettent des informations sur la réussite ou l’échec, à l’exception du fait que l’événement est généralement marqué comme géré en cas de réussite.Neither the RequestBringIntoView event nor the BringIntoView method transmit any information about success or failure, other than that the event is typically marked handled on success. Les raisons de l’échec peuvent inclure les paramètres d’élément, tels que la Visibility d’une valeur autre que Visible.Reasons for failure can include the element settings, such as Visibility being some value other than Visible.

Si vous utilisez la signature qui ne spécifie pas de targetRectangle, la taille totale de l’élément (son RenderSize) sera visible.If you use the signature that does not specify a targetRectangle, then the entire element size (its RenderSize) will be made visible.

En appelant cette méthode, vous appelez potentiellement MakeVisible sur toute zone défilante parente qui contient l’élément.By calling this method, you potentially will call MakeVisible on any parent scrollable area that contains the element. Si cet élément n’est pas contenu dans une zone à défilement, l’événement RequestBringIntoView est toujours déclenché, mais il n’y a aucun effet, car il n’y a pas d’écouteurs d’événements.If this element is not contained in a scrollable area, the RequestBringIntoView event is still raised, but there will be no effect because there are no event listeners.

Voir aussi

S’applique à