Обзор API WebView2

Внедрение элемента управления WebView2 в приложение предоставляет приложению доступ к различным функциям браузера через методы и свойства, предоставляемые классами или интерфейсами WebView2.

WebView2 имеет сотни API, которые предоставляют широкий набор возможностей, начиная от расширения возможностей собственной платформы вашего приложения и заканчивая возможностью вашего приложения изменять интерфейсы браузера. В этой статье представлена высокоуровневая группировка API WebView2, чтобы помочь вам понять различные действия, которые можно выполнять с помощью WebView2.

Подробное содержание:

Обзор функциональных областей верхнего уровня

При размещении элемента управления WebView2 ваше приложение имеет доступ к следующим функциям и API:

Функциональная область Назначение
Основные классы: среда, контроллер и ядро Классы CoreWebView2Environment, и CoreWebView2 (или эквивалентные интерфейсы) работают вместе, CoreWebView2Controllerпоэтому в приложении можно разместить элемент управления браузера WebView2 и получить доступ к функциям браузера. Эти большие классы предоставляют широкий спектр API, к которым ваше ведущее приложение может получить доступ, чтобы предоставлять следующие категории функций, связанных с браузером, для ваших пользователей.
Взаимодействие в Интернете и нативном коде Внедряйте веб-контент в собственные приложения. Взаимодействие между машинным кодом и веб-кодом с помощью простых сообщений, кода JavaScript и собственных объектов.
Функции браузера Управление WebView2 предоставляет приложению доступ ко многим функциям браузера. Вы можете изменять эти функции браузера, включать и отключать их.
Управление процессами Получите сведения о запущенных процессах WebView2, завершающихся процессах и неудавшихся процессах, чтобы приложение могло предпринять соответствующие действия.
Переход к страницам и управление загруженным контентом Управление переходами к веб-страницам и управление содержимым, загружаемым на веб-страницы.
Элементы iframe Встраивание других веб-страниц в собственные веб-страницы. Определять, когда создаются внедренные веб-страницы, определять, когда внедренные веб-страницы осуществляют переход, и при необходимости обходить параметры x-frame.
Проверка подлинности Приложение может обрабатывать базовую проверку подлинности с помощью элемента управления WebView2. Обычная проверка подлинности — это особый подход к проверке подлинности, который является частью протокола HTTP.
Отрисовка WebView2 в приложениях, не относящихся к платформе Используйте эти API для настройки системы отрисовки WebView2, если ваше ведущее приложение не использует платформу пользовательского интерфейса. Эта настройка отрисовки управляет тем, как WebView2 отображает выходные данные в хост-приложении, а WebView2 обрабатывает ввод, фокус и доступность.
Отрисовка WebView2 с помощью Composition Для рендеринга WebView2 на основе композиции используйте CoreWebView2Environment для создания .CoreWebView2CompositionController CoreWebView2CompositionController предоставляет те же API, что и CoreWebView2Controller, но также включает API для рендеринга на основе композиции.
Параметры среды Пользовательские данные: управление папкой пользовательских данных (UDF), которая является папкой на компьютере пользователя. Функция UDF содержит данные, связанные с ведущим приложением и WebView2. Приложения WebView2 используют папки с данными пользователя для хранения данных браузера, таких как файлы cookie, разрешения и кэшированные ресурсы. Управление несколькими профилями в одной UDF.
Выбор среды выполнения поддерживает предварительное тестирование и самостоятельное размещение. Вы можете задать порядок поиска для каналов с предварительными версиями браузера и указать, какие каналы предварительных версий браузера будут искаться.
Производительность и отладка Анализируйте и отлаживайте производительность, обрабатывайте события, связанные с производительностью, и управляйте использованием памяти, чтобы повысить скорость отклика вашего приложения.
Chrome DevTools Protocol (CDP) Инструментирование, проверка, отладка и профилирование браузеров на основе Chromium. Протокол Chrome DevTools Protocol (CDP) — это основа для Microsoft Edge DevTools. Используйте протокол Chrome DevTools для функций, которые не реализованы на платформе WebView2.

