灯具网站模板,mui做wap网站,chrome网站开发插件,中山网直播本主题介绍了如何使用 C/WinRT 注册和撤销事件处理委托。 可以使用任何标准 C 函数类对象来处理事件。 使用 Visual Studio 添加事件处理程序#xff08;WPF#xff09;
一种将事件处理程序添加到项目的简便方法是使用 Visual Studio 中的 XAML 设计器用户界面 (UI)。 XAML …本主题介绍了如何使用 C/WinRT 注册和撤销事件处理委托。 可以使用任何标准 C 函数类对象来处理事件。 使用 Visual Studio 添加事件处理程序WPF
一种将事件处理程序添加到项目的简便方法是使用 Visual Studio 中的 XAML 设计器用户界面 (UI)。 XAML 页面在 XAML 设计器中打开后请选择要处理其事件的控件。 在该控件的属性页中的上方单击闪电形图标以列出所有源于该控件的事件。 然后双击想要处理的事件例如OnClicked。
XAML 设计器会将相应的事件处理程序函数原型和存根实现添加到源文件供你替换为自己的实现。 备注
通常情况下无需在 Midl 文件 (.idl) 中描述事件处理程序。 因此XAML 设计器不会向 Midl 文件添加事件处理程序函数原型。 它仅将这些原型添加到 .h 和 .cpp 文件。 注册用于处理事件的委托
一个简单示例将处理按钮的单击事件。 使用 XAML 标记注册用于处理该事件的成员函数很常见如下所示。
// MainPage.xaml
Button x:NamemyButton ClickClickHandlerClick Me/Button// MainPage.h
void ClickHandler(winrt::Windows::Foundation::IInspectable const sender,winrt::Windows::UI::Xaml::RoutedEventArgs const args);// MainPage.cpp
void MainPage::ClickHandler(IInspectable const /* sender */,RoutedEventArgs const /* args */)
{myButton().Content(box_value(LClicked));
}以上代码选自 Visual Studio 中的“空白应用 (C/WinRT)”项目。 代码 myButton() 调用生成的访问器函数该函数将返回名为 myButton 的按钮。 如果更改该按钮元素的 x:Name则生成的访问器函数的名称也会更改。 备注
在这种情况下事件源引发事件的对象是名为 myButton 的按钮。 事件接收者处理事件的对象是 MainPage 的实例。 本主题后面将详细信息介绍如何管理事件源和事件收件人的生存期。 可以强制注册用于处理事件的成员函数而不在标记中以声明方式注册。 从下面的代码示例来看可能不明显但 ButtonBase::Click 调用的参数是 RoutedEventHandler 委托的实例 。 在本例中我们使用了采用对象和指向成员函数的指针的 RoutedEventHandler 构造函数重载 。
// MainPage.cpp
MainPage::MainPage()
{InitializeComponent();myButton().Click({ this, MainPage::ClickHandler });
}重要
注册委托时上述代码示例传递原始的 this 指针指向当前对象 。 若要了解如何建立对当前对象的强引用或弱引用请参阅如果使用成员函数作为委托。 下面是一个使用静态成员函数的示例请注意语法更简单。
// MainPage.h
static void ClickHandler(winrt::Windows::Foundation::IInspectable const sender,winrt::Windows::UI::Xaml::RoutedEventArgs const args);// MainPage.cpp
MainPage::MainPage()
{InitializeComponent();myButton().Click( MainPage::ClickHandler );
}
void MainPage::ClickHandler(IInspectable const /* sender */,RoutedEventArgs const /* args */) { ... }还有其他方法可用来构建 RoutedEventHandler 。 下面是摘自 RoutedEventHandler 的文档主题的语法块从网页右上角“语言”下拉菜单中选择 C/WinRT 。 请注意各种构造函数一种采用 lambda另一种是自由函数还有一种我们在上面使用的采用对象和指向成员函数的指针。
struct RoutedEventHandler : winrt::Windows::Foundation::IUnknown
{RoutedEventHandler(std::nullptr_t nullptr) noexcept;template typename L RoutedEventHandler(L lambda);template typename F RoutedEventHandler(F* function);template typename O, typename M RoutedEventHandler(O* object, M method);/* ... other constructors ... */void operator()(winrt::Windows::Foundation::IInspectable const sender,winrt::Windows::UI::Xaml::RoutedEventArgs const e) const;
};了解函数调用运算符的语法也很有帮助。 它将告诉你委托的形参需要是怎样的。 如你所见在本例中函数调用运算符语法与我们 MainPage::ClickHandler 的形参匹配 。 备注
对于任何给定事件若要了解其委托的详细信息以及该委托的形参先查看事件本身的文档主题。 接下来以 UIElement.KeyDown 事件为例。 访问该主题并从“语言”下拉列表中选择 C/WinRT。 主题开头的语法块中将显示以下内容。
// Register
event_token KeyDown(KeyEventHandler const handler) const;该信息告诉我们 UIElement.KeyDown 事件具有 KeyEventHandler 的委托类型因为那是向此事件类型注册委托时所传递的类型 。 因此立即单击主题上的链接转到该 KeyEventHandler 委托类型。 这里语法块包含函数调用运算符。 如上所述它将告诉你委托的形参需要是怎样的。
void operator()(winrt::Windows::Foundation::IInspectable const sender,winrt::Windows::UI::Xaml::Input::KeyRoutedEventArgs const e) const;如你所见需要声明委托将 IInspectable 作为发送方并将 KeyRoutedEventArgs 类的实例作为实参 。
另以 Popup.Closed 事件为例。 其委托类型为 EventHandlerIInspectable。 因此委托会将一个 IInspectable 作为发送方另一个 IInspectable因为它是 EventHandler 的类型形参作为实参 。
如果你不想在事件处理程序中执行很多工作则可以使用 lambda 函数而不是成员函数。 重复一下从下面的代码示例来看可能不明显但一个 RoutedEventHandler 委托正在从 lambda 函数构造该委托同样需要与之前讨论的函数调用运算符的语法匹配 。
MainPage::MainPage()
{InitializeComponent();myButton().Click([this](IInspectable const /* sender */, RoutedEventArgs const /* args */){myButton().Content(box_value(LClicked));});
}在构建委托时可以选择指示稍微明确一些 以便传递委托或多次使用委托等。
MainPage::MainPage()
{InitializeComponent();auto click_handler [](IInspectable const sender, RoutedEventArgs const /* args */){sender.aswinrt::Windows::UI::Xaml::Controls::Button().Content(box_value(LClicked));};myButton().Click(click_handler);AnotherButton().Click(click_handler);
}撤销已注册的委托
当你注册委托时通常会向你返回一个令牌。 随后可以使用该令牌撤销委托这意味着将从事件取消注册委托再次引发该事件时不会调用该委托。
为简单起见上面的代码示例都没有介绍如何执行该操作。 但下面这个代码示例将令牌存储在结构的专用数据成员中并在析构函数中撤销令牌的处理程序。
struct Example : ExampleTExample
{Example(winrt::Windows::UI::Xaml::Controls::Button const button) : m_button(button){m_token m_button.Click([this](IInspectable const, RoutedEventArgs const){// ...});}~Example(){m_button.Click(m_token);}private:winrt::Windows::UI::Xaml::Controls::Button m_button;winrt::event_token m_token;
};可以不进行上面示例中的强引用而存储对按钮的弱引用请参阅 C/WinRT 中的强引用和弱引用。 备注
当事件源以同步方式引发其事件时你就可以放心地撤销处理程序不会收到更多事件了。 但对于异步事件即使在撤销尤其是在析构函数中撤销后你的对象在开始析构后仍可能收到正在进行的事件。 在析构之前找到取消订阅的地方也许可以缓解此问题若要查找稳妥的解决方案请参阅使用事件处理委托安全访问 this 指针。
或者当你注册代理时也可以指定 winrt::auto_revoke即 winrt::auto_revoke_t 类型的值以请求一个事件撤销程序winrt::event_revoker 类型 。 事件撤销程序为你保留对事件源引发事件的对象的弱引用。 可以通过调用 event_revoker::revoke 成员函数手动撤销但事件撤销程序会在该函数超出范围时自动调用函数本身 。 撤销函数检查事件源是否仍然存在如果存在将撤销你的代理 。 在本示例中无需存储事件源并且不需要析构函数。
struct Example : ExampleTExample
{Example(winrt::Windows::UI::Xaml::Controls::Button button){m_event_revoker button.Click(winrt::auto_revoke,[this](IInspectable const /* sender */,RoutedEventArgs const /* args */){// ...});}private:winrt::Windows::UI::Xaml::Controls::Button::Click_revoker m_event_revoker;
};下面是摘自 ButtonBase::Click 事件的文档主题的语法块 。 它显示了三个不同的注册和撤销函数。 可以清楚地看到从第三个重载进行声明时需要哪种类型的事件撤销程序。 你可以将相同类型的委托传递给“注册”和“使用 event_revoker 撤销”重载 。
// Register
winrt::event_token Click(winrt::Windows::UI::Xaml::RoutedEventHandler const handler) const;// Revoke with event_token
void Click(winrt::event_token const token) const;// Revoke with event_revoker
Button::Click_revoker Click(winrt::auto_revoke_t,winrt::Windows::UI::Xaml::RoutedEventHandler const handler) const;备注
在上述代码示例中Button::Click_revoker 是 winrt::event_revokerwinrt::Windows::UI::Xaml::Controls::Primitives::IButtonBase 的类型别名。 类似的模式适用于所有 C/WinRT 事件。 每个 Windows 运行时事件都具有返回事件撤销程序的撤销函数重载且该撤销程序的类型是事件源的成员。 另一个示例是CoreWindow::SizeChanged 事件具有注册函数重载它返回类型 CoreWindow::SizeChanged_revoker 的值 。
在页面-导航方案中可以考虑撤销处理程序。 如果反复进入某个页面然后退出则可以在离开该页面时撤销任何处理程序。 或者如果你重复使用同一页面实例请检查令牌的值仅在该值未设置时注册 (if (!m_token){ ... })。 第三个选项是将事件撤销程序作为数据成员存储在页面中。 第四个选项将在本主题后面描述是捕获对 lambda 函数中的 this 对象的强引用或弱引用 。 如果“自动撤销”委托无法注册
如果在注册委托时尝试指定 winrt::auto_revoke并且结果是 winrt::hresult_no_interface 异常那么这通常意味着事件源不支持弱引用。 例如这是 Windows.UI.Composition 命名空间中的常见情况。 在此情况下不能使用自动撤销功能。 必须故障回复到手动撤销事件处理程序。 异步操作和运算的委托类型
前面的示例使用的是 RoutedEventHandler 委托类型但当然还有很多其他委托类型 。 例如异步操作和运算带进度和不带进度具有期望相应类型的委托的已完成和/或进度事件。
例如带进度的异步运算进度事件可以是实现 IAsyncOperationWithProgress 的任何内容需要 AsyncOperationProgressHandler 类型的委托 。 下面是使用 lambda 函数创作该类型的委托的代码示例。 该示例还演示了如何创作 AsyncOperationWithProgressCompletedHandler 代理 。
#include winrt/Windows.Foundation.h
#include winrt/Windows.Web.Syndication.husing namespace winrt;
using namespace Windows::Foundation;
using namespace Windows::Web::Syndication;void ProcessFeedAsync()
{Uri rssFeedUri{ Lhttps://blogs.windows.com/feed };SyndicationClient syndicationClient;auto async_op_with_progress syndicationClient.RetrieveFeedAsync(rssFeedUri);async_op_with_progress.Progress([](IAsyncOperationWithProgressSyndicationFeed,RetrievalProgress const /* sender */,RetrievalProgress const args){uint32_t bytes_retrieved args.BytesRetrieved;// use bytes_retrieved;});async_op_with_progress.Completed([](IAsyncOperationWithProgressSyndicationFeed,RetrievalProgress const sender,AsyncStatus const /* asyncStatus */){SyndicationFeed syndicationFeed sender.GetResults();// use syndicationFeed;});// or (but this function must then be a coroutine, and return IAsyncAction)// SyndicationFeed syndicationFeed{ co_await async_op_with_progress };
}如上面的“协同程序”注释所示与将代理与异步操作和运算的已完成事件结合使用相比你可能会发现使用协同程序更自然。 详细信息和代码示例请参阅利用 C/WinRT 实现的并发和异步运算。 备注
对一个异步操作或运算实现多个完成处理程序是错误的做法 。 可对其已完成的事件使用单个委托或者可对其运行 co_await。 如果同时采用这两种方法则第二种方法会失败。 如果坚持使用委托而不是协同程序则可以选择更简单的语法。
async_op_with_progress.Completed([](auto /*sender*/, AsyncStatus const /* args */)
{// ...
});返回一个值的代理类型
某些委托类型本身必须返回一个值。 示例ListViewItemToKeyHandler它将返回一个字符串 。 下面是创作该类型的委托的示例请注意lambda 函数将返回一个值。
using namespace winrt::Windows::UI::Xaml::Controls;winrt::hstring f(ListView listview)
{return ListViewPersistenceHelper::GetRelativeScrollPosition(listview, [](IInspectable const item){return Lkey for item goes here;});
}使用事件处理委托安全访问 this 指针
如果你使用对象的成员函数处理事件或者从对象成员函数中的某个 lambda 函数内部处理事件则需要考虑事件接收方处理事件的对象和事件源引发事件的对象的相对生存期。 详细信息以及代码示例请参阅 C/WinRT 中的强引用和弱引用。
