FrameworkElement.BringIntoView FrameworkElement.BringIntoView FrameworkElement.BringIntoView FrameworkElement.BringIntoView Method

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) BringIntoView(Rect) BringIntoView(Rect) 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() BringIntoView() BringIntoView() 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) BringIntoView(Rect) BringIntoView(Rect) 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 Rect Rect 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 comprend un grand graphique dans une zone de défilement contrainte.The following example has a large graphic in a constrained scrolling region. Un bouton sur la page a un gestionnaire qui fait défiler la vue à une région particulière du 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 RequestBringIntoView événement 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’elle puisse être gérée par un ScrollViewer, ou une classe dérivée ou semblable.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 la source de l’événement est placée dans la vue à travers le code incorporé dans le ScrollViewer contrôle.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 le RequestBringIntoView événement ni le BringIntoView méthode transmettre toutes les informations sur le succès ou l’échec, autre que celui qui l’événement est généralement marqué comme géré sur 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. Raisons de l’échec peut inclure des paramètres de l’élément, tel que Visibility en cours 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 un targetRectangle, puis la taille de la totalité de l’élément (son RenderSize) sera rendu 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 éventuellement appeler 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 avec défilement, le RequestBringIntoView événement est déclenché, mais il n’y aura aucun effet car il existe des é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() BringIntoView() BringIntoView() 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 quand le URI (Uniform Resource Identifier)uniform resource identifier (URI) en cours de la navigation inclut un fragment.The following example implements a handler for an application navigation event that responds whenever the URI (Uniform Resource Identifier)uniform resource identifier (URI) being navigated to includes a fragment. Le fragment est nommé dans le URIURI suivant le signe dièse (#), et le comportement implémenté provoque l’élément à faire défiler dans la vue dans le cadre.The fragment is named in the URIURI following the hash sign (#), and the implemented behavior causes the element to scroll into view within the frame. BringIntoView et RequestBringIntoView demande que le 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 RequestBringIntoView événement 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’elle puisse être gérée par un ScrollViewer, ou une classe dérivée ou semblable.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 la source de l’événement est placée dans la vue à travers le code incorporé dans le ScrollViewer contrôle.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 le RequestBringIntoView événement ni le BringIntoView méthode transmettre toutes les informations sur le succès ou l’échec, autre que celui qui l’événement est généralement marqué comme géré sur 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. Raisons de l’échec peut inclure des paramètres de l’élément, tel que Visibility en cours 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 un targetRectangle, puis la taille de la totalité de l’élément (son RenderSize) sera rendu 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 éventuellement appeler 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 avec défilement, le RequestBringIntoView événement est déclenché, mais il n’y aura aucun effet car il existe des é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 à