Freigeben über

winrt::handle_type Strukturvorlage (C++/WinRT)

Die Vorlage für die winrt::handle und winrt::file_handle strukturiert unter anderem.

Anmerkung

Sie können ihre eigenen Handleeigenschaften definieren (z. B. handle_traits oder file_handle_traits in \cppwinrt\winrt\base.h), und sie mit winrt::handle_type als typename Tverwenden. Kopieren Sie eines dieser Beispiele aus base.h in Ihre eigene Quellcodedatei, und stellen Sie einen eigenen Handletyp und eine eigene Implementierung bereit. Weitere Details finden Sie im MSDN Magazine-Artikel Windows mit C++-.

Syntax

template <typename T>
struct handle_type

Vorlagenparameter

typename T Ein Eigenschaftentyp, der die Art des dargestellten Handles angibt (ein Handle, ein Dateihandle oder ein anderer Typ).

Anforderungen

Mindestens unterstützte SDK: Windows SDK, Version 10.0.17134.0 (Windows 10, Version 1803)

Namespace: winrt

Header: %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (standardmäßig enthalten)

Membertypaliasen

Aliasname Art
handle_type::type Ein Synonym für Typname T::type, wobei T- der typename T Vorlagenparameter ist.

Erbauer

Konstruktor Beschreibung
handle_type::handle_type-Konstruktor Initialisiert eine neue Instanz der handle_type Struktur, optional mit einer Kopie oder einem Verschieben der Eingabedaten.

Memberfunktionen

Funktion Beschreibung
handle_type::Attach-Funktion Fügt einen Handlewert an und übernimmt den Besitz davon.
handle_type::Close-Funktion Schließt das zugrunde liegende Handle.
handle_type::d etach-Funktion Trennt vom zugrunde liegenden Handle.
handle_type::get-Funktion Gibt das zugrunde liegende Handle zurück, wenn Sie es an eine Funktion übergeben müssen.
handle_type::p ut-Funktion Gibt die Adresse des zugrunde liegenden Handles zurück. Diese Funktion unterstützt Sie beim Aufrufen von Methoden, die Verweise als Ausgabeparameter über einen Zeiger auf ein Handle zurückgeben.

Memberoperatoren

Operator Beschreibung
handle_type::operator bool Überprüft, ob das handle_type-Objekt derzeit ein gültiges Handle darstellt.
handle_type::operator= (Zuordnungsoperator) Weist dem handle_type -Objekt einen Wert zu.

Kostenlose Funktionen

Funktion Beschreibung
Swap-Funktion Tauscht den Inhalt der beiden handle_type Parameter so, dass sie den Handle eines anderen enthalten.

handle_type::handle_type-Konstruktor

Initialisiert eine neue Instanz der handle_type Struktur, optional mit einer Kopie oder einem Verschieben der Eingabedaten.

Syntax

handle_type() noexcept;
explicit handle_type(handle_type::type value) noexcept;
handle_type(handle_type&& other) noexcept;

Parameter

value Ein Wert, der das handle_type-Objekt initialisiert.

other Eine weitere handle_type, die das handle_type-Objekt initialisiert.

handle_type::Attach-Funktion

Fügt einen Handlewert an und übernimmt den Besitz davon.

Syntax

void attach(handle_type::type value) noexcept;

Parameter

value Einen Handlewert an, der angefügt werden soll.

handle_type::Close-Funktion

Schließt das zugrunde liegende Handle.

Syntax

void close() noexcept;

handle_type::d etach-Funktion

Trennt vom zugrunde liegenden Handle.

Syntax

handle_type::type detach() noexcept;

Rückgabewert

Das zugrunde liegende Handle, das zuvor durch das handle_type-Objekt dargestellt wurde.

handle_type::get-Funktion

Gibt das zugrunde liegende Handle zurück, wenn Sie es an eine Funktion übergeben müssen.

Syntax

handle_type::type get() const noexcept;

Rückgabewert

Das zugrunde liegende Handle, dargestellt durch das handle_type-Objekt.

handle_type::p ut-Funktion

Gibt die Adresse des zugrunde liegenden Handles zurück. Diese Funktion unterstützt Sie beim Aufrufen von Methoden, die Verweise als Ausgabeparameter über einen Zeiger auf ein Handle zurückgeben.

Syntax

handle_type::type* put() noexcept;

Rückgabewert

Die Adresse des zugrunde liegenden Handles, dargestellt durch das handle_type-Objekt.

handle_type::operator bool

Überprüft, ob das handle_type-Objekt derzeit ein gültiges Handle darstellt.

Syntax

explicit operator bool() const noexcept;

Rückgabewert

true, wenn das handle_type-Objekt derzeit ein gültiges Handle darstellt, andernfalls false.

handle_type::operator= (Zuordnungsoperator)

Weist dem handle_type -Objekt einen Wert zu.

Syntax

winrt::handle_type& operator=(winrt::handle_type&& other) noexcept;

Parameter

other Ein handle_type Wert, der dem handle_type-Objekt zugewiesen werden soll.

Rückgabewert

Ein Verweis auf das handle_type-Objekt.

Swap-Funktion

Tauscht den Inhalt der beiden handle_type Parameter so, dass sie den Handle eines anderen enthalten.

Syntax

void swap(winrt::handle_type& left, winrt::handle_type& right) noexcept;

Parameter

left right Ein handle_type Wert, dessen Handle sich gegenseitig mit dem des anderen Parameters austauschen soll.

Siehe auch