DesktopWindowXamlSource 클래스

정의

네임스페이스:

Windows.UI.Xaml.Hosting

비 UWP 데스크톱 애플리케이션(예: WPF 또는 Windows Forms 애플리케이션)이 창 핸들(HWND)과 연결된 모든 UI 요소에서 UWP 컨트롤을 호스트할 수 있도록 합니다.

/// [Windows.Foundation.Metadata.ContractVersion(Windows.UI.Xaml.Hosting.HostingContract, 196608)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DesktopWindowXamlSource : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.UI.Xaml.Hosting.HostingContract), 196608)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DesktopWindowXamlSource : System.IDisposable

Public Class DesktopWindowXamlSource
Implements IDisposable

상속

Object IInspectable DesktopWindowXamlSource

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IClosable IDisposable

Windows 요구 사항

디바이스 패밀리	Windows Desktop Extension SDK (10.0.17763.0에서 도입되었습니다.)
API contract	Windows.UI.Xaml.Hosting.HostingContract (v3.0에서 도입되었습니다.)

설명

DesktopWindowXamlSource는 UWP XAML 호스팅 API의 기본 클래스입니다. 이 API를 사용하면 비 UWP 데스크톱 애플리케이션이 창 핸들(HWND)과 연결된 UI 요소에서 Windows.UI.Xaml.UIElement에서 파생된 모든 컨트롤을 호스트할 수 있습니다. 이 API는 WPF, Windows Forms 및 Windows API(Win32)를 사용하여 빌드된 데스크톱 애플리케이션에서 사용할 수 있습니다. 자세한 내용은 데스크톱 애플리케이션에서 UWP XAML 호스팅 API 사용을 참조하세요.

DesktopWindowXamlSource 개체를 만든 후에 호스트할 Windows.UI.Xaml.UIElement 개체를 만들기 전에 Windows.UI.Xaml.UIElement 콘텐츠를 호스트하는 프레임워크는 모든 개체가 동일한 스레드로 초기화되도록 합니다. 호스트할 DesktopWindowXamlSource 개체를 만들기 전에 Windows.UI.Xaml.UIElement 개체를 만드는 경우 Windows.UI.Xaml.UIElement 개체를 인스턴스화하기 전에 WindowsXamlManager.InitializeForCurrentThread를 호출해야 합니다.

DesktopWindowXamlSource는 IClosable에서 파생되므로 작업을 마치면 닫는 것이 좋습니다(.NET에서 삭제).

생성자

DesktopWindowXamlSource()

DesktopWindowXamlSource 클래스의 새 instance 초기화합니다.

속성

Content	데스크톱 애플리케이션에서 호스트하려는 Windows.UI.Xaml.UIElement 개체를 가져오거나 설정합니다.
HasFocus	DesktopWindowXamlSource가 현재 데스크톱 애플리케이션에 포커스가 있는지 여부를 나타내는 값을 가져옵니다.

메서드

Close()	이 DesktopWindowXamlSource에서 사용하는 모든 리소스를 닫고 해제합니다.
Dispose()	관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.
NavigateFocus(XamlSourceFocusNavigationRequest)	프로그래밍 방식으로 데스크톱 애플리케이션의 DesktopWindowXamlSource 에 초점을 맞추려고 시도합니다.

이벤트

GotFocus	DesktopWindowXamlSource가 데스크톱 애플리케이션에서 포커스를 받을 때 발생합니다(예: DesktopWindowXamlSource 바로 앞의 요소에 포커스가 있는 동안 사용자가 Tab 키를 누릅니다).
TakeFocusRequested	호스트 데스크톱 애플리케이션이 DesktopWindowXamlSource 개체에서 포커스를 되돌립니다(예: 사용자가 DesktopWindowXamlSource 의 마지막 포커스 가능 요소에 있고 Tab을 누름)를 받을 때 발생합니다.

추가 정보

• 데스크톱 애플리케이션에서 UWP XAML 호스팅 API 사용