WinUI 2 (UWP) アプリの WebView2
次の考慮事項は、WinUI 2 (UWP) アプリの WebView2 に適用されます。 WebView2 WinUI 2 (UWP) コントロールは開発中です。
オートフィル UI
自動入力 UI は、WebView2 for UWP アプリ用にまだ実装されていません。
関連項目:
- WebView2 API の概要のオートフィル。
PDF に印刷する
PDF に印刷するには、アプリが UWP の書き込み可能な場所 (ローカル フォルダーなど) にアクセスできる必要があります。 UWP でアクセス可能なパスの完全な一覧については、「 ファイル アクセス許可」を参照してください。
関連項目:
- WebView2 API の概要での印刷。
既定の印刷
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 カーソルは、 cursor: url(https://contoso.com/cursor.png), pointer;などのイメージ URL にすることはできません。 「 CSS - URL から読み込まれたカーソルが機能しない」を参照してください。
定義済みの CSS カーソル
WinUI 2 (UWP) では、定義済みの CSS カーソルの一部はサポートされていません。 CSS カーソルを使用すると、 cursor: wait; や cursor: crosshair;など、定義済みのカーソルの一部にカーソルを変更できますが、 cursor: progress や cursor: noneなど、他のカーソルには変更できません。
| Keyword | サポートの有無 |
|---|---|
| 全般 | |
| 自動 | ✔️ |
| default | ✔️ |
| none | ❌ |
| リンク & 状態 | |
| コンテキスト メニュー | ✔️ |
| help | ✔️ |
| ポインタ | ✔️ |
| progress | ❌ |
| 待つ | ✔️ |
| Selection | |
| セル | ❌ |
| 十字 | ✔️ |
| テキスト | ✔️ |
| vertical-text | ❌ |
| ドラッグ & ドロップ | |
| alias | ❌ |
| 写し | ❌ |
| move | ✔️ |
| no-drop | ✔️ |
| 許可されていません | ✔️ |
| グラブ | ❌ |
| つかんで | ❌ |
| スクロール & サイズ変更 | |
| all-scroll | ✔️ |
| col-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 | ✔️ |
| ズーミング | |
| ズームイン | ❌ |
| ズームアウト | ❌ |
関連項目:
- CSS カーソル - [値] セクションでは、上記のキーワード (keyword)値について説明します。
Microsoft Edge 開発者ツール
WinUI 2 では、ストア署名された WebView2 WinUI 2 (UWP) アプリ内で Microsoft Edge DevTools を起動できません。 ただし、リモート デバッグを使用してこれを回避できます。 「WebView2 WinUI 2 (UWP) アプリのリモート デバッグ」を参照してください。
API の制限事項
WinUI 2 では、次のクラスにアクセスできません。
CoreWebView2EnvironmentOptionsCoreWebView2ControllerOptions
関連項目
- WebView2 API の概要のオートフィル。
- WebView2 API の概要での印刷。
- WebView2 API の概要に関するページの画像キャプチャ。
- 「WebView2 API の概要」のダウンロード。
- WebView2 WinUI 2 (UWP) アプリのリモート デバッグ
API リファレンス:
- .NET: WebView2.DefaultBackgroundColor プロパティ
- Win32: ICoreWebView2Controller2::_getDefaultBackgroundColor
- Win32: ICoreWebView2Controller2::_putDefaultBackgroundColor
Windows ドキュメント:
MDN:
- MDN のカーソル CSS プロパティの値。
WebView2Feedback リポジトリ: