CDHtmlDialog Třída

Slouží k vytváření dialogových oken, která místo prostředků dialogových oken používají html k implementaci uživatelského rozhraní.

Syntaxe

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Členové

Veřejné konstruktory

Název	Popis
CDHtmlDialog::CDHtmlDialog	Vytvoří CDHtmlDialog objektu.
CDHtmlDialog::~CDHtmlDialog	Zničí CDHtmlDialog objektu.

Veřejné metody

Název	Popis
CDHtmlDialog::CanAccessExternal	Přepsání, které je volána jako kontrola přístupu, abyste zjistili, zda skriptovací objekty na načtené stránce mají přístup k externímu odeslání řídicího webu. Kontroluje, zda je odesílání bezpečné pro skriptování nebo aktuální zónu, umožňuje objekty, které nejsou bezpečné pro skriptování.
CDHtmlDialog::CreateControlSite	Lze přepsat pomocí vytvoření instance řídicího webu pro hostování ovládacího prvku WebBrowser v dialogovém okně.
CDHtmlDialog::DDX_DHtml_AxControl	Vyměňuje data mezi členské proměnné a hodnotou vlastnosti ovládacího prvku ActiveX na stránce HTML.
CDHtmlDialog::DDX_DHtml_CheckBox	Vyměňuje data mezi členské proměnné a zaškrtávacím políčekm na stránce HTML.
CDHtmlDialog::DDX_DHtml_ElementText	Vyměňuje data mezi členovou proměnnou a libovolnou vlastností elementu HTML na stránce HTML.
CDHtmlDialog::DDX_DHtml_Radio	Vyměňuje data mezi členské proměnné a přepínačem na stránce HTML.
CDHtmlDialog::DDX_DHtml_SelectIndex	Získá nebo nastaví index seznamu na stránce HTML.
CDHtmlDialog::DDX_DHtml_SelectString	Získá nebo nastaví zobrazovaný text položky seznamu (na základě aktuálního indexu) na stránce HTML.
CDHtmlDialog::DDX_DHtml_SelectValue	Získá nebo nastaví hodnotu položky seznamu (na základě aktuálního indexu) na stránce HTML.
CDHtmlDialog::DestroyModeless	Zničí bezmodální dialogové okno.
CDHtmlDialog::EnableModeless	Povolí bezmodální dialogová okna.
CDHtmlDialog::FilterDataObject	Umožňuje dialogové okno filtrovat datové objekty schránky vytvořené hostovaným prohlížečem.
CDHtmlDialog::GetControlDispatch	IDispatch Načte rozhraní v ovládacím prvku ActiveX vloženém do dokumentu HTML.
CDHtmlDialog::GetControlProperty	Načte požadovanou vlastnost zadaného ovládacího prvku ActiveX.
CDHtmlDialog::GetCurrentUrl	Načte adresu URL (Uniform Resource Locator) přidruženou k aktuálnímu dokumentu.
CDHtmlDialog::GetDHtmlDocument	IHTMLDocument2 Načte rozhraní v aktuálně načteném dokumentu HTML.
CDHtmlDialog::GetDropTarget	Volané obsaženým ovládacím prvku WebBrowser, když se používá jako cíl pro přetažení, aby dialog mohl poskytnout alternativu IDropTarget.
CDHtmlDialog::GetElement	Získá rozhraní v HTML elementu.
CDHtmlDialog::GetElementHtml	innerHTML Načte vlastnost elementu HTML.
CDHtmlDialog::GetElementInterface	Načte požadovaný ukazatel rozhraní z elementu HTML.
CDHtmlDialog::GetElementProperty	Načte hodnotu vlastnosti elementu HTML.
CDHtmlDialog::GetElementText	innerText Načte vlastnost elementu HTML.
CDHtmlDialog::GetEvent	IHTMLEventObj Získá ukazatel na aktuální objekt události.
CDHtmlDialog::GetExternal	Získá rozhraní hostitele IDispatch .
CDHtmlDialog::GetHostInfo	Načte možnosti uživatelského rozhraní hostitele.
CDHtmlDialog::GetOptionKeyPath	Načte klíč registru, pod kterým jsou uloženy předvolby uživatele.
CDHtmlDialog::HideUI	Skryje uživatelské rozhraní hostitele.
CDHtmlDialog::IsExternalDispatchSafe	Určuje, jestli je rozhraní hostitele IDispatch bezpečné pro skriptování.
CDHtmlDialog::LoadFromResource	Načte zadaný prostředek do ovládacího prvku WebBrowser.
CDHtmlDialog::Navigate	Přejde na zadanou adresu URL.
CDHtmlDialog::OnBeforeNavigate	Volá se rozhraním před vyvoláním události navigace.
CDHtmlDialog::OnDocumentComplete	Volá se rozhraním k upozornění aplikace, když dokument dosáhl READYSTATE_COMPLETE stavu.
CDHtmlDialog::OnDocWindowActivate	Volá se rozhraním při aktivaci nebo deaktivaci okna dokumentu.
CDHtmlDialog::OnFrameWindowActivate	Volá se rozhraním při aktivaci nebo deaktivaci okna rámečku.
CDHtmlDialog::OnInitDialog	Volá se v reakci na WM_INITDIALOG zprávu.
CDHtmlDialog::OnNavigateComplete	Volá se rozhraním po dokončení události navigace.
CDHtmlDialog::ResizeBorder	Upozorní objekt, který potřebuje ke změně velikosti ohraničení.
CDHtmlDialog::SetControlProperty	Nastaví vlastnost ovládacího prvku ActiveX na novou hodnotu.
CDHtmlDialog::SetElementHtml	innerHTML Nastaví vlastnost elementu HTML.
CDHtmlDialog::SetElementProperty	Nastaví vlastnost elementu HTML.
CDHtmlDialog::SetElementText	innerText Nastaví vlastnost elementu HTML.
CDHtmlDialog::SetExternalDispatch	Nastaví rozhraní hostitele IDispatch .
CDHtmlDialog::SetHostFlags	Nastaví příznaky uživatelského rozhraní hostitele.
CDHtmlDialog::ShowContextMenu	Volá se, když se má zobrazit místní nabídka.
CDHtmlDialog::ShowUI	Zobrazuje uživatelské rozhraní hostitele.
CDHtmlDialog::TranslateAccelerator	Volá se ke zpracování zpráv akcelerátoru nabídky.
CDHtmlDialog::TranslateUrl	Volá se k úpravě adresy URL, která se má načíst.
CDHtmlDialog::UpdateUI	Volá se, aby hostiteli oznámil, že se změnil stav příkazu.

