winrt::weak_ref 結構範本 (C++/WinRT)
類型,表示 C++/WinRT 物件或介面的弱式參考。 如需詳細資訊以及程式碼範例,請參閱 C++/WinRT 中的強式和弱式參考。
Syntax
template <typename T>
struct weak_ref
範本參數
typename T
C++/WinRT 物件的類型或介面的弱式參考,由 weak_ref 物件表示。 這是弱式參考目標的類型。
規格需求
最低支援的 SDK:Windows SDK 10.0.17134.0 版 (Windows 10版本 1803)
命名空間: winrt
標頭: %WindowsSdkDir%IncludeWindowsTargetPlatformVersion <> \cppwinrt\winrt\base. (h 預設包含)
建構函式
建構函式 | 描述 |
---|---|
weak_ref::weak_ref 建構函式 | 使用輸入資料的複本,初始化 weak_ref 結構的新實例。 |
成員函數
函式 | 描述 |
---|---|
weak_ref::get 函式 | 遞增參考計數,並擷取 weak_ref 物件弱式參考 的 C++/WinRT 物件或介面。 判斷是否可以將 weak_ref 解析為強式參考的方式,就是呼叫 get 並嘗試。 |
成員運算子
運算子 | 描述 |
---|---|
weak_ref::operator bool | 檢查 weak_ref 物件是否擁有弱式參考或 nullptr 。 判斷 是否可以將weak_ref 解析為強式參考的方式,就是呼叫 weak_ref::get 並嘗試。 |
weak_ref::weak_ref 建構函式
使用輸入資料的複本,初始化 weak_ref 結構的新實例。
語法
weak_ref(std::nullptr_t = nullptr) noexcept;
weak_ref(T const& object);
weak_ref(com_ptr<T> const& object);
參數
object
初始化 weak_ref 物件的 C++/WinRT 物件或介面或智慧型指標。
weak_ref::get 函式
遞增參考計數,並擷取 weak_ref 物件弱式參考 的 C++/WinRT 物件或介面。 判斷是否可以將 weak_ref 解析為強式參考的方式,就是呼叫 get 並嘗試。
語法
auto get() const noexcept;
傳回值
由 weak_ref 物件弱式參考的 C++/WinRT 物件或介面,或者 nullptr
弱式參考的目標已終結。
weak_ref::operator bool
檢查 weak_ref 物件是否擁有弱式參考或 nullptr
。 判斷 是否可以將weak_ref 解析為強式參考的方式,就是呼叫 weak_ref::get 並嘗試。
語法
explicit operator bool() const noexcept;
傳回值
true
如果 weak_ref 物件擁有弱式參考則為 ; false
如果 weak_ref 物件擁有 ,則為 nullptr
。