Skip to content

Commit bd825b1

Browse files
authored
Add AllowHostInputProcessing in "Overview of WebView2 APIs" (#3496)
* incoming * add to Detailed Contents * remove minor nav blocks
1 parent b078be0 commit bd825b1

1 file changed

Lines changed: 25 additions & 84 deletions

File tree

microsoft-edge/webview2/concepts/overview-features-apis.md

Lines changed: 25 additions & 84 deletions
Original file line numberDiff line numberDiff line change
@@ -87,6 +87,7 @@ when adding an h4 heading, add nav link below the h2
8787
* [Rendering WebView2 using Composition](#rendering-webview2-using-composition)
8888
* [Connecting to the visual tree](#connecting-to-the-visual-tree)
8989
* [Forwarding input](#forwarding-input)
90+
* [Allow input event messages to pass through the browser window](#allow-input-event-messages-to-pass-through-the-browser-window)
9091
* [Drag and drop](#drag-and-drop)
9192
* [Accessibility](#accessibility)
9293
* [Environment options](#environment-options)
@@ -170,13 +171,6 @@ See also:
170171

171172
The Microsoft Edge WebView2 control lets you embed web content into native applications. You can communicate between native code and web code using simple messages, JavaScript code, and native objects. The following are the main APIs for communicating between web and native code.
172173

173-
**Subsections below:**
174-
* [Host/web object sharing](#hostweb-object-sharing)
175-
* [Script execution](#script-execution)
176-
* [Web messaging](#web-messaging)
177-
* [Script dialogs](#script-dialogs)
178-
* [Shared buffer](#shared-buffer)
179-
180174
Common use cases for web/native interop:
181175
* Update the native host window title after navigating to a different website.
182176
* Send a native camera object and use its methods from a web app.
@@ -546,38 +540,6 @@ See also:
546540

547541
The WebView2 control gives your app access to many browser features. You can modify these browser features and turn them on or off.
548542

549-
**Subsections below:**
550-
* [Printing](#printing)
551-
* [Cookies](#cookies)
552-
* [Image capture](#image-capture)
553-
* [Control whether the screen capture UI is shown](#control-whether-the-screen-capture-ui-is-shown)
554-
* [Downloads](#downloads)
555-
* [Save as](#save-as)
556-
* [Web notification handling](#web-notification-handling)
557-
* [Permissions](#permissions)
558-
* [Context menus](#context-menus)
559-
* [Status bar](#status-bar)
560-
* [Fluent overlay scrollbars](#fluent-overlay-scrollbars)
561-
* [User Agent](#user-agent)
562-
* [Autofill](#autofill)
563-
* [Audio](#audio)
564-
* [Hit-testing of mouse-clicks in regions](#hit-testing-of-mouse-clicks-in-regions)
565-
* [Swipe gesture navigation](#swipe-gesture-navigation)
566-
* [Enable or disable the browser responding to accelerator keys (shortcut keys)](#enable-or-disable-the-browser-responding-to-accelerator-keys-shortcut-keys)
567-
* [Fullscreen](#fullscreen)
568-
* [PDF toolbar](#pdf-toolbar)
569-
* [Theming](#theming)
570-
* [Language](#language)
571-
* [New window](#new-window)
572-
* [Close window](#close-window)
573-
* [Document title](#document-title)
574-
* [Favicon](#favicon)
575-
* [Security and privacy](#security-and-privacy)
576-
* [Tracking prevention](#tracking-prevention)
577-
* [SmartScreen](#smartscreen)
578-
* [Custom crash reporting](#custom-crash-reporting)
579-
* [Browser extensions](#browser-extensions)
580-
581543

582544
<!-- ------------------------------ -->
583545
#### Printing
@@ -1963,9 +1925,6 @@ See also:
19631925

19641926
Get information about running WebView2 processes, exiting processes, and failed processes, so that your app can take action accordingly.
19651927

1966-
**Subsections below:**
1967-
* [Frame process info](#frame-process-info)
1968-
19691928
##### [.NET/C#](#tab/dotnetcsharp)
19701929

19711930
* `CoreWebView2` Class:
@@ -2104,18 +2063,6 @@ The Frame Process Info API, including `GetProcessExtendedInfos`, provides a snap
21042063

21052064
Through the WebView2 control, your app can manage navigation to webpages and manage content that's loaded in the webpages.
21062065

2107-
**Subsections below:**
2108-
* [Manage content loaded into WebView2](#manage-content-loaded-into-webview2)
2109-
* [Navigation history](#navigation-history)
2110-
* [Navigation kind](#navigation-kind)
2111-
* [Block unwanted navigating](#block-unwanted-navigating)
2112-
* [Navigation events](#navigation-events)
2113-
* [Manage network requests in WebView2](#manage-network-requests-in-webview2)
2114-
* [Custom scheme registration](#custom-scheme-registration)
2115-
* [Client certificates](#client-certificates)
2116-
* [Server certificates](#server-certificates)
2117-
* [Launch an external URI scheme](#launch-an-external-uri-scheme)
2118-
21192066

21202067
<!-- ------------------------------ -->
21212068
#### Manage content loaded into WebView2
@@ -2671,17 +2618,6 @@ Use these APIs to set up the WebView2 rendering system if your host app doesn't
26712618

26722619
* **No UI framework, and using Composition** - If your app UI is built using [DirectComposition](/windows/win32/directcomp/directcomposition-portal) or [Windows.UI.Composition](/uwp/api/Windows.UI.Composition), you should use `CoreWebView2CompositionController` rather than using these APIs; see [Rendering WebView2 using Composition](#rendering-webview2-using-composition), below.
26732620

2674-
2675-
**Subsections below:**
2676-
* [Sizing, positioning, and visibility](#sizing-positioning-and-visibility)
2677-
* [Zooming](#zooming)
2678-
* [Rasterization scale](#rasterization-scale)
2679-
* [Focus and tabbing](#focus-and-tabbing)
2680-
* [Parent window](#parent-window)
2681-
* [Keyboard accelerators](#keyboard-accelerators)
2682-
* [Default background color](#default-background-color)
2683-
2684-
26852621
##### [.NET/C#](#tab/dotnetcsharp)
26862622

26872623
* `CoreWebView2Controller` Class:
@@ -2962,13 +2898,6 @@ See also:
29622898

29632899
For composition-based WebView2 rendering, use `CoreWebView2Environment` to create a `CoreWebView2CompositionController`. `CoreWebView2CompositionController` provides the same APIs as `CoreWebView2Controller`, but also includes APIs for composition-based rendering.
29642900

2965-
**Subsections below:**
2966-
* [Connecting to the visual tree](#connecting-to-the-visual-tree)
2967-
* [Forwarding input](#forwarding-input)
2968-
* [Drag and drop](#drag-and-drop)
2969-
* [Accessibility](#accessibility)
2970-
2971-
29722901
##### [.NET/C#](#tab/dotnetcsharp)
29732902

29742903
* [CoreWebView2CompositionController Class](/dotnet/api/microsoft.web.webview2.core.corewebview2compositioncontroller)
@@ -3066,6 +2995,30 @@ https://learn.microsoft.com/microsoft-edge/webview2/reference/winrt/microsoft_we
30662995
---
30672996

30682997

2998+
<!-- ------------------------------ -->
2999+
#### Allow input event messages to pass through the browser window
3000+
3001+
Allows user input event messages (keyboard, mouse, touch, or pen) to pass through the browser window, to be received by an app process window.
3002+
3003+
##### [.NET/C#](#tab/dotnetcsharp)
3004+
3005+
* `CoreWebView2ControllerOptions` Class:
3006+
* [CoreWebView2ControllerOptions.AllowHostInputProcessing Property](/dotnet/api/microsoft.web.webview2.core.corewebview2controlleroptions.allowhostinputprocessing)
3007+
3008+
##### [WinRT/C#](#tab/winrtcsharp)
3009+
3010+
* `CoreWebView2ControllerOptions` Class:
3011+
* [CoreWebView2ControllerOptions.AllowHostInputProcessing Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2controlleroptions)
3012+
3013+
##### [Win32/C++](#tab/win32cpp)
3014+
3015+
* [ICoreWebView2ControllerOptions4](/microsoft-edge/webview2/reference/win32/icorewebview2controlleroptions4)
3016+
* [ICoreWebView2ControllerOptions4::get_AllowHostInputProcessing](/microsoft-edge/webview2/reference/win32/icorewebview2controlleroptions4#get_allowhostinputprocessing)
3017+
* [ICoreWebView2ControllerOptions4::put_AllowHostInputProcessing](/microsoft-edge/webview2/reference/win32/icorewebview2controlleroptions4#put_allowhostinputprocessing)
3018+
3019+
---
3020+
3021+
30693022
<!-- ------------------------------ -->
30703023
#### Drag and drop
30713024

@@ -3125,20 +3078,12 @@ Not applicable.
31253078
<!-- ====================================================================== -->
31263079
## Environment options
31273080

3128-
**Subsections below:**
3129-
* [User data](#user-data)
3130-
* [Runtime selection](#runtime-selection)
3131-
31323081

31333082
<!-- ------------------------------ -->
31343083
#### User data
31353084

31363085
Manage the user data folder (UDF), which is a folder on the user's machine. The UDF contains data related to the host app and WebView2. WebView2 apps use user data folders to store browser data, such as cookies, permissions, and cached resources.
31373086

3138-
**Subsections below:**
3139-
* [Multiple profiles](#multiple-profiles)
3140-
* [Delete a profile](#delete-a-profile)
3141-
31423087
See also:
31433088
* [Manage user data folders](./user-data-folder.md)
31443089
* [Clear browsing data from the user data folder](./clear-browsing-data.md)
@@ -3374,10 +3319,6 @@ See also:
33743319

33753320
Analyze and debug performance, handle performance-related events, and manage memory usage to increase the responsiveness of your app.
33763321

3377-
**Subsections below:**
3378-
* [Memory usage target](#memory-usage-target)
3379-
3380-
33813322
##### [.NET/C#](#tab/dotnetcsharp)
33823323

33833324
* `CoreWebView2` Class:

0 commit comments

Comments
 (0)