Класс Microsoft. Web. WebView2. Core. CoreWebView2CompositionController

Примечание

Это экспериментальный API-интерфейс , который поставляется вместе с пакетом SDK предварительной версии. Ознакомьтесь с заметками о выпуске WebView2.

Пространство имен: Microsoft. Web. WebView2. Core
Сборка: Microsoft.Web.WebView2.Core.dll

Этот класс является расширением класса CoreWebView2Controller для поддержки визуального размещения.

Краткий обзор

Участников Описания
Cursor (Курсор) Текущий курсор, WebView рассчитает, что он должен быть.
CursorChanged Событие срабатывает, когда WebView считает, что курсор должен быть изменен.
RootVisualTarget RootVisualTarget — это визуальный элемент в визуальном дереве размещающего приложения.
UIAProvider Возвращает поставщик модели автоматизации пользовательского интерфейса для WebView.
CreateCoreWebView2PointerInfoFromPointerId Вспомогательная функция для преобразования pointerId, полученного из системы, в CoreWebView2PointerInfo.
SendMouseInput Если eventKind — CoreWebView2MouseEventKind. HorizontalWheel или CoreWebView2MouseEventKind. Wheel, то mouseData задает величину движения колесика.
SendPointerInput SendPointerInput принимает вводные данные и указатель пера для типов, определенных в CoreWebView2PointerEventKind.

Участников

Cursor (Курсор)

Текущий курсор, WebView рассчитает, что он должен быть.

Открытый курсор IntPtr

Курсор должен быть установлен в WM_SETCURSOR с помощью мыши. SetCursor или установлен на соответствующем родительском элементе/предок WebView через SetClassLongPtr. HCURSOR можно освободить таким образом, чтобы CopyCursor и DestroyCursor, чтобы сохранить собственную копию, если вы еще не настраиваете курсор.

CursorChanged

Событие срабатывает, когда WebView считает, что курсор должен быть изменен.

событие EventHandler< объект > CursorChanged

Например, если курсор мыши установлен по умолчанию, но затем перемещается поверх текста, он может попытаться перейти на курсор IBeam. Ожидается, что разработчик должен отправить CoreWebView2MouseEventKind. Leave сообщения (в дополнение к CoreWebView2MouseEventKind. Move messages) через API SendMouseInput. Это необходимо для того, чтобы убедиться в том, что указатель мыши находится в WebView, отправляющем события CursorChanged.

RootVisualTarget

RootVisualTarget — это визуальный элемент в визуальном дереве размещающего приложения.

общедоступный объект RootVisualTarget

Этот визуальный элемент — это то, где WebView будет подключаться к визуальному дереву. Приложение использует этот визуальный элемент, чтобы расположить WebView в приложении. Чтобы изменить размер WebView, приложению по-прежнему нужно использовать свойство Boundss. Свойством RootVisualTarget может быть IDCompositionVisual или Windows:: UI:: композиция:: ContainerVisual. WebView подключится к визуальному дереву для предоставленного визуального элемента перед возвратом из метода присваивания свойств. Приложение должно быть зафиксировано на своем устройстве, в котором задано свойство RootVisualTarget. Свойство RootVisualTarget поддерживает значение nullptr, чтобы отключить WebView от визуального дерева приложения.

UIAProvider

Возвращает поставщик модели автоматизации пользовательского интерфейса для WebView.

общедоступный объект UIAProvider

CreateCoreWebView2PointerInfoFromPointerId

Вспомогательная функция для преобразования pointerId, полученного из системы, в CoreWebView2PointerInfo.

общедоступные CoreWebView2PointerInfo CreateCoreWebView2PointerInfoFromPointerId(uint pointerId, IntPtr ParentWindow, Matrix4x4 Transform)

parentWindow — HWND, который содержит WebView. Это может быть любой HWND в дереве HWND, который включает WebView. CoreWebView2Matrix4x4 является преобразованием из HWND в WebView. Возвращенный CoreWebView2PointerInfo используется в SendPointerInfo. Тип указателя должен быть либо пером, либо сенсорным, либо функция завершится сбоем.

SendMouseInput

Если eventKind — CoreWebView2MouseEventKind. HorizontalWheel или CoreWebView2MouseEventKind. Wheel, то mouseData задает величину движения колесика.

Public void SendMouseInput(CoreWebView2MouseEventKind eventKind, CoreWebView2MouseEventVirtualKeys virtualKeys, uint mouseData, Point Point)

Положительное значение указывает на то, что колесико было повернуто вперед от пользователя; отрицательное значение указывает на то, что колесико было повернуто на обратном направлении к пользователю. Один щелчок мыши определяется как WHEEL_DELTA (120). Если eventKind — CoreWebView2MouseEventKind. XButtonDoubleClick CoreWebView2MouseEventKind. XButtonDown или CoreWebView2MouseEventKind. XButtonUp, mouseData указывает, какие кнопки X были нажаты или отпущены. Это значение должно быть 1, если первая кнопка X нажата/выпущена, и 2 при нажатии или отпускании второй кнопки X. Если eventKind — CoreWebView2MouseEventKind. Leave, virtualKeys, mouseData и Point должны равняться нулю. Если eventKind — любое другое значение, mouseData должно равняться нулю. Ожидается, что точка должна находиться в пространстве координат клиента WebView. Для отслеживания событий мыши, которые запускаются в WebView и потенциально могут перемещаться за пределы WebView и ведущего приложения, рекомендуется использовать вызов SetCapture и ReleaseCapture. Чтобы закрыть всплывающие окна, рекомендуется также отправить CoreWebView2MouseEventKind. Leave сообщения.

SendPointerInput

SendPointerInput принимает вводные данные и указатель пера для типов, определенных в CoreWebView2PointerEventKind.

общедоступная void SendPointerInput(CoreWebView2PointerEventKind eventKind, CoreWebView2PointerInfo pointerInfo)

Все входные данные указателя из системы должны быть преобразованы в CoreWebView2PointerInfo первыми.