Veřejné datové členy

Název	Popis
CDHtmlDialog::m_bUseHtmlTitle	Určuje, jestli se má jako popisek dialogového okna použít název dokumentu HTML.
CDHtmlDialog::m_nHtmlResID	ID prostředku HTML, které se má zobrazit.
CDHtmlDialog::m_pBrowserApp	Ukazatel na aplikaci webového prohlížeče
CDHtmlDialog::m_spHtmlDoc	Ukazatel na dokument HTML.
CDHtmlDialog::m_strCurrentUrl	Aktuální adresa URL.
CDHtmlDialog::m_szHtmlResID	Řetězcová verze ID prostředku HTML.

Poznámky

CDHtmlDialog může načíst html, který se má zobrazit z prostředku HTML nebo adresy URL.

CDHtmlDialog může také provádět výměnu dat s ovládacími prvky HTML a zpracovávat události z ovládacích prvků HTML, například kliknutí na tlačítko.

Hierarchie dědičnosti

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Požadavky

Záhlaví: afxdhtml.h

DDX_DHtml Pomocná makra

Pomocná DDX_DHtml makra umožňují snadný přístup k běžně používaným vlastnostem ovládacích prvků na stránce HTML.

Makra výměny dat

Název	Popis
DDX_DHtml_ElementValue	Nastaví nebo načte vlastnost Value z vybraného ovládacího prvku.
DDX_DHtml_ElementInnerText	Nastaví nebo načte text mezi počáteční a koncovou značkou aktuálního prvku.
DDX_DHtml_ElementInnerHtml	Nastaví nebo načte kód HTML mezi počáteční a koncovou značkou aktuálního prvku.
DDX_DHtml_Anchor_Href	Nastaví nebo načte cílovou adresu URL nebo bod ukotvení.
DDX_DHtml_Anchor_Target	Nastaví nebo načte cílové okno nebo rámec.
DDX_DHtml_Img_Src	Nastaví nebo načte název obrázku nebo videoklipu v dokumentu.
DDX_DHtml_Frame_Src	Nastaví nebo načte adresu URL přidruženého rámce.
DDX_DHtml_IFrame_Src	Nastaví nebo načte adresu URL přidruženého rámce.

CDHtmlDialog::CanAccessExternal

Přepsání, které je volána jako kontrola přístupu, abyste zjistili, zda skriptovací objekty na načtené stránce mají přístup k externímu odeslání řídicího webu. Kontroluje, zda je odesílání bezpečné pro skriptování nebo aktuální zónu, umožňuje objekty, které nejsou bezpečné pro skriptování.

virtual BOOL CanAccessExternal();

Návratová hodnota

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

CDHtmlDialog::CDHtmlDialog

Vytvoří dynamické dialogové okno HTML založené na prostředcích.

CDHtmlDialog();

CDHtmlDialog(
    LPCTSTR lpszTemplateName,
    LPCTSTR szHtmlResID,
    CWnd *pParentWnd = NULL);

CDHtmlDialog(
    UINT nIDTemplate,
    UINT nHtmlResID = 0,
    CWnd *pParentWnd = NULL);

Parametry

lpszTemplateName
Řetězec ukončený hodnotou null, který je názvem prostředku šablony dialogového okna.

szHtmlResID
Řetězec ukončený hodnotou null, který je názvem prostředku HTML.

pParentWnd
Ukazatel na objekt okna nadřazeného nebo vlastníka (typu CWnd), do kterého objekt dialogového okna patří. Pokud ano NULL, nadřazené okno objektu dialogového okna je nastaveno na hlavní okno aplikace.

nIDTemplate
Obsahuje číslo ID prostředku šablony dialogového okna.

nHtmlResID
Obsahuje číslo ID prostředku HTML.

Poznámky

Druhá forma konstruktoru poskytuje přístup k prostředku dialogového okna prostřednictvím názvu šablony. Třetí forma konstruktoru poskytuje přístup k prostředku dialogového okna prostřednictvím ID šablony prostředku. ID obvykle začíná předponou IDD_ .

CDHtmlDialog::~CDHtmlDialog

CDHtmlDialog Zničí objekt.

virtual ~CDHtmlDialog();

Poznámky

Člen funkce CWnd::DestroyWindow musí být použita ke zničení bezmodální dialogová okna, která jsou vytvořena CDialog::Create.

CDHtmlDialog::CreateControlSite

Lze přepsat pomocí vytvoření instance řídicího webu pro hostování ovládacího prvku WebBrowser v dialogovém okně.

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

Parametry

pContainer
Ukazatel na COleControlContainer objekt.

ppSite
Ukazatel na ukazatel na .COleControlSite

Návratová hodnota

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

Poznámky

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

CDHtmlDialog::DDX_DHtml_AxControl

Vyměňuje data mezi členské proměnné a hodnotou vlastnosti ovládacího prvku ActiveX na stránce HTML.

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    VARIANT& var);

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    LPCTSTR szPropName,
    VARIANT& var);

Parametry

pDX
Ukazatel na CDataExchange objekt.

szId
Hodnota parametru ID značky objektu ve zdroji HTML pro ovládací prvek ActiveX.

dispId
ID odeslání vlastnosti, se kterou chcete vyměňovat data.

szPropName
Název vlastnosti

var
Datový člen typu , COleVariantnebo VARIANTCComVariant, který obsahuje hodnotu vyměněnou s ovládacím prvku ActiveX vlastnost.

Příklad

// COleVariant m_varSliderValue;
DDX_DHtml_AxControl(pDX, _T("slider1"), 0x0b /* Value */, m_varSliderValue);

CDHtmlDialog::DDX_DHtml_CheckBox

Vyměňuje data mezi členské proměnné a zaškrtávacím políčekm na stránce HTML.

void DDX_DHtml_CheckBox(
    CDataExchange* pDX,
    LPCTSTR szId,
    int& value);

Parametry

pDX
Ukazatel na CDataExchange objekt.

szId
Hodnota, kterou jste zadali pro parametr ID ovládacího prvku HTML.

value
Hodnota, která se vyměňuje.

Příklad

// int m_nItalic;
DDX_DHtml_CheckBox(pDX, L"italic", m_nItalic);

CDHtmlDialog::DDX_DHtml_ElementText

Vyměňuje data mezi členovou proměnnou a libovolnou vlastností elementu HTML na stránce HTML.

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    CString& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    short& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    int& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    long& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    DWORD& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    float& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    double& value);

Parametry

pDX
Ukazatel na CDataExchange objekt.

szId
Hodnota, kterou jste zadali pro parametr ID ovládacího prvku HTML.

dispId
ID odeslání elementu HTML, se kterým chcete vyměňovat data.

value
Hodnota, která se vyměňuje.

CDHtmlDialog::DDX_DHtml_Radio

Vyměňuje data mezi členské proměnné a přepínačem na stránce HTML.

void DDX_DHtml_Radio(
    CDataExchange* pDX,
    LPCTSTR szId,
    long& value);

Parametry

pDX
Ukazatel na CDataExchange objekt.

szId
Hodnota, kterou jste zadali pro parametr ID ovládacího prvku HTML.

value
Hodnota, která se vyměňuje.

CDHtmlDialog::DDX_DHtml_SelectIndex

Získá nebo nastaví index seznamu na stránce HTML.

void DDX_DHtml_SelectIndex(
    CDataExchange* pDX,
    LPCTSTR szId,
    long& value);

Parametry

pDX
Ukazatel na CDataExchange objekt.

szId
Hodnota, kterou jste zadali pro parametr ovládacího prvku id HTML.

value
Hodnota, která se vyměňuje.

CDHtmlDialog::DDX_DHtml_SelectString

Získá nebo nastaví zobrazovaný text položky seznamu (na základě aktuálního indexu) na stránce HTML.

void DDX_DHtml_SelectString(
    CDataExchange* pDX,
    LPCTSTR szId,
    CString& value);

Parametry

pDX
Ukazatel na CDataExchange objekt.

szId
Hodnota, kterou jste zadali pro parametr ID ovládacího prvku HTML.

value
Hodnota, která se vyměňuje.

CDHtmlDialog::DDX_DHtml_SelectValue

Získá nebo nastaví hodnotu položky seznamu (na základě aktuálního indexu) na stránce HTML.

void DDX_DHtml_SelectValue(
    CDataExchange* pDX,
    LPCTSTR szId,
    CString& value);

Parametry

pDX
Ukazatel na CDataExchange objekt.

szId
Hodnota, kterou jste zadali pro parametr ID ovládacího prvku HTML.

value
Hodnota, která se vyměňuje.

Příklad

// CString m_strBlurDir;
DDX_DHtml_SelectValue(pDX, L"blurDir", m_strBlurDir);

CDHtmlDialog::DestroyModeless

Od objektu CDHtmlDialog odpojte bezmodální dialogové okno a zničí objekt.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Povolí bezmodální dialogová okna.

STDMETHOD(EnableModeless)(BOOL fEnable);

Parametry

fEnable
Viz fEnable v IDocHostUIHandler::EnableModeless sadě Windows SDK.

Návratová hodnota

Vrací objekt E_NOTIMPL.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::EnableModeless, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::FilterDataObject

Umožňuje dialogové okno filtrovat datové objekty schránky vytvořené hostovaným prohlížečem.

STDMETHOD(FilterDataObject)(
    IDataObject* pDO,
    IDataObject** ppDORet);

Parametry

pDO
Viz pDO v IDocHostUIHandler::FilterDataObject sadě Windows SDK.

ppDORet
Viz ppDORet v IDocHostUIHandler::FilterDataObject sadě Windows SDK.

Návratová hodnota

Vrací objekt S_FALSE.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::FilterDataObject, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::GetControlDispatch

IDispatch Načte rozhraní v ovládacím prvku ActiveX vloženém do dokumentu HTML vráceného GetDHtmlDocument.

HRESULT GetControlDispatch(
    LPCTSTR szId,
    IDispatch** ppdisp);

Parametry

szId
ID HTML ovládacího prvku ActiveX.

ppdisp
Rozhraní IDispatch ovládacího prvku, pokud je na webové stránce.

Návratová hodnota

Standardní HRESULT hodnota.

CDHtmlDialog::GetControlProperty

Načte požadovanou vlastnost zadaného ovládacího prvku ActiveX.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Parametry

szId
ID HTML ovládacího prvku ActiveX.

szPropName
Název vlastnosti ve výchozím národním prostředí aktuálního uživatele.

pdispControl
Ukazatel IDispatch ovládacího prvku ActiveX.

dispId
ID odeslání vlastnosti.

Návratová hodnota

Varianta obsahující požadovanou vlastnost nebo prázdnou variantu, pokud nebyl nalezen ovládací prvek nebo vlastnost.

Poznámky

Přetížení jsou uvedena nejméně zefektivnit v horní části až po nejúčinnější v dolní části.

CDHtmlDialog::GetCurrentUrl

Načte adresu URL (Uniform Resource Locator) přidruženou k aktuálnímu dokumentu.

void GetCurrentUrl(CString& szUrl);

Parametry

szUrl
Objekt CString obsahující adresu URL, která se má načíst.

CDHtmlDialog::GetDHtmlDocument

IHTMLDocument2 Načte rozhraní v aktuálně načteném dokumentu HTML.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Parametry

**pphtmlDoc Ukazatel na ukazatel na dokument HTML.

Návratová hodnota

Standardní .HRESULT Vrátí S_OK v případě úspěchu.

CDHtmlDialog::GetDropTarget

Volané obsaženým ovládacím prvku WebBrowser, když se používá jako cíl pro přetažení, aby dialog mohl poskytnout alternativu IDropTarget.

STDMETHOD(GetDropTarget)(
    IDropTarget* pDropTarget,
    IDropTarget** ppDropTarget);

Parametry

pDropTarget
Viz pDropTarget v IDocHostUIHandler::GetDropTarget sadě Windows SDK.

ppDropTarget
Viz ppDropTarget v IDocHostUIHandler::GetDropTarget sadě Windows SDK.

Návratová hodnota

Vrací objekt E_NOTIMPL.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::GetDropTarget, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::GetElement

Vrátí rozhraní u elementu HTML určeného znakem szElementId.

HRESULT GetElement(
    LPCTSTR szElementId,
    IDispatch** ppdisp,
    BOOL* pbCollection = NULL);

HRESULT GetElement(
    LPCTSTR szElementId,
    IHTMLElement** pphtmlElement);

Parametry

szElementId
ID elementu HTML.

ppdisp
IDispatch Ukazatel na požadovaný prvek nebo kolekci prvků.

pbCollection
Určuje BOOL , zda je objekt reprezentovaný jedním prvkem ppdisp nebo kolekcí prvků.

pphtmlElement
IHTMLElement Ukazatel na požadovaný prvek.

Návratová hodnota

Standardní HRESULT hodnota.

Poznámky

První přetížení použijte, pokud potřebujete zpracovat podmínky, ve kterých může být více než jeden prvek se zadaným ID. Pomocí posledního parametru můžete zjistit, jestli je vrácený ukazatel rozhraní na kolekci nebo jednu položku. Pokud je ukazatel rozhraní v kolekci, můžete dotazovat na IHTMLElementCollection objekt a použít jeho item vlastnost odkazovat na prvky podle řadové pozice.

Druhé přetížení selže, pokud je na stránce více než jeden prvek se stejným ID.

CDHtmlDialog::GetElementHtml

innerHTML Načte vlastnost element HTML identifikovaný szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

Parametry

szElementId
ID elementu HTML.

Návratová hodnota

innerHTML Vlastnost elementu HTML identifikovaného elementem szElementId nebo NULL pokud nebyl nalezen element.

CDHtmlDialog::GetElementInterface

Načte požadovaný ukazatel rozhraní z elementu HTML identifikovaného szElementId.

template <class Q> HRESULT GetElementInterface(
    LPCTSTR szElementId,
    Q** ppvObj);

HRESULT GetElementInterface(
    LPCTSTR szElementId,
    REFIID refiid,
    void** ppvObj);

Parametry

szElementId
ID elementu HTML.

ppvObj
Adresa ukazatele, který bude vyplněn požadovaným ukazatelem rozhraní, pokud je prvek nalezen a dotaz bude úspěšný.

refiid
ID rozhraní (IID) požadovaného rozhraní.

Návratová hodnota

Standardní HRESULT hodnota.

Příklad

CComPtr<IHTMLInputButtonElement> spBtn1;
CComPtr<IHTMLInputButtonElement> spBtn2;
HRESULT hr = S_OK;

// Use the template overload
hr = GetElementInterface(L"Button1", &spBtn1);

// Use the nontemplate overload
hr = GetElementInterface(L"Button1", IID_IHTMLInputButtonElement,
                         reinterpret_cast<void **>(&spBtn2));

CDHtmlDialog::GetElementProperty

Načte hodnotu vlastnosti identifikované dispId z elementu HTML identifikovaný szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Parametry

szElementId
ID elementu HTML.

dispId
ID odeslání vlastnosti.

Návratová hodnota

Hodnota vlastnosti nebo prázdné varianty, pokud se vlastnost nebo prvek nepodařilo najít.

CDHtmlDialog::GetElementText

innerText Načte vlastnost element HTML identifikovaný szElementId.

BSTR GetElementText(LPCTSTR szElementId);

Parametry

szElementId
ID elementu HTML.

Návratová hodnota

innerText Vlastnost elementu HTML identifikovaného szElementId nebo NULL pokud se vlastnost nebo element nepodařilo najít.

CDHtmlDialog::GetEvent

IHTMLEventObj Vrátí ukazatel na aktuální objekt události.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Parametry

ppEventObj
Adresa ukazatele, který bude vyplněn ukazatelem IHTMLEventObj rozhraní.

Návratová hodnota

Standardní HRESULT hodnota.

Poznámky

Tato funkce by měla být volána pouze z obslužné rutiny události DHTML.

CDHtmlDialog::GetExternal

Získá rozhraní hostitele IDispatch .

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Parametry

ppDispatch
Viz ppDispatch v IDocHostUIHandler::GetExternal sadě Windows SDK.

Návratová hodnota

Vrátí S_OK úspěch nebo E_NOTIMPL selhání.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::GetExternal, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::GetHostInfo

Načte možnosti uživatelského rozhraní hostitele.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Parametry

pInfo
Viz pInfo v IDocHostUIHandler::GetHostInfo sadě Windows SDK.

Návratová hodnota

Vrací objekt S_OK.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::GetHostInfo, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::GetOptionKeyPath

Načte klíč registru, pod kterým jsou uloženy předvolby uživatele.

STDMETHOD(GetOptionKeyPath)(
    LPOLESTR* pchKey,
    DWORD dw);

Parametry

pchKey
Viz pchKey v IDocHostUIHandler::GetOptionKeyPath sadě Windows SDK.

dw
Viz dw v IDocHostUIHandler::GetOptionKeyPath sadě Windows SDK.

Návratová hodnota

Vrací objekt E_NOTIMPL.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::GetOptionKeyPath, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::HideUI

Skryje uživatelské rozhraní hostitele.

STDMETHOD(HideUI)(void);

Návratová hodnota

Vrací objekt E_NOTIMPL.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::HideUI, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::IsExternalDispatchSafe

Určuje, jestli je rozhraní hostitele IDispatch bezpečné pro skriptování.

virtual BOOL IsExternalDispatchSafe();

Návratová hodnota

Vrací objekt FALSE.

CDHtmlDialog::LoadFromResource

Načte zadaný prostředek do ovládacího prvku WebBrowser v dialogovém okně DHTML.

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 prostředku, který se má načíst.

Návratová hodnota

TRUE v případě úspěchu; jinak FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Určuje, jestli se má jako popisek dialogového okna použít název dokumentu HTML.

BOOL m_bUseHtmlTitle;

Poznámky

Pokud m_bUseHtmlTitle ano TRUE, popisek dialogového okna se nastaví jako název dokumentu HTML. Jinak se popisek v dialogovém okně použije.

CDHtmlDialog::m_nHtmlResID

ID prostředku HTML, které se má zobrazit.

UINT m_nHtmlResID;

Příklad

CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
mydialog.m_nHtmlResID = IDR_HTML_MYDHTMLDLG;
mydialog.DoModal();

CDHtmlDialog::m_pBrowserApp

Ukazatel na aplikaci webového prohlížeče

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Ukazatel na dokument HTML.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

Aktuální adresa URL.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

Řetězcová verze ID prostředku HTML.

LPTSTR m_szHtmlResID;

Příklad

CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
TCHAR szResID[] = _T("HTML_PAGE");
mydialog.m_szHtmlResID = szResID;
mydialog.DoModal();

CDHtmlDialog::Navigate

Přejde na prostředek identifikovaný adresou URL, která je určena lpszURL.

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

Parametry

lpszURL
Ukazatel na řetězec obsahující adresu URL, na který se má cílit.

dwFlags
Příznaky proměnné, která určuje, jestli se má prostředek přidat do seznamu historie, jestli se má číst do mezipaměti nebo zapisovat z mezipaměti, a jestli 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 takové informace, jako je akce vyžadovaná serverem, typ dat předávaných serveru nebo stavový kód. Tento parametr se ignoruje, pokud adresa URL není adresou 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 adresa URL není adresou 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 adresa URL není adresou URL HTTP.

CDHtmlDialog::OnBeforeNavigate

Zavolá se rozhraním, které způsobí, že se událost aktivuje dříve, než dojde k navigaci.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametry

pDisp
Ukazatel na IDispatch objekt.

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

CDHtmlDialog::OnDocumentComplete

Volá se rozhraním k upozornění aplikace, když dokument dosáhl READYSTATE_COMPLETE stavu.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametry

pDisp
Ukazatel na IDispatch objekt.

szUrl
Ukazatel na řetězec obsahující adresu URL, na kterou jsme přešli.

CDHtmlDialog::OnDocWindowActivate

Volá se rozhraním při aktivaci nebo deaktivaci okna dokumentu.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Parametry

fActivate
Viz fActivate v IDocHostUIHandler::OnDocWindowActivate sadě Windows SDK.

Návratová hodnota

Vrací objekt E_NOTIMPL.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::OnDocWindowActivate, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::OnFrameWindowActivate

Volá se rozhraním při aktivaci nebo deaktivaci okna rámečku.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Parametry

fActivate
Viz fActivate v IDocHostUIHandler::OnFrameWindowActivate sadě Windows SDK.

Návratová hodnota

Vrací objekt E_NOTIMPL.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::OnFrameWindowActivate, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::OnInitDialog

Volá se v reakci na WM_INITDIALOG zprávu.

virtual BOOL OnInitDialog();

Návratová hodnota

Výchozí implementace vrátí TRUE.

Poznámky

Tato zpráva se odešle do dialogového okna během Createvolání , CreateIndirectnebo DoModal volání, ke kterým dojde bezprostředně před zobrazením dialogového okna.

Tuto členovou funkci přepište, pokud potřebujete provést speciální zpracování při inicializaci dialogového okna. V přepsáné verzi nejprve zavolejte základní třídu OnInitDialog , ale ignorujte její návratovou hodnotu. Obvykle se vrátíte TRUE ze své přepsané členské funkce.

Systém Windows volá OnInitDialog funkci prostřednictvím standardního globálního dialogového okna společného se všemi dialogovými okny knihovny tříd Microsoft Foundation, nikoli prostřednictvím mapy zpráv, takže pro tuto členovou funkci nepotřebujete položku mapy zpráv.

CDHtmlDialog::OnNavigateComplete

Volání rozhraní po navigaci na zadanou adresu URL je dokončeno.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametry

pDisp
Ukazatel na IDispatch objekt.

szUrl
Ukazatel na řetězec obsahující adresu URL, na kterou jsme přešli.

CDHtmlDialog::ResizeBorder

Upozorní objekt, který potřebuje ke změně velikosti ohraničení.

STDMETHOD(ResizeBorder)(
    LPCRECT prcBorder,
    IOleInPlaceUIWindow* pUIWindow,
    BOOL fRameWindow);

Parametry

prcBorder
Viz prcBorder v IDocHostUIHandler::ResizeBorder sadě Windows SDK.

pUIWindow
Viz pUIWindow v IDocHostUIHandler::ResizeBorder sadě Windows SDK.

fFrameWindow
Viz fFrameWindow v IDocHostUIHandler::ResizeBorder sadě Windows SDK.

Návratová hodnota

Vrátí E_NOTIMPL.

CDHtmlDialog::SetControlProperty

Nastaví vlastnost ovládacího prvku ActiveX na novou hodnotu.

void SetControlProperty(
    LPCTSTR szElementId,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    LPCTSTR szElementId,
    LPCTSTR szPropName,
    VARIANT* pVar);

Parametry

szElementId
ID HTML ovládacího prvku ActiveX.

dispId
ID odeslání vlastnosti, která se má nastavit.

pVar
Ukazatel na VARIANT obsahující hodnotu nové vlastnosti.

pdispControl
Ukazatel na rozhraní ovládacího prvku IDispatch ActiveX.

szPropName
Řetězec obsahující název vlastnosti, která se má nastavit.

CDHtmlDialog::SetElementHtml

innerHTML Nastaví vlastnost elementu HTML.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Parametry

szElementId
ID elementu HTML.

bstrText
Nová hodnota innerHTML vlastnosti.

punkElem
Ukazatel IUnknown elementu HTML.

CDHtmlDialog::SetElementProperty

Nastaví vlastnost elementu HTML.

void SetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId,
    VARIANT* pVar);

Parametry

szElementId
ID elementu HTML.

dispId
ID odeslání vlastnosti, která se má nastavit.

pVar
Nová hodnota vlastnosti.

CDHtmlDialog::SetElementText

innerText Nastaví vlastnost elementu HTML.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Parametry

