GettingFocusEventArgs 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
FocusManager.GettingFocus 및 UIElement.GettingFocus 이벤트에 대한 데이터를 제공합니다.
public ref class GettingFocusEventArgs sealed : RoutedEventArgs/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 262144)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class GettingFocusEventArgs final : RoutedEventArgs[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 262144)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class GettingFocusEventArgs : RoutedEventArgsPublic NotInheritable Class GettingFocusEventArgs
Inherits RoutedEventArgs- 상속
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 Creators Update (10.0.15063.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v4.0에서 도입되었습니다.)
|
설명
한 번에 하나의 UI 요소만 포커스를 가질 수 있습니다.
컨트롤은 다른 컨트롤이 포커스를 잃거나, 애플리케이션 보기가 변경되거나, 사용자가 애플리케이션을 전환하거나, 애플리케이션이 더 이상 포그라운드에 있지 않도록 시스템과 상호 작용할 때 포커스를 얻을 수 있습니다.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1803 | 17134 | TryCancel |
| 1803 | 17134 | TrySetNewFocusedElement |
| 1809 | 17763 | CorrelationId |
속성
| Cancel |
포커스 탐색을 취소할지 여부를 가져오거나 설정합니다. |
| CorrelationId |
포커스 이동 이벤트가 시작될 때 생성된 고유 ID를 가져옵니다. |
| Direction |
앱 UI 내에서 요소에서 요소로 포커스가 이동된 방향을 가져옵니다. |
| FocusState |
요소가 포커스를 얻은 입력 모드를 가져옵니다. |
| Handled |
라우트된 이벤트를 처리됨으로 표시하는 값을 가져오거나 설정합니다. Handled의 true 값은 이벤트 경로의 대부분의 처리기가 동일한 이벤트를 다시 처리하지 못하도록 합니다. |
| InputDevice |
입력 이벤트가 수신되는 입력 디바이스 유형을 가져옵니다. |
| NewFocusedElement |
가장 최근에 포커스가 있는 개체를 가져옵니다. |
| OldFocusedElement |
마지막으로 포커스가 있는 개체를 가져옵니다. |
| OriginalSource |
이벤트를 발생시킨 개체에 대한 참조를 가져옵니다. 앱 UI에서 선언된 요소가 아닌 컨트롤의 템플릿 부분입니다. (다음에서 상속됨 RoutedEventArgs) |
메서드
| TryCancel() |
진행 중인 포커스 작업을 취소하려고 시도합니다. |
| TrySetNewFocusedElement(DependencyObject) |
원래 대상 요소 대신 지정된 요소로 포커스를 리디렉션하려고 시도합니다. |