Kurzreferenz (C++/CX)

  • Artikel

Die Windows-Runtime unterstützt UWP-Apps (Universelle Windows-Plattform). Diese Apps, die nur in einer vertrauenswürdigen Betriebssystemumgebung ausgeführt werden, außerdem autorisierte Funktionen, Datentypen und Geräte verwenden und über Microsoft Store verteilt werden. Der C++/CX vereinfacht das Schreiben von Apps für die Windows-Runtime. Dieser Artikel ist eine Kurzübersicht; eine ausführlichere Dokumentation finden Sie unter Typsystem.

Wenn Sie auf der Befehlszeile aufbauen, verwenden Sie die /ZW Compileroption, um eine UWP-App oder eine Komponente für Windows-Runtime zu erstellen. Um auf Windows-Runtime-Deklarationen zuzugreifen, die in den Windows-Runtime-Metadatendateien (WINMD) definiert sind, geben Sie die #using Anweisung oder die /FU Compileroption an. Wenn Sie ein Projekt für eine UWP-App erstellen, werden diese Optionen von Visual Studio standardmäßig festgelegt und Verweise zu allen Windows-Runtime-Bibliotheken hinzugefügt.

Kurzreferenz

Konzept Standard-C++ C++/CX Hinweise
Grundlegende Typen Grundlegende C++-Typen Grundlegende C++/CX-Typen, die die in Windows-Runtime definierten grundlegenden Typen implementieren. Der default-Namespace enthält integrierte grundlegende Typen. Vom Compiler werden die grundlegenden C++/CX Typen implizit zu Standard-C++-Typen zugeordnet.

Die Platform -Familie von Namespaces enthält Typen, die grundlegende Windows-Runtime-Typen implementieren.
bool bool Ein 8-Bit-boolescher Wert.
wchar_t, char16_t char16 Ein nicht numerischer 16-Bit-Wert, der einen Unicode-Codepunkt (UTF-16) darstellt.
short

unsigned short		 int16

uint16		 Eine 16-Bit-Ganzzahl mit Vorzeichen.

Eine 16-Bit-Ganzzahl ohne Vorzeichen.
int

unsigned int		 int

uint32		 Eine 32-Bit-Ganzzahl mit Vorzeichen.

Eine 32-Bit-Ganzzahl ohne Vorzeichen.
long long - oder - __int64

unsigned long long		 int64

uint64		 Eine 64-Bit-Ganzzahl mit Vorzeichen.

Eine 64-Bit-Ganzzahl ohne Vorzeichen.
float, double float32, float64 Eine 32-Bit- oder 64-Bit-IEEE 754-Gleitkommazahl.
enum enum class

Oder

enum struct		 Eine 32-Bit-Enumeration.
(Nicht anwendbar) Platform::Guid Ein nicht numerischer 128-Bit-Wert (eine GUID) im Platform -Namespace.
std::time_get Windows::Foundation::DateTime Eine Datum/Uhrzeit-Struktur.
(Nicht anwendbar) Windows::Foundation::TimeSpan Eine TimeSpan-Struktur.
(Nicht anwendbar) Platform::Object^ Das nach Verweis gezählte Basisobjekt in der C++-Ansicht des Windows-Runtime-Typsystems.
std::wstring

L"..."		 Platform::String^ Platform::String^ ist eine nach Verweis gezählte, unveränderliche Sequenz von Unicode-Zeichen, die Text darstellt.
Zeiger Zeiger auf Objekt (*):

std::shared_ptr		 Handle-to-object (^, steht für Caretzeichen):

T^ identifier		 Alle Windows-Runtime-Klassen werden mit dem handle-to-object-Modifizierer deklariert. Auf Member des Objekts wird mit dem Klassenmemberzugriffs-Operator Pfeil (->) zugegriffen.

Der Caretzeichenmodifizierer bedeutet "Zeiger auf ein Windows-Runtime -Objekt, das automatisch nach Verweis gezählt wird." Genauer gesagt, deklariert "handle-to-object", dass der Compiler Code einfügen soll, um den Verweiszählerwert des Objekts zu automatisch verwalten und das Objekt zu löschen, wenn der Verweiszähler Null ist
Verweis Ein Verweis auf ein Objekt (&):

T& identifier		 Nachverfolgungsverweis (%):

T% identifier		 Es können nur Windows-Runtime-Typen mit dem Nachverfolgungsverweismodifizierer deklariert werden. Auf Member des Objekts wird mit dem Klassenmemberzugriffs-Operator Punkt (.) zugegriffen.

