FrameworkElement.BringIntoView Método

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)

Parâmetros

Exemplos

O exemplo a seguir tem um gráfico grande em uma região de rolagem restrita. Um botão na página tem um manipulador que rola a exibição para uma região específica do gráfico grande.

<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

Comentários

Ao chamar esse método, você gera um RequestBringIntoView evento que se origina do elemento atual. Esse evento é gerado para que possa ser tratado por uma ScrollViewerclasse derivada ou semelhante. O comportamento esperado é que o evento seja tratado pelo elemento pai, marcado como manipulado nos dados do evento e a origem do evento seja colocada em exibição por meio da lógica inserida no ScrollViewer controle. Nem o RequestBringIntoView evento nem o BringIntoView método transmitem informações sobre êxito ou falha, além de que o evento normalmente é marcado como manipulado com êxito. Os motivos da falha podem incluir as configurações de elemento, como Visibility ser algum valor diferente de Visible.

Se você usar a assinatura que não especifica um targetRectangle, todo o tamanho do elemento (seu RenderSize) ficará visível.

Ao chamar esse método, você potencialmente chamará MakeVisible em qualquer área rolável pai que contenha o elemento . Se esse elemento não estiver contido em uma área rolável, o RequestBringIntoView evento ainda será gerado, mas não haverá efeito porque não há ouvintes de eventos.

Confira também

• FlowDocumentScrollViewer

public:
 void BringIntoView();

public void BringIntoView ();

member this.BringIntoView : unit -> unit

Public Sub BringIntoView ()

Exemplos

O exemplo a seguir implementa um manipulador para um evento de navegação de aplicativo que responde sempre que o URI (uniform resource identifier) que está sendo navegado inclui um fragmento. O fragmento é nomeado no URI após o sinal de hash (#) e o comportamento implementado faz com que o elemento role para a exibição dentro do quadro. BringIntoView e RequestBringIntoView solicitam esse comportamento de rolagem no exemplo.

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

Comentários

Ao chamar esse método, você gera um RequestBringIntoView evento que se origina do elemento atual. Esse evento é gerado para que possa ser tratado por uma ScrollViewerclasse derivada ou semelhante. O comportamento esperado é que o evento seja tratado pelo elemento pai, marcado como manipulado nos dados do evento e a origem do evento seja colocada em exibição por meio da lógica inserida no ScrollViewer controle. Nem o RequestBringIntoView evento nem o BringIntoView método transmitem informações sobre êxito ou falha, além de que o evento normalmente é marcado como manipulado com êxito. Os motivos da falha podem incluir as configurações de elemento, como Visibility ser algum valor diferente de Visible.

Se você usar a assinatura que não especifica um targetRectangle, todo o tamanho do elemento (seu RenderSize) ficará visível.

Ao chamar esse método, você potencialmente chamará MakeVisible em qualquer área rolável pai que contenha o elemento . Se esse elemento não estiver contido em uma área rolável, o RequestBringIntoView evento ainda será gerado, mas não haverá efeito porque não há ouvintes de eventos.

Confira também

• ScrollViewer