Freigeben über

CHtmlView-Klasse

  • Artikel

Stellt die Funktionalität des WebBrowser-Steuerelements im Kontext der MFC-Dokument-/Ansichtarchitektur bereit.

Syntax

class CHtmlView : public CFormView

Member

Öffentliche Methoden

Name Beschreibung
CHtmlView::Create Erstellt das WebBrowser-Steuerelement.
CHtmlView::CreateControlSite Überschreibbar. Verwendet, um eine Steuerelement-Websiteinstanz zum Hosten eines Steuerelements auf dem Formular zu erstellen.
CHtmlView::ExecFormsCommand Führt den angegebenen Befehl mithilfe der Methode IOleCommandTarget::Exec aus.
CHtmlView::ExecWB Führt einen Befehl aus.
CHtmlView::GetAddressBar Bestimmt, ob die Adressleiste des Internet Explorer-Objekts angezeigt wird. (Vom WebBrowser-Steuerelement ignoriert; nur Internet Explorer.)
CHtmlView::GetApplication Ruft ein Anwendungsobjekt ab, das die Anwendung darstellt, die die aktuelle Instanz der Internet Explorer-Anwendung enthält.
CHtmlView::GetBusy Ruft einen Wert ab, der angibt, ob aktuell noch ein Download oder eine andere Aktivität ausgeführt wird.
CHtmlView::GetContainer Ruft den Container des WebBrowser-Steuerelements ab.
CHtmlView::GetFullName Ruft den vollständigen Namen, einschließlich Pfad, der im Webbrowser angezeigten Ressource ab. (Vom WebBrowser-Steuerelement ignoriert; nur Internet Explorer.)
CHtmlView::GetFullScreen Gibt an, ob das WebBrowser-Steuerelement im Vollbildmodus oder im normalen Modus ausgeführt wird.
CHtmlView::GetHeight Ruft die Höhe des Internet Explorer-Hauptfensters ab.
CHtmlView::GetHtmlDocument Ruft das aktive HTML-Dokument ab.
CHtmlView::GetLeft Ruft die Bildschirmkoordinate der linken Kante des Internet Explorer-Hauptfensters ab.
CHtmlView::GetLocationName Ruft den Namen der Ressource ab, die aktuell im WebBrowser angezeigt wird
CHtmlView::GetLocationURL Ruft die URL der Ressource ab, die aktuell im WebBrowser angezeigt wird.
CHtmlView::GetMenuBar Ruft einen Wert ab, der bestimmt, ob die Menüleiste angezeigt wird.
CHtmlView::GetOffline Ruft einen Wert ab, der bestimmt, ob das Steuerelement offline ist.
CHtmlView::GetParentBrowser Ruft einen Zeiger auf die IDispatch -Schnittstelle ab. Weitere Informationen finden Sie unter Implementieren der IDispatch Schnittstelle.
CHtmlView::GetProperty Ruft den aktuellen Wert einer Eigenschaft ab, die dem angegebenen Objekt zugeordnet ist.
CHtmlView::GetReadyState Ruft den Bereitschaftsstatus des Webbrowserobjekts ab.
CHtmlView::GetRegisterAsBrowser Gibt an, ob das WebBrowser-Steuerelement als Browser der obersten Ebene für die Zielnamenauflösung registriert ist.
CHtmlView::GetRegisterAsDropTarget Gibt an, ob das WebBrowser-Steuerelement als Ablageziel für die Navigation registriert ist.
CHtmlView::GetSilent Gibt an, ob Dialogfelder angezeigt werden können.
CHtmlView::GetSource Der HTML-Quellcode der Webseite.
CHtmlView::GetStatusBar Gibt an, ob die Statusleiste von Internet Explorer angezeigt wird. (Vom WebBrowser-Steuerelement ignoriert; nur Internet Explorer.)
CHtmlView::GetTheaterMode Gibt an, ob das WebBrowser-Steuerelement im Kinomodus ausgeführt wird.
CHtmlView::GetToolBar Ruft einen Wert ab, der bestimmt, ob die Symbolleiste angezeigt wird.
CHtmlView::GetTop Ruft die Bildschirmkoordinate der oberen Kante des Internet Explorer-Hauptfensters ab.
CHtmlView::GetTopLevelContainer Ruft einen Wert ab, der angibt, ob das aktuelle Objekt den Container der obersten Ebene des WebBrowser-Steuerelements darstellt.
CHtmlView::GetType Ruft den Typnamen des Dokumentobjekts ab.
CHtmlView::GetVisible Ruft einen Wert ab, der angibt, ob das Objekt sichtbar oder ausgeblendet ist.
CHtmlView::GetWidth Ruft die Breite des Internet Explorer-Hauptfensters ab.
CHtmlView::GoBack Navigiert zum vorherigen Element in der Verlaufsliste.
CHtmlView::GoForward Navigiert zum nächsten Element in der Verlaufsliste.
CHtmlView::GoHome Navigiert zur aktuellen Homepage oder Startseite.
CHtmlView::GoSearch Navigiert zur aktuellen Suchseite.
CHtmlView::LoadFromResource Lädt eine Ressource im WebBrowser-Steuerelement.
CHtmlView::Navigate Navigiert zu der durch eine URL bezeichnete Ressource.
CHtmlView::Navigate2 Navigiert zu der durch eine URL bezeichnete Ressource oder zu der durch einen vollständigen Pfad angegebenen Datei.
CHtmlView::OnBeforeNavigate2 Wird aufgerufen, bevor ein Navigationsvorgang im angegebenen WebBrowser (entweder in einem Fenster oder frameset-Element) erfolgt.
CHtmlView::OnCommandStateChange Wird aufgerufen, um eine Anwendung zu benachrichtigen, dass der aktivierte Zustand eines Webbrowserbefehls geändert wurde.
CHtmlView::OnDocumentComplete Wird aufgerufen, um eine Anwendung zu benachrichtigen, dass ein Dokument den Zustand READYSTATE_COMPLETE erreicht hat.
CHtmlView::OnDocWindowActivate Wird von der Internet Explorer- oder MSHTML-Implementierung IOleInPlaceActiveObject::OnDocWindowActivateaufgerufen, von der das aktive direkte Objekt benachrichtigt wird, wenn das Dokumentfenster des Containers aktiviert oder deaktiviert wird.
CHtmlView::OnDownloadBegin Wird aufgerufen, um eine Anwendung zu benachrichtigen, dass ein Navigationsvorgang beginnt.
CHtmlView::OnDownloadComplete Wird aufgerufen, wenn ein Navigationsvorgang beendet oder angehalten wurde bzw. wenn ein Fehler aufgetreten ist.
CHtmlView::OnEnableModeless Wird aufgerufen, um Dialogfelder ohne Modus zu aktivieren oder deaktivieren, wenn der Container ein modales Dialogfeld erstellt oder entfernt.
CHtmlView::OnFilterDataObject Wird auf dem Host von Internet Explorer oder MSHTML aufgerufen, um dem Host das Ersetzen des Datenobjekts von Internet Explorer oder MSHTML zu ermöglichen.
CHtmlView::OnFrameWindowActivate Wird aufgerufen IOleInPlaceActiveObject::OnFrameWindowActivate , um das Objekt zu benachrichtigen, wenn das Framefenster der obersten Ebene des Containers aktiviert oder deaktiviert wird.
CHtmlView::OnFullScreen Wird aufgerufen, wenn sich die FullScreen Eigenschaft geändert hat.
CHtmlView::OnGetDropTarget Wird von Internet Explorer oder MSHTML aufgerufen, wenn es als Drop-Ziel verwendet wird, damit der Host eine Alternative IDropTargetbereitstellen kann.
CHtmlView::OnGetExternal Wird von Internet Explorer oder MSHTML aufgerufen, um die IDispatch -Schnittstelle des Hosts zu erhalten.
CHtmlView::OnGetHostInfo Ruft die UI-Fähigkeiten des Internet Explorer- oder MSHTML-Hosts ab.
CHtmlView::OnGetOptionKeyPath Gibt den Registrierungsschlüssel zurück, unter dem Internet Explorer oder MSHTML Benutzereinstellungen speichert.
CHtmlView::OnHideUI Wird aufgerufen, wenn Internet Explorer oder MSHTML seine Menüs und Symbolleisten entfernt.
CHtmlView::OnMenuBar Wird aufgerufen, wenn sich die MenuBar Eigenschaft geändert hat.
CHtmlView::OnNavigateComplete2 Wird aufgerufen, nachdem die Navigation zu einem Link abgeschlossen wurde (entweder in einem Fenster oder frameset-Element).
CHtmlView::OnNavigateError Wird vom Framework aufgerufen, wenn ein Fehler bei der Navigation zu einem Link auftritt.
CHtmlView::OnNewWindow2 Wird aufgerufen, wenn ein neues Fenster erstellt wird, um eine Ressource anzuzeigen.
CHtmlView::OnProgressChange Wird aufgerufen, um eine Anwendung zu benachrichtigen, dass der Status eines Downloadvorgangs aktualisiert wurde.
CHtmlView::OnPropertyChange Wird aufgerufen, um eine Anwendung zu benachrichtigen, dass die PutProperty Methode den Wert einer Eigenschaft geändert hat.
CHtmlView::OnQuit Wird aufgerufen, um eine Anwendung zu benachrichtigen, dass die Internet Explorer-Anwendung beendet werden kann. (Betrifft nur Internet Explorer)
CHtmlView::OnResizeBorder Wird von der Internet Explorer- oder MSHTML-Implementierung aufgerufen, von IOleInPlaceActiveObject::ResizeBorderder das Objekt benachrichtigt wird, dass es die Größe des Rahmenbereichs ändern muss.
CHtmlView::OnShowContextMenu Wird von Internet Explorer oder MSHTML aufgerufen, wenn es darum geht, sein Kontextmenü anzuzeigen.
CHtmlView::OnShowUI Wird aufgerufen, wenn die Anzeige von Menüs und Symbolleisten in Internet Explorer oder MSHTML bevorsteht.
CHtmlView::OnStatusBar Wird aufgerufen, wenn sich die StatusBar Eigenschaft geändert hat.
CHtmlView::OnStatusTextChange Wird aufgerufen, um eine Anwendung zu benachrichtigen, dass der Text in der Statusleiste des WebBrowser-Steuerelements geändert wurde.
CHtmlView::OnTheaterMode Wird aufgerufen, wenn sich die TheaterMode Eigenschaft geändert hat.
CHtmlView::OnTitleChange Wird aufgerufen, um eine Anwendung zu benachrichtigen, wenn der Titel eines Dokuments im WebBrowser-Steuerelement verfügbar ist oder geändert wird.
CHtmlView::OnToolBar Wird aufgerufen, wenn sich die ToolBar Eigenschaft geändert hat.
CHtmlView::OnTranslateAccelerator Wird von Internet Explorer oder MSHTML aufgerufen, wenn IOleInPlaceActiveObject::TranslateAccelerator oder IOleControlSite::TranslateAccelerator zum Verarbeiten von Menütastenmeldungen aus der Nachrichtenwarteschlange des Containers aufgerufen wird.
CHtmlView::OnTranslateUrl Wird von Internet Explorer oder MSHTML aufgerufen, um dem Host die Möglichkeit zu geben, die zu ladende URL zu ändern.
CHtmlView::OnUpdateUI Benachrichtigt den Host, dass sich der Befehlsstatus geändert hat.
CHtmlView::OnVisible Wird aufgerufen, wenn das Fenster für das WebBrowser-Steuerelement ein- oder ausgeblendet werden soll.
CHtmlView::PutProperty Legt den Wert einer Eigenschaft fest, die dem angegebenen Objekt zugeordnet ist.
CHtmlView::QueryFormsCommand Fragt den Status von Befehlen ab, die von Ereignissen auf der Benutzeroberfläche generiert wurden.
CHtmlView::QueryStatusWB Fragt den Status eines Befehls ab, der vom WebBrowser-Steuerelement verarbeitet wird.
CHtmlView::Refresh Lädt die aktuelle Seite erneut.
CHtmlView::Refresh2 Lädt die aktuelle Datei und verhindert optional das Senden der pragma:nocache -Header.
CHtmlView::SetAddressBar Blendet die Adressleiste des Internet Explorer-Objekts ein oder aus. (Vom WebBrowser-Steuerelement ignoriert; nur Internet Explorer.)
CHtmlView::SetFullScreen Legt einen Wert fest, um zu bestimmen, ob das Steuerelement im Vollbildmodus oder im normalen Fenstermodus ausgeführt wird (Vom WebBrowser-Steuerelement ignoriert; nur Internet Explorer.)
CHtmlView::SetHeight Legt die Höhe des Internet Explorer-Hauptfensters fest.
CHtmlView::SetLeft Legt die horizontale Position des Internet Explorer-Hauptfensters fest.
CHtmlView::SetMenuBar Legt einen Wert fest, der bestimmt, ob die Menüleiste des Steuerelements angezeigt wird. (Vom WebBrowser-Steuerelement ignoriert; nur Internet Explorer.)
CHtmlView::SetOffline Legt einen Wert fest, der bestimmt, ob das Steuerelement offline ist.
CHtmlView::SetRegisterAsBrowser Legt einen Wert fest, der angibt, ob das WebBrowser-Steuerelement als Browser der obersten Ebene für die Zielnamenauflösung registriert ist.
CHtmlView::SetRegisterAsDropTarget Legt einen Wert fest, der angibt, ob das WebBrowser-Steuerelement als Ablageziel für die Navigation registriert ist.
CHtmlView::SetSilent Legt einen Wert fest, der angibt, ob das Steuerelement Dialogfelder anzeigt.
CHtmlView::SetStatusBar Legt einen Wert fest, der angibt, ob die Statusleiste von Internet Explorer angezeigt wird. (Vom WebBrowser-Steuerelement ignoriert; nur Internet Explorer.)
CHtmlView::SetTheaterMode Legt einen Wert fest, der angibt, ob das WebBrowser-Steuerelement im Kinomodus ausgeführt wird.
CHtmlView::SetToolBar Legt einen Wert fest, der bestimmt, ob die Symbolleiste des Steuerelements angezeigt wird. (Vom WebBrowser-Steuerelement ignoriert; nur Internet Explorer.)
CHtmlView::SetTop Legt die vertikale Position des Internet Explorer-Hauptfensters fest.
CHtmlView::SetVisible Legt einen Wert fest, der angibt, ob das Objekt sichtbar oder ausgeblendet ist.
CHtmlView::SetWidth Legt die Breite des Internet Explorer-Hauptfensters fest.
CHtmlView::Stop Bricht das Öffnen einer Datei ab.

