неразрешенный внешний для обработчика события указателя мыши выход для прямоугольника для XAML с C ++ / WinRT

Ошибка компоновщика указывает на отсутствие внешнего winrt::Windows::UI::Xaml::Input::PointerEventHandler::PointerEventHandler(),

Ключом к определению причины является то, что C ++ / WinRT основан на шаблонах, которые находятся в наборе включаемых файлов, которые должны быть включены в исходный код приложения. После компиляции необходимые функции будут создаваться компилятором по мере необходимости, если указанный шаблон доступен.

Если шаблон недоступен, так как файл, в котором он определен, не является частью компилируемого источника файла, то вы увидите ошибку компоновщика из неразрешенного внешнего. Компилятор не генерирует необходимое внешнее, потому что шаблон для этого недоступен.

Как @IInspectable упоминает в своем комментарии со ссылкой на эту статью Начните с C ++ / WinRT (см. примечание в цветной рамке с надписью Важно в начале раздела Быстрый запуск C ++ / WinRT):

Всякий раз, когда вы хотите использовать тип из пространств имен Windows, включите
соответствующий заголовочный файл пространства имен C ++ / WinRT Windows, как показано.
соответствующий заголовок — это заголовок с тем же именем, что и тип
Пространство имен.

Это требование для соответствующего файла заголовка, которое должно быть включено, относится как к исходному коду C ++ / WinRT, так и к исходному коду XAML. В этом случае исходный код XAML содержал PointerExited="PointerExitedHandler" которая требовала функции winrt::Windows::UI::Xaml::Input::PointerEventHandler::PointerEventHandler() но поскольку заголовочный файл, содержащий этот шаблон, не был частью источника C ++ / WinRT за файлом XAML, внешний файл не был сгенерирован компилятором и поэтому был недоступен для компоновщика. Результатом стала ошибка компоновщика fatal error LNK1120: 1 unresolved externals,

В Visual Studio 2017 с использованием шаблонов проекта C ++ / WinRT в сгенерированных файлах, предоставленных шаблонами проекта, находится файл pch.h который содержит список включаемых файлов для проекта.

Пример pch.h Файл, сгенерированный шаблоном проекта C ++ / WinRT:

//
// pch.h
// Header for platform projection include files
//

#pragma once

#define NOMINMAX

#include "winrt/Windows.Foundation.h"#include "winrt/Windows.ApplicationModel.Activation.h"#include "winrt/Windows.UI.Xaml.h"#include "winrt/Windows.UI.Xaml.Controls.h"#include "winrt/Windows.UI.Xaml.Controls.Primitives.h"#include "winrt/Windows.UI.Xaml.Data.h"#include "winrt/Windows.UI.Xaml.Interop.h"#include "winrt/Windows.UI.Xaml.Markup.h"#include "winrt/Windows.UI.Xaml.Navigation.h"

Этот файл используется как часть функциональности Precompiled Headers в Visual Studio 2017, чтобы сократить время перекомпиляции, пока этот файл не изменяется. pch.h Файл обычно включен в каждый из .cpp файлы, чтобы обеспечить необходимую среду компиляции, необходимую для исходных файлов приложения.

Однако этот файл не обязательно является полным списком всех необходимых включаемых файлов для конкретного приложения. И если приложение использует функциональные возможности C ++ / WinRT или XAML, которые не определены ни в одном из перечисленных включаемых файлов, компилятор выдаст ошибку при компиляции C ++ и исходного кода XAML.

Для этого конкретного приложения необходимы два дополнительных файла включения, поэтому pch.h файл нужно изменить так, чтобы он имел include директивы для этих дополнительных файлов.

pch.h Файл должен быть следующим. Обратите внимание на две строки с ADD_TO в комментариях.

//
// pch.h
// Header for platform projection include files
//

#pragma once

#define NOMINMAX

#include "winrt/Windows.Foundation.h"#include "winrt/Windows.ApplicationModel.Activation.h"#include "winrt/Windows.UI.Xaml.h"#include "winrt/Windows.UI.Xaml.Input.h"                    // ADD_TO:  need to add to allow use of mouse pointer handlers in XAML file MainPage.xaml
#include "winrt/Windows.UI.Xaml.Controls.h"#include "winrt/Windows.UI.Xaml.Shapes.h"                   // ADD_TO:  need to add to allow use of Rectangle in XAML file MainPage.xaml
#include "winrt/Windows.UI.Xaml.Controls.Primitives.h"#include "winrt/Windows.UI.Xaml.Data.h"#include "winrt/Windows.UI.Xaml.Interop.h"#include "winrt/Windows.UI.Xaml.Markup.h"#include "winrt/Windows.UI.Xaml.Navigation.h"

