UIElement.BringIntoViewRequested 이벤트
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이 요소 또는 해당 하위 항목 중 하나에서 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에서 도입되었습니다.)
|
설명
참고
프레임워크는 키보드 또는 게임 패드를 통해 포커스를 받는 요소에 대한 응답으로 또는 보조 기술이 요소의 자동화 피어에서 IScrollItemProvider의 ScrollIntoView 메서드를 실행할 때 이벤트를 발생시키는 경우도 있습니다.
이 이벤트를 사용하면 컨트롤이 요소를 보기로 가져오는 프로세스에 참여할 수 있습니다. 이는 ScrollViewer와 같은 부모 컨트롤에 이벤트를 발생시킨 요소가 스크롤 가능한 영역 내에 표시되도록 해야 했음을 나타냅니다. 스크롤되지 않는 컨트롤은 이벤트 데이터(BringIntoViewRequestedEventArgs)를 수정하여 자식 중 하나에서 발생하는 요청을 변경하는 방법으로 이벤트를 사용할 수 있습니다. 예를 들어 부모 요소의 이벤트를 수신 대기하여 TargetRect 를 확대하고 자식 요소를 보기로 가져올 때 최소한의 안쪽 여백이 포함되도록 할 수 있습니다.
일반적으로 이벤트 데이터(BringIntoViewRequestedEventArgs)는 처리된 것으로 표시해서는 안 됩니다. 이렇게 하면 StartBringIntoView가 호출될 때 의도한 목표를 방해할 수 있습니다. 다른 이벤트 데이터는 이벤트가 요청을 변경하기 위해 버블로 수정될 수 있습니다. 특히 부모 스크롤 컨트롤은 부분적으로 또는 완전히 요청을 충족하는지 여부에 관계없이 해당 기여를 고려하도록 이벤트 데이터를 수정해야 합니다. 최소한 스크롤러는 자신을 TargetElement 로 설정하고 TargetRect 를 자체 좌표 공간으로 업데이트해야 합니다. 요소 자체가 스크롤러 내에 있는 스크롤러 내에 있는 경우 요청된 맞춤을 충족하기 위해 각 요소가 반응해야 합니다.
TargetElement를 이벤트 버블로 수정할 수 있으므로 원래 이벤트가 발생한 요소를 결정하는 데 OriginalSource를 사용해야 합니다.
BringIntoViewRequested는 라우트된 이벤트입니다. 라우트된 이벤트 개념에 대한 자세한 내용은 이벤트 및 라우트된 이벤트 개요를 참조하세요.