Hinweise

Das WebBrowser-Steuerelement ist ein Fenster, in dem der Benutzer Websites im World Wide Web und Ordner im lokalen Dateisystem und in einem Netzwerk durchsuchen kann. Das WebBrowser-Steuerelement unterstützt die Navigation mithilfe von Hyperlinks und URLs (Uniform Resource Locator) und unterhält eine Verlaufsliste.

Verwenden der CHtmlView Klasse in einer MFC-Anwendung

In der standardmäßigen MFC-Frameworkanwendung (entweder auf SDI oder auf MDI basierend) wird das Ansichtsobjekt üblicherweise aus einem spezialisierten Satz Klassen abgeleitet. Diese Klassen, die alle aus CViewabgeleitet sind, bieten spezielle Funktionen über den von CViewbereitgestellten Rahmen hinaus.

Die Ableitung der Ansichtsklasse der Anwendung aus CHtmlView stellt der Ansicht das WebBrowser-Steuerelement bereit. Dadurch wird die Anwendung praktisch zu einem Webbrowser. Die bevorzugte Methode zum Erstellen einer Anwendung im Stil eines Webbrowsers besteht in der Verwendung des MFC-Anwendungs-Assistenten und dem Angeben von CHtmlView als Ansichtsklasse. Weitere Informationen zum Implementieren und Verwenden des WebBrowser-Steuerelements in MFC-Anwendungen finden Sie unter Erstellen eines Anwendung im Webbrowserstil.

Hinweis

Das WebBrowser-ActiveX-Steuerelement (und daher CHtmlView) ist nur für Programme verfügbar, die unter den Windows NT-Versions 4.0 oder höher ausgeführt werden, auf denen Internet Explorer 4.0 oder höher installiert wurde.

CHtmlView ist für Anwendungen ausgelegt, die auf das Web (und/oder HTML-Dokumente) zugreifen. Die folgenden CHtmlView -Memberfunktionen betreffen nur die Internet Explorer-Anwendung. Diese Funktionen werden im WebBrowser-Steuerelement erfolgreich ausgeführt, haben aber keine sichtbaren Auswirkungen.

Vererbungshierarchie

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

Anforderungen

Header: afxhtml.h

CHtmlView::Create

Rufen Sie diese Memberfunktion auf, um ein WebBrowser-Steuerelement oder einen Container für die ausführbare Datei von Internet Explorer zu erstellen.

virtual BOOL Create(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CCreateContext* pContext = NULL);

Parameter

lpszClassName
Verweist auf eine mit Null beendete Zeichenfolge, die die Windows-Klasse benennt. Der Klassenname kann ein beliebiger Name sein, der mit der AfxRegisterWndClass globalen Funktion oder der RegisterClass Windows-Funktion registriert ist. Wenn NULL, verwendet die vordefinierten Standardattribute CFrameWnd .

lpszWindowName
Verweist auf eine mit Null beendete Zeichenfolge, die den Fensternamen darstellt.

dwStyle
Gibt die Attribute der Fensterformatvorlage an. Standardmäßig werden die Formatvorlagen und WS_CHILD die WS_VISIBLE Windows-Formatvorlagen festgelegt.

rect
Ein Verweis auf eine RECT Struktur, die die Größe und Position des Fensters angibt. Mit rectDefault dem Wert kann Windows die Größe und Position des neuen Fensters angeben.

pParentWnd
Ein Zeiger auf das übergeordnete Fenster des Steuerelements.

nID
Die ID-Nummer der Ansicht. Legen Sie dies standardmäßig auf AFX_IDW_PANE_FIRST fest.

pContext
Ein Zeiger auf ein CCreateContext. NULL standardmäßig.

CHtmlView::CreateControlSite

Überschreibbar. Verwendet, um eine Steuerelement-Websiteinstanz zum Hosten eines Steuerelements auf dem Formular zu erstellen.

virtual BOOL CreateControlSite(
    COleControlContainer* pContainer,
    COleControlSite** ppSite,
    UINT nID,
    REFCLSID clsid);

Parameter

pContainer
Ein Zeiger auf ein COleControlContainer Objekt, das das Steuerelement enthält.

ppSite
Ein Zeiger auf einen Zeiger auf ein COleControlSite Objekt, das die Website für das Steuerelement bereitstellt.

nID
Der Bezeichner des steuerelements, das gehostet werden soll.

clsid
Die CLSID des zu hostenden Steuerelements

Rückgabewert

Gibt TRUE bei Erfolg bzw. FALSE bei einem Fehler zurück.

Hinweise

Sie können diese Memberfunktion außer Kraft setzen, um eine Instanz Ihrer eigenen Steuerelementwebsiteklasse zurückzugeben.

CHtmlView::ExecFormsCommand

Führt den angegebenen Befehl mithilfe der Methode IOleCommandTarget::Exec aus.

HRESULT ExecFormsCommand(
    DWORD dwCommandID,
    VARIANT* pVarIn,
    VARIANT* pVarOut);

Parameter

dwCommandID
Der Befehl, der ausgeführt werden soll. Dieser Befehl muss zur CMDSETID3_Forms3 Gruppe gehören.

pVarIn
Zeiger auf eine VARIANT Struktur, die Eingabeargumente enthält. Kann NULL sein.

pVarOut
Zeigen Sie auf eine VARIANT Struktur, um die Befehlsausgabe zu empfangen. Kann NULL sein.

Rückgabewert

Ein Standard HRESULT -Wert. Eine vollständige Auflistung möglicher Werte finden Sie im IOleCommandTarget::Exec Windows SDK.

Hinweise

ExecFormsCommand implementiert das Verhalten der IOleCommandTarget::Exec Methode.

CHtmlView::ExecWB

Rufen Sie diese Memberfunktion auf, um einen Befehl im WebBrowser oder Internet Explorer auszuführen.

void ExecWB(
    OLECMDID cmdID,
    OLECMDEXECOPT cmdexecopt,
    VARIANT* pvaIn,
    VARIANT* pvaOut);

Parameter

cmdID
Den auszuführenden Befehl.

cmdexecopt
Die zum Ausführen des Befehls festgelegten Optionen.

pvaIn
Eine Variante, die zum Angeben von Befehlseingabeargumenten verwendet wird.

pvaOut
Eine Variante, die zum Angeben von Befehlsausgabeargumenten verwendet wird.

Hinweise

Siehe IWebBrowser2::ExecWB im Windows SDK.

CHtmlView::GetAddressBar

Rufen Sie diese Memberfunktion auf, um die Adressleiste von Internet Explorer abzurufen.

BOOL GetAddressBar() const;

Rückgabewert

Nonzero, wenn die Adressleiste sichtbar ist; andernfalls 0.

Hinweise

Gilt für Internet Explorer. Wenn Sie diesen Aufruf mit einem WebBrowser-Steuerelement verwenden, wird kein Fehler zurückgegeben, dieser Aufruf wird jedoch ignoriert.

CHtmlView::GetApplication

Rufen Sie diese Memberfunktion auf, um das Automatisierungsobjekt abzurufen, das von der Anwendung unterstützt wird, die das WebBrowser-Steuerelement enthält.

LPDISPATCH GetApplication() const;

Rückgabewert

Ein Zeiger auf die IDispatch Schnittstelle des aktiven Dokumentobjekts. Weitere Informationen finden Sie unter Implementieren der IDispatch Schnittstelle.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetBusy

Rufen Sie diese Memberfunktion auf, um zu bestimmen, ob das WebBrowser-Steuerelement in einem Navigations- oder Downloadvorgang ausgeführt wird.

BOOL GetBusy() const;

Rückgabewert

Nonzero, wenn der Webbrowser ausgelastet ist; andernfalls 0.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetContainer

Rufen Sie diese Memberfunktion auf, um ein Objekt abzurufen, das für den Container des Webbrowsers ausgewertet wird.

LPDISPATCH GetContainer() const;

Rückgabewert

Ein Zeiger auf die IDispatch Schnittstelle des aktiven Dokumentobjekts.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetFullName

Rufen Sie diese Memberfunktion auf, um den vollständigen Pfad der Datei abzurufen, die derzeit in Internet Explorer angezeigt wird.

CString GetFullName() const;

Rückgabewert

Ein CString Objekt, das den Pfad und den Namen der aktuell angezeigten Datei enthält. Wenn kein Pfad und Dateiname vorhanden sind, GetFullName wird ein leerer CStringWert zurückgegeben.

Hinweise

Gilt für Internet Explorer. Wenn Sie diesen Aufruf mit einem WebBrowser-Steuerelement verwenden, wird kein Fehler zurückgegeben, dieser Aufruf wird jedoch ignoriert.

CHtmlView::GetFullScreen

Rufen Sie diese Memberfunktion auf, um zu bestimmen, ob das WebBrowser-Steuerelement im Vollbildmodus oder im normalen Fenstermodus ausgeführt wird.

BOOL GetFullScreen() const;

Rückgabewert

Nonzero, wenn der WebBrowser im Vollbildmodus ausgeführt wird; andernfalls 0.

Hinweise

Im Vollbildmodus wird das Internet Explorer-Hauptfenster maximiert, und die Statusleiste, die Symbolleiste, die Menüleiste und die Titelleiste sind ausgeblendet.

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetHeight

Rufen Sie diese Memberfunktion auf, um die Höhe des Framefensters des WebBrowser-Steuerelements in Pixel abzurufen.

long GetHeight() const;

Rückgabewert

Die Höhe des Rahmenfensters des Steuerelements in Pixel.

CHtmlView::GetHtmlDocument

Rufen Sie diese Memberfunktion auf, um das HTML-Dokument für das aktive Dokument abzurufen.

LPDISPATCH GetHtmlDocument() const;

Rückgabewert

Ein Zeiger auf die IDispatch Schnittstelle des aktiven Dokumentobjekts.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetLeft

Rufen Sie diese Memberfunktion auf, um den Abstand zwischen dem internen linken Rand des WebBrowser-Steuerelements und dem linken Rand des Containers abzurufen.

long GetLeft() const;

Rückgabewert

Der linke Randabstand in Pixel.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetLocationName

Rufen Sie diese Memberfunktion auf, um den Namen der Ressource abzurufen, die im WebBrowser angezeigt wird.

CString GetLocationName() const;

Rückgabewert

Ein CString Objekt, das den Namen der Ressource enthält, die derzeit im WebBrowser angezeigt wird.

Hinweise

Wenn es sich bei der Ressource um eine HTML-Seite im World Wide Web handelt, ist der Name der Titel dieser Seite. Wenn es sich bei der Ressource um einen Ordner oder eine Datei im Netzwerk oder auf dem lokalen Computer handelt, ist der Name der UNC oder der vollständige Pfad des Ordners oder der Datei.

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetLocationURL

Rufen Sie diese Memberfunktion auf, um die URL der Ressource abzurufen, die das WebBrowser-Steuerelement derzeit anzeigt.

CString GetLocationURL() const;

Rückgabewert

Ein CString Objekt, das die URL der Ressource enthält, die derzeit im WebBrowser angezeigt wird.

Hinweise

Wenn es sich bei der Ressource um einen Ordner oder eine Datei im Netzwerk oder auf dem lokalen Computer handelt, ist der Name der UNC oder der vollständige Pfad des Ordners oder der Datei.

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetMenuBar

Rufen Sie diese Memberfunktion auf, um zu bestimmen, ob die Menüleiste sichtbar ist.

BOOL GetMenuBar() const;

Rückgabewert

Nonzero, wenn die Menüleiste sichtbar ist; andernfalls 0.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetOffline

Rufen Sie diese Memberfunktion auf, um festzustellen, ob der Webbrowser offline ausgeführt wird.

BOOL GetOffline() const;

Rückgabewert

Nonzero, wenn der Webbrowser derzeit offline ist; andernfalls 0.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetParentBrowser

Rufen Sie diese Memberfunktion auf, um einen Zeiger auf das übergeordnete Objekt des WebBrowser-Steuerelements abzurufen.

LPDISPATCH GetParentBrowser() const;

Rückgabewert

Ein Zeiger auf die IDispatch Schnittstelle des Objekts, das das übergeordnete Element des WebBrowser-Steuerelements ist.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetProperty

Rufen Sie diese Memberfunktion auf, um den Wert der aktuell dem Steuerelement zugeordneten Eigenschaft abzurufen.

BOOL GetProperty(
    LPCTSTR lpszProperty,
    CString& strValue);

COleVariant GetProperty(LPCTSTR lpszProperty);

Parameter

lpszProperty
Ein Zeiger auf eine Zeichenfolge, die die abzurufende Eigenschaft enthält.

strValue
Ein Verweis auf ein CString Objekt, das den aktuellen Wert der Eigenschaft empfängt.

Rückgabewert

In der ersten Version ist "nonzero" erfolgreich abgeschlossen; andernfalls 0. In der zweiten Version ein COleVariant Objekt.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetReadyState

Rufen Sie diese Memberfunktion auf, um den bereiten Zustand des WebBrowser-Objekts abzurufen.

READYSTATE GetReadyState() const;

Rückgabewert

Ein READYSTATE Wert, wie im Windows SDK beschrieben.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetRegisterAsBrowser

Rufen Sie diese Memberfunktion auf, um zu bestimmen, ob das WebBrowser-Objekt als Browser auf oberster Ebene für die Zielnamenauflösung registriert ist.

BOOL GetRegisterAsBrowser() const;

Rückgabewert

Nonzero, wenn der Browser als Browser auf oberster Ebene registriert ist; andernfalls 0.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetRegisterAsDropTarget

Rufen Sie diese Memberfunktion auf, um zu bestimmen, ob das WebBrowser-Steuerelement als Drop-Ziel für die Navigation registriert ist.

BOOL GetRegisterAsDropTarget() const;

Rückgabewert

Nonzero, wenn der Browser als Drop-Ziel registriert ist; andernfalls 0.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetSilent

Rufen Sie diese Memberfunktion auf, um zu bestimmen, ob dialogfelder im WebBrowser-Steuerelement angezeigt werden können.

BOOL GetSilent() const;

Rückgabewert

Nonzero, wenn Dialogfelder nicht über das WebBrowser-Steuerelement angezeigt werden können; andernfalls 0.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetSource

Rufen Sie diese Memberfunktion auf, um den HTML-Quellcode für die Webseite abzurufen.

BOOL GetSource(CString& strRef);

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Parameter

refString
Ein CString Quellcode, der den Quellcode enthält.

Hinweise

Diese Funktion entspricht dem Befehl "Quelle anzeigen" in Internet Explorer, mit der Ausnahme, dass der Quellcode in einem CString.

CHtmlView::GetStatusBar

Rufen Sie diese Memberfunktion auf, um zu bestimmen, ob das WebBrowser-Steuerelement eine Statusleiste anzeigt.

BOOL GetStatusBar() const;

Rückgabewert

Nonzero, wenn die Statusleiste angezeigt werden kann; andernfalls 0.

Hinweise

Gilt für Internet Explorer. Wenn Sie diesen Aufruf mit einem WebBrowser-Steuerelement verwenden, wird kein Fehler zurückgegeben, dieser Aufruf wird jedoch ignoriert.

CHtmlView::GetTheaterMode

Rufen Sie diese Memberfunktion auf, um zu bestimmen, ob sich der Webbrowser im Theatermodus befindet.

BOOL GetTheaterMode() const;

Rückgabewert

Nonzero, wenn sich der Webbrowser im Theatermodus befindet; andernfalls 0.

Hinweise

Wenn sich der Webbrowser im Theatermodus befindet, füllt das Hauptfenster des Browsers den gesamten Bildschirm, eine Symbolleiste mit einem minimalen Satz von Navigationstools wird angezeigt, und die Statusleiste wird in der oberen rechten Ecke des Bildschirms angezeigt.

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetToolBar

Rufen Sie diese Memberfunktion auf, um zu bestimmen, ob die Symbolleiste sichtbar ist.

int GetToolBar() const;

Rückgabewert

Ein Wert, der angibt, ob die Symbolleiste sichtbar ist. Nonzero, wenn die Symbolleiste sichtbar ist; andernfalls 0.

CHtmlView::GetTop

Rufen Sie diese Memberfunktion auf, um die Bildschirmkoordinate des oberen Rands des Hauptfensters des WebBrowser-Steuerelements abzurufen.

long GetTop() const;

Rückgabewert

Adresse einer Variablen, die die Bildschirmkoordinate des oberen Rands des Hauptfensters empfängt.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetTopLevelContainer

Rufen Sie diese Memberfunktion auf, um zu bestimmen, ob Internet Explorer der Container der obersten Ebene des WebBrowser-Steuerelements ist.

BOOL GetTopLevelContainer() const;

Rückgabewert

Nonzero der Container ist der Container der obersten Ebene; andernfalls 0.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetType

Rufen Sie diese Memberfunktion auf, um den Typnamen des enthaltenen aktiven Dokuments abzurufen.

CString GetType() const;

Rückgabewert

Ein CString Objekt, das den Typnamen des enthaltenen aktiven Dokuments enthält.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetVisible

Rufen Sie diese Memberfunktion auf, um festzustellen, ob das enthaltene Objekt sichtbar ist.

BOOL GetVisible() const;

Rückgabewert

Nonzero, wenn das Objekt sichtbar ist; andernfalls 0.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GetWidth

Ruft die Breite des Internet Explorer-Hauptfensters ab.

long GetWidth() const;

Rückgabewert

Die aktuelle Breite des Fensters in Pixel.

CHtmlView::GoBack

Navigiert rückwärts ein Element in der Verlaufsliste.

void GoBack();

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GoForward

Navigiert in der Verlaufsliste um ein Element vorwärts.

void GoForward();

CHtmlView::GoHome

Navigiert zur aktuellen Homepage oder Startseite, die im Dialogfeld „Internetoptionen“ von Internet Explorer oder im Dialogfeld „Interneteigenschaften“ beim Zugriff aus der Systemsteuerung festgelegt ist.

void GoHome();

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::GoSearch

Navigiert zur aktuellen Suchseite, wie im Dialogfeld "Internet Explorer-Internetoptionen" oder im Dialogfeld "Interneteigenschaften" angegeben, auf die über die Systemsteuerung zugegriffen wird.

void GoSearch();

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::LoadFromResource

Rufen Sie diese Memberfunktion auf, um die angegebene Ressource in das WebBrowser-Steuerelement zu laden.

BOOL LoadFromResource(LPCTSTR lpszResource);
BOOL LoadFromResource(UINT nRes);

Parameter

lpszResource
Ein Zeiger auf eine Zeichenfolge, die den Namen der zu ladenden Ressource enthält.

nRes
Die ID des Puffers, der den Namen der zu ladenden Ressource enthält.

Rückgabewert

Ungleich 0, wenn erfolgreich, andernfalls 0.

Hinweise

Betrifft Internet Explorer und WebBrowser.

Rufen Sie diese Memberfunktion auf, um zu der Ressource zu navigieren, die durch eine URL identifiziert wird.

void Navigate(
    LPCTSTR URL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeaders = NULL,
    LPVOID lpvPostData = NULL,
    DWORD dwPostDataLen = 0);

Parameter

URL
Eine vom Aufrufer zugewiesene Zeichenfolge, die die URL enthält, zu der navigiert werden soll, oder den vollständigen Pfad der anzuzeigenden Datei.

dwFlags
Die Flags einer Variablen, die angibt, ob die Ressource der Verlaufsliste hinzugefügt werden soll, ob sie aus dem Cache gelesen oder geschrieben werden soll, und ob die Ressource in einem neuen Fenster angezeigt werden soll. Die Variable kann eine Kombination der von der BrowserNavConstants Enumeration definierten Werte sein.

lpszTargetFrameName
Ein Zeiger auf eine Zeichenfolge, die den Namen des Frames enthält, in dem die Ressource angezeigt werden soll.

lpszHeaders
Ein Zeiger auf einen Wert, der die HTTP-Header angibt, die an den Server gesendet werden sollen. Diese Kopfzeilen werden den Standardmäßigen Internet Explorer-Headern hinzugefügt. Die Header können z. B. die erforderliche Aktion des Servers, den Typ der an den Server übergebenen Daten oder einen Statuscode angeben. Dieser Parameter wird ignoriert, wenn URL es sich nicht um eine HTTP-URL handelt.

lpvPostData
Ein Zeiger auf die Daten, die mit der HTTP POST-Transaktion gesendet werden sollen. Beispielsweise wird die POST-Transaktion verwendet, um Daten zu senden, die von einem HTML-Formular gesammelt wurden. Wenn dieser Parameter keine Postdaten angibt, Navigate gibt es eine HTTP GET-Transaktion aus. Dieser Parameter wird ignoriert, wenn URL es sich nicht um eine HTTP-URL handelt.

dwPostDataLen
Daten, die mit der HTTP POST-Transaktion gesendet werden sollen. Beispielsweise wird die POST-Transaktion verwendet, um Daten zu senden, die von einem HTML-Formular gesammelt wurden. Wenn dieser Parameter keine Postdaten angibt, Navigate gibt es eine HTTP GET-Transaktion aus. Dieser Parameter wird ignoriert, wenn URL es sich nicht um eine HTTP-URL handelt.

Hinweise

Betrifft Internet Explorer und WebBrowser.

Rufen Sie diese Memberfunktion auf, um zu der Ressource zu navigieren, die durch eine URL identifiziert wurde, oder zu der Datei, die durch einen vollständigen Pfad identifiziert wird.

void Navigate2(
    LPITEMIDLIST pIDL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL);

void Navigate2(
    LPCTSTR lpszURL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeaders = NULL,
    LPVOID lpvPostData = NULL,
    DWORD dwPostDataLen = 0);

void Navigate2(
    LPCTSTR lpszURL,
    DWORD dwFlags,
    CByteArray& baPostedData,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeader = NULL);

Parameter

pIDL
Ein Zeiger auf eine ITEMIDLIST Struktur.

dwFlags
Die Flags einer Variablen, die angibt, ob die Ressource der Verlaufsliste hinzugefügt werden soll, ob sie aus dem Cache gelesen oder geschrieben werden soll, und ob die Ressource in einem neuen Fenster angezeigt werden soll. Die Variable kann eine Kombination der von der BrowserNavConstants Enumeration definierten Werte sein.

lpszTargetFrameName
Ein Zeiger auf eine Zeichenfolge, die den Namen des Frames enthält, in dem die Ressource angezeigt werden soll.

lpszURL
Ein Zeiger auf eine Zeichenfolge, die die URL enthält.

lpvPostData
Daten, die mit der HTTP POST-Transaktion gesendet werden sollen. Beispielsweise wird die POST-Transaktion verwendet, um Daten zu senden, die von einem HTML-Formular gesammelt wurden. Wenn dieser Parameter keine Postdaten angibt, Navigate2 gibt es eine HTTP GET-Transaktion aus. Dieser Parameter wird ignoriert, wenn URL es sich nicht um eine HTTP- oder HTTPS-URL handelt.

dwPostDataLen
Länge in Byte der Daten, auf die der lpvPostData Parameter verweist.

lpszHeaders
Ein Zeiger auf einen Wert, der die HTTP- oder HTTPS-Header angibt, die an den Server gesendet werden sollen. Diese Kopfzeilen werden den Standardmäßigen Internet Explorer-Headern hinzugefügt. Die Header können z. B. die erforderliche Aktion des Servers, den Typ der an den Server übergebenen Daten oder einen Statuscode angeben. Dieser Parameter wird ignoriert, wenn URL es sich nicht um eine HTTP- oder HTTPS-URL handelt.

baPostedData
Ein Verweis auf ein CByteArray-Objekt.

Hinweise

Diese Memberfunktion erweitert die Navigate Memberfunktion durch die Unterstützung des Browsens in speziellen Ordnern, z. B. "Desktop" und "Arbeitsplatz", die durch den Parameter pIDLdargestellt werden.

Betrifft Internet Explorer und WebBrowser.

Beispiel

void CMyHtmlView::OnGoToMicrosoft()
{
   Navigate2(_T("http://home.microsoft.com"));
}

CHtmlView::OnBeforeNavigate2

Diese Memberfunktion wird vom Framework aufgerufen, um ein Ereignis auszulösen, bevor ein Navigationsvorgang im Webbrowser auftritt.

virtual void OnBeforeNavigate2(
    LPCTSTR lpszURL,
    DWORD nFlags,
    LPCTSTR lpszTargetFrameName,
    CByteArray& baPostedData,
    LPCTSTR lpszHeaders,
    BOOL* pbCancel);

Parameter

lpszURL
Zeigen Sie auf eine Zeichenfolge, die die URL enthält, zu der navigiert werden soll.

nFlags
Für die zukünftige Verwendung reserviert.

lpszTargetFrameName
Eine Zeichenfolge, die den Namen des Frames enthält, in dem die Ressource angezeigt werden soll, oder NULL wenn kein benannter Frame für die Ressource vorgesehen ist.

baPostedData
Ein Verweis auf ein CByteArray Objekt, das die an den Server zu sendenden Daten enthält, wenn die HTTP POST-Transaktion verwendet wird.

lpszHeaders
Ein Zeiger auf eine Zeichenfolge, die andere HTTP-Header enthält, die an den Server gesendet werden sollen (nur HTTP-URLs). Die Header können z. B. die erforderliche Aktion des Servers, den Typ der an den Server übergebenen Daten oder einen Statuscode angeben.

pbCancel
Ein Zeiger auf ein Cancel-Flag. Eine Anwendung kann diesen Parameter auf "nonzero" festlegen, um den Navigationsvorgang abzubrechen, oder auf Null, um den Vorgang fortzusetzen.

CHtmlView::OnCommandStateChange

Diese Memberfunktion wird vom Framework aufgerufen, um eine Anwendung zu benachrichtigen, dass der aktivierte Zustand eines Webbrowserbefehls geändert wurde.

virtual void OnCommandStateChange(
    long nCommand,
    BOOL bEnable);

Parameter

nCommand
Bezeichner des Befehls, dessen aktivierter Zustand geändert wurde.

bEnable
Aktivierter Zustand. Dieser Parameter ist nicht null, wenn der Befehl aktiviert ist, oder null, wenn er deaktiviert ist.

CHtmlView::OnDocumentComplete

Diese Memberfunktion wird vom Framework aufgerufen, um eine Anwendung zu benachrichtigen, dass ein Dokument den READYSTATE_COMPLETE Status erreicht hat.

virtual void OnDocumentComplete(LPCTSTR lpszURL);

Parameter

lpszURL
Ein Zeiger auf eine Zeichenfolge, die die URL, den UNC-Dateinamen oder eine PIDL (einen Zeiger auf eine Elementbezeichnerliste) auswertet, zu der navigiert wurde.

Hinweise

Nicht jeder Frame löst dieses Ereignis aus, aber jeder Frame, der ein OnDownloadBegin Ereignis auslöst, löst ein entsprechendes OnDocumentComplete Ereignis aus.

Die angegebene lpszURL URL kann sich von der URL unterscheiden, zu der der Browser navigiert wurde, da diese URL die kanonisierte und qualifizierte URL ist. Wenn eine Anwendung z. B. eine URL eines Aufrufs Navigate oder Navigate2einer Anwendung angibt, lautet "<https://www.microsoft.com/>"die übergebene OnNavigateComplete2 URL ."www.microsoft.com" Wenn der Server den Browser zu einer anderen URL umgeleitet hat, wird die umgeleitete URL hier angezeigt.

CHtmlView::OnDocWindowActivate

Wird von der Internet Explorer- oder MSHTML-Implementierung IOleInPlaceActiveObject::OnDocWindowActivateaufgerufen, von der das aktive direkte Objekt benachrichtigt wird, wenn das Dokumentfenster des Containers aktiviert oder deaktiviert wird.

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

Parameter

fActivate
Gibt den Status des Dokumentfensters an. Wenn dieser Wert nicht null ist, wird das Fenster aktiviert. Wenn dieser Wert null ist, wird das Fenster deaktiviert.

Rückgabewert

S_OK wenn dies erfolgreich ist oder andernfalls ein OLE-definierter Fehlercode vorliegt.

Hinweise

Überschreiben OnDocWindowActivate , um auf die OnDocWindowActivate Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::OnDocWindowActivate im Windows SDK.

CHtmlView::OnDownloadBegin

Diese Memberfunktion wird vom Framework aufgerufen, um mit dem Herunterladen eines Dokuments zu beginnen.

virtual void OnDownloadBegin();

Hinweise

Dieses Ereignis wird kurz nach dem OnBeforeNavigate2 Ereignis ausgelöst, es sei denn, die Navigation wird abgebrochen. Jede Animation oder "beschäftigt" zeigt an, dass der Container mit diesem Ereignis verbunden werden muss.

CHtmlView::OnDownloadComplete

Diese Memberfunktion wird vom Framework aufgerufen, um anzugeben, dass ein Navigationsvorgang beendet, angehalten oder fehlgeschlagen ist.

virtual void OnDownloadComplete();

CHtmlView::OnEnableModeless

Wird aufgerufen, wenn Internet Explorer oder MSHTML modale UI anzeigt.

virtual HRESULT OnEnableModeless(BOOL fEnable);

Parameter

fEnable
Gibt an, ob die Dialogfelder ohne Modus des Hosts aktiviert oder deaktiviert sind. Wenn dieser Wert nicht null ist, sind dialogfelderlose Modus aktiviert. Wenn dieser Wert null ist, werden dialogfelder ohne Modus deaktiviert.

Rückgabewert

S_OK wenn dies erfolgreich ist oder andernfalls ein OLE-definierter Fehlercode vorliegt.

Hinweise

Aktiviert oder deaktiviert moduslose Dialogfelder, wenn der Container ein modales Dialogfeld erstellt oder zerstört. Überschreiben OnEnableModeless , um auf die EnableModeless Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::EnableModeless im Windows SDK.

CHtmlView::OnFilterDataObject

Wird auf dem Host von Internet Explorer oder MSHTML aufgerufen, um dem Host das Ersetzen des Datenobjekts von Internet Explorer oder MSHTML zu ermöglichen.

virtual HRESULT OnFilterDataObject(
    LPDATAOBJECT pDataObject,
    LPDATAOBJECT* ppDataObject);

Parameter

pDataObject
Adresse der Schnittstelle, die IDataObject von Internet Explorer oder MSHTML bereitgestellt wird.

ppDataObject
Adresse, die den IDataObject vom Host bereitgestellten Schnittstellenzeiger empfängt. Der Inhalt dieses Parameters sollte immer initialisiert NULLwerden, auch wenn die Methode fehlschlägt.

Rückgabewert

S_OK wenn das Datenobjekt ersetzt wird, S_FALSE wenn das Datenobjekt nicht ersetzt wird, oder ein OLE-definierter Fehlercode, wenn ein Fehler auftritt.

Hinweise

Überschreiben OnFilterDataObject , um auf die FilterDataObject Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::FilterDataObject im Windows SDK.

CHtmlView::OnFrameWindowActivate

Wird aufgerufen IOleInPlaceActiveObject::OnFrameWindowActivate , um das Objekt zu benachrichtigen, wenn das Framefenster der obersten Ebene des Containers aktiviert oder deaktiviert wird.

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

Parameter

fActivate
Gibt den Status des Framefensters der obersten Ebene des Containers an. Wenn dieser Wert nicht null ist, wird das Fenster aktiviert. Wenn dieser Wert null ist, wird das Fenster deaktiviert.

Rückgabewert

S_OK wenn dies erfolgreich ist oder andernfalls ein OLE-definierter Fehlercode vorliegt.

Hinweise

Überschreiben OnFrameWindowActivate , um auf die OnFrameWindowActivate Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::OnFrameWindowActivate im Windows SDK.

CHtmlView::OnFullScreen

Diese Memberfunktion wird vom Framework aufgerufen, wenn sich die FullScreen Eigenschaft geändert hat.

virtual void OnFullScreen(BOOL bFullScreen);

Parameter

bFullScreen
Nonzero, wenn Internet Explorer sich im Vollbildmodus befindet; andernfalls null.

CHtmlView::OnGetDropTarget

Wird von Internet Explorer oder MSHTML aufgerufen, wenn es als Drop-Ziel verwendet wird, damit der Host eine Alternative IDropTargetbereitstellen kann.

virtual HRESULT OnGetDropTarget(
    LPDROPTARGET pDropTarget,
    LPDROPTARGET* ppDropTarget);

Parameter

pDropTarget
IDropTarget Internet Explorer oder MSHTML schlägt die Verwendung vor.

ppDropTarget
Die Adresse des IDropTarget Empfängers, der den IDropTarget Schnittstellenzeiger empfängt, den der Host bereitstellen möchte.

Rückgabewert

Eine Liste der Rückgabecodes finden Sie IDocHostUIHandler::GetDropTarget im Windows SDK.

Hinweise

Überschreiben OnGetDropTarget , um auf die GetDropTarget Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::GetDropTarget im Windows SDK.

CHtmlView::OnGetExternal

Wird von Internet Explorer oder MSHTML aufgerufen, um die IDispatch -Schnittstelle des Hosts zu erhalten.

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

Parameter

lppDispatch
Ein Zeiger auf die Adresse, die den IDispatch Schnittstellenzeiger der Hostanwendung empfängt. Wenn der Host eine Automatisierungsschnittstelle verfügbar macht, kann er über diesen Parameter einen Verweis auf Internet Explorer oder MSHTML bereitstellen. Der Inhalt dieses Parameters sollte immer initialisiert NULLwerden, auch wenn die Methode fehlschlägt.

Rückgabewert

S_OK wenn dies erfolgreich ist oder andernfalls ein OLE-definierter Fehlercode vorliegt.

Hinweise

Überschreiben OnGetExternal , um auf die GetExternal Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::GetExternal im Windows SDK.

CHtmlView::OnGetHostInfo

Ruft die UI-Fähigkeiten des Internet Explorer- oder MSHTML-Hosts ab.

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

Parameter

pInfo
Adresse einer DOCHOSTUIINFO Struktur, die die UI-Funktionen des Hosts empfängt.

Rückgabewert

S_OK wenn dies erfolgreich ist oder andernfalls ein OLE-definierter Fehlercode vorliegt.

Hinweise

Überschreiben OnGetHostInfo , um auf die GetHostInfo Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::GetHostInfo im Windows SDK.

CHtmlView::OnGetOptionKeyPath

Rufen Sie diese Memberfunktion auf, um den Registrierungsschlüssel abzurufen, unter dem Internet Explorer oder MSHTML Benutzereinstellungen speichert.

virtual HRESULT OnGetOptionKeyPath(
    LPOLESTR* pchKey,
    DWORD dwReserved);

Parameter

pchKey
Adresse eines LPOLESTR , das die Registrierungsunterschlüsselzeichenfolge empfängt, in der der Host seine Standardoptionen speichert. Dieser Unterschlüssel wird unter dem HKEY_CURRENT_USER Schlüssel angezeigt. Weisen Sie diesen Speicher mithilfe von CoTaskMemAlloc. Die aufrufende Anwendung ist dafür verantwortlich, diesen Speicher mit CoTaskMemFreefreizugeben. Dieser Parameter sollte immer initialisiert NULLwerden, auch wenn die Methode fehlschlägt.

dwReserved
Für die zukünftige Verwendung reserviert. Derzeit nicht verwendet.

Rückgabewert

S_OK wenn erfolgreich oder S_FALSE anderweitig. Wenn , Internet S_FALSEExplorer oder MSHTML standardmäßig eigene Benutzeroptionen verwendet werden.

Hinweise

Überschreiben OnGetOptionKeyPath , um auf die GetOptionKeyPath Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::GetOptionKeyPath im Windows SDK.

CHtmlView::OnHideUI

Diese Memberfunktion wird vom Framework aufgerufen, wenn Internet Explorer oder MSHTML seine Menüs und Symbolleisten entfernt.

virtual HRESULT OnHideUI();

Rückgabewert

S_OK wenn dies erfolgreich ist oder andernfalls ein OLE-definierter Fehlercode vorliegt.

Hinweise

Überschreiben OnHideUI , um auf die HideUI Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::HideUI im Windows SDK.

CHtmlView::OnMenuBar

Diese Memberfunktion wird vom Framework aufgerufen, wenn sich die MenuBar Eigenschaft geändert hat.

virtual void OnMenuBar(BOOL bMenuBar);

Parameter

bMenuBar
Nonzero, wenn die Internet Explorer-Menüleiste sichtbar ist; andernfalls null.

CHtmlView::OnNavigateComplete2

Diese Memberfunktion wird vom Framework aufgerufen, nachdem die Navigation zu einem Link abgeschlossen wurde (entweder in einem Fenster- oder Framesetelement).

virtual void OnNavigateComplete2(LPCTSTR strURL);

Parameter

strURL
Ein Zeichenfolgenausdruck, der den URL-, UNC-Dateinamen oder PIDL (einen Zeiger auf eine Elementbezeichnerliste) auswertet, zu der navigiert wurde.

Hinweise

Der URL-Parameter kann eine PIDL sein, wenn eine Shellnamensentität vorhanden ist, für die keine URL-Darstellung vorhanden ist.

Die darin strURL enthaltene URL kann sich von der URL unterscheiden, zu der der Browser navigiert wurde, da diese URL die kanonisierte und qualifizierte URL ist. Wenn eine Anwendung z. B. eine URL eines Aufrufs Navigate oder Navigate2einer Anwendung angibt, lautet "<https://www.microsoft.com/>"die übergebene OnNavigateComplete2 URL ."www.microsoft.com" Wenn der Server den Browser zu einer anderen URL umgeleitet hat, wird die umgeleitete URL hier angezeigt.

CHtmlView::OnNavigateError

Wird vom Framework aufgerufen, wenn ein Fehler bei der Navigation zu einem Link auftritt.

virtual void OnNavigateError(
    LPCTSTR lpszURL,
    LPCTSTR lpszFrame,
    DWORD dwError,
    BOOL* pbCancel);

Parameter

lpszURL
Die URL, für die die Navigation fehlgeschlagen ist.

lpszFrame
Der Name des Frames, in dem die Ressource angezeigt werden soll oder NULL wenn kein benannter Frame für die Ressource vorgesehen war.

dwError
Falls verfügbar, ist ein Fehlerstatuscode vorhanden. Eine Liste der möglichen und HTTP-Statuscodes finden Sie unter Ereignisstatuscodes.For a list of the possible HRESULT and HTTP status codes, see NavigateError Event Status Codes..

pbCancel
Gibt an, ob die Navigation auf eine Fehlerseite oder eine weitere AutoSuche abgebrochen werden soll. Wenn TRUE (standard) fahren Sie mit der Navigation zu einer Fehlerseite oder AutoSuche fort; wenn FALSE, brechen Sie die Navigation zu einer Fehlerseite oder autoSearch ab.

Hinweise

Überschreiben Sie diese Methode, um eine benutzerdefinierte Navigationsfehlerbehandlung bereitzustellen.

Weitere Informationen finden Sie unter DWebBrowserEvents2::NavigateError.

CHtmlView::OnNewWindow2

Diese Memberfunktion wird vom Framework aufgerufen, wenn ein neues Fenster zum Anzeigen einer Ressource erstellt werden soll.

virtual void OnNewWindow2(
    LPDISPATCH* ppDisp,
    BOOL* Cancel);

Parameter

ppDisp
Ein Zeiger auf einen Schnittstellenzeiger, der optional den IDispatch Schnittstellenzeiger eines neuen WebBrowser- oder Internet Explorer-Objekts empfängt.

Cancel
Ein Zeiger auf ein Cancel-Flag. Eine Anwendung kann diesen Parameter auf "nonzero" festlegen, um den Navigationsvorgang abzubrechen, oder auf Null, um den Vorgang fortzusetzen.

Hinweise

Dieses Ereignis steht vor der Erstellung eines neuen Fensters aus dem WebBrowser.

CHtmlView::OnProgressChange

Diese Memberfunktion wird vom Framework aufgerufen, um eine Anwendung zu benachrichtigen, dass der Fortschritt eines Downloadvorgangs aktualisiert wurde.

virtual void OnProgressChange(
    long nProgress,
    long nProgressMax);

Parameter

nProgress
Der Gesamtfortschritt, der angezeigt werden soll, oder -1, wenn der Fortschritt abgeschlossen ist.

nProgressMax
Maximaler Statuswert.

Hinweise

Der Container kann die von diesem Ereignis bereitgestellten Informationen verwenden, um die Anzahl der bisher heruntergeladenen Bytes anzuzeigen oder eine Statusanzeige zu aktualisieren.

CHtmlView::OnPropertyChange

Diese Memberfunktion wird vom Framework aufgerufen, um eine Anwendung zu benachrichtigen, die PutProperty den Wert einer Eigenschaft geändert hat.

virtual void OnPropertyChange(LPCTSTR lpszProperty);

Parameter

lpszProperty
Ein Zeiger auf eine Zeichenfolge, die den Namen der Eigenschaft enthält.

CHtmlView::OnQuit

Diese Memberfunktion wird vom Framework aufgerufen, um eine Anwendung zu benachrichtigen, dass die Internet Explorer-Anwendung zum Beenden bereit ist.

virtual void OnQuit();

CHtmlView::OnResizeBorder

Wird von der Internet Explorer- oder MSHTML-Implementierung aufgerufen, von IOleInPlaceActiveObject::ResizeBorderder das Objekt benachrichtigt wird, dass es die Größe des Rahmenbereichs ändern muss.

virtual HRESULT OnResizeBorder(
    LPCRECT prcBorder,
    LPOLEINPLACEUIWINDOW pUIWindow,
    BOOL fFrameWindow);

Parameter

prcBorder
Neues äußeres Rechteck für rahmenbereich.

pUIWindow
Ein Zeiger auf die Schnittstelle für das Frame- oder Dokumentfensterobjekt, dessen Rahmen geändert wurde.

fFrameWindow
TRUE wenn das Framefenster aufgerufen IOleInPlaceActiveObject::ResizeBorderwird, andernfalls FALSE.

Rückgabewert

S_OK wenn dies erfolgreich ist oder andernfalls ein OLE-definierter Fehlercode vorliegt.

Hinweise

Überschreiben OnResizeBorder , um auf die ResizeBorder Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::ResizeBorder im Windows SDK.

CHtmlView::OnShowContextMenu

Wird von Internet Explorer oder MSHTML aufgerufen, wenn es darum geht, sein Kontextmenü anzuzeigen.

virtual HRESULT OnShowContextMenu(
    DWORD dwID,
    LPPOINT ppt,
    LPUNKNOWN pcmdtReserved,
    LPDISPATCH pdispReserved);

