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.

请参阅