Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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
-
guidTabIdDie 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
-
fEnableGibt an, ob das Caretbrowsen aktiviert werden soll.
DualEngineExecNavigationCommand
Führt einen Navigationsbefehl aus.
public HRESULT DualEngineExecNavigationCommand(NAVIGATION_COMMAND Command)
Parameter
-
commandDer auszuführende Navigationsbefehl.
DualEngineFindOnPage
Sucht eine instance von Text auf der Seite.
public HRESULT DualEngineFindOnPage(int iRequestID, LPCWSTR pszFindText, BOOL fFindNext, BOOL fForward)
Parameter
iRequestIDEine ID zum Verwenden der korrelierten Suche auf Seitenanforderungen und -ereignissen.pszFindTextDer 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.fForwardGibt 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
pszUriDer URI, von dem die Geolocation-Anforderung stammt.responseDie Antwort auf die Anforderung.
DualEngineGoToEntry
Navigiert zu einem bestimmten Reiseprotokolleintrag.
public HRESULT DualEngineGoToEntry(ULONG ulEntryId)
Parameter
-
ulEntryIdDie 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
pDualEngineObserverEin Zeiger auf den Beobachter für diesen Browser.configKonfigurationsflags für das gewünschte Browserverhalten.engineSwitchingPolicyFlagsFlags, die bestimmen, wie der Motorwechsel gehandhabt wird.sentinelEntryInfoDie Anzahl der Verlaufselemente vor und nach der anfänglichen Navigation für diesen instance.pszUrlDie anfängliche URL, zu der navigiert werden soll.hwndHostDer HWND des Hostfensters, dem das Browserfenster zugeordnet wird.phwndDer 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
pDualEngineObserverEin Zeiger auf den Beobachter für diesen Browser.configKonfigurationsflags für das gewünschte Browserverhalten.engineSwitchingPolicyFlagsFlags, die bestimmen, wie der Motorwechsel gehandhabt wird.sentinelEntryInfoDie Anzahl der Verlaufselemente vor und nach der anfänglichen Navigation für diesen instance.pszUrlDie anfängliche URL, zu der navigiert werden soll.hwndHostDer HWND des Hostfensters, dem das Browserfenster zugeordnet wird.phwndDer HWND des Browserfensters.pszReferrerDer HTTP-Referer-Anforderungsheader für die anfängliche Navigation.pszHeadersZusätzliche Header, die für die anfängliche Navigation an den Server gesendet werden sollen.postDataDaten, 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.ulEntryIdDie ID des Eintrags im Reiseprotokoll, zu dem nach der Wiederherstellung navigiert werden soll.pDualEngineObserverEin Zeiger auf den Beobachter für diesen Browser.configKonfigurationsflags für das gewünschte Browserverhalten.engineSwitchingPolicyFlagsFlags, die bestimmen, wie der Motorwechsel gehandhabt wird.sentinelEntryInfoDie Anzahl der Verlaufselemente vor und nach der anfänglichen Navigation für diesen instance.pszUrlDie anfängliche URL, zu der navigiert werden soll.hwndHostDer HWND des Hostfensters, dem das Browserfenster zugeordnet wird.phwndDer HWND des Browserfensters.
DualEngineLostFocus
Benachrichtigt den Browser, dass er den Fokus verloren hat.
public HRESULT DualEngineLostFocus(HWND hwndLostFocus)
Parameter
-
hwndLostFocusDas Fenster, in das der Fokus verschoben wird.
DualEngineNavigate
Navigiert zu einer URL.
public HRESULT DualEngineNavigate(LPCWSTR pszUrl, BOOL fSkipOnBeforeUnload)
Parameter
pszUrlDie URL, zu der navigiert werden soll.fSkipOnBeforeUnloadGibt an, ob die Behandlung übersprungenonBeforeUnloadwerden 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
pszUrlDie URL, zu der navigiert werden soll.fSkipOnBeforeUnloadGibt an, ob die Behandlung übersprungenonBeforeUnloadwerden soll.pszReferrerDer HTTP-Referer-Anforderungsheader für diese Navigation.pszHeadersZusätzliche Header, die für diese Navigation an den Server gesendet werden sollen.postDataDaten, 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
fShouldDeleteEntriesGibt 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
-
typeDer 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
-
fProtectFocusGibttruean, dass der Browser nicht versucht, den Fokus zu stehlen, wennfalse, 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
-
engineSwitchingPolicyFlagsFlags, die das gewünschte Engine-Schaltverhalten darstellen.
DualEngineSetFocus
Legt den Fokus innerhalb des gehosteten Browsers fest.
public HRESULT DualEngineSetFocus(DUALENGINE_FOCUSDIRECTION focusDirection)
Parameter
-
focusDirectionDie 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
-
fFullscreenWennfalse, wird der Vollbildmodus beendet, wenn das Medium vollbildend ist; wenntrue, geschieht nichts.
DualEngineSetPosition
Legt die Größe und Position des Browserfensters fest.
public HRESULT DualEngineSetPosition(int x, int y, int iWidth, int iHeight)
Parameter
xDie neue Position der linken Seite des Fensters in Clientkoordinaten.yDie neue Position des oberen Fensters in Clientkoordinaten.iWidthDie neue Breite des Fensters in Pixel.iHeightDie 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
-
fFullscreenWenntrueund derzeit nicht im Theatermodus, wechselt der Browser in den Theatermodus. Wennfalseund 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
fTheaterShowingGibt an, ob sich der Host derzeit im Theatermodus befindet.yTheaterThresholdDie 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
-
visibilityDer Sichtbarkeitszustand, den wir eingeben.
DualEngineSetWindowStyle
Ändert den Stil des Browserfensters.
public HRESULT DualEngineSetWindowStyle(int wlStyle, int wlExStyle)
Parameter
wlStyleDer festzulegende Wert der Fensterformatvorlage.wlExStyleDer festzulegende Wert erweiterter Windows-Stil.
DualEngineSetZoom
Ändert den Zoomwert des Browsers.
public HRESULT DualEngineSetZoom(int iZoomPercent)
Parameter
-
iZoomPercentDer Zoomprozentsatz, auf den der Browser festgelegt werden soll.
DualEngineSimulateKeyInput
Sendet eine simulierte Schlüsseleingabe.
public HRESULT DualEngineSimulateKeyInput(DWORD vKey, KEYACTION keyAction)
Parameter
vKeyDer zu simulierende virtuelle Schlüsselcode.keyActionDie wichtigste aktion, die simuliert werden soll.
DualEngineSimulateMouseInput
Sendet eine simulierte Mauseingabe.
public HRESULT DualEngineSimulateMouseInput(DWORD x, DWORD y, MOUSEACTION mouseAction)
Parameter
xDie x-Koordinate.yDie y-Koordinate.mouseActionDie zu simulierende Mausaktion.
DualEngineStopFindOnPage
Beendet den Suchvorgang.
public HRESULT DualEngineStopFindOnPage(BOOL fClean)
Parameter
-
fCleanGibttruean, dass die hervorgehobenen Ergebnisse und das aktuell ausgewählte Ergebnis gelöscht werden; wennfalse, bleibt das aktuell ausgewählte Ergebnis ausgewählt.
DualEngineTranslateAccelerator
Verarbeitet eine Zugriffstastenmeldung.
public HRESULT DualEngineTranslateAccelerator(LPMSG lpMsg)
Parameter
-
lpMsgEin Zeiger auf eine MSG-Struktur, die die zu übersetzende Nachricht angibt.