다음을 통해 공유


UIElement.BringIntoViewRequested 이벤트

정의

이 요소 또는 해당 하위 항목 중 하나에서 StartBringIntoView 가 호출될 때 발생합니다.

// Register
event_token BringIntoViewRequested(TypedEventHandler<UIElement, BringIntoViewRequestedEventArgs const&> const& handler) const;

// Revoke with event_token
void BringIntoViewRequested(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::BringIntoViewRequested_revoker BringIntoViewRequested(auto_revoke_t, TypedEventHandler<UIElement, BringIntoViewRequestedEventArgs const&> const& handler) const;
public event TypedEventHandler<UIElement,BringIntoViewRequestedEventArgs> BringIntoViewRequested;
function onBringIntoViewRequested(eventArgs) { /* Your code */ }
uIElement.addEventListener("bringintoviewrequested", onBringIntoViewRequested);
uIElement.removeEventListener("bringintoviewrequested", onBringIntoViewRequested);
- or -
uIElement.onbringintoviewrequested = onBringIntoViewRequested;
Public Custom Event BringIntoViewRequested As TypedEventHandler(Of UIElement, BringIntoViewRequestedEventArgs) 

이벤트 유형

Windows 요구 사항

디바이스 패밀리
Windows 10, version 1803 (10.0.17134.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v6.0에서 도입되었습니다.)

설명

참고

프레임워크는 키보드 또는 게임 패드를 통해 포커스를 받는 요소에 대한 응답으로 또는 보조 기술이 요소의 자동화 피어에서 IScrollItemProviderScrollIntoView 메서드를 실행할 때 이벤트를 발생시키는 경우도 있습니다.

이 이벤트를 사용하면 컨트롤이 요소를 보기로 가져오는 프로세스에 참여할 수 있습니다. 이는 ScrollViewer와 같은 부모 컨트롤에 이벤트를 발생시킨 요소가 스크롤 가능한 영역 내에 표시되도록 해야 했음을 나타냅니다. 스크롤되지 않는 컨트롤은 이벤트 데이터(BringIntoViewRequestedEventArgs)를 수정하여 자식 중 하나에서 발생하는 요청을 변경하는 방법으로 이벤트를 사용할 수 있습니다. 예를 들어 부모 요소의 이벤트를 수신 대기하여 TargetRect 를 확대하고 자식 요소를 보기로 가져올 때 최소한의 안쪽 여백이 포함되도록 할 수 있습니다.

일반적으로 이벤트 데이터(BringIntoViewRequestedEventArgs)는 처리된 것으로 표시해서는 안 됩니다. 이렇게 하면 StartBringIntoView가 호출될 때 의도한 목표를 방해할 수 있습니다. 다른 이벤트 데이터는 이벤트가 요청을 변경하기 위해 버블로 수정될 수 있습니다. 특히 부모 스크롤 컨트롤은 부분적으로 또는 완전히 요청을 충족하는지 여부에 관계없이 해당 기여를 고려하도록 이벤트 데이터를 수정해야 합니다. 최소한 스크롤러는 자신을 TargetElement 로 설정하고 TargetRect 를 자체 좌표 공간으로 업데이트해야 합니다. 요소 자체가 스크롤러 내에 있는 스크롤러 내에 있는 경우 요청된 맞춤을 충족하기 위해 각 요소가 반응해야 합니다.

TargetElement를 이벤트 버블로 수정할 수 있으므로 원래 이벤트가 발생한 요소를 결정하는 데 OriginalSource를 사용해야 합니다.

BringIntoViewRequested는 라우트된 이벤트입니다. 라우트된 이벤트 개념에 대한 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.

적용 대상

추가 정보