winrt::weak_ref 構造体テンプレート (C++/WinRT)

C++/WinRT オブジェクトまたはインターフェイスへの弱い参照を表す型。 詳細とコード例については、「C++/WinRT の強参照と弱参照」を参照してください。

構文

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);

パラメーター

objectweak_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;

戻り値

trueweak_ref オブジェクトが弱い参照を所有している場合。falseweak_ref オブジェクトが所有している場合は .nullptr

こちらもご覧ください