Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Внедрение элемента управления WebView2 в приложение предоставляет приложению доступ к различным функциям браузера через методы и свойства, предоставляемые классами или интерфейсами WebView2.
WebView2 имеет сотни API, которые предоставляют широкий набор возможностей, начиная от расширения возможностей собственной платформы вашего приложения и заканчивая возможностью вашего приложения изменять интерфейсы браузера. В этой статье представлена высокоуровневая группировка API WebView2, чтобы помочь вам понять различные действия, которые можно выполнять с помощью WebView2.
Подробное содержание:
- Обзор функциональных областей верхнего уровня
- Основные классы: среда, контроллер и ядро
- Взаимодействие в Интернете и нативном коде
-
Функции браузера
- Печать
- Файлы cookie
- Захват изображения
- Find
- Загружаемые файлы
- Сохранить как
- Обработка веб-уведомлений
- Разрешения
- Контекстные меню
- Строка состояния
- Полосы прокрутки наложения Fluent
- Агент пользователя
- Автозаполнение
- Audio
- Тестирование щелчков мышью в регионах
- Навигация с помощью жеста прокрутки
- Включить или отключить браузер, реагирующий на сочетания клавиш (сочетания клавиш)
- Полноэкранный режим
- Панель инструментов PDF
- Визуальные темы
- Language
- Новое окно
- Закрытие окна
- Название документа
- Фавикон
- Безопасность и конфиденциальность
- Расширения браузера
- Управление процессами
- Включить фоновую обработку и автономную поддержку (API рабочих сценариев WebView2)
- Переход к страницам и управление загруженным контентом
- Элементы iframe
- Проверка подлинности
- Отрисовка WebView2 в приложениях, не относящихся к платформе
- Отрисовка WebView2 с помощью Composition
- Параметры среды
- Производительность и отладка
- Chrome DevTools Protocol (CDP)
- См. также
Обзор функциональных областей верхнего уровня
При размещении элемента управления 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класса создаются пары экземпляровCoreWebView2ControllerandCoreWebView2.Этот
CoreWebView2Controllerкласс отвечает за функциональные возможности, связанные с размещением, такие как фокус окна, видимость, размер и ввод данных, в которых ваше приложение размещает элемент управления WebView2.Этот
CoreWebView2класс предназначен для веб-части элемента управления WebView2, включая сеть, навигацию, скрипты, а также анализ и визуализацию HTML.
См. также:
Взаимодействие в Интернете и нативном коде
Элемент управления Microsoft Edge WebView2 позволяет внедрять веб-контент в собственные приложения. Вы можете взаимодействовать между машинным кодом и веб-кодом с помощью простых сообщений, кода JavaScript и собственных объектов. Ниже приведены основные API для взаимодействия между веб-кодом и машинным кодом.
Распространенные варианты использования веб- и нативного взаимодействия:
- Обновите заголовок окна собственного узла после перехода на другой веб-сайт.
- Отправка собственного объекта камеры и использование его методов из веб-приложения.
- Запустите выделенный файл JavaScript на веб-стороне приложения.
См. также:
- Взаимодействие машинного и веб-кода
- Вызов веб-кода из нативного кода
- Вызов нативного кода из веб-кода
- Вызов собственного кода WinRT из веб-кода
-
API JavaScript в WebView2 для
window.chrome.webviewAPI JavaScript
Общий доступ к узлам и веб-объектам
WebView2 позволяет передавать объекты, определенные в машинном коде, в веб-код приложения. Объекты узла — это любые объекты, определенные в машинном коде, который вы решили передать в веб-код вашего приложения.
Хост-объекты могут быть проецированы в JavaScript, так что вы можете вызывать методы собственных объектов (или другие API) из веб-кода вашего приложения. Например, приложение может вызывать такие API в результате взаимодействия с пользователем на веб-стороне приложения. Таким образом, вам не нужно повторно реализовывать API ваших собственных объектов, таких как методы или свойства, в веб-коде.
-
CoreWebView2Класс: -
CoreWebView2SettingsКласс:
Выполнение сценария
Позволяет основному приложению добавлять код JavaScript в содержимое веб-сайта в элементе управления WebView2.
-
CoreWebView2Класс: - Класс CoreWebView2ExecuteScriptResult
-
CoreWebView2FrameКласс: - Класс CoreWebView2ScriptException
-
CoreWebView2SettingsКласс:
Обмен сообщениями в Интернете
Приложение может отправлять сообщения веб-содержимому, находящемуся в элементе управления WebView2, и получать сообщения из этого веб-содержимого. Сообщения отправляются в виде строк или объектов JSON.
При необходимости можно публиковать и получать объекты DOM вместе с сообщением с помощью additionalObjects параметра PostWebMessageAsJson (.NET, WinRT) или ( PostWebMessageAsJsonWithAdditionalObjects Win32). Класс WebView2 CoreWebView2FileSystemHandle представляет DOM FileSystemHandleи CoreWebView2File представляет DOM File. См. также chrome.webview.postMessageWithAdditionalObjects в справочнике по JavaScript.
CoreWebView2Класс:CoreWebView2FrameКласс:CoreWebView2SettingsКласс:CoreWebView2EnvironmentКласс:CoreWebView2FileSystemHandleКласс:Перечисление CoreWebView2FileSystemHandleKind
FileDirectory
Перечисление CoreWebView2FileSystemHandlePermission
ReadOnlyReadWrite
Диалоговые окна сценариев
При размещении WebView2 приложение может управлять различными диалоговыми окнами JavaScript, подавлять их или заменять их пользовательскими диалоговыми окнами.
Общий буфер
API SharedBuffer поддерживает совместное использование буферов между процессом ведущего приложения WebView2 и процессом отрисовки WebView2 на основе общей памяти ОС.
См. также:
-
CoreWebView2Класс: -
CoreWebView2EnvironmentКласс: -
CoreWebView2FrameКласс: - Класс CoreWebView2SharedBuffer
-
CoreWebView2SharedBufferAccess Enum
ReadOnlyReadWrite
Функции браузера
Управление WebView2 предоставляет приложению доступ ко многим функциям браузера. Вы можете изменять эти функции браузера, включать и отключать их.
Печать
Вы можете распечатать веб-страницу на принтере, в PDF-файле или потоке PDF, настроив пользовательские параметры печати.
См. также:
-
CoreWebView2Класс: -
CoreWebView2EnvironmentКласс: - Класс CoreWebView2PrintSettings
- Перечисление CoreWebView2PrintDialogKind
- Перечисление CoreWebView2PrintStatus
Файлы cookie
В WebView2 можно использовать файлы cookie для управления сеансами пользователей, хранения параметров персонализации пользователей и отслеживания их поведения.
См. также:
-
CoreWebView2Класс: - Класс CoreWebView2Cookie
- Класс CoreWebView2CookieManager
-
CoreWebView2ProfileКласс:
Захват изображения
Благодаря размещению WebView2 приложение может делать снимки экрана и указывать формат, который следует использовать для сохранения изображения.
-
CoreWebView2Класс:
Управление отображением пользовательского интерфейса захвата экрана
Событие ScreenCaptureStarting возникает каждый раз, когда WebView2 и (или) iframe, соответствующий CoreWebView2Frame (или любому из его дочерних элементов iframe), запрашивают разрешение на использование API записи экрана до отображения пользовательского интерфейса. Затем приложение может заблокировать отображение пользовательского интерфейса или разрешить отображение пользовательского интерфейса.
CoreWebView2Класс:CoreWebView2FrameКласс:CoreWebView2NonClientRegionKindПеречисление:
Поиск
API поиска позволяет программно управлять операциями поиска и позволяет добавить в приложение следующие функции:
- Настройте параметры поиска, в том числе термин поиска, учет регистра, сопоставление Word, выделение совпадений и подавление пользовательского интерфейса по умолчанию.
- Находите текстовые строки и перемещайтесь по ним в элементе управления WebView2.
- Программно инициируйте операции поиска и переходите по результатам поиска .
- Отключение интерфейса поиска по умолчанию.
- Отслеживание состояния операций поиска .
Существуют известные проблемы с API поиска для документов PDF. При просмотре PDF-документа в элементе управления WebView2 функция поиска в настоящее время предоставляет только первый индекс и число найденных совпадений. Например, если строка встречается в PDF-файле три раза, пользовательский интерфейс будет показывать 1/3 и не будет поддерживать вызов команд "Далее " и " Назад" программным путем.
Мы активно исследуем эти проблемы и рекомендуем сообщать о любых проблемах, с которыми вы столкнулись, с помощью репозитория WebView2Feedback .
CoreWebView2Класс:CoreWebView2EnvironmentКласс:-
- Свойство CoreWebView2Find.ActiveMatchIndex
- Событие CoreWebView2Find.ActiveMatchIndexChanged
- CoreWebView2Find.FindNext — метод
- CoreWebView2Find.FindPrevious — метод
- CoreWebView2Find.MatchCount - свойство
- Событие CoreWebView2Find.MatchCountChanged
- Метод CoreWebView2Find.StartAsync
- Метод CoreWebView2Find.Stop
Загрузки
Ваше приложение может управлять скачиванием в WebView2. Приложение может:
- Разрешение или блокировка скачивания на основе различных метаданных.
- Изменение расположения скачивания.
- Настройте пользовательский пользовательский пользовательский интерфейс загрузки.
- Настройте пользовательский интерфейс по умолчанию.
Общая информация:
-
CoreWebView2Класс:
Изменение интерфейса по умолчанию:
-
CoreWebView2Класс: -
CoreWebView2ProfileКласс:
Пользовательский интерфейс скачивания:
Сохранить как
API "Сохранить как" позволяют программно выполнять операцию "Сохранить как ". С помощью этих API можно заблокировать диалоговое окно "Сохранить как " по умолчанию, а затем создать собственный пользовательский интерфейс для сохранения документа. Эти API относятся только к диалоговому окну "Сохранить как ", а не к диалоговому окну "Загрузка ", в котором используются API загрузки.
CoreWebView2Класс:Перечисление CoreWebView2SaveAsKind
CompleteDefaultHtmlOnlySingleFile
CoreWebView2SaveAsUIResult Enum
CancelledFileAlreadyExistsInvalidPathKindNotSupportedSuccess
Класс CoreWebView2SaveAsUIShowingEventArgs
- Свойство CoreWebView2SaveAsUIShowingEventArgs.AllowReplace
- Свойство CoreWebView2SaveAsUIShowingEventArgs.Cancel
- CoreWebView2SaveAsUIShowingEventArgs.ContentMimeType - свойство
- Свойство CoreWebView2SaveAsUIShowingEventArgs.Kind
- Свойство CoreWebView2SaveAsUIShowingEventArgs.SaveAsFilePath
- Свойство CoreWebView2SaveAsUIShowingEventArgs.SuppressDefaultDialog
- CoreWebView2SaveAsUIShowingEventArgs.GetDeferral - метод
Настройка предупреждения системы безопасности при сохранении файла
Прослушивая SaveFileSecurityCheckStarting событие, приложение может зарегистрировать обработчик для этого события, чтобы получить информацию о пути к файлу, расширении имени файла и URI источника документа. Затем вы можете применить собственные правила для выполнения действий, например:
- Разрешить сохранение файла без предоставления пользовательского интерфейса предупреждения о безопасности по умолчанию для политики типов файлов.
- Отмените сохранение.
- Создайте собственный пользовательский интерфейс для управления политиками типов файлов среды выполнения.
CoreWebView2Класс:Класс CoreWebView2SaveFileSecurityCheckStartingEventArgs
- Свойство CoreWebView2SaveFileSecurityCheckStartingEventArgs.CancelSave
- Свойство CoreWebView2SaveFileSecurityCheckStartingEventArgs.DocumentOriginUri
- Свойство CoreWebView2SaveFileSecurityCheckStartingEventArgs.FileExtension
- Свойство CoreWebView2SaveFileSecurityCheckStartingEventArgs.FilePath
- Свойство CoreWebView2SaveFileSecurityCheckStartingEventArgs.SuppressDefaultPolicy
- Метод CoreWebView2SaveFileSecurityCheckStartingEventArgs.GetDeferral
Обработка веб-уведомлений
API веб-уведомлений поддерживают непостоянные уведомления. Событие NotificationReceived для CoreWebView2 управления обработкой веб-уведомлений, что позволяет приложению узла настраивать или подавлять их. Необработанные уведомления по умолчанию используются в пользовательском интерфейсе WebView2.
CoreWebView2Класс:Класс CoreWebView2Notification
- CoreWebView2Notification.BadgeUri - свойство
- Свойство CoreWebView2Notification.Body
- Свойство CoreWebView2Notification.BodyImageUri
- Свойство CoreWebView2Notification.Direction
- Свойство CoreWebView2Notification.IconUri
- Свойство CoreWebView2Notification.IsSilent
- Свойство CoreWebView2Notification.Language
- CoreWebView2Notification.RequiresInteraction - свойство
- Свойство CoreWebView2Notification.ShouldRenotify
- Свойство CoreWebView2Notification.Tag
- Свойство CoreWebView2Notification.Timestamp
- Свойство CoreWebView2Notification.Title
- Свойство CoreWebView2Notification.VibrationPattern
- Метод CoreWebView2Notification.ReportClicked
- CoreWebView2Notification.ReportClosed - метод
- CoreWebView2Notification.ReportShown - метод
- Событие CoreWebView2Notification.CloseRequested
Перечисление CoreWebView2TextDirectionKind
DefaultLeftToRightRightToLeft
Разрешения
Разные веб-страницы могут запрашивать у вас разрешения на доступ к некоторым привилегированным ресурсам, таким как датчик геолокации, камера и микрофон. Ведущее приложение может программно отвечать на запросы разрешений и может заменять пользовательский интерфейс разрешений по умолчанию собственным пользовательским интерфейсом.
-
CoreWebView2Класс: -
CoreWebView2FrameКласс: - Перечисление CoreWebView2PermissionKind
-
CoreWebView2PermissionRequestedEventArgsКласс: - Класс CoreWebView2PermissionSetting
-
CoreWebView2ProfileКласс:
Контекстные меню
Элемент управления WebView2 предоставляет контекстное меню по умолчанию (контекстное меню), которое можно настроить или отключить, а также можно создать собственное контекстное меню.
См. также:
-
CoreWebView2Класс: - Класс CoreWebView2ContextMenuItem
- Класс CoreWebView2ContextMenuRequestedEventArgs
- Класс CoreWebView2ContextMenuTarget
-
CoreWebView2EnvironmentКласс: -
CoreWebView2SettingsКласс:
Строка состояния
Строка состояния находится в левом нижнем углу страницы и показывает состояние отображаемой веб-страницы. В WebView2 можно включить или отключить строку состояния, получить текст в строке состояния и узнать, изменился ли текст в строке состояния.
-
CoreWebView2Класс: -
CoreWebView2SettingsКласс:
Полосы прокрутки наложения Fluent
Стилизует полосы прокрутки под дизайн Microsoft Fluent и накладывает полосы прокрутки поверх веб-содержимого. Этот дизайн адаптивной полосы прокрутки адаптируется к различным устройствам и размерам окон.
Чтобы поэкспериментировать с полосами прокрутки наложения Fluent, в Microsoft Edge перейдите к полосам edge://flagsпрокрутки наложения Fluent и введите их.
См. также:
- Флаги -
msEdgeFluentOverlayScrollbarбраузера WebView2 иmsOverlayScrollbarWinStyleфлаги.
CoreWebView2EnvironmentOptionsКласс:Перечисление CoreWebView2ScrollbarStyle
DefaultFluentOverlay
Агент пользователя
Агент пользователя — это строка, представляющая удостоверение программы от имени пользователя, например имя браузера. В WebView2 можно настроить агент пользователя.
См. также:
- Определение Windows 11 и архитектуры ЦП с помощью User-Agent клиентских подсказок
- Переопределение строки агента пользователя
-
CoreWebView2SettingsКласс:
Автозаполнение
Приложение может самостоятельно управлять включением функции автозаполнения браузера для получения общих сведений или для паролей.
-
CoreWebView2SettingsКласс:
"Audio" (Аудио);
Приложение может отключать и включать любой звук, а также узнавать, когда он воспроизводится.
Тестирование щелчков мышью в регионах
Предоставляет результаты тестирования на попадание в областях, содержащихся в WebView2. Полезно для визуальных приложений, которые хотят обрабатывать события мыши в неклиентской области окна WebView2.
CoreWebView2CompositionControllerКласс:CoreWebView2NonClientRegionChangedEventArgsКласс:CoreWebView2NonClientRegionKind перечисление
CaptionClientNowhere
CoreWebView2SettingsКласс:
Навигация с помощью жеста прокрутки
С помощью элемента управления WebView2 приложение может включать и выключать навигацию с помощью жеста прокрутки на устройствах с поддержкой сенсорного ввода. Этот жест позволяет конечным пользователям:
- Проведите пальцем влево или вправо (по горизонтали), чтобы перейти к предыдущей или следующей странице журнала переходов.
- Потяните, чтобы обновить (проведите пальцем по вертикали) текущую страницу.
В настоящее время эта функция по умолчанию отключена в браузере. Чтобы включить эту функцию в WebView2, задайте свойство AdditionalBrowserArguments , указав --pull-to-refresh переключатель.
-
CoreWebView2SettingsКласс: -
CoreWebView2EnvironmentOptionsКласс:
Включить или отключить браузер, реагирующий на сочетания клавиш (сочетания клавиш)
ICoreWebView2AcceleratorKeyPressedEventArgs имеет свойство IsBrowserAcceleratorKeyEnabled , позволяющее вам контролировать, обрабатывает ли браузер сочетания клавиш (сочетания клавиш), такие как Ctrl+P или F3.
См. также:
- Ускорители клавиатуры ниже.
-
CoreWebView2AcceleratorKeyPressedEventArgsКласс:
Полноэкранный режим
В WebView2 можно узнать, когда элемент HTML переходит в полноэкранный режим или покидает его.
Панель инструментов PDF
В верхней части средства просмотра PDF-файлов браузера есть специальная панель инструментов для PDF-файлов. В WebView2 можно скрыть некоторые элементы на панели инструментов средства просмотра PDF.
-
CoreWebView2SettingsКласс:
Темы
В WebView2 вы можете настроить такую цветовую тему, как системная, светлая или темная.
-
CoreWebView2ProfileКласс:
Язык
Это Language свойство задает язык интерфейса по умолчанию для WebView2, который применяется к пользовательскому интерфейсу браузера (например, к контекстным меню и диалоговым окнам), а также задает accept-language заголовок HTTP, который WebView2 отправляет на веб-сайты.
Это ScriptLocale свойство позволяет основному приложению устанавливать языковой стандарт по умолчанию для всех Intl API JavaScript и других API JavaScript, которые от него зависят, например Intl.DateTimeFormat(), который влияет на форматирование строк в форматах времени и даты.
-
CoreWebView2EnvironmentOptionsКласс: -
CoreWebView2ControllerOptionsКласс:
Новое окно
WebView2 предоставляет функциональность для обработки функции window.open()JavaScript .
Закрытие окна
WebView2 предоставляет функциональность для обработки функции window.close()JavaScript .
-
CoreWebView2Класс: -
CoreWebView2ControllerКласс:
Название документа
Приложение может обнаружить, когда изменилось название текущего документа верхнего уровня.
-
CoreWebView2Класс:
Фавикон
В WebView2 можно настроить фавикон для веб-сайта или получать уведомления об изменениях.
-
CoreWebView2Класс:
Безопасность и конфиденциальность
Блокировка отслеживания
Блокировка отслеживания позволяет приложению-организатору управлять уровнем блокировки отслеживания элемента управления WebView2, связанного с профилем пользователя.
-
CoreWebView2EnvironmentOptionsКласс: -
CoreWebView2ProfileКласс: -
Перечисление CoreWebView2TrackingPreventionLevel
NoneBasicBalancedStrict
Фильтр SmartScreen
Фильтр SmartScreen в Microsoft Defender ("SmartScreen") включен по умолчанию. Свойство IsReputationCheckingRequired определяет, включен ли фильтр SmartScreen.
Если вы не отключите фильтр SmartScreen, вы должны уведомить всех пользователей о том, что ваше программное обеспечение включает фильтр SmartScreen в Microsoft Defender, а также собирает и отправляет сведения о пользователе в корпорацию Майкрософт, как описано в заявлении о конфиденциальности корпорации Майкрософт и в фильтре SmartScreen в разделе "Пользовательские данные и конфиденциальность в Microsoft Edge".
См. также:
- SmartScreen в разделе "Данные и конфиденциальность" в WebView2.
-
CoreWebView2SettingsКласс:
Настраиваемые отчеты о сбоях
При сбое какого-либо процесса WebView2 создается один или несколько файлов минидампа, которые отправляются в корпорацию Майкрософт для диагностики. Используйте этот API для настройки отчетов о сбоях при запуске диагностики и анализе.
- Чтобы предотвратить отправку аварийных дампов в Майкрософт, задайте свойству
IsCustomCrashReportingEnabledзначениеfalse. - Чтобы найти аварийные дампы и выполнить с их помощью настройку, используйте свойство
CrashDumpFolderPath.
См. также:
- Настраиваемые отчеты о сбоях в разделе "Данные и конфиденциальность" в WebView2.
- Files Minidump
-
CoreWebView2EnvironmentOptionsКласс: -
CoreWebView2EnvironmentКласс:
Расширения браузера
Ваше приложение может внедрить элемент управления WebView2, использующий расширение Microsoft Edge. Расширение Microsoft Edge — это небольшое приложение, которое разработчики используют для добавления или изменения функций Microsoft Edge, чтобы улучшить работу пользователя в Интернете.
См. также:
CoreWebView2EnvironmentOptionsКласс:CoreWebView2ProfileКласс:
Управление процессами
Получите сведения о запущенных процессах WebView2, завершающихся процессах и неудавшихся процессах, чтобы приложение могло предпринять соответствующие действия.
-
CoreWebView2Класс: - Класс CoreWebView2BrowserProcessExitedEventArgs
-
CoreWebView2EnvironmentКласс: - Класс CoreWebView2ProcessFailedEventArgs
- Перечисление CoreWebView2ProcessFailedKind
- Перечисление CoreWebView2ProcessFailedReason
- Класс CoreWebView2ProcessInfo
Сведения о процессе фрейма
API сведений о процессе кадра, включая GetProcessExtendedInfos, предоставляет snapshot коллекцию всех кадров, которые активно выполняются в связанном процессе рендеринга. Этот API позволяет приложению определять, какая часть WebView2 потребляет ресурсы, такие как память или использование ЦП.
CoreWebView2EnvironmentКласс:CoreWebView2ProcessExtendedInfoКласс:CoreWebView2Класс:CoreWebView2FrameКласс:CoreWebView2FrameInfoКласс:
Включить фоновую обработку и автономную поддержку (API рабочих сценариев WebView2)
API рабочих сценариев WebView2 позволяют ведущим приложениям взаимодействовать с рабочими веб-процессами для разгрузки задач из основного потока, повышения скорости отклика и поддержки фоновых операций. К этим рабочим веб-процессам относятся выделенные сотрудники, общие рабочие процессы и служебные сценарии.
Эти API предоставляют следующие возможности:
- События жизненного цикла: Следить за созданием и уничтожением рабочих.
-
Интерфейсы обмена сообщениями: Общайтесь с работниками с помощью и
PostMessageWebMessageReceived; в частности:CoreWebView2ServiceWorker.PostWebMessageAsJsonCoreWebView2ServiceWorker.PostWebMessageAsStringCoreWebView2DedicatedWorker.PostWebMessageAsJsonCoreWebView2DedicatedWorker.PostWebMessageAsStringCoreWebView2ServiceWorker.WebMessageReceivedCoreWebView2DedicatedWorker.WebMessageReceivedchrome.webview.postMessage- Не:
chrome.webview.postMessageWithAdditionalObjects
- Управление работниками: Запрашивать и извлекать регистрации и экземпляры рабочих ролей.
-
CoreWebView2Класс:
-
Класс CoreWebView2DedicatedWorker
- Событие CoreWebView2DedicatedWorker.DedicatedWorkerCreated
- Событие CoreWebView2DedicatedWorker.Destroy
- CoreWebView2DedicatedWorker.PostWebMessageAsJson - метод
- CoreWebView2DedicatedWorker.PostWebMessageAsString - метод
- Свойство CoreWebView2DedicatedWorker.ScriptUri
- Событие CoreWebView2DedicatedWorker.WebMessageReceived
-
CoreWebView2FrameКласс:
-
CoreWebView2ProfileКласс:
-
Класс CoreWebView2ServiceWorkerRegistration
- Свойство CoreWebView2ServiceWorkerRegistration.ActiveServiceWorker
- Свойство CoreWebView2ServiceWorkerRegistration.Origin
- Свойство CoreWebView2ServiceWorkerRegistration.ScopeUri
- Событие CoreWebView2ServiceWorkerRegistration.ServiceWorkerActivated
- CoreWebView2ServiceWorkerRegistration.TopLevelOrigin - свойство
- Событие CoreWebView2ServiceWorkerRegistration.Unregistration
Переход к страницам и управление загруженным контентом
С помощью элемента управления WebView2 приложение может управлять переходом к веб-страницам и контентом, загружаемым на веб-страницы.
Управление контентом, загруженным в WebView2
Эти API загружают, останавливают загрузку и перезагружают содержимое в WebView2. Загружаемое содержимое может быть следующим:
- Содержимое из URL-адреса.
- Строка HTML.
- Локальное содержимое через сопоставление имени виртуального хоста с локальной папкой.
- Содержимое из созданного сетевого запроса.
См. также:
-
CoreWebView2Класс:- CoreWebView2.ClearVirtualHostNameToFolderMapping - метод
- Метод CoreWebView2.Navigate
- CoreWebView2.NavigateToString - метод
- CoreWebView2.NavigateWithWebResourceRequest - метод
- CoreWebView2.Reload - метод
- CoreWebView2.SetVirtualHostNameToFolderMapping - метод
- Метод CoreWebView2.Stop
- Событие CoreWebView2.WebResourceRequested
-
CoreWebView2SettingsКласс:
Журнал переходов
Методы журнала позволяют переходить назад и вперед в WebView2, а события журнала предоставляют сведения об изменениях в журнале и в текущем источнике WebView2.
Тип навигации
NavigationKind получает тип навигации для каждого перехода, например Back/Forward, Reload или переход к новому документу.
-
CoreWebView2NavigationStartingEventArgsКласс: - Перечисление CoreWebView2NavigationKind
Блокировка нежелательных переходов
Это NavigationStarting событие позволяет приложению отменить переход к указанным URL-адресам в WebView2, в том числе для фреймов.
-
CoreWebView2Класс:- Событие CoreWebView2.NavigationStarting
-
Событие CoreWebView2.FrameNavigationStarting — заменено; Использовать
CoreWebView2Frame.NavigationStartingвместо
-
CoreWebView2FrameКласс: - Класс CoreWebView2NavigationStartingEventArgs
События навигации
С NavigationStarting помощью других событий навигации приложение может быть проинформировано о состоянии навигации в WebView2.
Навигация — это процесс загрузки нового URL-адреса.
См. также:
-
CoreWebView2Класс:- Событие CoreWebView2.ContentLoading
- Событие CoreWebView2.DOMContentLoaded
-
Событие CoreWebView2.FrameNavigationCompleted — заменено; используйте
CoreWebView2Frame.NavigationCompletedвместо этого. - Событие CoreWebView2.NavigationCompleted
- Класс CoreWebView2ContentLoadingEventArgs
- Класс CoreWebView2DOMContentLoadedEventArgs
-
CoreWebView2FrameКласс: - Класс CoreWebView2NavigationCompletedEventArgs
Управление сетевыми запросами в WebView2
Это WebResourceRequested событие позволяет приложению перехватывать и переопределять все сетевые запросы в WebView2. Это WebResourceResponseReceived событие позволяет приложению отслеживать отправленный запрос и ответ, полученный из сети.
См. также:
CoreWebView2Класс:
Регистрация пользовательской схемы
Это CustomSchemeRegistration позволяет регистрировать пользовательские схемы в WebView2, чтобы приложение могло обрабатывать WebResourceRequested события для запросов к этим URL-адресам настраиваемых схем и перемещать WebView2 к таким URL-адресам.
- Класс CoreWebView2CustomSchemeRegistration
-
CoreWebView2EnvironmentOptionsКласс:
Сертификаты клиентов
В WebView2 можно использовать API сертификата клиента для выбора сертификата клиента на уровне приложения. Этот API позволяет:
- При желании отобразить пользовательский интерфейс.
- Замена диалогового окна сертификата клиента по умолчанию.
- Программный запрос сертификатов.
- Выберите сертификат из списка, чтобы отвечать серверу, когда WebView2 делает запрос к HTTP-серверу, которому требуется сертификат клиента для HTTP-аутентификации.
Сертификаты сервера
В WebView2 можно использовать API сертификата сервера, чтобы доверять сертификату TLS сервера на уровне приложения. Таким образом, ведущее приложение может отрисовывать страницу, не уведомляя пользователя об ошибке TLS, или ваше ведущее приложение может автоматически отменить запрос.
Запуск схемы внешнего URI
Запустите схему URI, зарегистрированную в операционной системе.
-
CoreWebView2Класс: -
Класс CoreWebView2LaunchingExternalUriSchemeEventArgs
- Свойство CoreWebView2LaunchingExternalUriSchemeEventArgs.Cancel
- Свойство CoreWebView2LaunchingExternalUriSchemeEventArgs.InitiatingOrigin
- Свойство CoreWebView2LaunchingExternalUriSchemeEventArgs.IsUserInitiated
- Свойство CoreWebView2LaunchingExternalUriSchemeEventArgs.Uri
- Метод CoreWebView2LaunchingExternalUriSchemeEventArgs.GetDeferral
Элементы iframe
Элементы iframe позволяют встраивать другие веб-страницы в собственные веб-страницы. В WebView2 вы можете:
- Узнайте, когда создаются элементы iframe.
- Узнайте, когда выполняется переход в iframe.
- Разрешить обход параметров x-frame.
См. также:
- Общий доступ к узлам и веб-объектам (см. выше)
- Использование фреймов в приложениях WebView2
- Отслеживание журнала навигации для вложенных элементов iframe (API FrameCreatedEvent) в архивных заметках о выпуске для SDK WebView2.
Проверка подлинности
Приложение может обрабатывать базовую проверку подлинности с помощью элемента управления WebView2. Обычная проверка подлинности — это особый подход к проверке подлинности, который является частью протокола HTTP.
См. также:
Отрисовка WebView2 в приложениях, не относящихся к платформе
Используйте эти API для настройки системы отрисовки WebView2, если ваше ведущее приложение не использует платформу пользовательского интерфейса. Эта настройка отрисовки управляет тем, как WebView2 отображает выходные данные в хост-приложении, а WebView2 обрабатывает ввод, фокус и доступность.
Когда использовать эти API
Платформа пользовательского интерфейса — если вы используете платформу пользовательского интерфейса для своего приложения, вам следует использовать элемент WebView2, предоставляемый этой платформой пользовательского интерфейса, а не эти API.
Нет инфраструктуры пользовательского интерфейса и не используется композиция - Если вы не используете платформу пользовательского интерфейса для своего приложения (например, если вы используете чистый Win32 напрямую) или если ваша платформа пользовательского интерфейса не имеет элемента WebView2, вам необходимо создать
CoreWebView2Controllerи отобразить его в своем приложении, используя эти API в этом разделе.Нет инфраструктуры пользовательского интерфейса и используется композиция — если пользовательский интерфейс приложения создан с помощью DirectComposition или Windows.UI.Composition, следует использовать
CoreWebView2CompositionControllerвместо использования эти API; см. раздел Отрисовка WebView2 с помощью Composition ниже.
-
CoreWebView2ControllerКласс: -
CoreWebView2EnvironmentКласс:
Размер, расположение и видимость
CoreWebView2Controller берет родителя HWND. Свойство Bounds определяет размеры и позиционирует WebView2 относительно родительского HWND. Видимость WebView2 можно переключать с помощью .IsVisible
-
CoreWebView2ControllerКласс:
Масштабирование
WebView2 ZoomFactor используется для масштабирования только веб-содержимого окна. Масштабирование пользовательского интерфейса также обновляется, когда пользователь увеличивает содержимое, нажимая клавишу CTRL и вращая колесико мыши.
-
CoreWebView2ControllerКласс: -
CoreWebView2SettingsКласс:
Масштаб растеризации
API RasterizationScale масштабирует весь пользовательский интерфейс WebView2, включая контекстные меню, подсказки и всплывающие окна. Приложение может указать, должен ли WebView2 обнаруживать изменения масштаба монитора и автоматически обновлять RasterizationScale.
BoundsMode используется для настройки того, интерпретируется ли свойство Bounds как необработанные пиксели или DIP (которые должны быть масштабированы с помощью RasterizationScale).
Фокус и клавиша TAB
Элемент управления WebView2 инициирует события, сообщающие приложению, когда элемент управления получает или теряет фокус. Для перехода с помощью клавиши TAB (нажатия клавиши TAB ) существует API для перемещения фокуса в WebView2 и событие для WebView2, запрашивающее возвращение фокуса в приложение.
Родительское окно
WebView2 может быть передан другому дескриптору родительского окна (HWND). WebView2 также необходимо уведомлять об изменении положения приложения на экране.
-
CoreWebview2ControllerКласс:
Ускорители клавиатуры
Когда WebView2 находится в фокусе, он напрямую получает входные данные от пользователя. Приложение может перехватывать и обрабатывать определенные сочетания клавиш (сочетания клавиш) или отключать обычное поведение сочетаний клавиш браузера.
См. также раздел " Включение и отключение браузера, реагирующего на сочетания клавиш" (сочетания клавиш) выше.
- Класс CoreWebView2AcceleratorKeyPressedEventArgs
-
CoreWebView2ControllerКласс: -
CoreWebView2SettingsКласс:
Цвет фона по умолчанию
WebView2 может указать цвет фона по умолчанию. Цвет может быть любого непрозрачного или прозрачного. Этот цвет будет использоваться, если на HTML-странице не задан собственный цвет фона.
См. также:
- Установка цвета фона по умолчанию при инициализации WebView2 (API DefaultBackgroundColor) в архивных заметках о выпуске для SDK WebView2.
CoreWebView2ControllerКласс:CoreWebView2ControllerOptionsКласс:
Отрисовка WebView2 с помощью Composition
Для рендеринга WebView2 на основе композиции используйте CoreWebView2Environment для создания .CoreWebView2CompositionController
CoreWebView2CompositionController предоставляет те же API, что и CoreWebView2Controller, но также включает API для рендеринга на основе композиции.
- Класс CoreWebView2CompositionController
-
CoreWebView2EnvironmentКласс:
Подключение к визуальному дереву
WebView2 может подключить свое дерево композиции к IDCompositionVisual, IDCompositionTarget или Windows::UI::Composition::ContainerVisual.
-
CoreWebView2CompositionControllerКласс:
Переадресация ввода
Пространственный ввод (мышь, сенсорный ввод, перо) принимается приложением и должен быть отправлен в WebView2. WebView2 уведомляет приложение, когда курсор должен быть обновлен в зависимости от положения мыши.
-
CoreWebView2CompositionControllerКласс: -
CoreWebView2EnvironmentКласс: - Класс CoreWebView2PointerInfo
Разрешить прохождение сообщений о событиях ввода через окно браузера
Позволяет сообщениям о событиях ввода данных пользователя (клавиатуре, мыши, сенсорном вводе или пере) проходить через окно браузера и поступать в окно процесса приложения.
-
CoreWebView2ControllerOptionsКласс:
Перетаскивание
По умолчанию поддерживается перетаскивание из элемента управления WebView2 в другое приложение. Однако для перетаскивания к элементу управления WebView2 требуется, чтобы когда ведущее приложение получает IDropTarget событие из системы, ведущее приложение перенаправляло это событие в элемент управления WebView2. Перетаскивание к элементу управления WebView2 включает в себя операции перетаскивания, которые полностью находятся в элементе управления WebView2.
Используйте следующие API-интерфейсы для пересылки IDropTarget событий из системы в элемент управления WebView2.
-
CoreWebView2CompositionControllerКласс:
Специальные возможности
По умолчанию WebView2 отображается в дереве специальных возможностей как дочерний элемент родительского HWND для приложений Win32/C++. WebView2 предоставляет API для лучшего позиционирования содержимого WebView2 относительно других элементов в приложении.
Параметры среды
Данные пользователя
Управление папкой пользовательских данных (UDF), которая является папкой на компьютере пользователя. Функция UDF содержит данные, связанные с ведущим приложением и WebView2. Приложения WebView2 используют папки с данными пользователя для хранения данных браузера, таких как файлы cookie, разрешения и кэшированные ресурсы.
См. также:
-
CoreWebView2EnvironmentКласс: -
CoreWebView2EnvironmentOptionsКласс:
Очистка данных браузера:
-
CoreWebView2ProfileКласс: - Перечисление CoreWebView2BrowsingDataKinds
Несколько профилей
Управление несколькими профилями в одной папке данных пользователя.
См. также:
Создайте объект options, определяющий профиль:
-
CoreWebView2EnvironmentКласс: - Класс CoreWebView2ControllerOptions
Создайте элемент управления WebView2, использующий профиль:
-
CoreWebView2EnvironmentКласс:
Получать доступ к профилю и управлять им:
-
CoreWebView2Класс: - Класс CoreWebView2Profile
Удаление профиля
Приложение может удалять профили пользователей для элемента управления WebView2 в веб-браузере.
См. также:
-
CoreWebView2ProfileКласс:
Выбор среды выполнения
Выбор среды выполнения поддерживает предварительное тестирование и самостоятельное размещение. При создании среды WebView2:
- Чтобы задать порядок поиска для каналов предварительной версии браузера, используйте свойство
CoreWebView2EnvironmentOptions.ChannelSearchKind. - Чтобы указать, какие каналы предварительных версий браузера будут выполняться, используйте свойство
CoreWebView2EnvironmentOptions.ReleaseChannels.
См. также:
- Переключение на предварительный канал для тестирования ожидаемых API и функций
- Предварительное тестирование с использованием каналов предварительных версий Microsoft Edge
- Самостоятельное размещение путем развертывания каналов с предварительными версиями каналов
CoreWebView2EnvironmentOptionsКласс:Перечисление CoreWebView2ChannelSearchKind
MostStableLeastStable
Перечисление CoreWebView2ReleaseChannels
NoneStableBetaDevCanary
Производительность и отладка
Анализируйте и отлаживайте производительность, обрабатывайте события, связанные с производительностью, и управляйте использованием памяти, чтобы повысить скорость отклика вашего приложения.
Целевой показатель использования памяти
Указывает уровни потребления памяти, такие как low или normal.
Chrome DevTools Protocol (CDP)
Chrome DevTools Protocol (CDP) предоставляет API-интерфейсы для инструментария, проверки, отладки и профилирования браузеров на основе Chromium. Протокол Chrome DevTools — это основа для Microsoft Edge DevTools. Используйте протокол Chrome DevTools для функций, которые не реализованы на платформе WebView2.
См. также:
- Использование протокола Chrome DevTools Protocol (CDP) в приложениях WebView2
- Chrome DevTools Protocol
Открыто:
-
CoreWebView2SettingsКласс: -
CoreWebView2Класс:
Звоните:
-
CoreWebView2Класс:
Приемник:
См. также
- Введение в Microsoft Edge WebView2
- Справочные материалы по API WebView2 — ссылки на API для дополнительных платформ и языков, например WinRT/C++ (COM).