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.

请参阅