WPF(또는 WinForm)에서 UWP UI 구성 요소 사용하는 방법
이전에 데스크톱 응용 프로그램에서 UWP 구성 요소를 사용하는 방법을 설명했었습니다.
데스크톱 윈도우 응용 프로그램에서 UWP 라이브러리를 이용한 비디오 장치 열람하는 방법
; https://www.sysnet.pe.kr/2/0/11284
윈도우 데스크톱 응용 프로그램(예: Console)에서 알림 메시지(Toast notifications) 띄우기
; https://www.sysnet.pe.kr/2/0/11073
이번에는 아래의 질문 글에 따라,
안녕하세요. WPF에서 UWP Control을 참조하려고 합니다.
; https://www.sysnet.pe.kr/3/0/5099
UWP UI 컨트롤을 WPF에 포함하는 방법을 알아보겠습니다. 사실 방법은, 위의 질문자가 써놓았던 다음의 자료에서 잘 설명하고 있습니다.
WindowsXamlHost control for Windows Forms and WPF
; https://learn.microsoft.com/en-us/windows/communitytoolkit/controls/wpf-winforms/windowsxamlhost
그래도 ^^ 한번 직접 따라 해 보겠습니다. 우선, .NET Framework 4.6.2 이상의 WPF 프로젝트(WinForm의 경우에는 이 글에서 예제로 실습하진 않지만 방식은 유사하므로 이 글을 읽고 나서 위의 문서를 보시면 바로 알 수 있습니다.)를 하나 만들고 NuGet 패키지 참조를 추가합니다.
Install-Package Microsoft.Toolkit.Wpf.UI.XamlHost
그다음 아래의 외부 모듈을 참조 추가하고,
C:\Program Files (x86)\Windows Kits\10\UnionMetadata\Windows.winmd
"View" / "Toolbox (Ctrl + Alt + X)"를 열면 "Windows Community Toolkit" 범주에 "WindowsXamlHost" 컨트롤을 WPF XAML Form에 끌어다 놓습니다. 그럼 XAML에 WindowsXamlHost 마크업이 추가되는데 기본 추가된 속성을 대충 정리하면 다음과 같이 XAML이 구성될 것입니다.
<Window
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
xmlns:local="clr-namespace:WpfApp1"
xmlns:XamlHost="clr-namespace:Microsoft.Toolkit.Wpf.UI.XamlHost;assembly=Microsoft.Toolkit.Wpf.UI.XamlHost" x:Class="WpfApp1.MainWindow"
mc:Ignorable="d"
Title="MainWindow" Height="450" Width="800">
<Grid>
<XamlHost:WindowsXamlHost />
</Grid>
</Window>
이제 원하는 UWP 컨트롤을 WindowsXamlHost의 InitialTypeName 속성으로 지정하면 됩니다.
질문 글에 포함된 예제에서는 UWP Button 컨트롤을 지정하고 있습니다.
<XamlHost:WindowsXamlHost x:Name="btnTest" InitialTypeName="Windows.UI.Xaml.Controls.Button" />
이후, UWP 래퍼 컨트롤 내에서 InitialTypeName에 지정한 컨트롤을 생성할 텐데 이 컨트롤은 다음과 같이 Child 속성으로 접근할 수 있습니다.
using System.Windows;
namespace WpfApp1
{
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
Windows.UI.Xaml.Controls.Button button = btnTest.Child as Windows.UI.Xaml.Controls.Button;
button.Content = "TEST";
button.Click += Button_Click;
}
private void Button_Click(object sender, Windows.UI.Xaml.RoutedEventArgs e)
{
MessageBox.Show("TestButton Clicked");
}
}
}
하지만 실제로 실행해 보면 위의 코드는 TargetInvocationException / NullReferenceException 오류가 발생합니다.
System.Reflection.TargetInvocationException
HResult=0x80131604
Message=Exception has been thrown by the target of an invocation.
Source=mscorlib
StackTrace:
at System.RuntimeTypeHandle.CreateInstance(RuntimeType type, Boolean publicOnly, Boolean noCheck, Boolean& canBeCached, RuntimeMethodHandleInternal& ctor, Boolean& bNeedSecurityCheck)
at System.RuntimeType.CreateInstanceSlow(Boolean publicOnly, Boolean skipCheckThis, Boolean fillCache, StackCrawlMark& stackMark)
at System.Activator.CreateInstance(Type type, Boolean nonPublic)
at System.RuntimeType.CreateInstanceImpl(BindingFlags bindingAttr, Binder binder, Object[] args, CultureInfo culture, Object[] activationAttributes, StackCrawlMark& stackMark)
at System.Activator.CreateInstance(Type type, BindingFlags bindingAttr, Binder binder, Object[] args, CultureInfo culture, Object[] activationAttributes)
...[생략]...
at MS.Win32.HwndSubclass.SubclassWndProc(IntPtr hwnd, Int32 msg, IntPtr wParam, IntPtr lParam)
at MS.Win32.UnsafeNativeMethods.DispatchMessage(MSG& msg)
at System.Windows.Threading.Dispatcher.PushFrameImpl(DispatcherFrame frame)
at System.Windows.Application.RunDispatcher(Object ignore)
at System.Windows.Application.RunInternal(Window window)
at WpfApp1.App.Main()
Inner Exception 1:
NullReferenceException: Object reference not set to an instance of an object.
왜냐하면 UWP 래퍼 컨트롤 내에서 내부 컨트롤을 생성할 시간이 필요한데, 위의 코드는 생성되기도 전에 Child 속성에 접근했기 때문입니다. 다행히 UWP 래퍼 컨트롤은 내부 컨트롤을 생성한 시점을 이벤트로 알려주는데요, 그래서 대개의 경우 다음과 같이 XAML 코드를 만들어 주면 됩니다.
<XamlHost:WindowsXamlHost x:Name="btnTest" InitialTypeName="Windows.UI.Xaml.Controls.Button"
ChildChanged="ChildControlCreated" />
그리고 저 이벤트 핸들러 이후의 시점부터 Child 속성을 안전하게 접근할 수 있습니다.
using System;
using System.Windows;
namespace WpfApp1
{
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
}
private void ChildControlCreated(object sender, EventArgs e)
{
Windows.UI.Xaml.Controls.Button button = btnTest.Child as Windows.UI.Xaml.Controls.Button;
button.Content = "TEST";
button.Click += Button_Click;
}
private void Button_Click(object sender, Windows.UI.Xaml.RoutedEventArgs e)
{
MessageBox.Show("TestButton Clicked");
}
}
}
(
첨부 파일은 이 글의 예제 코드를 포함합니다.)
질문 글 덕분에 저도 이렇게 실습을 해보는군요. ^^
참고로, 이 기능은 12월에 릴리스된 Windows 1809 업데이트부터 사용할 수 있다고 문서에 명시되어 있습니다.
Starting in Windows 10 Insider Preview SDK build 17709
현재(2018-12-19 기준) 일반 사용자들에게 배포된 Windows 10은 Version 1803에 OS Build 번호가 17134입니다. 만약, 1803 이하의 윈도우 10에서 위의 예제 코드를 실행한다면 MainWindow 로드 시에 다음과 같은 예외가 발생합니다.
System.Windows.Markup.XamlParseException
HResult=0x80131501
Message='The invocation of the constructor on type 'Microsoft.Toolkit.Wpf.UI.XamlHost.WindowsXamlHost' that matches the specified binding constraints threw an exception.' Line number '12' and line position '10'.
Source=PresentationFramework
StackTrace:
at System.Windows.Markup.XamlReader.RewrapException(Exception e, IXamlLineInfo lineInfo, Uri baseUri)
Inner Exception 1:
TypeLoadException: Could not find Windows Runtime type 'Windows.UI.Xaml.Hosting.DesktopWindowXamlSource'.
[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]