Parameter

dwID
Bezeichner des anzuzeigenden Kontextmenüs. Eine Liste der Werte finden Sie IDocHostUIHandler::ShowContextMenu im Windows SDK.

ppt
Bildschirmkoordinaten für das Menü.

pcmdtReserved
IOleCommandTarget Schnittstelle zum Abfragen des Befehlsstatus und Ausführen von Befehlen für dieses Objekt.

pdispReserved
IDispatch Schnittstelle des Objekts an den Bildschirmkoordinaten. Auf diese Weise kann ein Host bestimmte Objekte unterscheiden, um einen spezifischeren Kontext bereitzustellen.

Rückgabewert

Eine Liste der Werte finden Sie IDocHostUIHandler::ShowContextMenu im Windows SDK.

Hinweise

Überschreiben OnShowContextMenu , um auf die ShowContextMenu Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::ShowContextMenu im Windows SDK.

CHtmlView::OnShowUI

Wird aufgerufen, wenn die Anzeige von Menüs und Symbolleisten in Internet Explorer oder MSHTML bevorsteht.

virtual HRESULT OnShowUI(
    DWORD dwID,
    LPOLEINPLACEACTIVEOBJECT pActiveObject,
    LPOLECOMMANDTARGET pCommandTarget,
    LPOLEINPLACEFRAME pFrame,
    LPOLEINPLACEUIWINDOW pDoc);

Parameter

dwID
Für die zukünftige Verwendung reserviert.

pActiveObject
IOleInPlaceActiveObject Schnittstelle des derzeit aktiven Objekts.

pCommandTarget
IOleCommandTarget Schnittstelle des Objekts.

pFrame
IOleInPlaceFrame Schnittstelle des Objekts. Dies ist für Menüs und Symbolleisten erforderlich.

pDoc
IOleInPlaceUIWindow Schnittstelle für das Objekt. Dies ist für Symbolleisten erforderlich.

Rückgabewert

Eine Liste der Werte finden Sie IDocHostUIHandler::ShowUI im Windows SDK.

Hinweise

Überschreiben OnShowUI , um auf die ShowUI Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::ShowUI im Windows SDK.

CHtmlView::OnStatusBar

Diese Memberfunktion wird vom Framework aufgerufen, wenn sich die StatusBar Eigenschaft geändert hat.

virtual void OnStatusBar(BOOL bStatusBar);

Parameter

bStatusBar
Nonzero, wenn die Statusleiste von Internet Explorer sichtbar oder null ist.

CHtmlView::OnStatusTextChange

Diese Memberfunktion wird vom Framework aufgerufen, um eine Anwendung zu benachrichtigen, dass der Text der Statusleiste, die dem WebBrowser-Steuerelement zugeordnet ist, geändert wurde.

virtual void OnStatusTextChange(LPCTSTR lpszText);

Parameter

lpszText
Eine Zeichenfolge, die den neuen Statusleistentext enthält.

CHtmlView::OnTheaterMode

Diese Memberfunktion wird vom Framework aufgerufen, wenn sich die TheaterMode Eigenschaft geändert hat.

virtual void OnTheaterMode(BOOL bTheaterMode);

Parameter

bTheaterMode
Nonzero, wenn Internet Explorer im Theatermodus ist; andernfalls null.

CHtmlView::OnTitleChange

Diese Memberfunktion wird vom Framework aufgerufen, um eine Anwendung zu benachrichtigen, wenn der Titel eines Dokuments im WebBrowser-Steuerelement verfügbar oder geändert wird.

virtual void OnTitleChange(LPCTSTR lpszText);

Parameter

lpszText
Der neue Dokumenttitel.

Hinweise

Bei HTML kann sich der Titel ändern; während html noch heruntergeladen wird, wird die URL des Dokuments als Titel festgelegt. Nachdem der eigentliche Titel (sofern vorhanden) aus dem HTML-Code analysiert wurde, wird der Titel so geändert, dass er den tatsächlichen Titel widerspiegelt.

CHtmlView::OnToolBar

Diese Memberfunktion wird vom Framework aufgerufen, wenn sich die ToolBar Eigenschaft geändert hat.

virtual void OnToolBar(BOOL bToolBar);

Parameter

bToolBar
Nonzero, wenn die Symbolleiste von Internet Explorer sichtbar oder null ist.

CHtmlView::OnTranslateAccelerator

Wird von Internet Explorer oder MSHTML aufgerufen, wenn IOleInPlaceActiveObject::TranslateAccelerator oder IOleControlSite::TranslateAccelerator zum Verarbeiten von Menütastenmeldungen aus der Nachrichtenwarteschlange des Containers aufgerufen wird.

virtual HRESULT OnTranslateAccelerator(
    LPMSG lpMsg,
    const GUID* pguidCmdGroup,
    DWORD nCmdID);

Parameter

lpMsg
Verweist auf die Nachricht, die möglicherweise übersetzt werden muss.

pguidCmdGroup
Befehlsgruppenbezeichner.

nCmdID
Befehlsbezeichner.

Rückgabewert

S_OK wenn erfolgreich oder S_FALSE anderweitig.

Hinweise

Überschreiben OnTranslateAccelerator , um auf die TranslateAccelerator Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::TranslateAccelerator im Windows SDK.

CHtmlView::OnTranslateUrl

Wird von Internet Explorer oder MSHTML aufgerufen, um dem Host die Möglichkeit zu geben, die zu ladende URL zu ändern.

virtual HRESULT OnTranslateUrl(
    DWORD dwTranslate,
    OLECHAR* pchURLIn,
    OLECHAR** ppchURLOut);

Parameter

dwTranslate
Für die zukünftige Verwendung reserviert.

pchURLIn
Adresse einer von Internet Explorer oder MSHTML bereitgestellten Zeichenfolge, die die zu übersetzende URL darstellt.

ppchURLOut
Adresse eines Zeichenfolgenzeigers, der die Adresse der übersetzten URL empfängt. Der Host weist den Puffer mithilfe des Aufgabenspeicher-Allocators zu. Der Inhalt dieses Parameters sollte immer initialisiert NULLwerden, auch wenn die URL nicht übersetzt wird oder die Methode fehlschlägt.

Rückgabewert

S_OK wenn die URL übersetzt wurde, S_FALSE wenn die URL nicht übersetzt wurde, oder ein OLE-definierter Fehlercode, wenn ein Fehler aufgetreten ist.

Hinweise

Überschreiben OnTranslateUrl , um auf die TranslateUrl Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren. Weitere Informationen finden Sie IDocHostUIHandler::TranslateUrl im Windows SDK.

CHtmlView::OnUpdateUI

Benachrichtigt den Host, dass sich der Befehlsstatus geändert hat.

virtual HRESULT OnUpdateUI();

Rückgabewert

S_OK wenn dies erfolgreich ist oder andernfalls ein OLE-definierter Fehlercode vorliegt.

Hinweise

Der Host sollte den Status der Symbolleistenschaltflächen aktualisieren. Diese Methode wird unabhängig vom Rückgabewert aufgerufen.ShowUI Überschreiben OnUpdateUI , um auf die UpdateUI Benachrichtigung vom Microsoft-Webbrowser-Steuerelement zu reagieren.

CHtmlView::OnVisible

Diese Memberfunktion wird vom Framework aufgerufen, wenn das Fenster für den WebBrowser angezeigt oder ausgeblendet werden soll.

virtual void OnVisible(BOOL bVisible);

Parameter

bVisible
Nonzero, wenn das Objekt sichtbar oder null ist, andernfalls.

Hinweise

Dadurch kann sich das Hostfenster des Objektsteuerelements auf die gleiche Weise verhalten wie das Internet Explorer-Fenster.

CHtmlView::PutProperty

Rufen Sie diese Memberfunktion auf, um die eigenschaft festzulegen, die einem bestimmten Objekt zugeordnet ist.

void PutProperty(
    LPCTSTR lpszProperty,
    const VARIANT& vtValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    double dValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    long lValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    LPCTSTR lpszValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    short nValue);

Parameter

lpszProperty
Eine Zeichenfolge, die die festzulegende Eigenschaft enthält.

vtValue
Der neue Wert der durch lpszProperty.

lpszPropertyName
Ein Zeiger auf eine Zeichenfolge, die den Namen der festzulegenden Eigenschaft enthält.

dValue
Der neue Wert der -Eigenschaft.

lValue
Der neue Wert der -Eigenschaft.

lpszValue
Ein Zeiger auf eine Zeichenfolge, die den neuen Wert der Eigenschaft enthält.

nValue
Der neue Wert der -Eigenschaft.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::QueryFormsCommand

Fragt den Status von Befehlen ab, die von Ereignissen auf der Benutzeroberfläche generiert wurden.

HRESULT QueryFormsCommand(
    DWORD dwCommandID,
    BOOL* pbSupported,
    BOOL* pbEnabled,
    BOOL* pbChecked);

Parameter

dwCommandID
Der Bezeichner des Befehls, für den abgefragt wird.

pbSupported
Ein Zeiger auf eine BOOL Angabe, ob der Befehl (identifiziert durch dwCommandID) unterstützt wird. Wenn TRUEder Befehl unterstützt wird; andernfalls FALSE.

pbEnabled
Ein Zeiger auf eine BOOL Angabe, ob der Befehl (identifiziert durch dwCommandID) aktiviert ist. Wenn TRUEder Befehl unterstützt wird; andernfalls FALSE.

pbChecked
Ein Zeiger auf eine BOOL Angabe, ob der Befehl (identifiziert durch dwCommandID) aktiviert ist. Wenn TRUEder Befehl unterstützt wird; andernfalls FALSE.

