以下注意事项适用于 WinUI 2 (UWP) 应用中的 WebView2。 WebView2 WinUI 2 (UWP) 控件正在开发中。
详细内容:
- 自动填充 UI
- 打印为 PDF 格式
- 默认打印
- SmartScreen
- 下载文件
- XAML 限制
- 设置 DefaultBackgroundColor
- 设置透明度
- CSS 光标
- Microsoft Edge 开发人员工具
- API 限制
- 另请参阅
自动填充 UI
尚未为适用于 UWP 应用的 WebView2 实现自动填充 UI。
另请参阅:
- WebView2 API 概述中的自动填充。
打印为 PDF
打印到 PDF 要求应用有权访问 UWP 中的可写位置,例如本地文件夹。 有关 UWP 可访问路径的完整列表,请参阅 文件访问权限。
另请参阅:
- WebView2API 概述中的打印。
默认打印
对于 UWP 应用,WebView2 已禁用默认打印。 但是,可以通过调用 CapturePreview来捕获和打印当前视区。
另请参阅:
- WebView2 API 概述中的图像捕获。
SmartScreen
WebView2 将应用程序中导航到的 URL 发送到 SmartScreen 服务,以确保客户保持安全。 如果要禁用此导航,可以通过环境变量执行此操作:
Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--disable-features=msSmartScreenProtection");
必须在创建之前 CoreWebView2 设置此环境变量,这在最初设置 WebView2.Source 属性 或最初调用 WebView2.EnsureCoreWebView2Async 方法 时发生。
下载文件
UWP 中 WebView2 的当前下载行为存在一些已知限制。
另存为
通过 另存为 保存文件正常工作,并且已为 UWP 应用的 WebView2 启用。 文件将保存在用户选择的文件夹中。
文件下载到哪个文件夹
如果主机不更改 ResultFilePath 已下载文件,则下载的文件将下载到具有 Downloads 该文件夹中应用程序包名称的子文件夹。
如果主机更改 ResultFilePath 已下载文件,则仅当应用默认有权访问该文件路径时,才会下载该文件。 如果要使用默认情况下应用无权访问的文件位置,则必须设置相应的功能。 请参阅 UWP 文档中的 应用功能声明 。
下载中心
禁止从下载中心打开文件和文件夹。 单击文件或文件夹图标不会打开相应的文件/文件夹。
另请参阅:
- WebView2 API 概述中的下载。
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; OR cursor: crosshair;,但不能更改为其他光标,如 cursor: progress OR cursor: none。
| 关键字 | 是否支持? |
|---|---|
| 常规: | |
auto |
是 ✔️ |
default |
是 ✔️ |
none |
否 ❌ |
| 链接和状态: | |
context-menu |
是 ✔️ |
help |
是 ✔️ |
pointer |
是 ✔️ |
progress |
否 ❌ |
wait |
是 ✔️ |
| 选择: | |
cell |
否 ❌ |
crosshair |
是 ✔️ |
text |
是 ✔️ |
vertical-text |
否 ❌ |
| 拖放: | |
alias |
否 ❌ |
copy |
否 ❌ |
move |
是 ✔️ |
no-drop |
是 ✔️ |
not-allowed |
是 ✔️ |
grab |
否 ❌ |
grabbing |
否 ❌ |
| 调整大小和滚动: | |
all-scroll |
是 ✔️ |
col-resize |
否 ❌ |
row-resize |
否 ❌ |
n-resize |
是 ✔️ |
e-resize |
是 ✔️ |
s-resize |
是 ✔️ |
w-resize |
是 ✔️ |
ne-resize |
是 ✔️ |
nw-resize |
是 ✔️ |
se-resize |
是 ✔️ |
sw-resize |
是 ✔️ |
ew-resize |
是 ✔️ |
ns-resize |
是 ✔️ |
nesw-resize |
是 ✔️ |
nwse-resize |
是 ✔️ |
| 缩放: | |
zoom-in |
否 ❌ |
zoom-out |
否 ❌ |
另请参阅:
- CSS 光标 - “值”部分描述了上述关键字 (keyword) 值。
Microsoft Edge 开发人员工具
在 WinUI 2 上,无法在应用商店签名的 WebView2 WinUI 2 (UWP) 应用中启动 Microsoft Edge 开发工具。 但是,可以通过使用远程调试来解决此问题。 请参阅 远程调试 WebView2 WinUI 2 (UWP) 应用。
API 限制
以下类在 WinUI 2 中不可访问:
CoreWebView2EnvironmentOptionsCoreWebView2ControllerOptions
另请参阅
- WebView2 API 概述中的自动填充。
- WebView2API 概述中的打印。
- WebView2 API 概述中的图像捕获。
- WebView2 API 概述中的下载。
- 远程调试 WebView2 WinUI 2 (UWP) 应用
API 参考:
- .NET: WebView2.DefaultBackgroundColor 属性
- Win32: ICoreWebView2Controller2::_getDefaultBackgroundColor
- Win32: ICoreWebView2Controller2::_putDefaultBackgroundColor
Windows 文档:
MDN:
- MDN 的光标 CSS 属性中的值。
WebView2Feedback 存储库: