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

  • Artikel

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

Hinweis

Sie können ihre eigenen Handle-Merkmale definieren (siehe z. B. handle_traits oder file_handle_traits in \cppwinrt\winrt\base.h), und verwenden Sie sie mit winrt::handle_type als typename T. Kopieren Sie eine dieser Beispiele aus base.h ihrer eigenen Quellcodedatei, und geben Sie Ihren eigenen Handle-Typ und die Implementierung an. 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 Dateihandpunkt oder ein anderer Typ).

Anforderungen

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

Namespace: winrt

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

Elementtyp-Aliase

Aliasname Typ
handle_type::typ Ein Synonym für den Typname T::type, wobei T der typename T Vorlagenparameter ist.

Konstruktoren

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::Anfügenfunktion Fügt einen Handle-Wert an, und übernimmt ihn.
handle_type::Close-Funktion Schließt den zugrunde liegenden Handle.
handle_type::d etach-Funktion Entfernt vom zugrunde liegenden Handle.
handle_type::get-Funktion Gibt den zugrunde liegenden 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 hilft Ihnen beim Aufrufen von Methoden, die Verweise über einen Zeiger auf einen Handle zurückgeben.

Memberoperatoren

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

Kostenlose Funktionen

Funktion BESCHREIBUNG
swap-Funktion Wechselt 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 Ein weiteres handle_type , das das handle_type-Objekt initialisiert.

handle_type::Anfügenfunktion

Fügt einen Handle-Wert an, und übernimmt ihn.

Syntax

void attach(handle_type::type value) noexcept;

Parameter

value Ein Handle-Wert, der angefügt werden soll.

handle_type::Close-Funktion

Schließt den zugrunde liegenden Handle.

Syntax

void close() noexcept;

handle_type::d etach-Funktion

Entfernt vom zugrunde liegenden Handle.

Syntax

handle_type::type detach() noexcept;

Rückgabewert

Das zugrunde liegende Handle, das früher durch das handle_type-Objekt dargestellt wird.

handle_type::get-Funktion

Gibt den zugrunde liegenden Handle zurück, sollten Sie sie an eine Funktion übergeben müssen.

Syntax

handle_type::type get() const noexcept;

Rückgabewert

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

handle_type::p ut-Funktion

Gibt die Adresse des zugrunde liegenden Handles zurück; Diese Funktion hilft Ihnen beim Aufrufen von Methoden, die Verweise über einen Zeiger auf einen Handle zurückgeben.

Syntax

handle_type::type* put() noexcept;

Rückgabewert

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

handle_type::Operator bool

Überprüft, ob das handle_type-Objekt derzeit einen gültigen Handle darstellt.

Syntax

explicit operator bool() const noexcept;

Rückgabewert

true wenn das handle_type-Objekt derzeit einen gültigen 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

Wechselt 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

leftright Ein handle_type Wert, dessen Handle sich gegenseitig mit dem anderen Parameter austauschen soll.

Siehe auch