На этой странице перечислены только API, которые входят в пакеты SDK для выпуска; в нем не перечислены экспериментальные API или стабильные API, которые еще не доступны в выпусках SDK. Полный список API, включая экспериментальные API, см. в заметках о выпуске WebView2.

Основные классы: среда, контроллер и ядро

Классы CoreWebView2Environment, и CoreWebView2 (или эквивалентные интерфейсы) работают вместе, CoreWebView2Controllerпоэтому в приложении можно разместить элемент управления браузера WebView2 и получить доступ к функциям браузера. Эти три больших класса предоставляют широкий спектр API, к которым может получить доступ ваше ведущее приложение, чтобы предоставить пользователям множество категорий функций, связанных с браузером.

  • Этот CoreWebView2Environment класс представляет группу элементов управления WebView2, которые совместно используют один и тот же процесс браузера WebView2, папку пользовательских данных и процесс отрисовки. Из этого CoreWebView2Environment класса создаются пары экземпляров CoreWebView2Controller and CoreWebView2 .

  • Этот CoreWebView2Controller класс отвечает за функциональные возможности, связанные с размещением, такие как фокус окна, видимость, размер и ввод данных, в которых ваше приложение размещает элемент управления WebView2.

  • Этот CoreWebView2 класс предназначен для веб-части элемента управления WebView2, включая сеть, навигацию, скрипты, а также анализ и визуализацию HTML.

См. также:

Взаимодействие в Интернете и нативном коде

Элемент управления Microsoft Edge WebView2 позволяет внедрять веб-контент в собственные приложения. Вы можете взаимодействовать между машинным кодом и веб-кодом с помощью простых сообщений, кода JavaScript и собственных объектов. Ниже приведены основные API для взаимодействия между веб-кодом и машинным кодом.

Распространенные варианты использования веб- и нативного взаимодействия:

  • Обновите заголовок окна собственного узла после перехода на другой веб-сайт.
  • Отправка собственного объекта камеры и использование его методов из веб-приложения.
  • Запустите выделенный файл JavaScript на веб-стороне приложения.

См. также:

Общий доступ к узлам и веб-объектам

WebView2 позволяет передавать объекты, определенные в машинном коде, в веб-код приложения. Объекты узла — это любые объекты, определенные в машинном коде, который вы решили передать в веб-код вашего приложения.

Хост-объекты могут быть проецированы в JavaScript, так что вы можете вызывать методы собственных объектов (или другие API) из веб-кода вашего приложения. Например, приложение может вызывать такие API в результате взаимодействия с пользователем на веб-стороне приложения. Таким образом, вам не нужно повторно реализовывать API ваших собственных объектов, таких как методы или свойства, в веб-коде.

Выполнение сценария

Позволяет основному приложению добавлять код JavaScript в содержимое веб-сайта в элементе управления WebView2.

Обмен сообщениями в Интернете

Приложение может отправлять сообщения веб-содержимому, находящемуся в элементе управления WebView2, и получать сообщения из этого веб-содержимого. Сообщения отправляются в виде строк или объектов JSON.

При необходимости можно публиковать и получать объекты DOM вместе с сообщением с помощью additionalObjects параметра PostWebMessageAsJson (.NET, WinRT) или ( PostWebMessageAsJsonWithAdditionalObjects Win32). Класс WebView2 CoreWebView2FileSystemHandle представляет DOM FileSystemHandleи CoreWebView2File представляет DOM File. См. также chrome.webview.postMessageWithAdditionalObjects в справочнике по JavaScript.

Диалоговые окна сценариев

При размещении WebView2 приложение может управлять различными диалоговыми окнами JavaScript, подавлять их или заменять их пользовательскими диалоговыми окнами.

Общий буфер

API SharedBuffer поддерживает совместное использование буферов между процессом ведущего приложения WebView2 и процессом отрисовки WebView2 на основе общей памяти ОС.

См. также:

Функции браузера

Управление WebView2 предоставляет приложению доступ ко многим функциям браузера. Вы можете изменять эти функции браузера, включать и отключать их.

Печать

Вы можете распечатать веб-страницу на принтере, в PDF-файле или потоке PDF, настроив пользовательские параметры печати.

См. также:

Файлы cookie

В WebView2 можно использовать файлы cookie для управления сеансами пользователей, хранения параметров персонализации пользователей и отслеживания их поведения.

См. также:

Захват изображения

Благодаря размещению WebView2 приложение может делать снимки экрана и указывать формат, который следует использовать для сохранения изображения.

Управление отображением пользовательского интерфейса захвата экрана

Событие ScreenCaptureStarting возникает каждый раз, когда WebView2 и (или) iframe, соответствующий CoreWebView2Frame (или любому из его дочерних элементов iframe), запрашивают разрешение на использование API записи экрана до отображения пользовательского интерфейса. Затем приложение может заблокировать отображение пользовательского интерфейса или разрешить отображение пользовательского интерфейса.

Поиск

API поиска позволяет программно управлять операциями поиска и позволяет добавить в приложение следующие функции:

  • Настройте параметры поиска, в том числе термин поиска, учет регистра, сопоставление Word, выделение совпадений и подавление пользовательского интерфейса по умолчанию.
  • Находите текстовые строки и перемещайтесь по ним в элементе управления WebView2.
  • Программно инициируйте операции поиска и переходите по результатам поиска .
  • Отключение интерфейса поиска по умолчанию.
  • Отслеживание состояния операций поиска .

Существуют известные проблемы с API поиска для документов PDF. При просмотре PDF-документа в элементе управления WebView2 функция поиска в настоящее время предоставляет только первый индекс и число найденных совпадений. Например, если строка встречается в PDF-файле три раза, пользовательский интерфейс будет показывать 1/3 и не будет поддерживать вызов команд "Далее " и " Назад" программным путем.

Мы активно исследуем эти проблемы и рекомендуем сообщать о любых проблемах, с которыми вы столкнулись, с помощью репозитория WebView2Feedback .

Загрузки

Ваше приложение может управлять скачиванием в WebView2. Приложение может:

  • Разрешение или блокировка скачивания на основе различных метаданных.
  • Изменение расположения скачивания.
  • Настройте пользовательский пользовательский пользовательский интерфейс загрузки.
  • Настройте пользовательский интерфейс по умолчанию.

Общая информация:

Изменение интерфейса по умолчанию:

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

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

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

Настройка предупреждения системы безопасности при сохранении файла

Прослушивая SaveFileSecurityCheckStarting событие, приложение может зарегистрировать обработчик для этого события, чтобы получить информацию о пути к файлу, расширении имени файла и URI источника документа. Затем вы можете применить собственные правила для выполнения действий, например:

  • Разрешить сохранение файла без предоставления пользовательского интерфейса предупреждения о безопасности по умолчанию для политики типов файлов.
  • Отмените сохранение.
  • Создайте собственный пользовательский интерфейс для управления политиками типов файлов среды выполнения.

Обработка веб-уведомлений

API веб-уведомлений поддерживают непостоянные уведомления. Событие NotificationReceived для CoreWebView2 управления обработкой веб-уведомлений, что позволяет приложению узла настраивать или подавлять их. Необработанные уведомления по умолчанию используются в пользовательском интерфейсе WebView2.

Разрешения

Разные веб-страницы могут запрашивать у вас разрешения на доступ к некоторым привилегированным ресурсам, таким как датчик геолокации, камера и микрофон. Ведущее приложение может программно отвечать на запросы разрешений и может заменять пользовательский интерфейс разрешений по умолчанию собственным пользовательским интерфейсом.

Контекстные меню

Элемент управления WebView2 предоставляет контекстное меню по умолчанию (контекстное меню), которое можно настроить или отключить, а также можно создать собственное контекстное меню.

См. также:

Строка состояния

Строка состояния находится в левом нижнем углу страницы и показывает состояние отображаемой веб-страницы. В WebView2 можно включить или отключить строку состояния, получить текст в строке состояния и узнать, изменился ли текст в строке состояния.

Полосы прокрутки наложения Fluent

Стилизует полосы прокрутки под дизайн Microsoft Fluent и накладывает полосы прокрутки поверх веб-содержимого. Этот дизайн адаптивной полосы прокрутки адаптируется к различным устройствам и размерам окон.

Чтобы поэкспериментировать с полосами прокрутки наложения Fluent, в Microsoft Edge перейдите к полосам edge://flagsпрокрутки наложения Fluent и введите их.

См. также:

Агент пользователя

Агент пользователя — это строка, представляющая удостоверение программы от имени пользователя, например имя браузера. В WebView2 можно настроить агент пользователя.

См. также:

Автозаполнение

Приложение может самостоятельно управлять включением функции автозаполнения браузера для получения общих сведений или для паролей.

"Audio" (Аудио);

Приложение может отключать и включать любой звук, а также узнавать, когда он воспроизводится.

Тестирование щелчков мышью в регионах

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

Навигация с помощью жеста прокрутки

С помощью элемента управления WebView2 приложение может включать и выключать навигацию с помощью жеста прокрутки на устройствах с поддержкой сенсорного ввода. Этот жест позволяет конечным пользователям:

  • Проведите пальцем влево или вправо (по горизонтали), чтобы перейти к предыдущей или следующей странице журнала переходов.
  • Потяните, чтобы обновить (проведите пальцем по вертикали) текущую страницу.

В настоящее время эта функция по умолчанию отключена в браузере. Чтобы включить эту функцию в WebView2, задайте свойство AdditionalBrowserArguments , указав --pull-to-refresh переключатель.

Включить или отключить браузер, реагирующий на сочетания клавиш (сочетания клавиш)

ICoreWebView2AcceleratorKeyPressedEventArgs имеет свойство IsBrowserAcceleratorKeyEnabled , позволяющее вам контролировать, обрабатывает ли браузер сочетания клавиш (сочетания клавиш), такие как Ctrl+P или F3.

См. также:

Полноэкранный режим

В WebView2 можно узнать, когда элемент HTML переходит в полноэкранный режим или покидает его.

Панель инструментов PDF

В верхней части средства просмотра PDF-файлов браузера есть специальная панель инструментов для PDF-файлов. В WebView2 можно скрыть некоторые элементы на панели инструментов средства просмотра PDF.

Темы

В WebView2 вы можете настроить такую цветовую тему, как системная, светлая или темная.

Язык

Это Language свойство задает язык интерфейса по умолчанию для WebView2, который применяется к пользовательскому интерфейсу браузера (например, к контекстным меню и диалоговым окнам), а также задает accept-language заголовок HTTP, который WebView2 отправляет на веб-сайты.

Это ScriptLocale свойство позволяет основному приложению устанавливать языковой стандарт по умолчанию для всех Intl API JavaScript и других API JavaScript, которые от него зависят, например Intl.DateTimeFormat(), который влияет на форматирование строк в форматах времени и даты.

Новое окно

WebView2 предоставляет функциональность для обработки функции window.open()JavaScript .

Закрытие окна

WebView2 предоставляет функциональность для обработки функции window.close()JavaScript .

Название документа

Приложение может обнаружить, когда изменилось название текущего документа верхнего уровня.

Фавикон

В WebView2 можно настроить фавикон для веб-сайта или получать уведомления об изменениях.

Безопасность и конфиденциальность

Блокировка отслеживания

Блокировка отслеживания позволяет приложению-организатору управлять уровнем блокировки отслеживания элемента управления WebView2, связанного с профилем пользователя.

Фильтр SmartScreen

Фильтр SmartScreen в Microsoft Defender ("SmartScreen") включен по умолчанию. Свойство IsReputationCheckingRequired определяет, включен ли фильтр SmartScreen.

Если вы не отключите фильтр SmartScreen, вы должны уведомить всех пользователей о том, что ваше программное обеспечение включает фильтр SmartScreen в Microsoft Defender, а также собирает и отправляет сведения о пользователе в корпорацию Майкрософт, как описано в заявлении о конфиденциальности корпорации Майкрософт и в фильтре SmartScreen в разделе "Пользовательские данные и конфиденциальность в Microsoft Edge".

См. также:

  • SmartScreen в разделе "Данные и конфиденциальность" в WebView2.
Настраиваемые отчеты о сбоях

При сбое какого-либо процесса WebView2 создается один или несколько файлов минидампа, которые отправляются в корпорацию Майкрософт для диагностики. Используйте этот API для настройки отчетов о сбоях при запуске диагностики и анализе.

  • Чтобы предотвратить отправку аварийных дампов в Майкрософт, задайте свойству IsCustomCrashReportingEnabled значение false.
  • Чтобы найти аварийные дампы и выполнить с их помощью настройку, используйте свойство CrashDumpFolderPath .

См. также:

Расширения браузера

Ваше приложение может внедрить элемент управления WebView2, использующий расширение Microsoft Edge. Расширение Microsoft Edge — это небольшое приложение, которое разработчики используют для добавления или изменения функций Microsoft Edge, чтобы улучшить работу пользователя в Интернете.

См. также:

Управление процессами

Получите сведения о запущенных процессах WebView2, завершающихся процессах и неудавшихся процессах, чтобы приложение могло предпринять соответствующие действия.

Сведения о процессе фрейма

API сведений о процессе кадра, включая GetProcessExtendedInfos, предоставляет snapshot коллекцию всех кадров, которые активно выполняются в связанном процессе рендеринга. Этот API позволяет приложению определять, какая часть WebView2 потребляет ресурсы, такие как память или использование ЦП.

Включить фоновую обработку и автономную поддержку (API рабочих сценариев WebView2)

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

Эти API предоставляют следующие возможности:

  • События жизненного цикла: Следить за созданием и уничтожением рабочих.
  • Интерфейсы обмена сообщениями: Общайтесь с работниками с помощью и PostMessageWebMessageReceived; в частности:
    • CoreWebView2ServiceWorker.PostWebMessageAsJson
    • CoreWebView2ServiceWorker.PostWebMessageAsString
    • CoreWebView2DedicatedWorker.PostWebMessageAsJson
    • CoreWebView2DedicatedWorker.PostWebMessageAsString
    • CoreWebView2ServiceWorker.WebMessageReceived
    • CoreWebView2DedicatedWorker.WebMessageReceived
    • chrome.webview.postMessage
    • Не: chrome.webview.postMessageWithAdditionalObjects
  • Управление работниками: Запрашивать и извлекать регистрации и экземпляры рабочих ролей.

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

Управление контентом, загруженным в WebView2

Эти API загружают, останавливают загрузку и перезагружают содержимое в WebView2. Загружаемое содержимое может быть следующим:

  • Содержимое из URL-адреса.
  • Строка HTML.
  • Локальное содержимое через сопоставление имени виртуального хоста с локальной папкой.
  • Содержимое из созданного сетевого запроса.

См. также:

Методы журнала позволяют переходить назад и вперед в WebView2, а события журнала предоставляют сведения об изменениях в журнале и в текущем источнике WebView2.

NavigationKind получает тип навигации для каждого перехода, например Back/Forward, Reload или переход к новому документу.

Блокировка нежелательных переходов

Это NavigationStarting событие позволяет приложению отменить переход к указанным URL-адресам в WebView2, в том числе для фреймов.

С NavigationStarting помощью других событий навигации приложение может быть проинформировано о состоянии навигации в WebView2. Навигация — это процесс загрузки нового URL-адреса.

См. также:

Управление сетевыми запросами в WebView2

Это WebResourceRequested событие позволяет приложению перехватывать и переопределять все сетевые запросы в WebView2. Это WebResourceResponseReceived событие позволяет приложению отслеживать отправленный запрос и ответ, полученный из сети.

См. также:

Регистрация пользовательской схемы

Это CustomSchemeRegistration позволяет регистрировать пользовательские схемы в WebView2, чтобы приложение могло обрабатывать WebResourceRequested события для запросов к этим URL-адресам настраиваемых схем и перемещать WebView2 к таким URL-адресам.

Сертификаты клиентов

В WebView2 можно использовать API сертификата клиента для выбора сертификата клиента на уровне приложения. Этот API позволяет:

  • При желании отобразить пользовательский интерфейс.
  • Замена диалогового окна сертификата клиента по умолчанию.
  • Программный запрос сертификатов.
  • Выберите сертификат из списка, чтобы отвечать серверу, когда WebView2 делает запрос к HTTP-серверу, которому требуется сертификат клиента для HTTP-аутентификации.

Сертификаты сервера

В WebView2 можно использовать API сертификата сервера, чтобы доверять сертификату TLS сервера на уровне приложения. Таким образом, ведущее приложение может отрисовывать страницу, не уведомляя пользователя об ошибке TLS, или ваше ведущее приложение может автоматически отменить запрос.

Запуск схемы внешнего URI

Запустите схему URI, зарегистрированную в операционной системе.

Элементы iframe

Элементы iframe позволяют встраивать другие веб-страницы в собственные веб-страницы. В WebView2 вы можете:

  • Узнайте, когда создаются элементы iframe.
  • Узнайте, когда выполняется переход в iframe.
  • Разрешить обход параметров x-frame.

См. также:

Проверка подлинности

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

См. также:

Отрисовка WebView2 в приложениях, не относящихся к платформе

Используйте эти API для настройки системы отрисовки WebView2, если ваше ведущее приложение не использует платформу пользовательского интерфейса. Эта настройка отрисовки управляет тем, как WebView2 отображает выходные данные в хост-приложении, а WebView2 обрабатывает ввод, фокус и доступность.

Когда использовать эти API

  • Платформа пользовательского интерфейса — если вы используете платформу пользовательского интерфейса для своего приложения, вам следует использовать элемент WebView2, предоставляемый этой платформой пользовательского интерфейса, а не эти API.

  • Нет инфраструктуры пользовательского интерфейса и не используется композиция - Если вы не используете платформу пользовательского интерфейса для своего приложения (например, если вы используете чистый Win32 напрямую) или если ваша платформа пользовательского интерфейса не имеет элемента WebView2, вам необходимо создать CoreWebView2Controller и отобразить его в своем приложении, используя эти API в этом разделе.

  • Нет инфраструктуры пользовательского интерфейса и используется композиция — если пользовательский интерфейс приложения создан с помощью DirectComposition или Windows.UI.Composition, следует использовать CoreWebView2CompositionController вместо использования эти API; см. раздел Отрисовка WebView2 с помощью Composition ниже.

Размер, расположение и видимость

CoreWebView2Controller берет родителя HWND. Свойство Bounds определяет размеры и позиционирует WebView2 относительно родительского HWND. Видимость WebView2 можно переключать с помощью .IsVisible

Масштабирование

WebView2 ZoomFactor используется для масштабирования только веб-содержимого окна. Масштабирование пользовательского интерфейса также обновляется, когда пользователь увеличивает содержимое, нажимая клавишу CTRL и вращая колесико мыши.

Масштаб растеризации

API RasterizationScale масштабирует весь пользовательский интерфейс WebView2, включая контекстные меню, подсказки и всплывающие окна. Приложение может указать, должен ли WebView2 обнаруживать изменения масштаба монитора и автоматически обновлять RasterizationScale. BoundsMode используется для настройки того, интерпретируется ли свойство Bounds как необработанные пиксели или DIP (которые должны быть масштабированы с помощью RasterizationScale).

Фокус и клавиша TAB

Элемент управления WebView2 инициирует события, сообщающие приложению, когда элемент управления получает или теряет фокус. Для перехода с помощью клавиши TAB (нажатия клавиши TAB ) существует API для перемещения фокуса в WebView2 и событие для WebView2, запрашивающее возвращение фокуса в приложение.

Родительское окно

WebView2 может быть передан другому дескриптору родительского окна (HWND). WebView2 также необходимо уведомлять об изменении положения приложения на экране.

Ускорители клавиатуры

Когда WebView2 находится в фокусе, он напрямую получает входные данные от пользователя. Приложение может перехватывать и обрабатывать определенные сочетания клавиш (сочетания клавиш) или отключать обычное поведение сочетаний клавиш браузера.

См. также раздел " Включение и отключение браузера, реагирующего на сочетания клавиш" (сочетания клавиш) выше.

Цвет фона по умолчанию

WebView2 может указать цвет фона по умолчанию. Цвет может быть любого непрозрачного или прозрачного. Этот цвет будет использоваться, если на HTML-странице не задан собственный цвет фона.

См. также:

Отрисовка WebView2 с помощью Composition

Для рендеринга WebView2 на основе композиции используйте CoreWebView2Environment для создания .CoreWebView2CompositionController CoreWebView2CompositionController предоставляет те же API, что и CoreWebView2Controller, но также включает API для рендеринга на основе композиции.

Подключение к визуальному дереву

WebView2 может подключить свое дерево композиции к IDCompositionVisual, IDCompositionTarget или Windows::UI::Composition::ContainerVisual.

Переадресация ввода

Пространственный ввод (мышь, сенсорный ввод, перо) принимается приложением и должен быть отправлен в WebView2. WebView2 уведомляет приложение, когда курсор должен быть обновлен в зависимости от положения мыши.

Разрешить прохождение сообщений о событиях ввода через окно браузера

Позволяет сообщениям о событиях ввода данных пользователя (клавиатуре, мыши, сенсорном вводе или пере) проходить через окно браузера и поступать в окно процесса приложения.

Перетаскивание

По умолчанию поддерживается перетаскивание из элемента управления WebView2 в другое приложение. Однако для перетаскивания к элементу управления WebView2 требуется, чтобы когда ведущее приложение получает IDropTarget событие из системы, ведущее приложение перенаправляло это событие в элемент управления WebView2. Перетаскивание к элементу управления WebView2 включает в себя операции перетаскивания, которые полностью находятся в элементе управления WebView2.

Используйте следующие API-интерфейсы для пересылки IDropTarget событий из системы в элемент управления WebView2.

Специальные возможности

По умолчанию WebView2 отображается в дереве специальных возможностей как дочерний элемент родительского HWND для приложений Win32/C++. WebView2 предоставляет API для лучшего позиционирования содержимого WebView2 относительно других элементов в приложении.

Не применимо.

Параметры среды

Данные пользователя

Управление папкой пользовательских данных (UDF), которая является папкой на компьютере пользователя. Функция UDF содержит данные, связанные с ведущим приложением и WebView2. Приложения WebView2 используют папки с данными пользователя для хранения данных браузера, таких как файлы cookie, разрешения и кэшированные ресурсы.

См. также:

Очистка данных браузера:

Несколько профилей

Управление несколькими профилями в одной папке данных пользователя.

См. также:

Создайте объект options, определяющий профиль:

Создайте элемент управления WebView2, использующий профиль:

Получать доступ к профилю и управлять им:

Удаление профиля

Приложение может удалять профили пользователей для элемента управления WebView2 в веб-браузере.

См. также:

Выбор среды выполнения

Выбор среды выполнения поддерживает предварительное тестирование и самостоятельное размещение. При создании среды WebView2:

  • Чтобы задать порядок поиска для каналов предварительной версии браузера, используйте свойство CoreWebView2EnvironmentOptions.ChannelSearchKind .
  • Чтобы указать, какие каналы предварительных версий браузера будут выполняться, используйте свойство CoreWebView2EnvironmentOptions.ReleaseChannels .

См. также:

Производительность и отладка

Анализируйте и отлаживайте производительность, обрабатывайте события, связанные с производительностью, и управляйте использованием памяти, чтобы повысить скорость отклика вашего приложения.

Целевой показатель использования памяти

Указывает уровни потребления памяти, такие как low или normal.

Chrome DevTools Protocol (CDP)

Chrome DevTools Protocol (CDP) предоставляет API-интерфейсы для инструментария, проверки, отладки и профилирования браузеров на основе Chromium. Протокол Chrome DevTools — это основа для Microsoft Edge DevTools. Используйте протокол Chrome DevTools для функций, которые не реализованы на платформе WebView2.

См. также:

Открыто:

Звоните:

Приемник:

См. также