winrt：：agile_ref結構範本 (C++/WinRT)

發行項
07/20/2023

類型，表示 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 函式	擷取 proxy 至 agile_ref 物件的目標，該物件可在呼叫 get 的任何執行緒內容中安全地使用。

成員運算子

運算子	描述
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);

參數

object 初始化 agile_ref 物件的 C++/WinRT 物件或介面。

agile_ref：：get 函式

擷取 proxy 至 agile_ref 物件的目標，該物件可在呼叫 get 的任何執行緒內容中安全地使用。

語法

T get() const;

傳回值

agile_ref 物件所 參考之 C++/WinRT 物件或介面的 Proxy。

agile_ref：：operator bool

檢查 agile_ref 物件是否以有效的 C++/WinRT 物件或介面為目標。

語法

explicit operator bool() const noexcept;

傳回值

true 如果 agile_ref 物件具有有效的目標，則為，否則 false 為。