Freigeben über


WebUIView Klasse

Definition

Stellt eine Ansicht (Fenster) der App für das Hintergrundskript der Anwendung dar.

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
Vererbung
Object Platform::Object IInspectable WebUIView
Attribute
Implementiert

Windows-Anforderungen

Gerätefamilie
Windows 10, version 1809 (eingeführt in 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v7.0)

Beispiele

Ihre App kann auf das NewWebUIViewCreated-Ereignis lauschen, um die Steuerung der Navigation für eine neue Ansicht abzufangen (verfügbar gemacht über NewWebUIEventCreatedEventArgs.WebUIView):

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

Hinweise

Windows 10 Web-Apps unterstützen ein optionales Anwendungshintergrundskript, das gestartet wird, bevor Ansichten aktiviert werden, und wird für die Dauer des Prozesses ausgeführt. Damit können Sie Navigationsvorgänge überwachen und ändern, Zustände über Navigationsvorgänge hinweg nachverfolgen, Navigationsfehler überwachen und Code ausführen, bevor Ansichten aktiviert sind.

Wenn dieses Hintergrundskript als StartPage in Ihrem App-Manifest angegeben ist, werden alle Ansichten (Fenster) der App für das Skript als Instanzen der WebUIView -Klasse verfügbar gemacht, wobei dieselben Ereignisse, Eigenschaften und Methoden als allgemeine (Win32) WebView bereitgestellt werden.

Es gibt mehrere Unterschiede zwischen der HTML-Webansicht (x-ms-webview/MSHTMLWebViewElement) und der WebUIView -Klasse:

  HTML-Webansicht WebUIView-Klasse
Asynchrone WebUIView-Methoden Zurückgeben von MSWebViewAsyncOperation-Objekten Zurückgeben von JavaScript-Zusageobjekten
Navigate-Methode Erfordert einen URI in Form einer Zeichenfolge. Erfordert ein Windows.Foundation.Uri-Objekt
InvokeScriptAsync-Methode Skriptargumente werden als beliebige Anzahl von Zeichenfolgenparametern angegeben. Skriptargumente werden als Array von Zeichenfolgen angegeben.

Jede App-Aktivierung mit dem Hintergrundskript als StartPage ist für die Navigation auf das Skript selbst angewiesen.

Eigenschaften

ApplicationViewId

Ruft den Bezeichner für diese Ansicht ab.

CanGoBack

Ruft einen Wert ab, der angibt, ob im Rückwärtsnavigationsverlauf mindestens eine Seite vorhanden ist.

CanGoForward

Ruft einen Wert ab, der angibt, ob im Vorwärtsnavigationsverlauf mindestens eine Seite vorhanden ist.

ContainsFullScreenElement

Ruft einen Wert ab, der angibt, ob die Ansicht ein Element enthält, das den Vollbildmodus unterstützt.

DefaultBackgroundColor

Ruft die Farbe ab, die als Ansichtshintergrund verwendet werden soll, wenn der HTML-Inhalt keine Farbe angibt, oder legt diese fest.

DeferredPermissionRequests

Ruft eine Auflistung von Berechtigungsanforderungen ab, die darauf warten, gewährt oder verweigert zu werden.

DocumentTitle

Ruft den Titel der Seite ab, die derzeit in der Ansicht angezeigt wird.

IgnoreApplicationContentUriRulesNavigationRestrictions

Ruft einen Wert ab, der angibt, ob Inhalts-URI-Regeln und Navigationseinschränkungen ignoriert werden sollen, oder legt diesen fest.

Settings

Ruft ein WebViewControlSettings-Objekt ab, das Eigenschaften zum Aktivieren oder Deaktivieren von IWebViewControl-Features enthält.

Source

Ruft die URI-Quelle des HTML-Inhalts ab, der im Steuerelement angezeigt werden soll, oder legt diese fest.

Methoden

AddInitializeScript(String)

Fügt ein Skript zum Initialisieren der Ansicht hinzu.

BuildLocalStreamUri(String, String)

Erstellt einen URI, den Sie an NavigateToLocalStreamUri übergeben können.

CapturePreviewToStreamAsync(IRandomAccessStream)

Erstellt ein Bild des aktuellen Ansichtsinhalts und schreibt es in den angegebenen Stream.

CaptureSelectedContentToDataPackageAsync()

Ruft asynchron ein DataPackage ab , das den ausgewählten Inhalt im Steuerelement enthält.

CreateAsync()

Erstellt eine neue Ansicht als asynchrone Aktion.

CreateAsync(Uri)

Erstellt eine neue Ansicht mit bestimmten Argumenten als asynchrone Aktion.

GetDeferredPermissionRequestById(UInt32, WebViewControlDeferredPermissionRequest)

Gibt die Verzögerte Berechtigungsanforderung mit der angegebenen ID zurück.

GoBack()

Navigiert zur vorherigen Seite im Navigationsverlauf.

GoForward()

Navigiert zur nächsten Seite im Navigationsverlauf.

InvokeScriptAsync(String, IIterable<String>)

Führt die angegebene Skriptfunktion aus dem aktuell geladenen HTML-Code mit bestimmten Argumenten als asynchrone Aktion aus.

Navigate(Uri)

Lädt den HTML-Inhalt am angegebenen URI (Uniform Resource Identifier).

NavigateToLocalStreamUri(Uri, IUriToStreamResolver)

Lädt lokale Webinhalte am angegebenen URI mithilfe eines IUriToStreamResolvers.

NavigateToString(String)

Lädt den angegebenen HTML-Inhalt als neues Dokument.

NavigateWithHttpRequestMessage(HttpRequestMessage)

Navigiert das Steuerelement zu einem URI mit einer POST-Anforderung und HTTP-Headern.

Refresh()

Lädt den aktuellen Inhalt im Steuerelement neu.

Stop()

Hält die navigation oder den Download des aktuellen Steuerelements an.

Ereignisse

Activated

Tritt auf, wenn die Ansicht aktiviert wird.

Closed

Tritt auf, wenn die Ansicht geschlossen wurde.

ContainsFullScreenElementChanged

Tritt auf, wenn sich die status ändert, ob die Ansicht derzeit ein Vollbildelement enthält oder nicht.

ContentLoading

Tritt auf, wenn die Ansicht mit dem Laden neuer Inhalte beginnt.

DOMContentLoaded

Ein Ereignis, das ausgelöst wird, wenn die Ansicht die Analyse des aktuellen HTML-Inhalts abgeschlossen hat.

FrameContentLoading

Tritt auf, wenn ein Frame in der Ansicht mit dem Laden neuer Inhalte beginnt.

FrameDOMContentLoaded

Tritt auf, wenn ein Frame in der Ansicht den aktuellen HTML-Inhalt analysiert hat.

FrameNavigationCompleted

Tritt auf, wenn das Steuerelement das Laden des aktuellen Inhalts abgeschlossen hat oder wenn die Navigation fehlgeschlagen ist.

FrameNavigationStarting

Tritt ein, kurz bevor die Ansicht zu neuen Inhalten navigiert.

LongRunningScriptDetected

Ein Ereignis, das regelmäßig ausgelöst wird, während das Steuerelement JavaScript ausführt, sodass Sie das Skript anhalten können.

NavigationCompleted

Tritt auf, wenn das Steuerelement das Laden des aktuellen Inhalts abgeschlossen hat oder wenn die Navigation fehlgeschlagen ist.

NavigationStarting

Tritt auf, bevor das Steuerelement zu neuen Inhalten navigiert.

NewWindowRequested

Tritt auf, wenn ein Benutzer eine Aktion im Steuerelement ausführt, die bewirkt, dass Inhalte in einem neuen Fenster geöffnet werden.

PermissionRequested

Tritt auf, wenn eine Aktion im Steuerelement erfordert, dass diese Berechtigung erteilt werden muss.

ScriptNotify

Tritt auf, wenn der im Steuerelement enthaltene Inhalt eine Zeichenfolge mithilfe von JavaScript an die App übergibt.

UnsafeContentWarningDisplaying

Tritt auf, wenn das Steuerelement eine Warnseite für Inhalte anzeigt, die vom SmartScreen-Filter als unsicher gemeldet wurden.

UnsupportedUriSchemeIdentified

Tritt auf, wenn versucht wird, mit einem Schema, das vom Steuerelement nicht unterstützt wird, zu einem URI zu navigieren.

UnviewableContentIdentified

Ein Ereignis, das ausgelöst wird, wenn das Steuerelement versucht, eine nicht unterstützte Datei herunterzuladen.

WebResourceRequested

Ein Ereignis, das ausgelöst wird, wenn eine HTTP-Anforderung gestellt wird.

Gilt für: