WinUI 2 (UWP) アプリの WebView2 には、次の考慮事項が適用されます。 WebView2 WinUI 2 (UWP) コントロールは開発中です。
詳細な内容:
- オートフィル UI
- PDF に印刷
- 既定の印刷
- SmartScreen
- ファイルのダウンロード
- XAML の制限
- DefaultBackgroundColor の設定
- 透明度の設定
- CSS カーソル
- Microsoft Edge 開発者ツール
- API の制限事項
- 関連項目
オートフィル UI
オートフィル UI は、UWP アプリの WebView2 にはまだ実装されていません。
関連項目:
- 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 property (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; や cursor: crosshair; などの定義済みカーソルの一部に変更できますが、 cursor: progress や cursor: none などの他のカーソルには変更できません。
| Keyword | サポートの有無 |
|---|---|
| 全般: | |
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 では、Microsoft Edge DevTools はストア署名済みの WebView2 WinUI 2 (UWP) アプリ内で起動できません。 ただし、リモート デバッグを使用してこれを回避できます。 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 リポジトリ: