FrameworkElement.BringIntoView Método

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Tenta trazer esse elemento para a exibição, dentro de qualquer região rolável na qual ele está contido.

Sobrecargas

BringIntoView(Rect)	Tenta trazer o tamanho da região fornecido desse elemento para a exibição, dentro de qualquer região rolável na qual ele está contido.
BringIntoView()	Tenta trazer esse elemento para a exibição, dentro de qualquer região rolável na qual ele está contido.

BringIntoView(Rect)

Tenta trazer o tamanho da região fornecido desse elemento para a exibição, dentro de qualquer região rolável na qual ele está contido.

C#

public void BringIntoView(System.Windows.Rect targetRectangle);

Parâmetros

targetRectangle

Rect

Tamanho especificado do elemento que também deve ser colocado na exibição.

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.

XAML

<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>

C#

void GoToLake(object sender, RoutedEventArgs e)
{
    mapframe.BringIntoView(new Rect(800, 400, 200, 200));
}

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

BringIntoView()

Tenta trazer esse elemento para a exibição, dentro de qualquer região rolável na qual ele está contido.

C#

public void 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.

C#

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;
    }
}

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