Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

FrameworkElement.BringIntoView-Methode: (Rect)

 

Veröffentlicht: Oktober 2016

Versucht, die bereitgestellte Bereichsgröße dieses Elements in in einem bildlauffähigen Bereiche anzuzeigen, in dem es enthalten ist.

Namespace:   System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public void BringIntoView(
	Rect targetRectangle
)

Parameter

targetRectangle
Type: System.Windows.Rect

Angegebene Größe des Elements, das auch in der Ansicht angezeigt werden soll.

Durch Aufrufen dieser Methode lösen Sie ein RequestBringIntoView -Ereignis, das aus dem aktuellen Element stammt. Dieses Ereignis wird ausgelöst, damit sie von verarbeitet werden kann ein ScrollViewer, oder einer abgeleiteten oder ähnlichen Klasse. Das erwartete Verhalten ist, dass das Ereignis, durch das übergeordnete Element behandelt wird, als in den Ereignisdaten behandelt gekennzeichnet und die Quelle des Ereignisses in der Ansicht über die Logik in eingebetteten geschaltet ist die ScrollViewer Steuerelement. Weder die RequestBringIntoView Ereignis noch die BringIntoView -Methode übertragen Informationen über eine erfolgreiche oder fehlerhafte, das Ereignis in der Regel gekennzeichnet behandelt auf Erfolg. Gründen fehlschlagen die Element-Einstellungen wie z. B. zählen Visibility einen Wert als wird Visible.

Wenn Sie eine Signatur verwenden, der keiner targetRectangle, klicken Sie dann auf die gesamte Elementgröße (die RenderSize) sichtbar gemacht.

Durch Aufrufen dieser Methode rufen Sie möglicherweise MakeVisible für alle übergeordneten bildlauffähigen Bereiche, die das Element enthält. Wenn dieses Element nicht in einem bildlauffähigen Bereich enthalten ist das RequestBringIntoView Ereignis dennoch ausgelöst, aber es werden keine Auswirkung, da keine Ereignislistener vorhanden sind.

Im folgende Beispiel ist eine große Grafik in einem eingeschränkten Bildlaufbereich. Eine Schaltfläche auf der Seite verfügt über einen Handler, der die Ansicht auf einen bestimmten Bereich der großen Grafik verschiebt.

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

.NET Framework
Verfügbar seit 3.0
Zurück zum Anfang
Anzeigen: