Třída CHtmlView

Poskytuje funkce ovládacího prvku WebBrowser v kontextu architektury dokumentů a zobrazení mfc.

Syntaxe

class CHtmlView : public CFormView

Členové

Veřejné metody

Název	Popis
CHtmlView::Create	Vytvoří ovládací prvek WebBrowser.
CHtmlView::CreateControlSite	Lze přepsat pomocí vytvoření instance řídicí lokality pro hostování ovládacího prvku ve formuláři.
CHtmlView::ExecFormsCommand	Spustí zadaný příkaz pomocí IOleCommandTarget::Exec metody.
CHtmlView::ExecWB	Spustí příkaz.
CHtmlView::GetAddressBar	Určuje, zda je viditelný adresní řádek objektu aplikace Internet Explorer. (Ovládací prvek WebBrowser ignoruje; Pouze Internet Explorer.)
CHtmlView::GetApplication	Načte objekt aplikace představující aplikaci, která obsahuje aktuální instanci aplikace Internet Explorer.
CHtmlView::GetBusy	Načte hodnotu označující, jestli probíhá stahování nebo jiná aktivita.
CHtmlView::GetContainer	Načte kontejner ovládacího prvku WebBrowser.
CHtmlView::GetFullName	Načte celý název prostředku, včetně cesty, který se zobrazí ve webovém prohlížeči. (Ovládací prvek WebBrowser ignoruje; Pouze Internet Explorer.)
CHtmlView::GetFullScreen	Určuje, zda ovládací prvek WebBrowser funguje v režimu zobrazení na celé obrazovce nebo v normálním režimu okna.
CHtmlView::GetHeight	Načte výšku hlavního okna Internet Exploreru.
CHtmlView::GetHtmlDocument	Načte aktivní dokument HTML.
CHtmlView::GetLeft	Načte souřadnici obrazovky levého okraje hlavního okna Aplikace Internet Explorer.
CHtmlView::GetLocationName	Načte název prostředku, který právě zobrazuje WebBrowser.
CHtmlView::GetLocationURL	Načte adresu URL prostředku, který právě zobrazuje WebBrowser.
CHtmlView::GetMenuBar	Načte hodnotu, která určuje, zda je řádek nabídek viditelný.
CHtmlView::GetOffline	Načte hodnotu, která určuje, zda je ovládací prvek offline.
CHtmlView::GetParentBrowser	Načte ukazatel na IDispatch rozhraní. Další informace naleznete v tématu Implementace IDispatch rozhraní.
CHtmlView::GetProperty	Načte aktuální hodnotu vlastnosti přidružené k danému objektu.
CHtmlView::GetReadyState	Načte připravený stav objektu webového prohlížeče.
CHtmlView::GetRegisterAsBrowser	Určuje, zda je ovládací prvek WebBrowser registrován jako prohlížeč nejvyšší úrovně pro překlad cílových názvů.
CHtmlView::GetRegisterAsDropTarget	Určuje, zda je ovládací prvek WebBrowser registrován jako cíl přetažení pro navigaci.
CHtmlView::GetSilent	Určuje, jestli se dají zobrazit nějaká dialogová okna.
CHtmlView::GetSource	Zdrojový kód HTML webové stránky.
CHtmlView::GetStatusBar	Určuje, jestli je zobrazený stavový řádek Internet Exploreru. (Ovládací prvek WebBrowser ignoruje; Pouze Internet Explorer.)
CHtmlView::GetTheaterMode	Určuje, zda je ovládací prvek WebBrowser v režimu kina.
CHtmlView::GetToolBar	Načte hodnotu, která určuje, zda je panel nástrojů viditelný.
CHtmlView::GetTop	Načte souřadnici obrazovky horního okraje hlavního okna aplikace Internet Explorer.
CHtmlView::GetTopLevelContainer	Načte hodnotu určující, zda aktuální objekt je kontejner nejvyšší úrovně ovládacího prvku WebBrowser.
CHtmlView::GetType	Načte název typu objektu dokumentu.
CHtmlView::GetVisible	Načte hodnotu označující, zda je objekt viditelný nebo skrytý.
CHtmlView::GetWidth	Načte šířku hlavního okna Internet Exploreru.
CHtmlView::GoBack	Přejde na předchozí položku v seznamu historie.
CHtmlView::GoForward	Přejde na další položku v seznamu historie.
CHtmlView::GoHome	Přejde na aktuální domovskou nebo úvodní stránku.
CHtmlView::GoSearch	Přejde na aktuální vyhledávací stránku.
CHtmlView::LoadFromResource	Načte prostředek v ovládacím prvku WebBrowser.
CHtmlView::Navigate	Přejde na prostředek identifikovaný adresou URL.
CHtmlView::Navigate2	Přejde k prostředku identifikovanému adresou URL nebo k souboru identifikovanému úplnou cestou.
CHtmlView::OnBeforeNavigate2	Volá se před operací navigace v daném WebBrowseru (v okně nebo elementu sady rámců).
CHtmlView::OnCommandStateChange	Volá se, aby aplikace oznámila, že se změnil povolený stav příkazu webového prohlížeče.
CHtmlView::OnDocumentComplete	Zavolá se, aby aplikace oznámila, že dokument dosáhl READYSTATE_COMPLETE stavu.
CHtmlView::OnDocWindowActivate	Volá se z aplikace Internet Explorer nebo MSHTML implementace IOleInPlaceActiveObject::OnDocWindowActivate, která upozorní aktivní místní objekt při aktivaci nebo deaktivaci okna dokumentu kontejneru.
CHtmlView::OnDownloadBegin	Volá se k upozornění aplikace, že začíná operace navigace.
CHtmlView::OnDownloadComplete	Volá se při dokončení operace navigace, byla zastavena nebo selhala.
CHtmlView::OnEnableModeless	Volána k povolení nebo zakázání bezmodálních dialogových oken, když kontejner vytvoří nebo zničí modální dialogové okno.
CHtmlView::OnFilterDataObject	Volá se na hostitele aplikací Internet Explorer nebo MSHTML, aby hostitel mohl nahradit objekt dat aplikace Internet Explorer nebo MSHTML.
CHtmlView::OnFrameWindowActivate	Volá se z IOleInPlaceActiveObject::OnFrameWindowActivate upozornění objektu při aktivaci nebo deaktivaci okna rámce nejvyšší úrovně kontejneru.
CHtmlView::OnFullScreen	Volá se při FullScreen změně vlastnosti.
CHtmlView::OnGetDropTarget	Volané aplikací Internet Explorer nebo MSHTML, když se používá jako cíl pro vyřazení, aby hostitel mohl poskytnout alternativu IDropTarget.
CHtmlView::OnGetExternal	Volal Internet Explorer nebo MSHTML pro získání rozhraní hostitele IDispatch .
CHtmlView::OnGetHostInfo	Načte možnosti uživatelského rozhraní hostitele Aplikace Internet Explorer nebo MSHTML.
CHtmlView::OnGetOptionKeyPath	Vrátí klíč registru, pod kterým aplikace Internet Explorer nebo MSHTML ukládá uživatelské předvolby.
CHtmlView::OnHideUI	Volá se, když Aplikace Internet Explorer nebo MSHTML odebere její nabídky a panely nástrojů.
CHtmlView::OnMenuBar	Volá se při MenuBar změně vlastnosti.
CHtmlView::OnNavigateComplete2	Volá se po dokončení navigace na hypertextový odkaz (na elementu okna nebo sady rámců).
CHtmlView::OnNavigateError	Volá se rozhraním, pokud navigace na hypertextový odkaz selže.
CHtmlView::OnNewWindow2	Volá se při vytvoření nového okna pro zobrazení prostředku.
CHtmlView::OnProgressChange	Volá se, aby aplikace oznámila, že byl aktualizován průběh operace stahování.
CHtmlView::OnPropertyChange	Volána k upozornění aplikace, že PutProperty metoda změnila hodnotu vlastnosti.
CHtmlView::OnQuit	Volá se k upozornění aplikace, že aplikace Internet Explorer je připravena ukončit. (Platí jenom pro Internet Explorer.
CHtmlView::OnResizeBorder	Volána z aplikace Internet Explorer nebo MSHTML implementace IOleInPlaceActiveObject::ResizeBorder, která upozorní objekt, který potřebuje změnit velikost svého ohraničení prostoru.
CHtmlView::OnShowContextMenu	Volá se z Internet Exploreru nebo MSHTML, když se chystá zobrazit místní nabídku.
CHtmlView::OnShowUI	Volal před Internet Explorer nebo MSHTML zobrazí své nabídky a panely nástrojů.
CHtmlView::OnStatusBar	Volá se při StatusBar změně vlastnosti.
CHtmlView::OnStatusTextChange	Volána k upozornění aplikace, že se změnil text stavového řádku přidruženého k ovládacímu prvku WebBrowser.
CHtmlView::OnTheaterMode	Volá se při TheaterMode změně vlastnosti.
CHtmlView::OnTitleChange	Zavolá se k oznámení aplikace, pokud název dokumentu v ovládacím prvku WebBrowser bude k dispozici nebo změní.
CHtmlView::OnToolBar	Volá se při ToolBar změně vlastnosti.
CHtmlView::OnTranslateAccelerator	Volal by Internet Explorer nebo MSHTML, pokud IOleInPlaceActiveObject::TranslateAccelerator nebo IOleControlSite::TranslateAccelerator je volána ke zpracování zpráv akcelerátor-key menu z fronty zpráv kontejneru.
CHtmlView::OnTranslateUrl	Volané aplikací Internet Explorer nebo MSHTML, aby hostitel mohl upravit adresu URL, která se má načíst.
CHtmlView::OnUpdateUI	Upozorní hostitele, že se změnil stav příkazu.
CHtmlView::OnVisible	Volá se, když by se mělo zobrazit nebo skrýt okno pro ovládací prvek WebBrowser.
CHtmlView::PutProperty	Nastaví hodnotu vlastnosti přidružené k danému objektu.
CHtmlView::QueryFormsCommand	Dotazy na stav jednoho nebo více příkazů generovaných událostmi uživatelského rozhraní
CHtmlView::QueryStatusWB	Dotazuje stav příkazu, který zpracovává ovládací prvek WebBrowser.
CHtmlView::Refresh	Znovu načte aktuální soubor.
CHtmlView::Refresh2	Znovu načte aktuální soubor a volitelně zabrání odeslání hlavičky pragma:nocache .
CHtmlView::SetAddressBar	Zobrazí nebo skryje adresní řádek objektu Internet Exploreru. (Ovládací prvek WebBrowser ignoruje; Pouze Internet Explorer.)
CHtmlView::SetFullScreen	Nastaví hodnotu, která určuje, jestli ovládací prvek pracuje v režimu zobrazení na celé obrazovce nebo v normálním režimu okna. (Ovládací prvek WebBrowser ignoruje; Pouze Internet Explorer.)
CHtmlView::SetHeight	Nastaví výšku hlavního okna Internet Exploreru.
CHtmlView::SetLeft	Nastaví vodorovnou pozici hlavního okna aplikace Internet Explorer.
CHtmlView::SetMenuBar	Nastaví hodnotu, která určuje, jestli je řádek nabídek ovládacího prvku viditelný. (Ovládací prvek WebBrowser ignoruje; Pouze Internet Explorer.)
CHtmlView::SetOffline	Nastaví hodnotu, která určuje, jestli je ovládací prvek offline.
CHtmlView::SetRegisterAsBrowser	Nastaví hodnotu označující, zda je ovládací prvek WebBrowser registrován jako prohlížeč nejvyšší úrovně pro překlad cílových názvů.
CHtmlView::SetRegisterAsDropTarget	Nastaví hodnotu označující, zda je ovládací prvek WebBrowser registrován jako cíl přetažení pro navigaci.
CHtmlView::SetSilent	Nastaví hodnotu, která určuje, zda ovládací prvek zobrazí dialogová okna.
CHtmlView::SetStatusBar	Nastaví hodnotu, která určuje, jestli je zobrazený stavový řádek Internet Exploreru. (Ovládací prvek WebBrowser ignoruje; Pouze Internet Explorer.)
CHtmlView::SetTheaterMode	Nastaví hodnotu označující, zda je ovládací prvek WebBrowser v režimu kina.
CHtmlView::SetToolBar	Nastaví hodnotu, která určuje, jestli je panel nástrojů ovládacího prvku viditelný. (Ovládací prvek WebBrowser ignoruje; Pouze Internet Explorer.)
CHtmlView::SetTop	Nastaví svislou pozici hlavního okna aplikace Internet Explorer.
CHtmlView::SetVisible	Nastaví hodnotu označující, zda je objekt viditelný nebo skrytý.
CHtmlView::SetWidth	Nastaví šířku hlavního okna Internet Exploreru.
CHtmlView::Stop	Ukončí otevírání souboru.

Poznámky

Ovládací prvek WebBrowser je okno, ve kterém uživatel může procházet weby na webu a složky v místním systému souborů a v síti. Ovládací prvek WebBrowser podporuje hypertextové odkazy, navigaci url (Uniform Resource Locator) a udržuje seznam historie.

CHtmlView Použití třídy v aplikaci MFC

Ve standardní aplikaci rozhraní MFC (založené na SDI nebo MDI) je objekt zobrazení běžně odvozen ze specializované sady tříd. Tyto třídy, všechny odvozené z CView, poskytují specializované funkce nad rámec toho, co poskytuje CView.

Nastavení třídy zobrazení aplikace na CHtmlView poskytuje zobrazení s ovládacím prvku WebBrowser. Díky tomu je aplikace webovým prohlížečem. Upřednostňovanou metodou vytvoření aplikace ve stylu webového prohlížeče je použití Průvodce aplikací MFC a určení CHtmlView jako třída zobrazení. Další informace o implementaci a použití ovládacího prvku WebBrowser v aplikacích MFC naleznete v tématu Vytvoření aplikace ve stylu webového prohlížeče.

Poznámka:

Ovládací prvek ActiveX WebBrowser (a protoCHtmlView) je k dispozici pouze pro programy spuštěné v systém Windows NT verze 4.0 nebo novější, ve kterých je nainstalována aplikace Internet Explorer 4.0 nebo novější.

CHtmlView je určen pro aplikace, které přistupuje k webu (a/nebo k dokumentům HTML). Následující CHtmlView členské funkce platí jenom pro aplikaci Internet Explorer. Tyto funkce budou u ovládacího prvku WebBrowser úspěšné, ale nebudou mít žádný viditelný efekt.

• GetAddressBar
• GetFullName
• GetStatusBar
• SetAddressBar
• SetFullScreen
• SetMenuBar
• SetStatusBar
• SetToolBar

Hierarchie dědičnosti

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

Požadavky

Záhlaví: afxhtml.h

CHtmlView::Create

Voláním této členské funkce vytvořte ovládací prvek Nebo kontejner WebBrowser pro spustitelný soubor aplikace Internet Explorer.

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

Parametry

lpszClassName
Odkazuje na řetězec znaků ukončený hodnotou null, který pojmenuje třídu Windows. Název třídy může být libovolný název zaregistrovaný v AfxRegisterWndClass globální funkci nebo RegisterClass funkci Windows. Pokud NULLpoužijete předdefinované výchozí CFrameWnd atributy.

lpszWindowName
Odkazuje na řetězec znaků s ukončenou hodnotou null, který představuje název okna.

dwStyle
Určuje atributy stylu okna. Ve výchozím nastavení jsou styly WS_VISIBLE Windows WS_CHILD nastavené.

rect
Odkaz na RECT strukturu určující velikost a umístění okna. Tato rectDefault hodnota umožňuje systému Windows určit velikost a umístění nového okna.

pParentWnd
Ukazatel na nadřazené okno ovládacího prvku.

nID
Číslo ID zobrazení. Ve výchozím nastavení je nastavena hodnota AFX_IDW_PANE_FIRST.

pContext
Ukazatel na .CCreateContext NULL ve výchozím nastavení.

CHtmlView::CreateControlSite

Lze přepsat pomocí vytvoření instance řídicí lokality pro hostování ovládacího prvku ve formuláři.

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

Parametry

pContainer
Ukazatel na COleControlContainer objekt obsahující ovládací prvek.

ppSite
Ukazatel na ukazatel na COleControlSite objekt, který poskytuje web ovládacího prvku.

nID
Identifikátor ovládacího prvku, který se má hostovat.

clsid
CLSID ovládacího prvku, který se má hostovat

Návratová hodnota

Vrátí TRUE úspěch FALSE při selhání.

Poznámky

Tuto členovou funkci můžete přepsat tak, aby vrátila instanci vlastní třídy webu ovládacího prvku.

CHtmlView::ExecFormsCommand

Spustí zadaný příkaz pomocí IOleCommandTarget::Exec metody.

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

Parametry

dwCommandID
Příkaz, který se má spustit. Tento příkaz musí patřit do CMDSETID3_Forms3 skupiny.

pVarIn
Ukazatel na VARIANT strukturu obsahující vstupní argumenty Může to být NULL.

pVarOut
Ukazatel na VARIANT strukturu pro příjem výstupu příkazu Může to být NULL.

Návratová hodnota

Standardní HRESULT hodnota. Úplný seznam možných hodnot najdete IOleCommandTarget::Exec v sadě Windows SDK.

Poznámky

ExecFormsCommand implementuje chování IOleCommandTarget::Exec metody.

CHtmlView::ExecWB

Voláním této členské funkce spusťte příkaz v aplikaci WebBrowser nebo Internet Explorer.

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

Parametry

cmdID
Příkaz, který se má provést.

cmdexecopt
Možnosti nastavené pro spuštění příkazu.

pvaIn
Varianta použitá pro zadání vstupních argumentů příkazu.

pvaOut
Varianta použitá pro zadání výstupních argumentů příkazu.

Poznámky

Viz IWebBrowser2::ExecWB v sadě Windows SDK.

CHtmlView::GetAddressBar

Voláním této členské funkce načtěte adresní řádek aplikace Internet Explorer.

BOOL GetAddressBar() const;

Návratová hodnota

Nenulové, pokud je adresní řádek viditelný; jinak nula.

Poznámky

Platí pro Internet Explorer. Pokud použijete toto volání s ovládacím prvku WebBrowser, vrátí se žádná chyba, ale bude toto volání ignorovat.

CHtmlView::GetApplication

Voláním této členské funkce načtěte objekt automatizace podporovaný aplikací, která obsahuje ovládací prvek WebBrowser.

LPDISPATCH GetApplication() const;

Návratová hodnota

Ukazatel na IDispatch rozhraní aktivního objektu dokumentu. Další informace naleznete v tématu Implementace IDispatch rozhraní.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetBusy

Voláním této členské funkce určíte, zda je ovládací prvek WebBrowser zapojen do navigace nebo stahování operace.

BOOL GetBusy() const;

Návratová hodnota

Nenulové, pokud je webový prohlížeč zaneprázdněn; jinak nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetContainer

Voláním této členské funkce načtěte objekt, který se vyhodnotí jako kontejner webového prohlížeče.

LPDISPATCH GetContainer() const;

Návratová hodnota

Ukazatel na IDispatch rozhraní aktivního objektu dokumentu.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetFullName

Voláním této členské funkce načtěte úplnou cestu k souboru, který aplikace Internet Explorer právě zobrazuje.

CString GetFullName() const;

Návratová hodnota

Objekt CString obsahující cestu a název aktuálně zobrazeného souboru. Pokud neexistuje žádná cesta a název souboru, GetFullName vrátí prázdnou CStringhodnotu .

Poznámky

Platí pro Internet Explorer. Pokud použijete toto volání s ovládacím prvku WebBrowser, vrátí se žádná chyba, ale bude toto volání ignorovat.

CHtmlView::GetFullScreen

Voláním této členské funkce určíte, zda ovládací prvek WebBrowser funguje v režimu zobrazení na celé obrazovce nebo v normálním režimu okna.

BOOL GetFullScreen() const;

Návratová hodnota

Nenulové, pokud webBrowser pracuje v režimu zobrazení na celé obrazovce; jinak nula.

Poznámky

V režimu celé obrazovky je hlavní okno Internet Exploreru maximalizované a stavový řádek, panel nástrojů, řádek nabídek a záhlaví jsou skryté.

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetHeight

Voláním této členské funkce načtěte výšku v pixelech okna rámečku ovládacího prvku WebBrowser.

long GetHeight() const;

Návratová hodnota

Výška okna rámečku ovládacího prvku v pixelech

CHtmlView::GetHtmlDocument

Voláním této členské funkce načtěte dokument HTML pro aktivní dokument.

LPDISPATCH GetHtmlDocument() const;

Návratová hodnota

Ukazatel na IDispatch rozhraní aktivního objektu dokumentu.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetLeft

Voláním této členské funkce načtěte vzdálenost mezi vnitřním levým okrajem ovládacího prvku WebBrowser a levým okrajem jeho kontejneru.

long GetLeft() const;

Návratová hodnota

Vzdálenost levého okraje v pixelech.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetLocationName

Voláním této členské funkce získáte název prostředku, který se zobrazí v Nástroji WebBrowser.

CString GetLocationName() const;

Návratová hodnota

Objekt CString obsahující název prostředku, který se aktuálně zobrazuje v nástroji WebBrowser.

Poznámky

Pokud je zdrojem stránka HTML na webu, název je název této stránky. Pokud je prostředek složkou nebo souborem v síti nebo místním počítači, je název UNC nebo úplná cesta ke složce nebo souboru.

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetLocationURL

Voláním této členské funkce načtěte adresu URL prostředku, který aktuálně zobrazuje ovládací prvek WebBrowser.

CString GetLocationURL() const;

Návratová hodnota

Objekt CString obsahující adresu URL prostředku, který se aktuálně zobrazuje v nástroji WebBrowser.

Poznámky

Pokud je prostředek složkou nebo souborem v síti nebo místním počítači, je název UNC nebo úplná cesta ke složce nebo souboru.

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetMenuBar

Voláním této členské funkce určíte, jestli je řádek nabídek viditelný.

BOOL GetMenuBar() const;

Návratová hodnota

Nenulové, pokud je řádek nabídek viditelný; jinak nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetOffline

Voláním této členské funkce určíte, jestli webový prohlížeč funguje offline.

BOOL GetOffline() const;

Návratová hodnota

Nenulové, pokud je webový prohlížeč momentálně offline; jinak nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetParentBrowser

Voláním této členské funkce načtěte ukazatel na nadřazený objekt ovládacího prvku WebBrowser.

LPDISPATCH GetParentBrowser() const;

Návratová hodnota

Ukazatel na IDispatch rozhraní objektu, který je nadřazený Ovládací prvek WebBrowser.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetProperty

Voláním této členské funkce získáte hodnotu vlastnosti, která je aktuálně přidružena k ovládacímu prvku.

BOOL GetProperty(
    LPCTSTR lpszProperty,
    CString& strValue);

COleVariant GetProperty(LPCTSTR lpszProperty);

Parametry

lpszProperty
Ukazatel na řetězec obsahující vlastnost, která se má načíst.

strValue
Odkaz na CString objekt, který přijímá aktuální hodnotu vlastnosti.

Návratová hodnota

V první verzi, nenulové, pokud bylo úspěšně dokončeno; jinak nula. Ve druhé verzi objekt.COleVariant

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetReadyState

Voláním této členské funkce načtěte připravený stav objektu WebBrowser.

READYSTATE GetReadyState() const;

Návratová hodnota

READYSTATE Hodnota, jak je popsáno v sadě Windows SDK.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetRegisterAsBrowser

Voláním této členské funkce určíte, zda je objekt WebBrowser registrován jako prohlížeč nejvyšší úrovně pro překlad cílových názvů.

BOOL GetRegisterAsBrowser() const;

Návratová hodnota

Nenulové, pokud je prohlížeč zaregistrovaný jako prohlížeč nejvyšší úrovně; jinak nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetRegisterAsDropTarget

Voláním této členské funkce určíte, zda je ovládací prvek WebBrowser registrován jako cíl přetažení pro navigaci.

BOOL GetRegisterAsDropTarget() const;

Návratová hodnota

Nenulové, pokud je prohlížeč registrován jako cíl pro odstranění; jinak nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetSilent

Voláním této členské funkce určíte, zda se dají v ovládacím prvku WebBrowser zobrazit nějaká dialogová okna.

BOOL GetSilent() const;

Návratová hodnota

Nenulové, pokud dialogová okna nelze zobrazit z ovládacího prvku WebBrowser; jinak nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetSource

Voláním této členské funkce načtěte zdrojový kód HTML pro webovou stránku.

BOOL GetSource(CString& strRef);

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Parametry

refString
A CString , který bude obsahovat zdrojový kód.

Poznámky

Tato funkce je ekvivalentní příkazu Zobrazit zdroj v Aplikaci Internet Explorer s tím rozdílem, že zdrojový kód je vrácen v objektu CString.

CHtmlView::GetStatusBar

Voláním této členské funkce určíte, zda ovládací prvek WebBrowser zobrazí stavový řádek.

BOOL GetStatusBar() const;

Návratová hodnota

Nenulové, pokud je možné zobrazit stavový řádek; jinak nula.

Poznámky

Platí pro Internet Explorer. Pokud použijete toto volání s ovládacím prvku WebBrowser, vrátí se žádná chyba, ale bude toto volání ignorovat.

CHtmlView::GetTheaterMode

Voláním této členské funkce určíte, jestli je webový prohlížeč v režimu kina.

BOOL GetTheaterMode() const;

Návratová hodnota

Nenulové, pokud je webový prohlížeč v režimu kina; jinak nula.

Poznámky

Když je webový prohlížeč v režimu kina, hlavní okno prohlížeče vyplní celou obrazovku, zobrazí se panel nástrojů s minimální sadou navigačních nástrojů a stavový řádek se zobrazí v pravém horním rohu obrazovky.

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetToolBar

Voláním této členské funkce určíte, zda je panel nástrojů viditelný.

int GetToolBar() const;

Návratová hodnota

Hodnota označující, zda je panel nástrojů viditelný. Nenulové, pokud je panel nástrojů viditelný; jinak nula.

CHtmlView::GetTop

Voláním této členské funkce načtěte souřadnici obrazovky horního okraje hlavního okna ovládacího prvku WebBrowser.

long GetTop() const;

Návratová hodnota

Adresa proměnné, která přijímá souřadnici obrazovky horního okraje hlavního okna

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetTopLevelContainer

Voláním této členské funkce určíte, zda je Internet Explorer kontejnerem nejvyšší úrovně ovládacího prvku WebBrowser.

BOOL GetTopLevelContainer() const;

Návratová hodnota

Nenulový kontejner je kontejner nejvyšší úrovně; jinak nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetType

Voláním této členské funkce načtěte název typu obsaženého aktivního dokumentu.

CString GetType() const;

Návratová hodnota

Objekt CString obsahující název typu obsaženého aktivního dokumentu.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetVisible

Voláním této členské funkce určíte, zda je obsažený objekt viditelný.

BOOL GetVisible() const;

Návratová hodnota

Nenulové, pokud je objekt viditelný; jinak nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GetWidth

Načte šířku hlavního okna Internet Exploreru.

long GetWidth() const;

Návratová hodnota

Aktuální šířka okna v pixelech.

CHtmlView::GoBack

Přejde zpět o jednu položku v seznamu historie.

void GoBack();

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GoForward

Umožňuje přeposlat jednu položku v seznamu historie.

void GoForward();

CHtmlView::GoHome

Přejde na aktuální domovskou nebo úvodní stránku zadanou v dialogovém okně Možnosti internetu aplikace Internet Explorer nebo v dialogovém okně Vlastnosti internetu, ke které se přistupuje z Ovládací panely.

void GoHome();

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::GoSearch

Přejde na aktuální vyhledávací stránku, jak je uvedeno v dialogovém okně Možnosti internetu aplikace Internet Explorer nebo v dialogovém okně Vlastnosti internetu, které se přistupuje z Ovládací panely.

void GoSearch();

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::LoadFromResource

Voláním této členské funkce načtěte zadaný prostředek do ovládacího prvku WebBrowser.

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

Parametry

lpszResource
Ukazatel na řetězec obsahující název prostředku, který se má načíst.

nRes
ID vyrovnávací paměti obsahující název prostředku, který se má načíst.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::Navigate

Voláním této členské funkce přejděte na prostředek identifikovaný adresou URL.

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

Parametry

URL
Řetězec přidělený volajícím, který obsahuje adresu URL pro přechod, nebo úplnou cestu k souboru, který se má zobrazit.

dwFlags
Příznaky proměnné, která určuje, zda má být prostředek přidán do seznamu historie, zda se má číst do mezipaměti nebo zapisovat z mezipaměti a zda se má prostředek zobrazit v novém okně. Proměnná může být kombinací hodnot definovaných výčtem BrowserNavConstants .

lpszTargetFrameName
Ukazatel na řetězec, který obsahuje název rámce, ve kterém se má prostředek zobrazit.

lpszHeaders
Ukazatel na hodnotu, která určuje hlavičky HTTP, které se mají odeslat na server. Tato záhlaví se přidají do výchozích hlaviček Aplikace Internet Explorer. Hlavičky můžou určovat například akci vyžadovanou serverem, typ dat předávaných serveru nebo stavový kód. Tento parametr se ignoruje, pokud URL se nejedná o adresu URL PROTOKOLU HTTP.

lpvPostData
Ukazatel na data, která se mají odeslat pomocí transakce HTTP POST. Například transakce POST slouží k odesílání dat shromážděných formulářem HTML. Pokud tento parametr nezadá žádná post data, Navigate vydá transakci HTTP GET. Tento parametr se ignoruje, pokud URL se nejedná o adresu URL PROTOKOLU HTTP.

dwPostDataLen
Data, která se mají odeslat pomocí transakce HTTP POST. Například transakce POST slouží k odesílání dat shromážděných formulářem HTML. Pokud tento parametr nezadá žádná post data, Navigate vydá transakci HTTP GET. Tento parametr se ignoruje, pokud URL se nejedná o adresu URL PROTOKOLU HTTP.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::Navigate2

Voláním této členské funkce přejděte k prostředku identifikovanému adresou URL nebo k souboru identifikovanému úplnou cestou.

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);

Parametry

pIDL
Ukazatel na ITEMIDLIST strukturu.

dwFlags
Příznaky proměnné, která určuje, zda má být prostředek přidán do seznamu historie, zda se má číst do mezipaměti nebo zapisovat z mezipaměti a zda se má prostředek zobrazit v novém okně. Proměnná může být kombinací hodnot definovaných výčtem BrowserNavConstants .

lpszTargetFrameName
Ukazatel na řetězec, který obsahuje název rámce, ve kterém se má prostředek zobrazit.

lpszURL
Ukazatel na řetězec obsahující adresu URL.

lpvPostData
Data, která se mají odeslat pomocí transakce HTTP POST. Například transakce POST slouží k odesílání dat shromážděných formulářem HTML. Pokud tento parametr nezadá žádná post data, Navigate2 vydá transakci HTTP GET. Tento parametr se ignoruje, pokud URL není adresa URL PROTOKOLU HTTP nebo HTTPS.

dwPostDataLen
Délka v bajtech dat, na lpvPostData která odkazuje parametr.

lpszHeaders
Ukazatel na hodnotu, která určuje hlavičky HTTP nebo HTTPS, které se mají odeslat na server. Tato záhlaví se přidají do výchozích hlaviček Aplikace Internet Explorer. Hlavičky můžou určovat například akci vyžadovanou serverem, typ dat předávaných serveru nebo stavový kód. Tento parametr se ignoruje, pokud URL není adresa URL PROTOKOLU HTTP nebo HTTPS.

baPostedData
Odkaz na CByteArray objekt.

Poznámky

Tato členová funkce rozšiřuje Navigate členovou funkci tím, že podporuje procházení speciálních složek, jako je Plocha a Můj počítač, které jsou reprezentovány parametrem pIDL.

Platí pro Internet Explorer a WebBrowser.

Příklad

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

CHtmlView::OnBeforeNavigate2

Tato členská funkce je volána architekturou, která způsobí, že se událost aktivuje před operací navigace ve webovém prohlížeči.

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

Parametry

lpszURL
Ukazatel na řetězec obsahující adresu URL, na který chcete přejít.

nFlags
Vyhrazeno pro budoucí použití.

lpszTargetFrameName
Řetězec, který obsahuje název rámce, ve kterém se má prostředek zobrazit, nebo NULL pokud není pro prostředek určen žádný pojmenovaný rámec.

baPostedData
Odkaz na CByteArray objekt obsahující data, která se mají odeslat na server, pokud se používá transakce HTTP POST.

lpszHeaders
Ukazatel na řetězec obsahující další hlavičky HTTP, které se mají odeslat na server (pouze adresy URL HTTP). Hlavičky můžou určovat například akci vyžadovanou serverem, typ dat předávaných serveru nebo stavový kód.

pbCancel
Ukazatel na příznak zrušení Aplikace může tento parametr nastavit na nenulovou, aby zrušila operaci navigace, nebo na nulu, aby mohla pokračovat.

CHtmlView::OnCommandStateChange

Tato členová funkce je volána architekturou, která upozorní aplikaci, že se změnil povolený stav příkazu webového prohlížeče.

virtual void OnCommandStateChange(
    long nCommand,
    BOOL bEnable);

Parametry

nCommand
Identifikátor příkazu, jehož povolený stav se změnil.

bEnable
Povolený stav. Tento parametr je nenulový, pokud je příkaz povolený, nebo nula, pokud je zakázaný.

CHtmlView::OnDocumentComplete

Tato členová funkce je volána architekturou, která upozorní aplikaci, že dokument dosáhl READYSTATE_COMPLETE stavu.

virtual void OnDocumentComplete(LPCTSTR lpszURL);

Parametry

lpszURL
Ukazatel na řetězec, který se vyhodnotí na adresu URL, název souboru UNC nebo PIDL (ukazatel na seznam identifikátorů položek), na který byl přešel.

Poznámky

Ne každý rámec tuto událost aktivuje, ale každý snímek, který OnDownloadBegin aktivuje událost, aktivuje odpovídající OnDocumentComplete událost.

Adresa URL označená lpszURL adresou URL se může lišit od adresy URL, na kterou byl prohlížeč přesměrován, protože tato adresa URL je kanonizovaná a kvalifikovaná adresa URL. Pokud například aplikace určuje adresu URL "www.microsoft.com" volání Navigate nebo Navigate2, adresa URL předaná uživatelem OnNavigateComplete2 bude "<https://www.microsoft.com/>". Také pokud server přesměroval prohlížeč na jinou adresu URL, přesměrovaná adresa URL se zde projeví.

CHtmlView::OnDocWindowActivate

Volá se z aplikace Internet Explorer nebo MSHTML implementace IOleInPlaceActiveObject::OnDocWindowActivate, která upozorní aktivní místní objekt při aktivaci nebo deaktivaci okna dokumentu kontejneru.

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

Parametry

fActivate
Označuje stav okna dokumentu. Pokud je tato hodnota nenulová, aktivuje se okno. Pokud je tato hodnota nula, okno se deaktivuje.

Návratová hodnota

S_OK v případě úspěchu nebo kódu chyby definovaného ole v opačném případě.

Poznámky

Přepsání OnDocWindowActivate pro reakci na OnDocWindowActivate oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::OnDocWindowActivate v sadě Windows SDK.

CHtmlView::OnDownloadBegin

Tato členová funkce je volána rozhraním pro zahájení stahování dokumentu.

virtual void OnDownloadBegin();

Poznámky

Tato událost se aktivuje krátce po OnBeforeNavigate2 události, pokud se navigace nezruší. Všechny animace nebo zaneprázdnění označující, že kontejner musí být připojený k této události.

CHtmlView::OnDownloadComplete

Tato členová funkce je volána architekturou, která označuje, že operace navigace byla dokončena, zastavena nebo selhala.

virtual void OnDownloadComplete();

CHtmlView::OnEnableModeless

Volá se při zobrazení modálního uživatelského rozhraní aplikace Internet Explorer nebo MSHTML.

virtual HRESULT OnEnableModeless(BOOL fEnable);

Parametry

fEnable
Označuje, jestli jsou dialogová okna bez režimu hostitele povolená nebo zakázaná. Pokud je tato hodnota nenulová, jsou povolena bezmodální dialogová okna. Pokud je tato hodnota nula, jsou dialogová okna bez režimu zakázaná.

Návratová hodnota

S_OK v případě úspěchu nebo kódu chyby definovaného ole v opačném případě.

Poznámky

Povolí nebo zakáže bezmodální dialogová okna, když kontejner vytvoří nebo zničí modální dialogové okno. Přepsání OnEnableModeless pro reakci na EnableModeless oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::EnableModeless v sadě Windows SDK.

CHtmlView::OnFilterDataObject

Volá se na hostitele aplikací Internet Explorer nebo MSHTML, aby hostitel mohl nahradit objekt dat aplikace Internet Explorer nebo MSHTML.

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

Parametry

pDataObject
IDataObject Adresa rozhraní dodaného aplikací Internet Explorer nebo MSHTML.

ppDataObject
Adresa, která přijímá IDataObject ukazatel rozhraní zadaný hostitelem. Obsah tohoto parametru by měl být vždy inicializován , NULLi když metoda selže.

Návratová hodnota

S_OK pokud je datový objekt nahrazen, S_FALSE pokud se datový objekt nenahradí, nebo kód chyby definovaný ole, pokud dojde k chybě.

Poznámky

Přepsání OnFilterDataObject pro reakci na FilterDataObject oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::FilterDataObject v sadě Windows SDK.

CHtmlView::OnFrameWindowActivate

Volá se z IOleInPlaceActiveObject::OnFrameWindowActivate upozornění objektu při aktivaci nebo deaktivaci okna rámce nejvyšší úrovně kontejneru.

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

Parametry

fActivate
Určuje stav okna rámce nejvyšší úrovně kontejneru. Pokud je tato hodnota nenulová, aktivuje se okno. Pokud je tato hodnota nula, okno se deaktivuje.

Návratová hodnota

S_OK v případě úspěchu nebo kódu chyby definovaného ole v opačném případě.

Poznámky

Přepsání OnFrameWindowActivate pro reakci na OnFrameWindowActivate oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::OnFrameWindowActivate v sadě Windows SDK.

CHtmlView::OnFullScreen

Tato členová funkce je volána rozhraním při FullScreen změně vlastnosti.

virtual void OnFullScreen(BOOL bFullScreen);

Parametry

bFullScreen
Nenulové, pokud je Internet Explorer v režimu celé obrazovky; v opačném případě nula.

CHtmlView::OnGetDropTarget

Volané aplikací Internet Explorer nebo MSHTML, když se používá jako cíl pro vyřazení, aby hostitel mohl poskytnout alternativu IDropTarget.

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

Parametry

pDropTarget
IDropTarget Aplikace Internet Explorer nebo MSHTML navrhuje použití.

ppDropTarget
IDropTarget Adresa příjemce ukazatele rozhraní, který IDropTarget chce hostitel poskytnout.

Návratová hodnota

Seznam IDocHostUIHandler::GetDropTarget návratových kódů najdete v sadě Windows SDK.

Poznámky

Přepsání OnGetDropTarget pro reakci na GetDropTarget oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::GetDropTarget v sadě Windows SDK.

CHtmlView::OnGetExternal

Volal Internet Explorer nebo MSHTML pro získání rozhraní hostitele IDispatch .

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

Parametry

lppDispatch
Ukazatel na adresu, která obdrží IDispatch ukazatel rozhraní hostitelské aplikace. Pokud hostitel zveřejňuje rozhraní Automation, může prostřednictvím tohoto parametru poskytnout odkaz na Internet Explorer nebo MSHTML. Obsah tohoto parametru by měl být vždy inicializován , NULLi když metoda selže.

Návratová hodnota

S_OK v případě úspěchu nebo kódu chyby definovaného ole v opačném případě.

Poznámky

Přepsání OnGetExternal pro reakci na GetExternal oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::GetExternal v sadě Windows SDK.

CHtmlView::OnGetHostInfo

Načte možnosti uživatelského rozhraní hostitele Aplikace Internet Explorer nebo MSHTML.

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

Parametry

pInfo
DOCHOSTUIINFO Adresa struktury, která přijímá možnosti uživatelského rozhraní hostitele

Návratová hodnota

S_OK v případě úspěchu nebo kódu chyby definovaného ole v opačném případě.

Poznámky

Přepsání OnGetHostInfo pro reakci na GetHostInfo oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::GetHostInfo v sadě Windows SDK.

CHtmlView::OnGetOptionKeyPath

Voláním této členské funkce získáte klíč registru, pod kterým aplikace Internet Explorer nebo MSHTML ukládá uživatelské předvolby.

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

Parametry

pchKey
Adresa příjemce LPOLESTR řetězce podklíče registru, do kterého hostitel ukládá výchozí možnosti. Tento podklíč bude pod HKEY_CURRENT_USER klíčem. Přidělit tuto paměť pomocí CoTaskMemAlloc. Volající aplikace zodpovídá za uvolnění této paměti pomocí CoTaskMemFree. Tento parametr by měl být vždy inicializován na NULL, i když metoda selže.

dwReserved
Vyhrazeno pro budoucí použití. Aktuálně se nepoužívá.

Návratová hodnota

S_OK v případě úspěchu nebo S_FALSE v opačném případě. Pokud S_FALSE, Aplikace Internet Explorer nebo MSHTML se ve výchozím nastavení nastaví na vlastní možnosti uživatele.

Poznámky

Přepsání OnGetOptionKeyPath pro reakci na GetOptionKeyPath oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::GetOptionKeyPath v sadě Windows SDK.

CHtmlView::OnHideUI

Tato členová funkce je volána rozhraním, když Aplikace Internet Explorer nebo MSHTML odebere své nabídky a panely nástrojů.

virtual HRESULT OnHideUI();

Návratová hodnota

S_OK v případě úspěchu nebo kódu chyby definovaného ole v opačném případě.

Poznámky

Přepsání OnHideUI pro reakci na HideUI oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::HideUI v sadě Windows SDK.

CHtmlView::OnMenuBar

Tato členová funkce je volána rozhraním při MenuBar změně vlastnosti.

virtual void OnMenuBar(BOOL bMenuBar);

Parametry

bMenuBar
Nenulové, pokud je řádek nabídek Aplikace Internet Explorer viditelný; v opačném případě nula.

CHtmlView::OnNavigateComplete2

Tato členová funkce je volána architekturou po dokončení navigace na hypertextový odkaz (v okně nebo elementu sady rámců).

virtual void OnNavigateComplete2(LPCTSTR strURL);

Parametry

strURL
Řetězcový výraz, který se vyhodnotí jako adresa URL, název souboru UNC nebo PIDL (ukazatel na seznam identifikátorů položek), na který byl přešel.

Poznámky

Parametr adresy URL může být PIDL, pokud existuje entita prostoru názvů prostředí, pro kterou neexistuje žádná reprezentace adresy URL.

Adresa URL obsažená v strURL adrese URL se může lišit od adresy URL, na kterou byl prohlížeč uveden, protože tato adresa URL je kanonizovaná a kvalifikovaná adresa URL. Pokud například aplikace určuje adresu URL "www.microsoft.com" volání Navigate nebo Navigate2, adresa URL předaná uživatelem OnNavigateComplete2 bude "<https://www.microsoft.com/>". Také pokud server přesměroval prohlížeč na jinou adresu URL, přesměrovaná adresa URL se zde projeví.

CHtmlView::OnNavigateError

Volá se rozhraním, pokud navigace na hypertextový odkaz selže.

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

Parametry

lpszURL
Adresa URL, pro kterou se navigace nezdařila.

lpszFrame
Název rámce, ve kterém se má prostředek zobrazit, nebo NULL pokud nebyl pro prostředek určen žádný pojmenovaný rámec.

dwError
Stavový kód chyby, pokud je k dispozici. Seznam možných HRESULT stavových kódů a stavových kódů HTTP najdete v tématu NavigateError Stavové kódy událostí.

pbCancel
Určuje, zda chcete zrušit navigaci na chybovou stránku nebo jakékoli další automatické hledání. Pokud TRUE (výchozí), pokračujte v navigaci na chybovou stránku nebo automatické hledání; pokud FALSE, zrušte navigaci na chybovou stránku nebo automatické hledání.

Poznámky

Tuto metodu přepište tak, aby poskytovala vlastní zpracování chyb navigace.

Další informace viz DWebBrowserEvents2::NavigateError.

CHtmlView::OnNewWindow2

Tato členová funkce je volána architekturou při vytvoření nového okna pro zobrazení prostředku.

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

Parametry

ppDisp
Ukazatel na ukazatel rozhraní, který volitelně obdrží IDispatch ukazatel rozhraní nového objektu WebBrowser nebo Internet Explorer.

Cancel
Ukazatel na příznak zrušení Aplikace může tento parametr nastavit na nenulovou, aby zrušila operaci navigace, nebo na nulu, aby mohla pokračovat.

Poznámky

Tato událost předchází vytvoření nového okna z webu WebBrowser.

CHtmlView::OnProgressChange

Tato členová funkce je volána architekturou, která upozorní aplikaci, že průběh operace stahování byl aktualizován.

virtual void OnProgressChange(
    long nProgress,
    long nProgressMax);

Parametry

nProgress
Množství celkového průběhu, které se má zobrazit, nebo -1 po dokončení průběhu.

nProgressMax
Maximální hodnota průběhu

Poznámky

Kontejner může pomocí informací poskytovaných touto událostí zobrazit počet bajtů stažených doposud nebo aktualizovat indikátor průběhu.

CHtmlView::OnPropertyChange

Tato členová funkce je volána architekturou, která upozorní aplikaci, která PutProperty změnila hodnotu vlastnosti.

virtual void OnPropertyChange(LPCTSTR lpszProperty);

Parametry

lpszProperty
Ukazatel na řetězec obsahující název vlastnosti.

CHtmlView::OnQuit

Tato členová funkce je volána architekturou, která upozorní aplikaci, že aplikace Internet Explorer je připravena ukončit.

virtual void OnQuit();

CHtmlView::OnResizeBorder

Volána z aplikace Internet Explorer nebo MSHTML implementace IOleInPlaceActiveObject::ResizeBorder, která upozorní objekt, který potřebuje změnit velikost svého ohraničení prostoru.

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

Parametry

prcBorder
Nový vnější obdélník pro ohraničení prostoru

pUIWindow
Ukazatel na rozhraní pro objekt okna rámečku nebo dokumentu, jehož ohraničení se změnilo.

fFrameWindow
TRUE je-li okno rámce volá IOleInPlaceActiveObject::ResizeBorder, jinak FALSE.

Návratová hodnota

S_OK v případě úspěchu nebo kódu chyby definovaného ole v opačném případě.

Poznámky

Přepsání OnResizeBorder pro reakci na ResizeBorder oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::ResizeBorder v sadě Windows SDK.

CHtmlView::OnShowContextMenu

Volá se z Internet Exploreru nebo MSHTML, když se chystá zobrazit místní nabídku.

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

Parametry

dwID
Identifikátor místní nabídky, která se má zobrazit. Seznam hodnot najdete IDocHostUIHandler::ShowContextMenu v sadě Windows SDK.

ppt
Souřadnice obrazovky pro nabídku

pcmdtReserved
IOleCommandTarget rozhraní používané k dotazování stavu příkazu a spouštění příkazů v tomto objektu.

pdispReserved
IDispatch rozhraní objektu na souřadnicích obrazovky. To umožňuje hostiteli rozlišovat konkrétní objekty, aby poskytoval konkrétnější kontext.

Návratová hodnota

Seznam hodnot najdete IDocHostUIHandler::ShowContextMenu v sadě Windows SDK.

Poznámky

Přepsání OnShowContextMenu pro reakci na ShowContextMenu oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::ShowContextMenu v sadě Windows SDK.

CHtmlView::OnShowUI

Volal před Internet Explorer nebo MSHTML zobrazí své nabídky a panely nástrojů.

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

Parametry

dwID
Vyhrazeno pro budoucí použití.

pActiveObject
IOleInPlaceActiveObject rozhraní aktuálně aktivního objektu.

pCommandTarget
IOleCommandTarget rozhraní objektu.

pFrame
IOleInPlaceFrame rozhraní objektu. To je potřeba pro nabídky a panely nástrojů.

pDoc
IOleInPlaceUIWindow rozhraní pro objekt. To je potřeba pro panely nástrojů.

Návratová hodnota

Seznam hodnot najdete IDocHostUIHandler::ShowUI v sadě Windows SDK.

Poznámky

Přepsání OnShowUI pro reakci na ShowUI oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::ShowUI v sadě Windows SDK.

CHtmlView::OnStatusBar

Tato členová funkce je volána rozhraním při StatusBar změně vlastnosti.

virtual void OnStatusBar(BOOL bStatusBar);

Parametry

bStatusBar
Nenulové, pokud je stavový řádek Internet Exploreru viditelný nebo nulový.

CHtmlView::OnStatusTextChange

Tato členová funkce je volána architekturou, která informuje aplikaci, že se změnil text stavového řádku přidruženého k ovládacímu prvku WebBrowser.

virtual void OnStatusTextChange(LPCTSTR lpszText);

Parametry

lpszText
Řetězec, který obsahuje nový text stavového řádku.

CHtmlView::OnTheaterMode

Tato členová funkce je volána rozhraním při TheaterMode změně vlastnosti.

virtual void OnTheaterMode(BOOL bTheaterMode);

Parametry

bTheaterMode
Nenulové, pokud je Internet Explorer v režimu kina; v opačném případě nula.

CHtmlView::OnTitleChange

Tato členová funkce je volána architekturou, která upozorní aplikaci, pokud je název dokumentu v ovládacím prvku WebBrowser k dispozici nebo se změní.

virtual void OnTitleChange(LPCTSTR lpszText);

Parametry

lpszText
Název nového dokumentu.

Poznámky

U HTML se název může změnit; zatímco html se stále stahuje, adresa URL dokumentu se nastaví jako název. Po skutečném názvu (pokud existuje) se z HTML analyzuje název, změní se název tak, aby odrážel skutečný název.

CHtmlView::OnToolBar

Tato členová funkce je volána rozhraním při ToolBar změně vlastnosti.

virtual void OnToolBar(BOOL bToolBar);

Parametry

bToolBar
Nenulové, pokud je panel nástrojů Internet Exploreru viditelný nebo nula jinak.

CHtmlView::OnTranslateAccelerator

Volal by Internet Explorer nebo MSHTML, pokud IOleInPlaceActiveObject::TranslateAccelerator nebo IOleControlSite::TranslateAccelerator je volána ke zpracování zpráv akcelerátor-key menu z fronty zpráv kontejneru.

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

Parametry

lpMsg
Odkazuje na zprávu, která může být potřeba přeložit.

pguidCmdGroup
Identifikátor skupiny příkazů.

nCmdID
Identifikátor příkazu.

Návratová hodnota

S_OK v případě úspěchu nebo S_FALSE v opačném případě.

Poznámky

Přepsání OnTranslateAccelerator pro reakci na TranslateAccelerator oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::TranslateAccelerator v sadě Windows SDK.

CHtmlView::OnTranslateUrl

Volané aplikací Internet Explorer nebo MSHTML, aby hostitel mohl upravit adresu URL, která se má načíst.

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

Parametry

dwTranslate
Vyhrazeno pro budoucí použití.

pchURLIn
Adresa řetězce zadaného aplikací Internet Explorer nebo MSHTML, který představuje adresu URL, která se má přeložit.

ppchURLOut
Adresa ukazatele řetězce, který obdrží adresu přeložené adresy URL. Hostitel přidělí vyrovnávací paměť pomocí alokátoru paměti úlohy. Obsah tohoto parametru by měl být vždy inicializován , NULLi když adresa URL není přeložena nebo metoda selže.

Návratová hodnota

S_OK pokud byla adresa URL přeložena, S_FALSE pokud adresa URL nebyla přeložena, nebo kód chyby definovaný ole, pokud došlo k chybě.

Poznámky

Přepsání OnTranslateUrl pro reakci na TranslateUrl oznámení z ovládacího prvku Microsoft Web Browser. Další informace najdete IDocHostUIHandler::TranslateUrl v sadě Windows SDK.

CHtmlView::OnUpdateUI

Upozorní hostitele, že se změnil stav příkazu.

virtual HRESULT OnUpdateUI();

Návratová hodnota

S_OK v případě úspěchu nebo kódu chyby definovaného ole v opačném případě.

Poznámky

Hostitel by měl aktualizovat stav tlačítek panelu nástrojů. Tato metoda je volána bez ohledu na návratovou hodnotu z ShowUI. Přepsání OnUpdateUI pro reakci na UpdateUI oznámení z ovládacího prvku Microsoft Web Browser.

CHtmlView::OnVisible

Tato členová funkce je volána architekturou, když by se mělo zobrazit nebo skrýt okno pro WebBrowser.

virtual void OnVisible(BOOL bVisible);

Parametry

bVisible
Nenulové, pokud je objekt viditelný nebo nulový jinak.

Poznámky

To umožňuje, aby se okno hostitele ovládacího prvku objektu chovalo stejně jako okno Aplikace Internet Explorer.

CHtmlView::PutProperty

Voláním této členské funkce nastavíte vlastnost přidruženou k danému objektu.

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);

Parametry

lpszProperty
Řetězec obsahující vlastnost, která se má nastavit.

vtValue
Nová hodnota vlastnosti označená parametrem lpszProperty.

lpszPropertyName
Ukazatel na řetězec obsahující název vlastnosti, která se má nastavit.

dValue
Nová hodnota vlastnosti.

lValue
Nová hodnota vlastnosti.

lpszValue
Ukazatel na řetězec obsahující novou hodnotu vlastnosti.

nValue
Nová hodnota vlastnosti.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::QueryFormsCommand

Dotazy na stav jednoho nebo více příkazů generovaných událostmi uživatelského rozhraní

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

Parametry

dwCommandID
Identifikátor příkazu, na který se dotazuje.

pbSupported
Ukazatel na BOOL určení, jestli je příkaz (identifikovaný dwCommandID) podporovaný. Pokud TRUEje příkaz podporován, jinak FALSE.

pbEnabled
Ukazatel na BOOL určení, jestli je příkaz (identifikovaný dwCommandID) povolený. Pokud TRUEje příkaz podporován, jinak FALSE.

pbChecked
Ukazatel na BOOL určení, zda je příkaz (identifikovaný ) zaškrtnutý dwCommandID. Pokud TRUEje příkaz podporován, jinak FALSE.

Návratová hodnota

Standardní HRESULT hodnota. Úplný seznam možných hodnot najdete IOleCommandTarget::QueryStatus v sadě Windows SDK.

Poznámky

QueryFormsCommand implementuje chování IOleCommandTarget::QueryStatus metody.

CHtmlView::QueryStatusWB

Voláním této členské funkce odešlete dotaz na stav příkazu.

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

Parametry

cmdID
OLECMDID Hodnota příkazu, pro který volající potřebuje informace o stavu.

Návratová hodnota

