FrameworkElement.BringIntoView Yöntem

Tanım

Ad Alanı:

System.Windows

Bütünleştirilmiş Kod:

PresentationFramework.dll

Bu öğeyi, içinde bulunduğu kaydırılabilir bölgelerde görünüme getirmeye çalışır.

Aşırı Yüklemeler

BringIntoView(Rect)	Bu öğenin sağlanan bölge boyutunu, içinde bulunduğu kaydırılabilir bölgelerde görüntülemeye çalışır.
BringIntoView()	Bu öğeyi, içinde bulunduğu kaydırılabilir bölgelerde görünüme getirmeye çalışır.

BringIntoView(Rect)

Bu öğenin sağlanan bölge boyutunu, içinde bulunduğu kaydırılabilir bölgelerde görüntülemeye çalışır.

C#

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

Parametreler

targetRectangle

Rect

Ayrıca görünüme getirilmesi gereken öğenin belirtilen boyutu.

Örnekler

Aşağıdaki örnekte, kısıtlı bir kaydırma bölgesinde büyük bir grafik vardır. Sayfadaki düğmenin, görünümü büyük grafiğin belirli bir bölgesine kaydıran bir işleyicisi vardır.

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

Açıklamalar

Bu yöntemi çağırarak geçerli öğeden kaynaklanan bir RequestBringIntoView olay oluşturursunuz. Bu olay, bir veya türetilmiş veya benzer bir ScrollViewersınıf tarafından işlenebilmesi için oluşturulur. Beklenen davranış, olayın üst öğe tarafından işlenmesi, olay verilerinde işlenmiş olarak işaretlenmesi ve olayın kaynağının denetime eklenmiş ScrollViewer mantık aracılığıyla görünüme getirilmesidir. RequestBringIntoView Olay veya BringIntoView yöntem, başarı veya başarısızlıkla ilgili herhangi bir bilgi iletmez; bunun dışında olay genellikle başarı üzerinde işlenir olarak işaretlenir. Hatanın nedenleri öğesi ayarlarını içerebilir, örneğin Visibility dışında Visiblebir değer olabilir.

belirtilmeyen targetRectangleimzayı kullanırsanız, tüm öğe boyutu (onun RenderSize) görünür hale getirilecektir.

Bu yöntemi çağırarak, büyük olasılıkla öğesini içeren herhangi bir üst kaydırılabilir alanda çağrısı MakeVisible yapacaksınız. Bu öğe kaydırılabilir bir alanda yer almadıysa, RequestBringIntoView olay yine tetiklenir, ancak olay dinleyicileri olmadığından hiçbir etkisi olmaz.

Ayrıca bkz.

• FlowDocumentScrollViewer

BringIntoView()

Bu öğeyi, içinde bulunduğu kaydırılabilir bölgelerde görünüme getirmeye çalışır.

C#

public void BringIntoView();

Örnekler

Aşağıdaki örnek, tekdüzen kaynak tanımlayıcısı (URI) bir parça içerdiğinde yanıt veren bir uygulama gezinti olayı için bir işleyici uygular. Parça, karma işaretinden (#) sonra URI'de adlandırılır ve uygulanan davranış öğenin çerçeve içinde görünüme kaymasına neden olur. BringIntoView ve RequestBringIntoView örnekte kaydırma davranışını isteyin.

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

Açıklamalar

Bu yöntemi çağırarak geçerli öğeden kaynaklanan bir RequestBringIntoView olay oluşturursunuz. Bu olay, bir veya türetilmiş veya benzer bir ScrollViewersınıf tarafından işlenebilmesi için oluşturulur. Beklenen davranış, olayın üst öğe tarafından işlenmesi, olay verilerinde işlenmiş olarak işaretlenmesi ve olayın kaynağının denetime eklenmiş ScrollViewer mantık aracılığıyla görünüme getirilmesidir. RequestBringIntoView Olay veya BringIntoView yöntem, başarı veya başarısızlıkla ilgili herhangi bir bilgi iletmez; bunun dışında olay genellikle başarı üzerinde işlenir olarak işaretlenir. Hatanın nedenleri öğesi ayarlarını içerebilir, örneğin Visibility dışında Visiblebir değer olabilir.

belirtilmeyen targetRectangleimzayı kullanırsanız, tüm öğe boyutu (onun RenderSize) görünür hale getirilecektir.

Bu yöntemi çağırarak, büyük olasılıkla öğesini içeren herhangi bir üst kaydırılabilir alanda çağrısı MakeVisible yapacaksınız. Bu öğe kaydırılabilir bir alanda yer almadıysa, RequestBringIntoView olay yine tetiklenir, ancak olay dinleyicileri olmadığından hiçbir etkisi olmaz.

Ayrıca bkz.

• ScrollViewer