WebUIView Klasse

Definition

Namespace:

Windows.UI.WebUI

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

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

IWebViewControl IWebViewControl2

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.