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 T
verwenden. 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.