Freigeben über

Schnittstelle IDualEngine20Browser

  • Artikel

Wichtig

Die DualEngine-API ist Teil eines Features mit eingeschränktem Zugriff (siehe LimitedAccessFeatures-Klasse). Wenn Sie weitere Informationen oder ein Entsperrtoken anfordern möchten, wenden Sie sich an Microsoft-Support.

interface IDualEngine20Browser
  : public IUnknown

Stellt eine Registerkarte "Internet Explorer" dar.

Zusammenfassung

Members Beschreibungen
DualEngineBrowserCommitted Benachrichtigt den Browser, dass ein Commit ausgeführt wurde und nicht mehr spekulativ ist.
DualEngineClose Schließt die browser-instance.
DualEngineDeleteTabRecoveryData Löscht Tab-Wiederherstellungsdaten.
DualEngineDoOnBeforeUnloadAndStop Beendet alle navigationsvorgänge, die gerade ausgeführt werden, und führt die onBeforeUnload Handler aus.
DualEngineDPIChanged Benachrichtigt, dass dpi geändert wurde und das Seitenlayout neu berechnet werden sollte.
DualEngineEnableCaretMode Aktiviert oder deaktiviert den Caret-Browsermodus.
DualEngineExecNavigationCommand Führt einen Navigationsbefehl aus.
DualEngineFindOnPage Sucht eine instance von Text auf der Seite.
DualEngineForceClose Schließt den browserbasierten instance.
DualEngineGeolocationPermissionResponse Stellt eine Antwort auf eine Geolocation-Berechtigungsanforderung bereit.
DualEngineGoToEntry Navigiert zu einem bestimmten Reiseprotokolleintrag.
DualEngineInitialize Initialisiert das Browserobjekt mit einer URL.
DualEngineInitialize2 Initialisiert das Browserobjekt mit einer URL. Diese Version ermöglicht es, zusätzliche Informationen zur anfänglichen Navigation zu übergeben.
DualEngineInitializeWithRecoveryData Initialisiert das Browserobjekt mithilfe von Tabstopp-Wiederherstellungsdaten.
DualEngineLostFocus Benachrichtigt den Browser, dass er den Fokus verloren hat.
DualEngineNavigate Navigiert zu einer URL.
DualEngineNavigate2 Navigiert zu einer URL mit zusätzlichen Informationen zur Navigation.
DualEngineNotifyNavigationEntriesDeleted Benachrichtigt, dass Navigationseinträge gelöscht wurden.
DualEnginePrepareToExitRegion Benachrichtigt den Browser, dass eine Navigation zu einer Seite erfolgt, die vom Host verarbeitet wird.
DualEnginePrint Ruft das Dialogfeld Drucken für die aktuelle Seite auf.
DualEngineProtectFocus Steuert, ob der Browser versucht, den Fokus auf sich selbst zu ändern.
DualEngineSavePageAs Ruft das Dialogfeld Webseite speichern für die aktuelle Seite auf.
DualEngineSetEngineSwitchingPolicyFlags Legt Flags fest, die bestimmen, wie der Browser den Engine-Wechsel behandelt.
DualEngineSetFocus Legt den Fokus innerhalb des gehosteten Browsers fest.
DualEngineSetMediaFullscreen Ändert den Vollbildzustand der Medien, die im Browser wiedergegeben werden.
DualEngineSetPosition Legt die Größe und Position des Browserfensters fest.
DualEngineSetTheaterFullscreen Ändert den Status des Theatermodus des Browsers.
DualEngineSetTheaterMargins Passt den oberen Rand des Browserfensters an, wenn es im Theatermodus angezeigt wird.
DualEngineSetVisible Benachrichtigt den Browser über eine Änderung der Sichtbarkeit.
DualEngineSetWindowStyle Ändert den Stil des Browserfensters.
DualEngineSetZoom Ändert den Zoomwert des Browsers.
DualEngineSimulateKeyInput Sendet eine simulierte Schlüsseleingabe.
DualEngineSimulateMouseInput Sendet eine simulierte Mauseingabe.
DualEngineStopFindOnPage Beendet den Suchvorgang.
DualEngineTranslateAccelerator Verarbeitet eine Zugriffstastenmeldung.

Gilt für

Produkt Eingeführt
Windows 10, Version 20H1 KB5032278
Windows 11, Version 22H2 KB5032288

Members

DualEngineBrowserCommitted

Benachrichtigt den Browser, dass ein Commit ausgeführt wurde und nicht mehr spekulativ ist.

public HRESULT DualEngineBrowserCommitted()

DualEngineClose

Schließt die browser-instance.

public HRESULT DualEngineClose()

DualEngineDeleteTabRecoveryData

Löscht Tab-Wiederherstellungsdaten.

public HRESULT DualEngineDeleteTabRecoveryData(REFGUID guidTabId)

Parameter
  • guidTabId Die GUID für die zu löschende Quellwiederherstellungsdatendatei.

DualEngineDoOnBeforeUnloadAndStop

Beendet alle navigationsvorgänge, die gerade ausgeführt werden, und führt die onBeforeUnload Handler aus.

public HRESULT DualEngineDoOnBeforeUnloadAndStop()

DualEngineDPIChanged

Benachrichtigt, dass dpi geändert wurde und das Seitenlayout neu berechnet werden sollte.

public HRESULT DualEngineDPIChanged()

DualEngineEnableCaretMode

Aktiviert oder deaktiviert den Caret-Browsermodus.

public HRESULT DualEngineEnableCaretMode(BOOL fEnable)

Parameter
  • fEnable Gibt an, ob das Caretbrowsen aktiviert werden soll.

DualEngineExecNavigationCommand

Führt einen Navigationsbefehl aus.

public HRESULT DualEngineExecNavigationCommand(NAVIGATION_COMMAND Command)

Parameter
  • command Der auszuführende Navigationsbefehl.

DualEngineFindOnPage

Sucht eine instance von Text auf der Seite.

public HRESULT DualEngineFindOnPage(int iRequestID, LPCWSTR pszFindText, BOOL fFindNext, BOOL fForward)

Parameter

  • iRequestID Eine ID zum Verwenden der korrelierten Suche auf Seitenanforderungen und -ereignissen.

  • pszFindText Der Text, der auf der Seite gesucht werden soll.

  • fFindNextGibt an, ob die Auswahl zum nächsten instance den Suchtext verschoben werden soll, true die Auswahl und false nicht.

  • fForward Gibt die Richtung an, in die die Auswahl angewendet werden soll, true bewegt sich vorwärts und false rückwärts.

DualEngineForceClose

Schließt den browserbasierten instance.

public HRESULT DualEngineForceClose()

DualEngineGeolocationPermissionResponse

Stellt eine Antwort auf eine Geolocation-Berechtigungsanforderung bereit.

public HRESULT DualEngineGeolocationPermissionResponse(LPCWSTR pszUri, SITE_PERMISSION_RESPONSE antwort)

Parameter

  • pszUri Der URI, von dem die Geolocation-Anforderung stammt.

  • response Die Antwort auf die Anforderung.

DualEngineGoToEntry

Navigiert zu einem bestimmten Reiseprotokolleintrag.

public HRESULT DualEngineGoToEntry(ULONG ulEntryId)

Parameter
  • ulEntryId Die Eintrags-ID des Reiseprotokolls, zu der navigiert werden soll.

DualEngineInitialize

Initialisiert das Browserobjekt mit einer URL.

public HRESULT DualEngineInitialize(IDualEngine20BrowserObserver * pDualEngineObserver, DUALENGINECONFIGURATION config, EngineSwitchingPolicyFlags engineSwitchingPolicyFlags, SentinelEntryInfo sentinelEntryInfo, LPCWSTR pszUrl, HWND hwndHost, HWND * phwnd)

