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.