Darstellung von WinRT-Typen und -Membern in JavaScript

Hier erfahren Sie, wie Sie WinRT-Typen und -Member aus webseitigem JavaScript-Code in einer WebView2-App verwenden, wenn sie nativen WinRT-Code aus webseitigem Code aufrufen.

Sprachäquivalente

Das WebView2 WinRT JS-Projektionstool (wv2winrt) konvertiert wie folgt von WinRT in JavaScript-Sprachkonstrukte.

Beim Übergeben von JavaScript-Objekten an Hostobjekte:

• Wenn JavaScript-Objekte Date an Hostobjekte als VT_DATEübergeben werden müssen, legen Sie die -Eigenschaft des Hostobjekts shouldSerializeDates auf fest true. Standardmäßig Date werden Objekte mithilfe JSON.stringifyvon als stringan den Host übergeben.
• Wenn von JavaScript typisierte Arrays an Hostobjekte als arrayübergeben werden müssen, legen Sie die -Eigenschaft des Hostobjekts shouldPassTypedArraysAsArrays auf fest true. Typisierte Arrays werden standardmäßig als IDispatchan den Host übergeben.

Siehe auch:

• Einführung in Microsoft Interface Definition Language 3.0

Statische Member der Klasse

Eine Laufzeitklasse mit statischen Eigenschaften, statischen Methoden oder statischen Ereignissen wird als Eigenschaft des Namespace dargestellt. Jede statische Eigenschaft, statische Methode und jedes statische Ereignis wird als Eigenschaft für dieses JavaScript-Objekt der Runtimeklasse dargestellt.

Beispiel: Für die statische WinRT-API-Methode Windows.Foundation.Uri.EscapeComponent:

• Windows.Foundation ist der Namespace.
• Uri ist die Runtimeklasse.
• EscapeComponent ist die statische Methode.

In JavaScript sieht die Darstellung ähnlich aus: : chrome.webview.hostObjects.Windows.Foundation.Uri.EscapeComponent

• EscapeComponent ist eine JavaScript-Methode, die eine Eigenschaft für das JavaScript-Objekt für die Uri Runtimeklasse ist.
• Die Uri Runtimeklasse ist eine Eigenschaft des JavaScript-Objekts für den Foundation Namespace.

Um beispielsweise die statische Methode Windows.Foundation.Uri.EscapeComponentaufzurufen, rufen Sie Folgendes auf:

`chrome.webview.hostObjects.Windows.Foundation.Uri.EscapeComponent("example");`

Das JavaScript-Namespaceobjekt ist chrome.webview.hostObjects.Windows.Foundationhier .

Klassenkonstruktoren

Ein Konstruktor für eine RuntimeClass Klasse wird als einzelne Eigenschaft in einem JavaScript-Objekt dargestellt, das auf zwei Arten aufgerufen werden kann:

• Als Konstruktor für das JavaScript-Namespaceobjekt.
• Als Funktion für das JavaScript-Namespaceobjekt.

Um beispielsweise ein neues Windows.Foundation.Uri -Objekt zu erstellen, können Sie es entweder als Konstruktor mit newaufrufen:

`let uri = new chrome.webview.hostObjects.Windows.Foundation.Uri("https://example.com/");`

Oder rufen Sie sie als Funktion ohne newauf:

`let uri = chrome.webview.hostObjects.Windows.Foundation.Uri("https://example.com/");`

Das JavaScript-Namespaceobjekt ist chrome.webview.hostObjects.Windows.Foundationhier .

Methodenüberladungen

Wenn ein WinRT-Methodenname für mehr als eine Methode überladen ist, wird beim Aufrufen dieses Methodennamens aus JavaScript die Überladung aufgerufen, die über die übereinstimmende Anzahl von Parametern verfügt.

Wenn mehrere Überladungen mit einer übereinstimmenden Anzahl von Parametern vorhanden sind, wird die erste Überladung aufgerufen, die sich in den Metadaten befindet.

Method out-Parameter

Wenn eine WinRT-Methode Parameter aufweist out , ist das zurückgegebene Ergebnis beim Aufrufen dieser Methode aus JavaScript ein JavaScript-Objekt, das eine Eigenschaft für jeden out Parameter ist. Wenn die Methode über einen Nicht-Rückgabetypvoid verfügt, verfügt das zurückgegebene Ergebnisobjekt auch über eine Eigenschaft namens value , die den Rückgabewert der Methode enthält.

Beim Aufrufen einer WinRT-Methode mit out Parametern werden alle out Parameter in der Parameterliste im Methodenaufruf übersprungen (es sei denn, es handelt sich um einen Arraytyp). Angenommen, eine WinRT-Methode mit out Parametern und einem Nicht-Rückgabetypvoid ist mit MIDL3 wie folgt definiert:

String MethodWithOutParams(String stringParam1, 
                           out Int32 intParam2, 
                           out Int32 intParam3, 
                           String stringParam4);

Wenn Sie diese Methode aus JavaScript aufrufen, lassen Sie die out Argumente aus:

let result = object.MethodWithOutParams("stringParam1", 
                                        "stringParam4");

Lesen Sie dann die -Eigenschaft für das JavaScript-Objektresult, um den value Rückgabewert der WinRT-Methode zu lesen. Um die Parameter der WinRT-Methode out zu lesen, lesen Sie die entsprechend benannten Eigenschaften für das JavaScript-Objekt result :

console.assert(result.value == "return value");

console.assert(result.intParam2 == 1);

console.assert(result.intParam3 == 2);

Bei Arraytypparametern out muss das Array beim Aufrufen der Methode in die Parameterliste der Methode übergeben werden. Bei einem Nicht-Rückgabetypvoid ersetzt das Ergebnisarray das Array, das für den Methodenaufruf übergeben wird. Für den void Rückgabetyp ist das Ergebnisarray das Ergebnis des Methodenaufrufs.

// Both methods update input array values to index values
String NonVoidMethodWithArrayOutParam(out Int[] intArrayParam);

Void VoidMethodWithArrayOutParam(out Int[] intArrayParam);

let input_array1 = [0, 0, 0];

let result1 = object.NonVoidMethodWithArrayOutParam(input_array1);

console.assert(input_array1 == [0, 1, 2])

let input_array2 = [0, 0, 0];

let result2 = object.VoidMethodWithArrayOutParam(input_array2);

console.assert(result2 == [0, 1, 2]);

Wenn typisierte Arrays als Arrayparameter out übergeben werden, chrome.webview.hostObjects.options.shouldPassTypedArraysAsArrays muss auf truefestgelegt werden.

Siehe auch:

• Problem 2788 zum WebView2 SDK und Windows App SDK (WinUI3) in C++ WinRT

Siehe auch

• Aufrufen von systemeigenem WinRT-Code aus webseitigem Code
• Einführung in Microsoft Interface Definition Language 3.0