winrt::agile_ref 结构模板 (C++/WinRT)
表示 对 C++/WinRT 对象或接口的敏捷引用的类型。 有关详细信息和代码示例,请参阅 C++/WinRT 中的敏捷对象。
语法
template <typename T>
struct agile_ref
模板参数
typename T
C++/WinRT 对象或接口的类型是一个敏捷引用,该引用由 agile_ref 对象表示。 这是敏捷引用的目标类型。
要求
支持的最低 SDK:Windows SDK 版本 10.0.17134.0 (Windows 10版本 1803)
命名空间: winrt
标头: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion<>\cppwinrt\winrt\base.h (默认包含)
构造函数
构造函数 | 说明 |
---|---|
agile_ref::agile_ref 构造函数 | 使用输入数据的副本(可选)初始化 agile_ref 结构的新实例。 |
成员函数
函数 | 说明 |
---|---|
agile_ref::get 函数 | 检索 agile_ref对象的目标 代理,该对象可在调用 获取 的任何线程上下文中安全地使用。 |
成员运算符
操作员 | 说明 |
---|---|
agile_ref::operator bool | 检查 agile_ref 对象是否针对 C++/WinRT 对象。 |
agile_ref::agile_ref 构造函数
使用输入数据的副本(可选)初始化 agile_ref 结构的新实例。
语法
agile_ref(std::nullptr_t = nullptr) noexcept;
agile_ref(T const& object);
parameters
object
初始化 agile_ref 对象的 C++/WinRT 对象或接口。
agile_ref::get 函数
检索 agile_ref对象的代理 ,该对象可在调用 获取 的任何线程上下文中安全地使用。
语法
T get() const;
返回值
由 agile_ref 对象引用的 C++/WinRT 对象或接口的代理。
agile_ref::operator bool
检查 agile_ref 对象是否面向有效的 C++/WinRT 对象或接口。
语法
explicit operator bool() const noexcept;
返回值
true
if the agile_ref object has a valid target, otherwise false
.