Похоже, что общее правило, которому следует C ++ / WinRT, заключается в том, что использование имен включаемых файлов следует за именами namespace директивы и модификаторы для различных частей C ++ / WinRT и его шаблонов.

Это означает, что если вы используете такой тип, как Windows::UI::Xaml::Input::PointerEventHandler::PointerEventHandler() каким-то образом, то вам нужно будет иметь include директива для включения файла с именем, похожим на используемое пространство имен, такое как winrt/Windows.UI.Xaml.Input.h Для того, чтобы иметь необходимые определения и декларации и шаблоны.

Теперь я могу использовать два способа установить обработчики указателя мыши для Rectangle определено в исходном файле XAML.

Я могу добавить необходимые директивы к источнику XAML как в:

<Page
x:Class="BlankAppTouch1.MainPage"xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"xmlns:local="using:BlankAppTouch1"xmlns:d="http://schemas.microsoft.com/expression/blend/2008"xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"mc:Ignorable="d">

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
<StackPanel Orientation="Horizontal" HorizontalAlignment="Center" VerticalAlignment="Center">
<Rectangle x:Name="touchRectangle"Width="200" Height="200" Fill="Blue"PointerExited="PointerExitedHandler" PointerReleased="touchRectangle_PointerReleased" PointerPressed="touchRectangle_PointerPressed"ManipulationMode="All"/>
<Button x:Name="myButton" >Click Me</Button>
</StackPanel>
</Grid>

</Page>

Или я могу указать обработчики в моем исходном файле C ++.

MainPage::MainPage()
{
InitializeComponent();

// can either attach mouse pointer event handlers to a Rectangle by doing the following
myTokenTouchRectangleExited = touchRectangle().PointerExited({ this, &MainPage::PointerExitedHandler });
myTokenTouchRectangleReleased = touchRectangle().PointerReleased({ this, &MainPage::touchRectangle_PointerReleased });
myTokenTouchRectanglePressed = touchRectangle().PointerPressed({ this, &MainPage::touchRectangle_PointerPressed });
// or you can add to the XAML file PointerExited="PointerExitedHandler" PointerReleased="touchRectangle_PointerReleased" PointerPressed="touchRectangle_PointerPressed"
// https://docs.microsoft.com/en-us/windows/uwp/xaml-platform/events-and-routed-events-overview
// can either attach an event handler to a button by doing the following
myTokenButton = myButton().Click({ this, &MainPage::ClickHandler });
// or you can add to the XAML file Click="ClickHandler" in the XAML source defining the button, <Button x:Name="myButton" >Click Me</Button>
}

где две переменные myTokenTouchRectangle а также myTokenButton используются для сохранения предыдущих обработчиков для этих обработчиков событий и определены в MainPage Класс как:

winrt::event_token myTokenTouchRectangleExited;
winrt::event_token myTokenTouchRectangleReleased;
winrt::event_token myTokenTouchRectanglePressed;
winrt::event_token myTokenButton;

Причина этих переменных состоит в том, чтобы захватить предыдущий обработчик событий, если мы хотим отменить нашу логику обработки событий. Например, если я изменю ClickHandler() для нажатия кнопки мыши включить исходную строку:

touchRectangle().PointerReleased(myTokenTouchRectangleReleased);

Затем я увижу изменение поведения щелчков мыши по синему прямоугольнику, если я нажму кнопку рядом с прямоугольником. Перед нажатием кнопки прямоугольник будет увеличиваться при нажатии левой кнопки мыши, touchRectangle().PointerPressed() Обработчик события изменяет размер прямоугольника, а затем уменьшает его при отпускании левой кнопки мыши, touchRectangle().PointerReleased() Обработчик события изменяет размер прямоугольника.

Если я нажимаю кнопку рядом с прямоугольником, в результате чего обработчик события освобожденного указателя мыши возвращается в исходное состояние, то когда я нажимаю левую кнопку мыши, прямоугольник увеличивается, а когда я отпускаю левую кнопку мыши, изменений нет в размере.

Если я переместлю курсор мыши за пределы прямоугольника, touchRectangle().PointerExited() Обработчик события срабатывает, чтобы уменьшить размер прямоугольника.