WebView2 in WinUI 2-Apps (UWP)

Die folgenden Überlegungen gelten für WebView2 in WinUI 2-Apps (UWP). Das WebView2 WinUI 2-Steuerelement (UWP) befindet sich in der Entwicklung.

Benutzeroberfläche für automatisches Ausfüllen

Die Benutzeroberfläche zum automatischen Ausfüllen ist für WebView2 für UWP-Apps noch nicht implementiert.

Siehe auch:

• AutoAusfüllen in der Übersicht über WebView2-APIs.

Als PDF drucken

In PDF drucken erfordert, dass die App Zugriff auf einen beschreibbaren Speicherort in UWP hat, z. B. auf einen lokalen Ordner. Eine vollständige Liste der Pfade, auf die UWP zugegriffen werden kann, finden Sie unter Dateizugriffsberechtigungen.

Siehe auch:

• Drucken in Übersicht über WebView2-APIs.

Standardmäßig drucken

Der Standarddruck ist für WebView2 für UWP-Apps deaktiviert. Sie können jedoch den aktuellen Viewport erfassen und drucken, indem Sie aufrufen CapturePreview.

Siehe auch:

• Bildaufnahme in Der Übersicht über WebView2-APIs.

SmartScreen

WebView2 sendet URLs, zu denen in Ihrer Anwendung navigiert wird, an den SmartScreen-Dienst , um sicherzustellen, dass Ihre Kunden sicher bleiben. Wenn Sie diese Navigation deaktivieren möchten, können Sie dies über eine Umgebungsvariable tun:

• Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--disable-features=msSmartScreenProtection");

Diese Umgebungsvariable muss vor der CoreWebView2 Erstellung festgelegt werden. Dies geschieht, wenn die WebView2.Source-Eigenschaft anfänglich festgelegt oder die WebView2.EnsureCoreWebView2Async-Methode aufgerufen wird.

Herunterladen von Dateien

Es gibt einige bekannte Einschränkungen für das aktuelle Downloadverhalten für WebView2 in UWP.

Speichern unter

Das Speichern von Dateien über Speichern unter funktioniert und ist für WebView2 für UWP-Apps aktiviert. Die Dateien werden in dem Ordner gespeichert, den der Benutzer auswählt.

In welchen Ordner die Dateien heruntergeladen werden?

Wenn der Host die ResultFilePath heruntergeladene Datei nicht ändert, werden die heruntergeladenen Dateien in einen Unterordner mit dem Namen des App-Pakets im Downloads Ordner heruntergeladen.

Wenn der Host die ResultFilePath der heruntergeladenen Datei ändert, wird die Datei nur heruntergeladen, wenn die App standardmäßig Zugriff auf diesen Dateipfad hat. Wenn Sie einen Dateispeicherort verwenden möchten, auf den die App standardmäßig keinen Zugriff hat, müssen Sie die entsprechende Funktion festlegen. Weitere Informationen finden Sie unter App-Funktionsdeklarationen in der UWP-Dokumentation.

Download-Hub

Das Öffnen von Dateien und Ordnern aus dem Downloads-Hub ist deaktiviert. Wenn Sie auf das Datei- oder Ordnersymbol klicken, wird die entsprechende Datei/der entsprechende Ordner nicht geöffnet.

Siehe auch:

• Downloads unter Übersicht über WebView2-APIs.

XAML-Einschränkung

Die XAML Island-Unterstützung erfordert zusätzlichen Aufwand und kann für zukünftige Releases in Betracht gezogen werden.

Festlegen von DefaultBackgroundColor

Auf WinUI 2 wird die DefaultBackgroundColor Eigenschaft nicht direkt verfügbar gemacht. Sie können die Standardhintergrundfarbe festlegen, indem Sie eine Umgebungsvariable wie folgt festlegen:

Environment.SetEnvironmentVariable("WEBVIEW2_DEFAULT_BACKGROUND_COLOR", "FF000000");

Siehe auch:

• .NET: WebView2.DefaultBackgroundColor-Eigenschaft
• Win32: ICoreWebView2Controller2::D efaultBackgroundColor-Eigenschaft (get, put)

Festlegen der Transparenz

In WinUI 2 wird Transparenz erreicht, indem die Farbe auf 00FFFFFFfestgelegt wird.

CSS-Cursor

In WinUI 2 (UWP) gelten für CSS-Cursor die folgenden Einschränkungen.

Bild-URLs

Der CSS-Cursor darf keine Bild-URL sein, z cursor: url(https://contoso.com/cursor.png), pointer;. B. . Weitere Informationen finden Sie unter CSS : Der aus der URL geladene Cursor funktioniert nicht.

Vordefinierte CSS-Cursor

In WinUI 2 (UWP) werden einige der vordefinierten CSS-Cursor nicht unterstützt. Sie können CSS-Cursor verwenden, um den Cursor auf einige der vordefinierten Cursor wie oder zu ändern, cursor: wait; aber nicht auf andere, zcursor: progress. B. oder cursor: none.cursor: crosshair;

Schlüsselwort	Unterstützt?
Allgemein
Auto	✔️
Vorgabe	✔️
keine	❌
Links & status
Kontextmenü	✔️
Hilfe	✔️
Zeiger	✔️
Progress	❌
Warte	✔️
Selection
Zelle	❌
Fadenkreuz	✔️
text	✔️
Vertikaler Text	❌
Ziehen & Ablegen
alias	❌
kopieren	❌
verschieben	✔️
no-drop	✔️
nicht zulässig	✔️
packen	❌
fassend	❌
Ändern der Größe & Scrollens
All-scroll	✔️
col-resize	❌
Zeilengröße ändern	❌
n-Größe ändern	✔️
E-Größe ändern	✔️
s-resize	✔️
w-größe ändern	✔️
ne-resize	✔️
nw-resize	✔️
se-resize	✔️
sw-resize	✔️
ew-resize	✔️
ns-resize	✔️
nesw-resize	✔️
nwse-resize	✔️
Zoomen
Vergrößern	❌
Verkleineren	❌

Siehe auch:

• CSS-Cursor: Im Abschnitt Werte werden die oben genannten Schlüsselwort (keyword) Werte beschrieben.

Microsoft Edge-Entwicklertools

Unter WinUI 2 können Microsoft Edge DevTools nicht in einer store-signierten WebView2 WinUI 2(UWP)-App gestartet werden. Sie können dies jedoch umgehen, indem Sie das Remotedebuggen verwenden. Weitere Informationen finden Sie unter Remotedebuggen von WebView2 WinUI 2-Apps (UWP).

API-Einschränkungen

Auf die folgenden Klassen kann in WinUI 2 nicht zugegriffen werden:

• CoreWebView2EnvironmentOptions
• CoreWebView2ControllerOptions

Siehe auch

• AutoAusfüllen in der Übersicht über WebView2-APIs.
• Drucken in Übersicht über WebView2-APIs.
• Bildaufnahme in Der Übersicht über WebView2-APIs.
• Downloads unter Übersicht über WebView2-APIs.
• Remotedebuggen von WebView2 WinUI 2-Apps (UWP)

API-Referenz:

• .NET: WebView2.DefaultBackgroundColor-Eigenschaft
• Win32: ICoreWebView2Controller2::_getDefaultBackgroundColor
• Win32: ICoreWebView2Controller2::_putDefaultBackgroundColor

Windows-Dokumentation:

• SmartScreen
• WebView2.Source-Eigenschaft
• WebView2.EnsureCoreWebView2Async-Methode
• App-Funktionsdeklarationen

MDN:

• Werte in der CURSOR-CSS-Eigenschaft bei MDN.

WebView2Feedback-Repository:

• CSS: Der aus der URL geladene Cursor funktioniert nicht.