Parameter

  • pDualEngineObserver Ein Zeiger auf den Beobachter für diesen Browser.

  • config Konfigurationsflags für das gewünschte Browserverhalten.

  • engineSwitchingPolicyFlags Flags, die bestimmen, wie der Motorwechsel gehandhabt wird.

  • sentinelEntryInfoDie Anzahl der Verlaufselemente vor und nach der anfänglichen Navigation für diesen instance.

  • pszUrl Die anfängliche URL, zu der navigiert werden soll.

  • hwndHost Der HWND des Hostfensters, dem das Browserfenster zugeordnet wird.

  • phwnd Der HWND des Browserfensters.

DualEngineInitialize2

Initialisiert das Browserobjekt mit einer URL. Diese Version ermöglicht es, zusätzliche Informationen zur anfänglichen Navigation zu übergeben.

public HRESULT DualEngineInitialize2(IDualEngine20BrowserObserver * pDualEngineObserver, DUALENGINECONFIGURATION config, EngineSwitchingPolicyFlags engineSwitchingPolicyFlags, SentinelEntryInfo sentinelEntryInfo, LPCWSTR pszUrl, HWND hwndHost, HWND * phwnd, LPCWSTR pszReferrer, LPCWSTR pszHeaders, VARIANT * postData)

Parameter

  • pDualEngineObserver Ein Zeiger auf den Beobachter für diesen Browser.

  • config Konfigurationsflags für das gewünschte Browserverhalten.

  • engineSwitchingPolicyFlags Flags, die bestimmen, wie der Motorwechsel gehandhabt wird.

  • sentinelEntryInfoDie Anzahl der Verlaufselemente vor und nach der anfänglichen Navigation für diesen instance.

  • pszUrl Die anfängliche URL, zu der navigiert werden soll.

  • hwndHost Der HWND des Hostfensters, dem das Browserfenster zugeordnet wird.

  • phwnd Der HWND des Browserfensters.

  • pszReferrer Der HTTP-Referer-Anforderungsheader für die anfängliche Navigation.

  • pszHeaders Zusätzliche Header, die für die anfängliche Navigation an den Server gesendet werden sollen.

  • postData Daten, die im Rahmen einer HTTP POST-Transaktion für die anfängliche Navigation an den Server gesendet werden sollen.

DualEngineInitializeWithRecoveryData

Initialisiert das Browserobjekt mithilfe von Tabstopp-Wiederherstellungsdaten.

public HRESULT DualEngineInitializeWithRecoveryData(REFGUID guidTabId, ULONG ulEntryId, IDualEngine20BrowserObserver * pDualEngineObserver, DUALENGINECONFIGURATION config, EngineSwitchingPolicyFlags engineSwitchingPolicyFlags, SentinelEntryInfo sentinelEntryInfo, LPCWSTR pszUrl, HWND hwndHost, HWND * phwnd)

Parameter

  • guidTabIdDie GUID für die Quellwiederherstellungsdatendatei, mit der diese instance initialisiert werden soll.

  • ulEntryId Die ID des Eintrags im Reiseprotokoll, zu dem nach der Wiederherstellung navigiert werden soll.

  • pDualEngineObserver Ein Zeiger auf den Beobachter für diesen Browser.

  • config Konfigurationsflags für das gewünschte Browserverhalten.

  • engineSwitchingPolicyFlags Flags, die bestimmen, wie der Motorwechsel gehandhabt wird.

  • sentinelEntryInfoDie Anzahl der Verlaufselemente vor und nach der anfänglichen Navigation für diesen instance.

  • pszUrl Die anfängliche URL, zu der navigiert werden soll.

  • hwndHost Der HWND des Hostfensters, dem das Browserfenster zugeordnet wird.

  • phwnd Der HWND des Browserfensters.

DualEngineLostFocus

Benachrichtigt den Browser, dass er den Fokus verloren hat.

public HRESULT DualEngineLostFocus(HWND hwndLostFocus)

Parameter
  • hwndLostFocus Das Fenster, in das der Fokus verschoben wird.

DualEngineNavigate

Navigiert zu einer URL.