szElementId
ID elementu HTML.

bstrText
Nová hodnota innerText vlastnosti.

punkElem
Ukazatel IUnknown elementu HTML.

CDHtmlDialog::SetExternalDispatch

Nastaví rozhraní hostitele IDispatch .

void SetExternalDispatch(IDispatch* pdispExternal);

Parametry

pdispExternal
IDispatch Nové rozhraní.

CDHtmlDialog::SetHostFlags

Nastaví příznaky uživatelského rozhraní hostitele.

void SetHostFlags(DWORD dwFlags);

Parametry

dwFlags
Možné hodnoty najdete DOCHOSTUIFLAG v sadě Windows SDK.

CDHtmlDialog::ShowContextMenu

Volá se, když se má zobrazit místní nabídka.

STDMETHOD(ShowContextMenu)(
    DWORD dwID,
    POINT* ppt,
    IUnknown* pcmdtReserved,
    IDispatch* pdispReserved);

Parametry

dwID
Viz dwID v IDocHostUIHandler::ShowContextMenu sadě Windows SDK.

ppt
Viz ppt v IDocHostUIHandler::ShowContextMenu sadě Windows SDK.

pcmdtReserved
Viz pcmdtReserved v IDocHostUIHandler::ShowContextMenu sadě Windows SDK.

pdispReserved
Viz pdispReserved v IDocHostUIHandler::ShowContextMenu sadě Windows SDK.

Návratová hodnota

Vrací objekt S_FALSE.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::ShowContextMenu, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::ShowUI

Zobrazuje uživatelské rozhraní hostitele.

STDMETHOD(ShowUI)(
    DWORD dwID,
    IOleInPlaceActiveObject* pActiveObject,
    IOleCommandTarget* pCommandTarget,
    IOleInPlaceFrame* pFrame,
    IOleInPlaceUIWindow* pDoc);

Parametry

dwID
Viz dwID v IDocHostUIHandler::ShowUI sadě Windows SDK.

pActiveObject
Viz pActiveObject v IDocHostUIHandler::ShowUI sadě Windows SDK.

pCommandTarget
Viz pCommandTarget v IDocHostUIHandler::ShowUI sadě Windows SDK.

pFrame
Viz pFrame v IDocHostUIHandler::ShowUI sadě Windows SDK.

pDoc
Viz pDoc v IDocHostUIHandler::ShowUI sadě Windows SDK.

Návratová hodnota

Vrací objekt S_FALSE.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::ShowUI, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::TranslateAccelerator

Volá se ke zpracování zpráv akcelerátoru nabídky.

STDMETHOD(TranslateAccelerator)(
    LPMSG lpMsg,
    const GUID* pguidCmdGroup,
    DWORD nCmdID);

Parametry

lpMsg
Viz lpMsg v IDocHostUIHandler::TranslateAccelerator sadě Windows SDK.

pguidCmdGroup
Viz pguidCmdGroup v IDocHostUIHandler::TranslateAccelerator sadě Windows SDK.

nCmdID
Viz nCmdID v IDocHostUIHandler::TranslateAccelerator sadě Windows SDK.

Návratová hodnota

Vrací objekt S_FALSE.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::TranslateAccelerator, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::TranslateUrl

Volá se k úpravě adresy URL, která se má načíst.

STDMETHOD(TranslateUrl)(
    DWORD dwTranslate,
    OLECHAR* pchURLIn,
    OLECHAR** ppchURLOut);

Parametry

dwTranslate
Viz dwTranslate v IDocHostUIHandler::TranslateUrl sadě Windows SDK.

pchURLIn
Viz pchURLIn v IDocHostUIHandler::TranslateUrl sadě Windows SDK.

ppchURLOut
Viz ppchURLOut v IDocHostUIHandler::TranslateUrl sadě Windows SDK.

Návratová hodnota

Vrací objekt S_FALSE.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::TranslateUrl, jak je popsáno v sadě Windows SDK.

CDHtmlDialog::UpdateUI

Volá se, aby hostiteli oznámil, že se změnil stav příkazu.

STDMETHOD(UpdateUI)(void);

Návratová hodnota

Vrací objekt E_NOTIMPL.

Poznámky

Tato členová funkce je CDHtmlDialog implementace IDocHostUIHandler::UpdateUI, jak je popsáno v sadě Windows SDK.

Viz také

Mfc – ukázka DHtmlExplore
DDX_DHtml Pomocná makra
Graf hierarchie