Rückgabewert

Ein Standard HRESULT -Wert. Eine vollständige Auflistung möglicher Werte finden Sie im IOleCommandTarget::QueryStatus Windows SDK.

Hinweise

QueryFormsCommand implementiert das Verhalten der IOleCommandTarget::QueryStatus Methode.

CHtmlView::QueryStatusWB

Rufen Sie diese Memberfunktion auf, um einen Befehlsstatus abzufragen.

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

Parameter

cmdID
Der OLECMDID Wert des Befehls, für den der Aufrufer Statusinformationen benötigt.

Rückgabewert

Die Adresse des OLECMDF Werts, der den Status des Befehls empfängt.

Hinweise

QueryStatusWB implementiert das Verhalten der IOleCommandTarget::QueryStatus Methode.

Betrifft Internet Explorer und WebBrowser.

CHtmlView::Refresh

Lädt die URL oder Datei neu, die der Webbrowser derzeit anzeigt.

void Refresh();

Hinweise

Refresh enthält keine Parameter zum Festlegen der Aktualisierungsebene.

Betrifft Internet Explorer und WebBrowser.

CHtmlView::Refresh2

Lädt die Datei neu, die derzeit in Internet Explorer angezeigt wird.

void Refresh2(int nLevel);

Parameter

nLevel
Die Adresse der Variablen, die die Aktualisierungsebene angibt. Die möglichen Variablen werden im RefreshConstantsWindows SDK definiert.

Hinweise

Im Gegensatz dazu RefreshRefresh2 enthält ein Parameter, der die Aktualisierungsebene angibt.

Betrifft Internet Explorer und WebBrowser.

CHtmlView::SetAddressBar

Rufen Sie diese Memberfunktion auf, um die Adressleiste des Internet Explorer-Objekts ein- oder auszublenden.

void SetAddressBar(BOOL bNewValue);

Parameter

bNewValue
Nonzero zum Anzeigen der Adressleiste; andernfalls 0.

Hinweise

Gilt für Internet Explorer. Wenn Sie diesen Aufruf mit einem WebBrowser-Steuerelement verwenden, wird kein Fehler zurückgegeben, dieser Aufruf wird jedoch ignoriert.

CHtmlView::SetFullScreen

Rufen Sie diese Memberfunktion auf, um Internet Explorer auf den Vollbild- oder normalen Fenstermodus festzulegen.

void SetFullScreen(BOOL bNewValue);

Parameter

bNewValue
Nonzero für den Vollbildmodus; andernfalls 0.

Hinweise

Im Vollbildmodus wird das Internet Explorer-Hauptfenster maximiert, und die Statusleiste, die Symbolleiste, die Menüleiste und die Titelleiste sind ausgeblendet.

Gilt für Internet Explorer. Wenn Sie diesen Aufruf mit einem WebBrowser-Steuerelement verwenden, wird kein Fehler zurückgegeben, dieser Aufruf wird jedoch ignoriert.

CHtmlView::SetHeight

Rufen Sie diese Memberfunktion auf, um die Höhe des Internet Explorer-Hauptfensters festzulegen.

void SetHeight(long nNewValue);

Parameter

nNewValue
Die Höhe des Hauptfensters in Pixel.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::SetLeft

Legt die horizontale Position des Internet Explorer-Hauptfensters fest.

void SetLeft(long nNewValue);

Parameter

nNewValue
Die Bildschirmkoordinate des linken Rands des Hauptfensters.

CHtmlView::SetMenuBar

Rufen Sie diese Memberfunktion auf, um die Internet Explorer-Menüleiste ein- oder auszublenden.

void SetMenuBar(BOOL bNewValue);

Parameter

bNewValue
Nonzero zum Anzeigen der Menüleiste; andernfalls 0.

Hinweise

Gilt für Internet Explorer. Wenn Sie diesen Aufruf mit einem WebBrowser-Steuerelement verwenden, wird kein Fehler zurückgegeben, dieser Aufruf wird jedoch ignoriert.

CHtmlView::SetOffline

Rufen Sie diese Memberfunktion auf, um einen Wert festzulegen, der angibt, ob das WebBrowser-Steuerelement derzeit im Offlinemodus ausgeführt wird.

void SetOffline(BOOL bNewValue);

Parameter

bNewValue
Nonzero zum Lesen aus dem lokalen Cache; andernfalls 0.

Hinweise

Im Offlinemodus liest der Browser HTML-Seiten aus dem lokalen Cache und nicht aus dem Quelldokument.

Betrifft Internet Explorer und WebBrowser.

CHtmlView::SetRegisterAsBrowser

Rufen Sie diese Memberfunktion auf, um einen Wert festzulegen, der angibt, ob das WebBrowser-Steuerelement als Browser auf oberster Ebene für die Auflösung von Zielnamen registriert ist.

void SetRegisterAsBrowser(BOOL bNewValue);

Parameter

bNewValue
Bestimmt, ob Internet Explorer als Browser auf oberster Ebene registriert ist. Wenn nonzero, wird der Webbrowser als Browser auf oberster Ebene registriert; wenn null, handelt es sich nicht um einen Browser auf oberster Ebene. Der Standardwert ist 0 (null).

Hinweise

Ein Browser auf oberster Ebene ist der Browser, der in der Registrierung als Standardbrowser festgelegt ist.

Betrifft Internet Explorer und WebBrowser.

CHtmlView::SetRegisterAsDropTarget

Rufen Sie diese Memberfunktion auf, um einen Wert festzulegen, der angibt, ob das WebBrowser-Steuerelement als Drop-Ziel für die Navigation registriert ist.

void SetRegisterAsDropTarget(BOOL bNewValue);

Parameter

bNewValue
Bestimmt, ob das WebBrowser-Steuerelement als Drop-Ziel für die Navigation registriert ist. Wenn nonzero, wird das Objekt als Drop-Ziel registriert. wenn 0, ist es kein Drop-Ziel.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::SetSilent

Rufen Sie diese Memberfunktion auf, um einen Wert festzulegen, der angibt, ob Dialogfelder angezeigt werden können.

void SetSilent(BOOL bNewValue);

Parameter

bNewValue
Wenn keine Zero-Kontrollkästchen angezeigt werden, werden keine Dialogfelder angezeigt. Wenn Null, werden Dialogfelder angezeigt. Der Standardwert ist 0 (null).

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::SetStatusBar

Rufen Sie diese Memberfunktion auf, um die Statusleiste anzuzeigen.

void SetStatusBar(BOOL bNewValue);

Parameter

bNewValue
Nonzero, wenn die Statusleiste sichtbar ist; andernfalls 0.

Hinweise

Gilt für Internet Explorer. Wenn Sie diesen Aufruf mit einem WebBrowser-Steuerelement verwenden, wird kein Fehler zurückgegeben, dieser Aufruf wird jedoch ignoriert.

CHtmlView::SetTheaterMode

Rufen Sie diese Memberfunktion auf, um einen Wert festzulegen, der angibt, ob sich das WebBrowser-Steuerelement im Theatermodus befindet.

void SetTheaterMode(BOOL bNewValue);

Parameter

bNewValue
Nonzero, um das WebBrowser-Steuerelement auf den Theatermodus festzulegen; andernfalls 0. Der Standardwert ist 0 (null).

Hinweise

Wenn sich der Webbrowser im Theatermodus befindet, füllt das Hauptfenster des Browsers den gesamten Bildschirm, eine Symbolleiste mit einem minimalen Satz von Navigationstools wird angezeigt, und die Statusleiste wird in der oberen rechten Ecke des Bildschirms angezeigt.

Betrifft Internet Explorer und WebBrowser.

CHtmlView::SetToolBar

Rufen Sie diese Memberfunktion auf, um die Internet Explorer-Symbolleiste ein- oder auszublenden.

void SetToolBar(int nNewValue);

Parameter

nNewValue
Gibt an, ob die Symbolleiste angezeigt werden soll. Nonzero, wenn die Symbolleiste angezeigt werden soll; andernfalls 0.

Hinweise

Gilt für Internet Explorer. Wenn Sie diesen Aufruf mit einem WebBrowser-Steuerelement verwenden, wird kein Fehler zurückgegeben, dieser Aufruf wird jedoch ignoriert.

CHtmlView::SetTop

Rufen Sie diese Memberfunktion auf, um den Abstand zwischen dem internen oberen Rand des WebBrowser-Steuerelements und dem oberen Rand des Containers festzulegen.

void SetTop(long nNewValue);

Parameter

nNewValue
Die Bildschirmkoordinate des oberen Rands des Hauptfensters.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::SetVisible

Rufen Sie diese Memberfunktion auf, um den Sichtbarkeitsstatus des WebBrowser-Steuerelements festzulegen.

void SetVisible(BOOL bNewValue);

Parameter

bNewValue
Nonzero, wenn das Steuerelement sichtbar ist; andernfalls 0.

Hinweise

Betrifft Internet Explorer und WebBrowser.

CHtmlView::SetWidth

Legt die Breite des Internet Explorer-Hauptfensters fest.

void SetWidth(long nNewValue);

Parameter

nNewValue
Die Breite des Internet Explorer-Hauptfensters in Pixel.

CHtmlView::Stop

Rufen Sie diese Memberfunktion auf, um alle ausstehenden Navigations- oder Downloadvorgänge abzubrechen und alle dynamischen Seitenelemente wie Hintergrundsounds und Animationen zu beenden.

void Stop();

Hinweise

Betrifft Internet Explorer und WebBrowser.

Siehe auch

MFC-Beispiel MFCIE
CFormView-Klasse
Hierarchiediagramm
IWebBrowser2