Adresa OLECMDF hodnoty, která obdrží stav příkazu.

Poznámky

QueryStatusWB implementuje chování IOleCommandTarget::QueryStatus metody.

Platí pro Internet Explorer a WebBrowser.

CHtmlView::Refresh

Znovu načte adresu URL nebo soubor, který se právě zobrazuje ve webovém prohlížeči.

void Refresh();

Poznámky

Refresh neobsahuje žádné parametry pro nastavení úrovně aktualizace.

Platí pro Internet Explorer a WebBrowser.

CHtmlView::Refresh2

Znovu načte soubor, který aplikace Internet Explorer právě zobrazuje.

void Refresh2(int nLevel);

Parametry

nLevel
Adresa proměnné určující úroveň aktualizace. Možné proměnné jsou definovány v RefreshConstantssadě Windows SDK.

Poznámky

Na rozdíl od Refreshparametru Refresh2 obsahuje parametr, který určuje úroveň aktualizace.

Platí pro Internet Explorer a WebBrowser.

CHtmlView::SetAddressBar

Voláním této členské funkce zobrazíte nebo skryjete adresní řádek objektu aplikace Internet Explorer.

void SetAddressBar(BOOL bNewValue);

Parametry

bNewValue
Nenulové zobrazení adresního řádku; jinak nula.

Poznámky

Platí pro Internet Explorer. Pokud použijete toto volání s ovládacím prvku WebBrowser, vrátí se žádná chyba, ale bude toto volání ignorovat.

CHtmlView::SetFullScreen

Voláním této členské funkce nastavíte Internet Explorer na režim celé obrazovky nebo normálního režimu okna.

void SetFullScreen(BOOL bNewValue);

Parametry

bNewValue
Nenulové pro režim zobrazení na celé obrazovce; jinak nula.

Poznámky

V režimu celé obrazovky je hlavní okno Internet Exploreru maximalizované a stavový řádek, panel nástrojů, řádek nabídek a záhlaví jsou skryté.

Platí pro Internet Explorer. Pokud použijete toto volání s ovládacím prvku WebBrowser, vrátí se žádná chyba, ale bude toto volání ignorovat.

CHtmlView::SetHeight

Voláním této členské funkce nastavíte výšku hlavního okna aplikace Internet Explorer.

void SetHeight(long nNewValue);

Parametry

nNewValue
Výška v pixelech hlavního okna.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::SetLeft

Nastaví vodorovnou pozici hlavního okna aplikace Internet Explorer.

void SetLeft(long nNewValue);

Parametry

nNewValue
Souřadnice obrazovky levého okraje hlavního okna.

CHtmlView::SetMenuBar

Voláním této členské funkce zobrazíte nebo skryjete řádek nabídek aplikace Internet Explorer.

void SetMenuBar(BOOL bNewValue);

Parametry

bNewValue
Nenulové zobrazení řádku nabídek; jinak nula.

Poznámky

Platí pro Internet Explorer. Pokud použijete toto volání s ovládacím prvku WebBrowser, vrátí se žádná chyba, ale bude toto volání ignorovat.

CHtmlView::SetOffline

Voláním této členské funkce nastavíte hodnotu označující, zda ovládací prvek WebBrowser aktuálně pracuje v offline režimu.

void SetOffline(BOOL bNewValue);

Parametry

bNewValue
Nenulové čtení z místní mezipaměti; jinak nula.

Poznámky

V offline režimu prohlížeč čte stránky HTML z místní mezipaměti, nikoli ze zdrojového dokumentu.

Platí pro Internet Explorer a WebBrowser.

CHtmlView::SetRegisterAsBrowser

Voláním této členské funkce nastavíte hodnotu označující, zda je ovládací prvek WebBrowser registrován jako prohlížeč nejvyšší úrovně pro překlad cílových názvů.

void SetRegisterAsBrowser(BOOL bNewValue);

Parametry

bNewValue
Určuje, jestli je Aplikace Internet Explorer zaregistrovaná jako prohlížeč nejvyšší úrovně. Pokud nenízero, webový prohlížeč je registrován jako prohlížeč nejvyšší úrovně; pokud nula, nejedná se o prohlížeč nejvyšší úrovně. Výchozí hodnota je nula.

Poznámky

Prohlížeč nejvyšší úrovně je prohlížeč nastavený v registru jako výchozí prohlížeč.

Platí pro Internet Explorer a WebBrowser.

CHtmlView::SetRegisterAsDropTarget

Voláním této členské funkce nastavíte hodnotu označující, zda je ovládací prvek WebBrowser registrován jako cíl přetažení pro navigaci.

void SetRegisterAsDropTarget(BOOL bNewValue);

Parametry

bNewValue
Určuje, zda je ovládací prvek WebBrowser registrován jako cíl přetažení pro navigaci. Pokud nenízero, objekt je registrován jako cíl přetažení; pokud nula, nejedná se o cíl odstranění.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::SetSilent

Voláním této členské funkce nastavíte hodnotu označující, jestli se dají zobrazit nějaká dialogová okna.

void SetSilent(BOOL bNewValue);

Parametry

bNewValue
Pokud nejsou nenulová, dialogová okna se nezobrazí; pokud je nula, zobrazí se dialogová okna. Výchozí hodnota je nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::SetStatusBar

Voláním této členské funkce zobrazíte stavový řádek.

void SetStatusBar(BOOL bNewValue);

Parametry

bNewValue
Nenulové, pokud je stavový řádek viditelný; jinak nula.

Poznámky

Platí pro Internet Explorer. Pokud použijete toto volání s ovládacím prvku WebBrowser, vrátí se žádná chyba, ale bude toto volání ignorovat.

CHtmlView::SetTheaterMode

Voláním této členské funkce nastavíte hodnotu označující, zda je ovládací prvek WebBrowser v režimu kina.

void SetTheaterMode(BOOL bNewValue);

Parametry

bNewValue
Nenulové nastavení ovládacího prvku WebBrowser na režim kina; jinak nula. Výchozí hodnota je nula.

Poznámky

Když je webový prohlížeč v režimu kina, hlavní okno prohlížeče vyplní celou obrazovku, zobrazí se panel nástrojů s minimální sadou navigačních nástrojů a stavový řádek se zobrazí v pravém horním rohu obrazovky.

Platí pro Internet Explorer a WebBrowser.

CHtmlView::SetToolBar

Voláním této členské funkce zobrazíte nebo skryjete panel nástrojů aplikace Internet Explorer.

void SetToolBar(int nNewValue);

Parametry

nNewValue
Určuje, zda se má panel nástrojů zobrazit. Nenulové, pokud se má zobrazit panel nástrojů; jinak nula.

Poznámky

Platí pro Internet Explorer. Pokud použijete toto volání s ovládacím prvku WebBrowser, vrátí se žádná chyba, ale bude toto volání ignorovat.

CHtmlView::SetTop

Voláním této členské funkce nastavíte vzdálenost mezi vnitřním horním okrajem ovládacího prvku WebBrowser a horním okrajem jeho kontejneru.

void SetTop(long nNewValue);

Parametry

nNewValue
Souřadnice obrazovky horního okraje hlavního okna.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::SetVisible

Voláním této členské funkce nastavíte stav viditelnosti ovládacího prvku WebBrowser.

void SetVisible(BOOL bNewValue);

Parametry

bNewValue
Nenulové, pokud je ovládací prvek viditelný; jinak nula.

Poznámky

Platí pro Internet Explorer a WebBrowser.

CHtmlView::SetWidth

Nastaví šířku hlavního okna Internet Exploreru.

void SetWidth(long nNewValue);

Parametry

nNewValue
Šířka v pixelech hlavního okna aplikace Internet Explorer.

CHtmlView::Stop

Voláním této členské funkce zrušíte všechny čekající operace navigace nebo stahování a zastavíte všechny dynamické prvky stránky, jako jsou zvuky pozadí a animace.

void Stop();

Poznámky

Platí pro Internet Explorer a WebBrowser.

Viz také

Mfc – ukázka MFCIE
Třída CFormView
Hierarchy chart
IWebBrowser2