GettingFocusEventArgs.CorrelationId 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
포커스 이동 이벤트가 시작될 때 생성된 고유 ID를 가져옵니다.
public:
property Platform::Guid CorrelationId { Platform::Guid get(); };
winrt::guid CorrelationId();
public Guid CorrelationId { get; }
var guid = gettingFocusEventArgs.correlationId;
Public ReadOnly Property CorrelationId As Guid
속성 값
고유 ID(있는 경우)입니다. 그렇지 않으면 null입니다.
기본값은 null입니다.
Windows 요구 사항
디바이스 패밀리 |
Windows 10, version 1809 (10.0.17763.0에서 도입되었습니다.)
|
API contract |
Windows.Foundation.UniversalApiContract (v7.0에서 도입되었습니다.)
|
설명
포커스 이동으로 인해 많은 직접 및 간접 작업이 발생할 수 있습니다.
예를 들어 LosingFocus 로 시작하고 LostFocus, GettingFocus를 통해 GotFocus로 이동하는 이벤트의 표준 시퀀스가 있습니다. 이러한 포커스 이벤트는 일반적으로 요소 트리의 여러 요소( FocusManager 포함)를 통해 라우팅됩니다.
경우에 따라 포커스 이벤트를 다시 라우팅할 수도 있습니다. 예를 들어 대상 요소가 어떤 이유로 유효하지 않은 경우 LosingFocus 이벤트에서 TrySetNewFocusedElement를 호출하여 포커스를 다른 요소로 다시 대상으로 지정할 수 있습니다.
다른 경우에는 포커스 이벤트 처리기 중 하나에서 포커스 변경을 취소해야 할 수 있습니다.
또한 포커스 이벤트가 비동기적으로 발생하기 때문에 이전 포커스 이벤트 실행을 완료하기 전에 포커스가 다시 변경될 수 있습니다.
포커스 이벤트가 시작될 때마다 이러한 포커스 작업 전체에서 포커스 이벤트를 추적하는 데 도움이 되는 고유한 CorrelationId가 생성됩니다.
다음과 같은 경우 새 CorrelationId가 생성됩니다.
- 사용자가 포커스를 이동합니다.
- 앱은 Control.Focus 또는 FocusManager.TryFocusAsync와 같은 메서드를 사용하여 포커스를 이동합니다.
- 창 활성화로 인해 앱이 포커스를 가져오고 잃습니다( CoreWindow.Activated 참조).