WebUIView Kelas

Definisi

Ruang nama:

Windows.UI.WebUI

Mewakili tampilan (jendela) aplikasi ke skrip latar belakang aplikasi.

public ref class WebUIView sealed : IWebViewControl, IWebViewControl2

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIView final : IWebViewControl, IWebViewControl2

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIView : IWebViewControl, IWebViewControl2

Public NotInheritable Class WebUIView
Implements IWebViewControl, IWebViewControl2

Warisan

Object Platform::Object IInspectable WebUIView

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Penerapan

IWebViewControl IWebViewControl2

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1809 (diperkenalkan dalam 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v7.0)

Contoh

Aplikasi Anda dapat mendengarkan peristiwa NewWebUIViewCreated untuk mencegat kontrol navigasi untuk tampilan baru (diekspos dari NewWebUIEventCreatedEventArgs.WebUIView):

Windows.UI.WebUI.WebUIApplication.addEventListener("newwebuiviewcreated", newWebUIViewCreatedEventHandler);

Keterangan

Windows 10 aplikasi web mendukung skrip latar belakang per aplikasi opsional yang dimulai sebelum tampilan diaktifkan dan berjalan selama proses. Dengan ini, Anda dapat memantau dan memodifikasi navigasi, melacak status di seluruh navigasi, memantau kesalahan navigasi, dan menjalankan kode sebelum tampilan diaktifkan.

Ketika skrip latar belakang ini ditentukan sebagai StartPage dalam manifes aplikasi Anda, setiap tampilan aplikasi (windows) diekspos ke skrip sebagai instans WebUIView kelas, menyediakan peristiwa, properti, dan metode yang sama sebagai WebView umum (Win32).

Ada beberapa perbedaan antara tampilan web HTML (x-ms-webview/MSHTMLWebViewElement) dan WebUIView kelas :

	Tampilan web HTML	Kelas WebUIView
Metode asinkron WebUIView	Mengembalikan objek MSWebViewAsyncOperation	Mengembalikan objek janji JavaScript
metode Navigate	MemerlukanURI dalam bentuk string	Memerlukan objek Windows.Foundation.Uri
metode InvokeScriptAsync	Argumen skrip ditentukan sebagai jumlah parameter string arbitrer	Argumen skrip ditentukan sebagai array string

Setiap aktivasi aplikasi dengan skrip latar belakang karena StartPage akan mengandalkan skrip itu sendiri untuk navigasi.

Properti

ApplicationViewId	Mendapatkan pengidentifikasi untuk tampilan ini.
CanGoBack	Mendapatkan nilai yang menunjukkan apakah setidaknya ada satu halaman dalam riwayat navigasi mundur.
CanGoForward	Mendapatkan nilai yang menunjukkan apakah setidaknya ada satu halaman dalam riwayat navigasi maju.
ContainsFullScreenElement	Mendapatkan nilai yang menunjukkan apakah tampilan berisi elemen yang mendukung layar penuh.
DefaultBackgroundColor	Mendapatkan atau mengatur warna yang akan digunakan sebagai latar belakang tampilan ketika konten HTML tidak menentukan warna.
DeferredPermissionRequests	Mendapatkan kumpulan permintaan izin yang menunggu untuk diberikan atau ditolak.
DocumentTitle	Mendapatkan judul halaman yang saat ini ditampilkan dalam tampilan.
IgnoreApplicationContentUriRulesNavigationRestrictions	Mendapatkan atau menetapkan nilai yang menentukan apakah akan mengabaikan aturan URI konten dan pembatasan navigasi.
Settings	Mendapatkan objek WebViewControlSettings yang berisi properti untuk mengaktifkan atau menonaktifkan fitur IWebViewControl.
Source	Mendapatkan atau mengatur sumber URI konten HTML untuk ditampilkan dalam kontrol.

Metode

AddInitializeScript(String)	Menambahkan skrip untuk menginisialisasi tampilan.
BuildLocalStreamUri(String, String)	Membuat URI yang dapat Anda berikan ke NavigateToLocalStreamUri
CapturePreviewToStreamAsync(IRandomAccessStream)	Membuat gambar konten tampilan saat ini dan menulisnya ke aliran yang ditentukan.
CaptureSelectedContentToDataPackageAsync()	Secara asinkron mendapatkan DataPackage yang berisi konten yang dipilih dalam kontrol.
CreateAsync()	Membuat tampilan baru sebagai tindakan asinkron.
CreateAsync(Uri)	Membuat tampilan baru dengan argumen tertentu, sebagai tindakan asinkron.
GetDeferredPermissionRequestById(UInt32, WebViewControlDeferredPermissionRequest)	Mengembalikan permintaan izin yang ditangguhkan dengan Id yang ditentukan.
GoBack()	Menavigasi ke halaman sebelumnya dalam riwayat navigasi.
GoForward()	Menavigasi ke halaman berikutnya dalam riwayat navigasi.
InvokeScriptAsync(String, IIterable<String>)	Menjalankan fungsi skrip yang ditentukan dari HTML yang saat ini dimuat, dengan argumen tertentu, sebagai tindakan asinkron.
Navigate(Uri)	Memuat konten HTML di Pengidentifikasi Sumber Daya Seragam (URI) yang ditentukan.
NavigateToLocalStreamUri(Uri, IUriToStreamResolver)	Memuat konten web lokal di URI yang ditentukan menggunakan IUriToStreamResolver.
NavigateToString(String)	Memuat konten HTML yang ditentukan sebagai dokumen baru.
NavigateWithHttpRequestMessage(HttpRequestMessage)	Menavigasi kontrol ke URI dengan permintaan POST dan header HTTP.
Refresh()	Memuat ulang isi saat ini dalam kontrol.
Stop()	Menghentikan navigasi atau unduhan kontrol saat ini.

Acara

Activated	Terjadi ketika tampilan diaktifkan.
Closed	Terjadi ketika tampilan telah ditutup.
ContainsFullScreenElementChanged	Terjadi ketika status apakah tampilan saat ini berisi elemen layar penuh atau tidak berubah.
ContentLoading	Terjadi ketika tampilan mulai memuat konten baru.
DOMContentLoaded	Peristiwa yang dipicu ketika tampilan telah selesai mengurai konten HTML saat ini.
FrameContentLoading	Terjadi ketika bingkai dalam tampilan mulai memuat konten baru.
FrameDOMContentLoaded	Terjadi ketika bingkai dalam tampilan telah selesai mengurai isi HTML saat ini.
FrameNavigationCompleted	Terjadi ketika kontrol telah selesai memuat isi saat ini atau jika navigasi gagal.
FrameNavigationStarting	Terjadi tepat sebelum tampilan menavigasi ke konten baru.
LongRunningScriptDetected	Peristiwa yang dipicu secara berkala saat kontrol menjalankan JavaScript, memungkinkan Anda menghentikan skrip.
NavigationCompleted	Terjadi ketika kontrol telah selesai memuat isi saat ini atau jika navigasi gagal.
NavigationStarting	Terjadi sebelum kontrol menavigasi ke konten baru.
NewWindowRequested	Terjadi ketika pengguna melakukan tindakan dalam kontrol yang menyebabkan konten dibuka di jendela baru.
PermissionRequested	Terjadi ketika tindakan dalam kontrol mengharuskan izin tersebut diberikan.
ScriptNotify	Terjadi ketika konten yang terkandung dalam kontrol meneruskan string ke aplikasi menggunakan JavaScript.
UnsafeContentWarningDisplaying	Terjadi ketika kontrol menunjukkan halaman peringatan untuk konten yang dilaporkan tidak aman oleh Filter LayarPintar.
UnsupportedUriSchemeIdentified	Terjadi ketika upaya dilakukan untuk menavigasi ke URI menggunakan skema yang tidak didukung kontrol.
UnviewableContentIdentified	Peristiwa yang dipicu ketika kontrol mencoba mengunduh file yang tidak didukung.
WebResourceRequested	Peristiwa yang diaktifkan saat permintaan HTTP dibuat.