FrameworkElement.BringIntoView FrameworkElement.BringIntoView FrameworkElement.BringIntoView FrameworkElement.BringIntoView Method

定義

この要素が含まれているスクロール可能な領域内に、この要素を表示することを試みます。Attempts to bring this element into view, within any scrollable regions it is contained within.

オーバーロード

BringIntoView(Rect) BringIntoView(Rect) BringIntoView(Rect) BringIntoView(Rect)

この要素が含まれているスクロール可能な領域内で、この要素の指定したサイズの領域が表示されるように試みます。Attempts to bring the provided region size of this element into view, within any scrollable regions it is contained within.

BringIntoView() BringIntoView() BringIntoView() BringIntoView()

この要素が含まれているスクロール可能な領域内に、この要素を表示することを試みます。Attempts to bring this element into view, within any scrollable regions it is contained within.

BringIntoView(Rect) BringIntoView(Rect) BringIntoView(Rect) BringIntoView(Rect)

この要素が含まれているスクロール可能な領域内で、この要素の指定したサイズの領域が表示されるように試みます。Attempts to bring the provided region size of this element into view, within any scrollable regions it is contained within.

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)

パラメーター

targetRectangle
Rect Rect Rect Rect

指定した、表示する必要がある要素のサイズ。Specified size of the element that should also be brought into view.

次の例では、制約付きのスクロール領域で大規模なグラフィックが。The following example has a large graphic in a constrained scrolling region. ページ上のボタンには、大きな画像の特定の地域にビューをスクロールするハンドラーがあります。A button on the page has a handler that scrolls the view to a particular region of the large graphic.

<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

注釈

このメソッドを呼び出すことにより、RequestBringIntoViewを現在の要素から取得されたイベント。By calling this method, you raise a RequestBringIntoView event that originates from the current element. 処理できるように、このイベントが発生した、 ScrollViewer、または派生または同様のクラス。This event is raised so that it can be handled by a ScrollViewer, or a derived or similar class. 想定される動作は、イベントがイベント データの処理済みとしてマーク、親要素によって処理し、イベントのソースに埋め込まれたロジックを通じてビューに読み込まれること、ScrollViewerコントロール。The expected behavior is that the event is handled by the parent element, marked handled in the event data, and the source of the event is brought into view through the logic embedded in the ScrollViewer control. どちらも、RequestBringIntoViewイベントもBringIntoViewメソッドについての成功または失敗、もう 1 つよりも、イベントは通常の処理の成功とマーク情報を送信します。Neither the RequestBringIntoView event nor the BringIntoView method transmit any information about success or failure, other than that the event is typically marked handled on success. 上の理由により障害などで要素の設定を含めることができますのVisibility以外のいくつかの値をされているVisibleします。Reasons for failure can include the element settings, such as Visibility being some value other than Visible.

指定されていない署名を使用する場合、 targetRectangle、全体の要素のサイズし (そのRenderSize) が表示されます。If you use the signature that does not specify a targetRectangle, then the entire element size (its RenderSize) will be made visible.

このメソッドを呼び出す可能性のある呼び出すMakeVisible要素を含む親スクロール可能な領域にします。By calling this method, you potentially will call MakeVisible on any parent scrollable area that contains the element. スクロール可能な領域では、この要素が含まれていない場合、RequestBringIntoViewも、イベントが発生しますが、ことはありません効果イベント リスナーが存在しないためです。If this element is not contained in a scrollable area, the RequestBringIntoView event is still raised, but there will be no effect because there are no event listeners.

こちらもご覧ください

BringIntoView() BringIntoView() BringIntoView() BringIntoView()

この要素が含まれているスクロール可能な領域内に、この要素を表示することを試みます。Attempts to bring this element into view, within any scrollable regions it is contained within.

public:
 void BringIntoView();
public void BringIntoView ();
member this.BringIntoView : unit -> unit
Public Sub BringIntoView ()

次の例では、実装されるたびに応答するアプリケーションのナビゲーション イベントのハンドラーをUniform Resource Identifier (URI)uniform resource identifier (URI)フラグメントには移動先が含まれています。The following example implements a handler for an application navigation event that responds whenever the Uniform Resource Identifier (URI)uniform resource identifier (URI) being navigated to includes a fragment. フラグメントの名前は、URIURIハッシュ記号に続く (#)、実装の動作により、スクロールして、フレーム内で表示する要素とします。The fragment is named in the URIURI following the hash sign (#), and the implemented behavior causes the element to scroll into view within the frame. BringIntoView RequestBringIntoViewの例では、そのスクロール動作を要求します。BringIntoView and RequestBringIntoView request that scrolling behavior in the example.

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

注釈

このメソッドを呼び出すことにより、RequestBringIntoViewを現在の要素から取得されたイベント。By calling this method, you raise a RequestBringIntoView event that originates from the current element. 処理できるように、このイベントが発生した、 ScrollViewer、または派生または同様のクラス。This event is raised so that it can be handled by a ScrollViewer, or a derived or similar class. 想定される動作は、イベントがイベント データの処理済みとしてマーク、親要素によって処理し、イベントのソースに埋め込まれたロジックを通じてビューに読み込まれること、ScrollViewerコントロール。The expected behavior is that the event is handled by the parent element, marked handled in the event data, and the source of the event is brought into view through the logic embedded in the ScrollViewer control. どちらも、RequestBringIntoViewイベントもBringIntoViewメソッドについての成功または失敗、もう 1 つよりも、イベントは通常の処理の成功とマーク情報を送信します。Neither the RequestBringIntoView event nor the BringIntoView method transmit any information about success or failure, other than that the event is typically marked handled on success. 上の理由により障害などで要素の設定を含めることができますのVisibility以外のいくつかの値をされているVisibleします。Reasons for failure can include the element settings, such as Visibility being some value other than Visible.

指定されていない署名を使用する場合、 targetRectangle、全体の要素のサイズし (そのRenderSize) が表示されます。If you use the signature that does not specify a targetRectangle, then the entire element size (its RenderSize) will be made visible.

このメソッドを呼び出す可能性のある呼び出すMakeVisible要素を含む親スクロール可能な領域にします。By calling this method, you potentially will call MakeVisible on any parent scrollable area that contains the element. スクロール可能な領域では、この要素が含まれていない場合、RequestBringIntoViewも、イベントが発生しますが、ことはありません効果イベント リスナーが存在しないためです。If this element is not contained in a scrollable area, the RequestBringIntoView event is still raised, but there will be no effect because there are no event listeners.

こちらもご覧ください

適用対象