public HRESULT DualEngineNavigate(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload)

Parameter

  • pszUrl Die URL, zu der navigiert werden soll.

  • fSkipOnBeforeUnload Gibt an, ob die Behandlung übersprungen onBeforeUnload werden soll.

DualEngineNavigate2

Navigiert zu einer URL mit zusätzlichen Informationen zur Navigation.

public HRESULT DualEngineNavigate2(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload, LPCWSTR pszReferrer, LPCWSTR pszHeaders, VARIANT * postData)

Parameter

  • pszUrl Die URL, zu der navigiert werden soll.

  • fSkipOnBeforeUnload Gibt an, ob die Behandlung übersprungen onBeforeUnload werden soll.

  • pszReferrer Der HTTP-Referer-Anforderungsheader für diese Navigation.

  • pszHeaders Zusätzliche Header, die für diese Navigation an den Server gesendet werden sollen.

  • postData Daten, die im Rahmen einer HTTP POST-Transaktion für diese Navigation an den Server gesendet werden sollen.

DualEngineNotifyNavigationEntriesDeleted

Benachrichtigt, dass Navigationseinträge gelöscht wurden.

public HRESULT DualEngineNotifyNavigationEntriesDeleted(BOOL fShouldDeleteEntries, SentinelEntryInfo sentinelEntryInfo)

Parameter

  • fShouldDeleteEntries Gibt an, ob der Browser alle Einträge in der Liste löschen soll.

  • sentinelEntryInfoDie Anzahl der Verlaufselemente vor und nach der anfänglichen Navigation für diesen instance.

DualEnginePrepareToExitRegion

Benachrichtigt den Browser, dass eine Navigation zu einer Seite erfolgt, die vom Host verarbeitet wird.

public HRESULT DualEnginePrepareToExitRegion(EXIT_REGION_TYPE type)

Parameter
  • type Der Navigationstyp, der diese Beendigung verursacht.

DualEnginePrint

Ruft das Dialogfeld Drucken für die aktuelle Seite auf.

public HRESULT DualEnginePrint()

DualEngineProtectFocus

Steuert, ob der Browser versucht, den Fokus auf sich selbst zu ändern.

public HRESULT DualEngineProtectFocus(BOOL fProtectFocus)

Parameter
  • fProtectFocus Gibt truean, dass der Browser nicht versucht, den Fokus zu stehlen, wenn false, ist das Stehlen des Fokus zulässig.

DualEngineSavePageAs

Ruft das Dialogfeld Webseite speichern für die aktuelle Seite auf.

public HRESULT DualEngineSavePageAs()

DualEngineSetEngineSwitchingPolicyFlags

Legt Flags fest, die bestimmen, wie der Browser den Engine-Wechsel behandelt.

public HRESULT DualEngineSetEngineSwitchingPolicyFlags(EngineSwitchingPolicyFlags engineSwitchingPolicyFlags)

Parameter
  • engineSwitchingPolicyFlags Flags, die das gewünschte Engine-Schaltverhalten darstellen.

DualEngineSetFocus

Legt den Fokus innerhalb des gehosteten Browsers fest.

public HRESULT DualEngineSetFocus(DUALENGINE_FOCUSDIRECTION focusDirection)

Parameter
  • focusDirection Die Richtung, in der sich der Fokus im Browser bewegt.

DualEngineSetMediaFullscreen

Ändert den Vollbildzustand der Medien, die im Browser wiedergegeben werden.

public HRESULT DualEngineSetMediaFullscreen(BOOL fFullscreen)

Warnung

Trotz ihres Namens beendet diese Funktion nur den Vollbildmodus und führt keine Aktion aus, wenn kein Medium im Vollbildmodus ist. Die Übergabe true an die Funktion ist immer ein No-Op.

Parameter
  • fFullscreen Wenn false, wird der Vollbildmodus beendet, wenn das Medium vollbildend ist; wenn true, geschieht nichts.

DualEngineSetPosition

Legt die Größe und Position des Browserfensters fest.

public HRESULT DualEngineSetPosition(int x, int y, int iWidth, int iHeight)

Parameter

  • x Die neue Position der linken Seite des Fensters in Clientkoordinaten.

  • y Die neue Position des oberen Fensters in Clientkoordinaten.

  • iWidth Die neue Breite des Fensters in Pixel.

  • iHeight Die neue Höhe des Fensters in Pixel.

DualEngineSetTheaterFullscreen

Ändert den Status des Theatermodus des Browsers.

public HRESULT DualEngineSetTheaterFullscreen(BOOL fFullscreen)

Im Theatermodus füllt das Browserfenster den gesamten Bildschirm aus und zeigt eine Symbolleiste mit einem minimalen Satz von Navigationsschaltflächen an. Eine status-Leiste befindet sich auch in der oberen rechten Ecke des Bildschirms. Explorer Balken, z. B. Verlauf und Favoriten, werden im Theatermodus als automatischer Einblendenbereich am linken Bildschirmrand angezeigt.

Parameter
  • fFullscreen Wenn true und derzeit nicht im Theatermodus, wechselt der Browser in den Theatermodus. Wenn false und derzeit im Theatermodus, beendet der Browser den Theatermodus.

DualEngineSetTheaterMargins

Passt den oberen Rand des Browserfensters an, wenn es im Theatermodus angezeigt wird.

public HRESULT DualEngineSetTheaterMargins(BOOL fTheaterShowing, int yTheaterThreshold)

Parameter

  • fTheaterShowing Gibt an, ob sich der Host derzeit im Theatermodus befindet.

  • yTheaterThreshold Die Größe des Rands zwischen dem oberen Bildschirmrand und dem Browserfenster im Vollbildmodus in Pixel.

DualEngineSetVisible

Benachrichtigt den Browser über eine Änderung der Sichtbarkeit.

public HRESULT DualEngineSetVisible(BROWSERVISIBILITY visibility)

Parameter
  • visibility Der Sichtbarkeitszustand, den wir eingeben.

DualEngineSetWindowStyle

Ändert den Stil des Browserfensters.

public HRESULT DualEngineSetWindowStyle(int wlStyle, int wlExStyle)

Parameter

  • wlStyle Der festzulegende Wert der Fensterformatvorlage.

  • wlExStyle Der festzulegende Wert erweiterter Windows-Stil.

DualEngineSetZoom

Ändert den Zoomwert des Browsers.

public HRESULT DualEngineSetZoom(int iZoomPercent)

Parameter
  • iZoomPercent Der Zoomprozentsatz, auf den der Browser festgelegt werden soll.

DualEngineSimulateKeyInput

Sendet eine simulierte Schlüsseleingabe.

public HRESULT DualEngineSimulateKeyInput(DWORD vKey, KEYACTION keyAction)

Parameter

  • vKey Der zu simulierende virtuelle Schlüsselcode.

  • keyAction Die wichtigste aktion, die simuliert werden soll.

DualEngineSimulateMouseInput

Sendet eine simulierte Mauseingabe.

public HRESULT DualEngineSimulateMouseInput(DWORD x, DWORD y, MOUSEACTION mouseAction)

Parameter

  • x Die x-Koordinate.

  • y Die y-Koordinate.

  • mouseAction Die zu simulierende Mausaktion.

DualEngineStopFindOnPage

Beendet den Suchvorgang.

public HRESULT DualEngineStopFindOnPage(BOOL fClean)

Parameter
  • fClean Gibt truean, dass die hervorgehobenen Ergebnisse und das aktuell ausgewählte Ergebnis gelöscht werden; wenn false, bleibt das aktuell ausgewählte Ergebnis ausgewählt.

DualEngineTranslateAccelerator

Verarbeitet eine Zugriffstastenmeldung.

public HRESULT DualEngineTranslateAccelerator(LPMSG lpMsg)

Parameter
  • lpMsg Ein Zeiger auf eine MSG-Struktur, die die zu übersetzende Nachricht angibt.