Bagikan melalui


WebUIView Kelas

Definisi

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
Penerapan

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.

Berlaku untuk