FrameworkElement.BringIntoView (Método) (Rect)

Una llamada a este método provoca un evento RequestBringIntoView que se origina en el elemento actual. Se provoca este evento para que ScrollViewer, o una clase derivada o similar, pueda administrarlo. El comportamiento esperado es que el elemento primario administre el evento, lo marque como administrado en los datos de evento y muestre el origen del evento a través de la lógica incrustada en el control ScrollViewer. Ni el evento RequestBringIntoView ni el método BringIntoView transmiten información sobre éxito o error, excepto que el evento se marca normalmente como administrado en caso de éxito. Las razones del error pueden incluir los valores del elemento, por ejemplo que Visibility sea un valor distinto de Visible.

Si usa la firma que no especifica targetRectangle, se hará visible el tamaño del elemento completo (su RenderSize).

Al llamar a este método, posiblemente llama a MakeVisible en cualquier área desplazable primaria que contenga el elemento. Si el elemento no está incluido en una área desplazable, se sigue provocando el evento RequestBringIntoView, pero no surte efecto porque no hay ningún agente de escucha de eventos.

El ejemplo siguiente tiene un gráfico grande en una área de desplazamiento restringida. Un botón en la página tiene un controlador que desplaza la vista a una región determinada del 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>

		Private Sub GoToLake(ByVal sender As Object, ByVal e As RoutedEventArgs)
			mapframe.BringIntoView(New Rect(800, 400, 200, 200))
		End Sub

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

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia