다음을 통해 공유


DesktopWindowXamlSource 클래스

정의

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

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 327680)]
/// [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(Microsoft.UI.Xaml.WinUIContract), 327680)]
[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
특성
구현

설명

DesktopWindowXamlSourceWindows 앱 SDK XAML 호스팅 API의 기본 클래스입니다. 이 API를 사용하면 WASDK가 아닌 데스크톱 애플리케이션이 HWND(창 핸들)와 연결된 UI 요소에서 Microsoft.UI.Xaml.UIElement 에서 파생된 모든 컨트롤을 호스트할 수 있습니다. 이 API는 WPF, Windows Forms 및 Windows API(Win32)를 사용하여 빌드된 데스크톱 애플리케이션에서 사용할 수 있습니다.

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

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

생성자

DesktopWindowXamlSource()

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

속성

Content

데스크톱 애플리케이션에서 호스트하려는 Microsoft.UI.Xaml.UIElement 개체를 가져오거나 설정합니다.

HasFocus

DesktopWindowXamlSource가 현재 데스크톱 애플리케이션에 포커스가 있는지 여부를 나타내는 값을 가져옵니다.

ShouldConstrainPopupsToWorkArea

팝업과 유사한 동작이 있는 컨트롤을 작업 영역으로 제한해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.

SiteBridge

DesktopSiteBridgeDesktopWindowXamlSource 개체와 연결된 를 가져옵니다.

SystemBackdrop

Mica 및 Acrylic과 같은 재질을 렌더링하는 데 사용되는 시스템 배경을 가져오거나 설정합니다.

메서드

Close()

DesktopWindowXamlSource에서 사용하는 모든 리소스를 닫고 해제합니다.

Dispose()

관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다.

Initialize(WindowId)

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

NavigateFocus(XamlSourceFocusNavigationRequest)

프로그래밍 방식으로 데스크톱 애플리케이션의 DesktopWindowXamlSource 에 초점을 맞추려고 시도합니다.

이벤트

GotFocus

DesktopWindowXamlSource가 데스크톱 애플리케이션에서 포커스를 받을 때 발생합니다(예: DesktopWindowXamlSource 바로 앞의 요소에 포커스가 있는 동안 사용자가 Tab 키를 누를 때).

TakeFocusRequested

호스트 데스크톱 애플리케이션이 DesktopWindowXamlSource 개체에서 포커스를 다시 가져오기 요청을 수신할 때 발생합니다(예: 사용자가 DesktopWindowXamlSource 의 마지막 포커스 가능한 요소에 있고 Tab 키를 누름).

적용 대상

추가 정보