WebView2 в приложениях WinUI 2 (UWP)

Следующие рекомендации относятся к WebView2 в приложениях WinUI 2 (UWP). Элемент управления WinUI 2 (UWP) WebView2 находится в разработке.

Пользовательский интерфейс автозаполнения

Пользовательский интерфейс автозаполнения еще не реализован для WebView2 для приложений UWP.

См. также:

• Автозаполнение в обзоре API WebView2.

Сохранить в формате PDF

Для печати в PDF требуется, чтобы у приложения был доступ к расположению, которое можно записывать в UWP, например к локальной папке. Полный список путей, доступных для UWP, см. в разделе Разрешения на доступ к файлам.

См. также:

• Печать в обзоре API WebView2.

Печать по умолчанию

Печать по умолчанию отключена для WebView2 для приложений UWP. Однако можно записать и распечатать текущее окно просмотра, вызвав .CapturePreview

См. также:

• Запись изображений в обзоре API WebView2.

SmartScreen

WebView2 отправляет URL-адреса, по которым осуществляется переход в приложении, в службу SmartScreen , чтобы обеспечить безопасность клиентов. Если вы хотите отключить эту навигацию, это можно сделать с помощью переменной среды:

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

Эта переменная среды должна быть задана перед CoreWebView2 созданием, которое происходит при первоначальном задании свойства WebView2.Source или вызове метода WebView2.EnsureCoreWebView2Async .

Скачивание файлов

Существует несколько известных ограничений для текущего поведения загрузки для WebView2 в UWP.

Сохранить как

Сохранение файлов с помощью функции "Сохранить как " работает и включено для WebView2 для приложений UWP. Файлы будут сохранены в папке, которую выберет пользователь.

Папка, в которую загружаются файлы

Если узел не изменяет ResultFilePath значение загруженного файла, скачанные файлы будут загружены во вложенную папку с именем пакета приложения в папке Downloads .

Если узел изменяет ResultFilePath значение скачаемого файла, файл будет скачан только в том случае, если приложение имеет доступ к нему по умолчанию. Если вы хотите использовать расположение файла, к которому приложение по умолчанию не имеет доступа, необходимо задать соответствующую возможность. См . статью Объявления возможностей приложений в документации по UWP.

Центр загрузок

Открытие файлов и папок из Центра загрузок отключено. Щелкнув значок файла или папки, соответствующий файл или папку не откроется.

См. также:

• Загрузки в обзоре API WebView2.

Ограничение XAML

Поддержка XAML Island требует дополнительной работы и может рассматриваться для будущих выпусков.

Настройка DefaultBackgroundColor

В WinUI 2 DefaultBackgroundColor свойство не предоставляется напрямую. Вы можете задать цвет фона по умолчанию, задав переменную среды следующим образом:

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

См. также:

• .NET: Свойство WebView2.DefaultBackgroundColor
• Win32: свойство ICoreWebView2Controller2::D efaultBackgroundColor (get, put)

Настройка прозрачности

В WinUI 2 прозрачность достигается путем установки цвета в .00FFFFFF

Курсоры CSS

В WinUI 2 (UWP) курсоры CSS имеют следующие ограничения.

URL-адреса изображений

Курсор CSS не может быть URL-адресом изображения, например cursor: url(https://contoso.com/cursor.png), pointer;. См . статью CSS — курсор, загруженный из URL-адреса, не работает.

Предопределенные курсоры CSS

В WinUI 2 (UWP) некоторые предопределенные курсоры CSS не поддерживаются. Курсоры CSS можно использовать для изменения курсора на некоторые из предопределенных курсоров, например cursor: wait; или cursor: crosshair;, но не на другие, например cursor: progress или cursor: none.

Ключевое слово	Поддержка
Общие
Авто	✔️
default	✔️
none	❌
Состояние & ссылок
контекстное меню	✔️
Справка	✔️
указатель	✔️
progress	❌
ждать	✔️
Selection
ячейка	❌
Перекрестие	✔️
текст	✔️
вертикальный текст	❌
Перетаскивание &
псевдоним	❌
копировать	❌
move	✔️
no-drop	✔️
Запрещено	✔️
хватать	❌
Захвата	❌
Изменение размера & прокрутки
all-scroll	✔️
col-resize	❌
изменение размера строки	❌
n-изменение размера	✔️
e-resize	✔️
S-изменение размера	✔️
w-изменение размера	✔️
ne-resize	✔️
nw-resize	✔️
se-resize	✔️
sw-resize	✔️
ew-resize	✔️
ns-resize	✔️
nesw-resize	✔️
nwse-resize	✔️
Масштабирование
увеличение масштаба	❌
Уменьшение масштаба	❌

См. также:

• Курсоры CSS— в разделе Значения описаны приведенные выше ключевое слово значения.

Средства разработчика Microsoft Edge

В WinUI 2 средства разработки Microsoft Edge нельзя запустить в приложении WebView2 WinUI 2 (UWP) с подписью магазина. Однако эту проблему можно обойти с помощью удаленной отладки. См. раздел Удаленная отладка приложений WebView2 WinUI 2 (UWP).

Ограничения API

Следующие классы недоступны в WinUI 2:

• CoreWebView2EnvironmentOptions
• CoreWebView2ControllerOptions

См. также

• Автозаполнение в обзоре API WebView2.
• Печать в обзоре API WebView2.
• Запись изображений в обзоре API WebView2.
• Загрузки в обзоре API WebView2.
• Удаленная отладка приложений WebView2 WinUI 2 (UWP)

Справочник по API:

• .NET: Свойство WebView2.DefaultBackgroundColor
• Win32: ICoreWebView2Controller2::_getDefaultBackgroundColor
• Win32: ICoreWebView2Controller2::_putDefaultBackgroundColor

Документация По Windows:

• SmartScreen
• Свойство WebView2.Source
• Метод WebView2.EnsureCoreWebView2Async
• Объявления возможностей приложения

MDN:

• Значения в свойстве CSS курсора в MDN.

Репозиторий WebView2Feedback:

• CSS — курсор, загруженный из URL-адреса, не работает