Der Nachverfolgungsverweis bedeutet "einen Verweis auf ein Windows-Runtime-Objekt, das automatisch nach Verweis gezählt wird." Genauer gesagt deklariert ein Nachverfolgungsverweis, dass der Compiler Code einfügen soll, um die Referenzanzahl des Objekts automatisch zu verwalten. Der Code löscht das Objekt, wenn die Bezugsanzahl auf Null gesetzt wird.
Dynamische Typdeklaration new ref new Weist ein Windows-Runtime-Objekt zu und gibt dann ein Handle für dieses Objekt zurück.
Verwaltung der Objektlebensdauer delete identifier

delete[] identifier		 (Destruktoraufruf.) Die Lebensdauer wird durch Verweiszählung bestimmt. Ein Aufruf an delete ruft den Destruktor auf, aber gibt selbst keinen Arbeitsspeicher frei.
Arraydeklaration T identifier[]

std::array identifier		 Array<T^>^ identifier( size )

Oder

WriteOnlyArray<T^> identifier( size )		 Deklariert ein eindimensionales bearbeitbares oder schreibgeschütztes Array vom Typ T^. Das Array selbst ist auch ein nach Verweis gezähltes Objekt, das mit dem handle-to-object-Modifizierer deklariert werden muss.

(Arraydeklarationen verwenden eine Vorlagenheaderklasse, die im Platform -Namespace ist.)
Klassendeklaration class identifier {}

struct identifier {}		 ref class identifier {}

ref struct identifier {}		 Deklariert eine Laufzeitklasse mit private Standardbarrierefreiheit.

Deklariert eine Laufzeitklasse mit public Standardbarrierefreiheit.
Strukturdeklaration struct identifier {}

(d. h. eine POD-Struktur (Plain Old Data))		 value class identifier {}

value struct identifier {}		 Deklariert eine POD-Struktur mit private Standardbarrierefreiheit.

Eine value class kann in Windows-Metadaten dargestellt werden, aber ein Standard-C++ class nicht.

Deklariert eine POD-Struktur mit public Standardbarrierefreiheit.

Eine value struct kann in Windows-Metadaten dargestellt werden, aber ein Standard-C++ struct nicht.
Schnittstellendeklaration Abstrakte Klasse, die nur rein virtuelle Funktionen enthält. interface class identifier {}

interface struct identifier {}		 Deklariert eine Schnittstelle mit private Standardbarrierefreiheit.

Deklariert eine Schnittstelle mit public Standardbarrierefreiheit.
Delegieren std::function public delegate return-type delegate-type-identifier ( [ Parameter ] ); Deklariert ein Objekt, das wie ein Funktionsaufruf aufgerufen werden kann.
Ereignis (Nicht anwendbar) event delegate-type-identifier event-identifier;

delegate-type-identifier delegate-identifier = ref new delegate-type-identifier( this [, Parameter] );

event-identifier += *delegate-identifier;

Oder

EventRegistrationToken token-identifier = object.event-identifier += delegate-identifier;

Oder

auto token-identifier = object.event-identifier::add( delegate-identifier );

object.event-identifier -= token-identifier;

Oder

object.event-identifier::remove( token-identifier );		 Deklariert ein event-Objekt, das eine Ereignishandlerauflistung (Delegaten) speichert, die beim Auftreten eines Ereignisses aufgerufen wird.

Erstellt einen Ereignishandler.

Fügt einen Ereignishandler hinzu.

Wenn ein Ereignishandler hinzugefügt wird, wird ein Ereignistoken (token-identifier) zurückgegeben. Falls Sie den Ereignishandler explizit entfernen möchten, müssen Sie das Ereignistoken für die spätere Verwendung speichern.

Entfernt einen Ereignishandler.

Um einen Ereignishandler zu entfernen, müssen Sie das Ereignistoken angeben, das Sie beim Hinzufügen des Ereignishandlers gespeichert haben.
Eigenschaft (Nicht anwendbar) property T identifier;

property T identifier[ index ];

property T default[ index ];		 Deklariert, dass auf eine Klassen- oder eine Objektmemberfunktion mit derselben Syntax zugegriffen wird, die für den Zugriff auf einen Datenmember oder ein indiziertes Arrayelement verwendet wurde.

Deklariert eine Eigenschaft in einer Klassen- oder Objektmemberfunktion.

Deklariert eine indizierte Eigenschaft in einer Objektmemberfunktion.

Deklariert eine indizierte Eigenschaft in einer Klassenmemberfunktion.
Parametrisierte Typen templates generic <typename T> interface class identifier {}

generic <typename T > delegate [return-type] delegate-identifier() {}		 Deklariert eine parametrisierte Schnittstellenklasse.

Deklariert einen parametrisierten Delegaten.
Auf NULL festlegbare Werttypen std::optional<T> Platform::IBox <T> Ermöglicht, dass Variablen von skalaren Typen und value-Strukturen einen Wert von nullptr aufweisen.

Weitere Informationen

C++-/CX-Sprachreferenz