CDHtmlDialog osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Olyan párbeszédpanelek létrehozására szolgál, amelyek a felhasználói felület implementálásához nem párbeszédpanel-erőforrásokat, hanem HTML-t használnak.

Szemantika

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Tagok

Nyilvános konstruktorok

Név	Description
CDHtmlDialog::CDHtmlDialog	CDHtmlDialog objektumot hoz létre.
CDHtmlDialog::~CDHtmlDialog	Elpusztít egy CDHtmlDialog objektumot.

Nyilvános metódusok

Név	Description
CDHtmlDialog::CanAccessExternal	Felülbírálás, amely hozzáférési ellenőrzésként van meghívva annak ellenőrzéséhez, hogy a betöltött lapon lévő szkriptobjektumok hozzáférnek-e a vezérlőhely külső feladásához. Ellenőrzi, hogy a küldés biztonságos-e a szkripteléshez, vagy az aktuális zóna lehetővé teszi olyan objektumok számára, amelyek nem biztonságosak a szkripteléshez.
CDHtmlDialog::CreateControlSite	Felülírható egy vezérlőwebhely-példány létrehozásához, amely a WebBrowser vezérlőt üzemelteti a párbeszédpanelen.
CDHtmlDialog::DDX_DHtml_AxControl	Adatokat cserél egy tagváltozó és egy HTML-oldalon található ActiveX-vezérlő tulajdonságértéke között.
CDHtmlDialog::DDX_DHtml_CheckBox	Adatokat cserél egy tagváltozó és egy HTML-oldalon lévő jelölőnégyzet között.
CDHtmlDialog::DDX_DHtml_ElementText	Adatokat cserél egy tagváltozó és egy HTML-oldal HTML-elemtulajdonságai között.
CDHtmlDialog::DDX_DHtml_Radio	Adatokat cserél egy tagváltozó és egy HTML-oldalon található választógomb között.
CDHtmlDialog::DDX_DHtml_SelectIndex	Lekéri vagy beállítja egy listamező indexét egy HTML-oldalon.
CDHtmlDialog::DDX_DHtml_SelectString	Lekéri vagy beállítja egy listamezőbejegyzés megjelenítendő szövegét (az aktuális index alapján) egy HTML-oldalon.
CDHtmlDialog::DDX_DHtml_SelectValue	Lekéri vagy beállítja egy listamezőbejegyzés értékét (az aktuális index alapján) egy HTML-oldalon.
CDHtmlDialog::DestroyModeless	Egy mód nélküli párbeszédpanel megsemmisítése.
CDHtmlDialog::EnableModeless	Engedélyezi a mód nélküli párbeszédpaneleket.
CDHtmlDialog::FilterDataObject	Lehetővé teszi, hogy a párbeszédpanel szűrje az üzemeltetett böngésző által létrehozott vágólap-adatobjektumokat.
CDHtmlDialog::GetControlDispatch	Lekéri a IDispatch HTML-dokumentumba beágyazott ActiveX-vezérlő felületét.
CDHtmlDialog::GetControlProperty	Lekéri a megadott ActiveX-vezérlő kért tulajdonságát.
CDHtmlDialog::GetCurrentUrl	Lekéri az aktuális dokumentumhoz társított egységes erőforrás-keresőt (URL-címet).
CDHtmlDialog::GetDHtmlDocument	Lekéri a IHTMLDocument2 jelenleg betöltött HTML-dokumentum felületét.
CDHtmlDialog::GetDropTarget	A tartalmazott WebBrowser-vezérlő meghívja, amikor drop targetként használják, hogy a párbeszédpanel alternatívát IDropTargetbiztosíthasson.
CDHtmlDialog::GetElement	Felületet kap egy HTML-elemhez.
CDHtmlDialog::GetElementHtml	Lekéri egy innerHTML HTML-elem tulajdonságát.
CDHtmlDialog::GetElementInterface	Lekéri a kért felületmutatót egy HTML-elemből.
CDHtmlDialog::GetElementProperty	Lekéri egy HTML-elem tulajdonságának értékét.
CDHtmlDialog::GetElementText	Lekéri egy innerText HTML-elem tulajdonságát.
CDHtmlDialog::GetEvent	Lekéri az IHTMLEventObj aktuális eseményobjektumra mutató mutatót.
CDHtmlDialog::GetExternal	Lekéri a gazdagép felületét IDispatch .
CDHtmlDialog::GetHostInfo	Lekéri a gazdagép felhasználói felületének képességeit.
CDHtmlDialog::GetOptionKeyPath	Lekéri a beállításkulcsot, amely alatt a felhasználói beállítások vannak tárolva.
CDHtmlDialog::HideUI	Elrejti a gazdagép felhasználói felületét.
CDHtmlDialog::IsExternalDispatchSafe	Azt jelzi, hogy a gazdagép IDispatch felülete biztonságos-e a szkripteléshez.
CDHtmlDialog::LoadFromResource	Betölti a megadott erőforrást a WebBrowser vezérlőbe.
CDHtmlDialog::Navigate	A megadott URL-címre navigál.
CDHtmlDialog::OnBeforeNavigate	A keretrendszer meghívta a navigációs esemény aktiválása előtt.
CDHtmlDialog::OnDocumentComplete	A keretrendszer meghívta, hogy értesítse az alkalmazást, ha egy dokumentum elérte az állapotot READYSTATE_COMPLETE .
CDHtmlDialog::OnDocWindowActivate	A keretrendszer meghívja a dokumentumablak aktiválása vagy inaktiválása esetén.
CDHtmlDialog::OnFrameWindowActivate	A keretrendszer meghívja a keretablak aktiválása vagy inaktiválása esetén.
CDHtmlDialog::OnInitDialog	Az üzenetre WM_INITDIALOG válaszul meghívva.
CDHtmlDialog::OnNavigateComplete	A keretrendszer egy navigációs esemény befejezése után hívja meg.
CDHtmlDialog::ResizeBorder	Riasztást küld az objektumról, amelynek át kell méreteznie a szegélyterületét.
CDHtmlDialog::SetControlProperty	Egy ActiveX-vezérlő tulajdonságát új értékre állítja.
CDHtmlDialog::SetElementHtml	Beállítja egy innerHTML HTML-elem tulajdonságát.
CDHtmlDialog::SetElementProperty	Beállít egy HTML-elem tulajdonságát.
CDHtmlDialog::SetElementText	Beállítja egy innerText HTML-elem tulajdonságát.
CDHtmlDialog::SetExternalDispatch	Beállítja a gazdagép felületét IDispatch .
CDHtmlDialog::SetHostFlags	Beállítja a gazdagép felhasználói felületi jelzőit.
CDHtmlDialog::ShowContextMenu	A helyi menü megjelenésekor hívható meg.
CDHtmlDialog::ShowUI	Megjeleníti a gazdagép felhasználói felületét.
CDHtmlDialog::TranslateAccelerator	A menügyorsítókulcs-üzenetek feldolgozására van meghívva.
CDHtmlDialog::TranslateUrl	A betöltéshez szükséges URL-cím módosítására van meghívva.
CDHtmlDialog::UpdateUI	Meghívva, hogy értesítse a gazdagépet arról, hogy a parancs állapota megváltozott.

Nyilvános adatok tagjai

Név	Description
CDHtmlDialog::m_bUseHtmlTitle	Azt jelzi, hogy a HTML-dokumentum címét használja-e a párbeszédpanel felirataként.
CDHtmlDialog::m_nHtmlResID	Megjelenítendő HTML-erőforrás erőforrás-azonosítója.
CDHtmlDialog::m_pBrowserApp	Mutató egy webböngésző-alkalmazáshoz.
CDHtmlDialog::m_spHtmlDoc	Egy HTML-dokumentumra mutató mutató.
CDHtmlDialog::m_strCurrentUrl	Az aktuális URL-cím.
CDHtmlDialog::m_szHtmlResID	A HTML-erőforrás-azonosító sztringverziója.

Megjegyzések

CDHtmlDialog betöltheti a HTML-t, hogy html-erőforrásból vagy URL-címből jelenjen meg.

CDHtmlDialog HTML-vezérlőkkel is végezhet adatcserét, és kezelheti a HTML-vezérlőkből származó eseményeket, például a gombkattintásokat.

Öröklési hierarchia

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Requirements

Fejléc:afxdhtml.h

DDX_DHtml Segédmakrók

A DDX_DHtml segédmakrók megkönnyítik a HTML-lapok vezérlőinek gyakran használt tulajdonságainak elérését.

Adatcsere-makrók

Név	Description
DDX_DHtml_ElementValue	Beállítja vagy lekéri az Érték tulajdonságot a kijelölt vezérlőből.
DDX_DHtml_ElementInnerText	Beállítja vagy lekéri a szöveget az aktuális elem kezdő és záró címkéi között.
DDX_DHtml_ElementInnerHtml	Beállítja vagy lekéri a HTML-t az aktuális elem kezdő és záró címkéi között.
DDX_DHtml_Anchor_Href	Beállítja vagy lekéri a cél URL-címét vagy a horgonypontot.
DDX_DHtml_Anchor_Target	Beállítja vagy lekéri a célablakot vagy a keretet.
DDX_DHtml_Img_Src	Beállítja vagy lekéri egy kép vagy egy videoklip nevét a dokumentumban.
DDX_DHtml_Frame_Src	Beállítja vagy lekéri a társított keret URL-címét.
DDX_DHtml_IFrame_Src	Beállítja vagy lekéri a társított keret URL-címét.

CDHtmlDialog::CanAccessExternal

Felülbírálás, amely hozzáférési ellenőrzésként van meghívva annak ellenőrzéséhez, hogy a betöltött lapon lévő szkriptobjektumok hozzáférnek-e a vezérlőhely külső feladásához. Ellenőrzi, hogy a küldés biztonságos-e a szkripteléshez, vagy az aktuális zóna lehetővé teszi olyan objektumok számára, amelyek nem biztonságosak a szkripteléshez.

virtual BOOL CanAccessExternal();

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

CDHtmlDialog::CDHtmlDialog

Erőforrás-alapú dinamikus HTML-párbeszédpanelt hoz létre.

CDHtmlDialog();

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

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

Paraméterek

lpszTemplateName
A párbeszédpanel-sablonerőforrás nevét tartalmazó null értékű sztring.

szHtmlResID
A HTML-erőforrás nevét tartalmazó null értékű sztring.

pParentWnd
Mutató arra a szülő- vagy tulajdonosablak-objektumra (típus CWnd), amelyhez a párbeszédpanel-objektum tartozik. Ha igen NULL, akkor a párbeszédpanel-objektum szülőablaka a fő alkalmazásablakra van állítva.

nIDTemplate
Egy párbeszédpanelsablon-erőforrás azonosítószámát tartalmazza.

nHtmlResID
Egy HTML-erőforrás azonosítószámát tartalmazza.

Megjegyzések

A konstruktor második formája a sablonnéven keresztül hozzáférést biztosít a párbeszédpanel-erőforráshoz. A konstruktor harmadik formája az erőforrássablon azonosítójával biztosít hozzáférést a párbeszédpanel-erőforráshoz. Az azonosító általában az IDD_ előtaggal kezdődik.

CDHtmlDialog::~CDHtmlDialog

Elpusztít egy objektumot CDHtmlDialog .

virtual ~CDHtmlDialog();

Megjegyzések

A CWnd::DestroyWindow tagfüggvényt a rendszer által CDialog::Createlétrehozott mód nélküli párbeszédpanelek elpusztítására kell használni.

CDHtmlDialog::CreateControlSite

Felülírható egy vezérlőwebhely-példány létrehozásához, amely a WebBrowser vezérlőt üzemelteti a párbeszédpanelen.

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

Paraméterek

pContainer
Az objektumra mutató COleControlContainer mutató.

ppSite
Mutató egy mutatóhoz egy COleControlSite.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Ezt a tagfüggvényt felülbírálhatja a saját vezérlőhelyosztály egy példányának visszaadásához.

CDHtmlDialog::DDX_DHtml_AxControl

Adatokat cserél egy tagváltozó és egy HTML-oldalon található ActiveX-vezérlő tulajdonságértéke között.

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

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

Paraméterek

pDX
Egy objektumra mutató CDataExchange mutató.

szId
Az objektumcímke azonosító paraméterének értéke az ActiveX-vezérlő HTML-forrásában.

dispId
Annak a tulajdonságnak a kézbesítési azonosítója, amellyel adatokat szeretne cserélni.

szPropName
A tulajdonság neve.

var
Az ActiveX vezérlőtulajdonságával kicserélt értéket tartalmazó adattag, amelynek típusa VARIANT, COleVariantvagy CComVarianttípusa.

Example

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

CDHtmlDialog::DDX_DHtml_CheckBox

Adatokat cserél egy tagváltozó és egy HTML-oldalon lévő jelölőnégyzet között.

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

Paraméterek

pDX
Egy objektumra mutató CDataExchange mutató.

szId
A HTML-vezérlő azonosítóparaméteréhez megadott érték.

value
A kicserélt érték.

Example

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

CDHtmlDialog::DDX_DHtml_ElementText

Adatokat cserél egy tagváltozó és egy HTML-oldal HTML-elemtulajdonságai között.

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

Paraméterek

pDX
Egy objektumra mutató CDataExchange mutató.

szId
A HTML-vezérlő azonosítóparaméteréhez megadott érték.

dispId
Annak a HTML-elemnek a küldési azonosítója, amellyel adatokat szeretne cserélni.

value
A kicserélt érték.

CDHtmlDialog::DDX_DHtml_Radio

Adatokat cserél egy tagváltozó és egy HTML-oldalon található választógomb között.

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

Paraméterek

pDX
Egy objektumra mutató CDataExchange mutató.

szId
A HTML-vezérlő azonosítóparaméteréhez megadott érték.

value
A kicserélt érték.

CDHtmlDialog::DDX_DHtml_SelectIndex

Lekéri vagy beállítja egy listamező indexét egy HTML-oldalon.

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

Paraméterek

pDX
Egy objektumra mutató CDataExchange mutató.

szId
A HTML-vezérlő paraméteréhez id megadott érték.

value
A kicserélt érték.

CDHtmlDialog::DDX_DHtml_SelectString

Lekéri vagy beállítja egy listamezőbejegyzés megjelenítendő szövegét (az aktuális index alapján) egy HTML-oldalon.

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

Paraméterek

pDX
Egy objektumra mutató CDataExchange mutató.

szId
A HTML-vezérlő azonosítóparaméteréhez megadott érték.

value
A kicserélt érték.

CDHtmlDialog::DDX_DHtml_SelectValue

Lekéri vagy beállítja egy listamezőbejegyzés értékét (az aktuális index alapján) egy HTML-oldalon.

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

Paraméterek

pDX
Egy objektumra mutató CDataExchange mutató.

szId
A HTML-vezérlő azonosítóparaméteréhez megadott érték.

value
A kicserélt érték.

Example

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

CDHtmlDialog::DestroyModeless

Leválaszt egy mód nélküli párbeszédpanelt az CDHtmlDialog objektumról, és megsemmisíti az objektumot.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Engedélyezi a mód nélküli párbeszédpaneleket.

STDMETHOD(EnableModeless)(BOOL fEnable);

Paraméterek

fEnable
Lásd fEnable a Windows SDK-ban IDocHostUIHandler::EnableModeless .

Visszaadott érték

Visszatér E_NOTIMPL.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::EnableModeless.

CDHtmlDialog::FilterDataObject

Lehetővé teszi, hogy a párbeszédpanel szűrje az üzemeltetett böngésző által létrehozott vágólap-adatobjektumokat.

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

Paraméterek

pDO
Lásd pDO a Windows SDK-ban IDocHostUIHandler::FilterDataObject .

ppDORet
Lásd ppDORet a Windows SDK-ban IDocHostUIHandler::FilterDataObject .

Visszaadott érték

Visszatér S_FALSE.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::FilterDataObject.

CDHtmlDialog::GetControlDispatch

Lekéri a IDispatch felületet egy ActiveX-vezérlőn, amely beágyazva van a visszaadott GetDHtmlDocumentHTML-dokumentumba.

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

Paraméterek

szId
Egy ActiveX-vezérlő HTML-azonosítója.

ppdisp
A IDispatch vezérlő felülete, ha a weblapon található.

Visszaadott érték

Egy standard HRESULT érték.

CDHtmlDialog::GetControlProperty

Lekéri a megadott ActiveX-vezérlő kért tulajdonságát.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Paraméterek

szId
Egy ActiveX-vezérlő HTML-azonosítója.

szPropName
Egy tulajdonság neve az aktuális felhasználó alapértelmezett területi beállításában.

pdispControl
Egy IDispatch ActiveX-vezérlő mutatója.

dispId
Egy tulajdonság feladóazonosítója.

Visszaadott érték

A kért tulajdonságot tartalmazó vagy üres változatot tartalmazó változat, ha a vezérlőelem vagy a tulajdonság nem található.

Megjegyzések

A túlterhelések felsorolása a legeredményesebbtől a legalsó szinten a leghatékonyabbig.

CDHtmlDialog::GetCurrentUrl

Lekéri az aktuális dokumentumhoz társított egységes erőforrás-keresőt (URL-címet).

void GetCurrentUrl(CString& szUrl);

Paraméterek

szUrl
A CString lekérendő URL-címet tartalmazó objektum.

CDHtmlDialog::GetDHtmlDocument

Lekéri a IHTMLDocument2 jelenleg betöltött HTML-dokumentum felületét.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Paraméterek

**pphtmlDoc Mutató egy HTML-dokumentumra mutató mutatóra.

Visszaadott érték

Egy standard HRESULT. Ha sikeres, S_OK visszaadja.

CDHtmlDialog::GetDropTarget

A tartalmazott WebBrowser-vezérlő meghívja, amikor drop targetként használják, hogy a párbeszédpanel alternatívát IDropTargetbiztosíthasson.

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

Paraméterek

pDropTarget
Lásd pDropTarget a Windows SDK-ban IDocHostUIHandler::GetDropTarget .

ppDropTarget
Lásd ppDropTarget a Windows SDK-ban IDocHostUIHandler::GetDropTarget .

Visszaadott érték

Visszatér E_NOTIMPL.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::GetDropTarget.

CDHtmlDialog::GetElement

A megadott HTML-elemhez tartozó felületet ad szElementIdvissza.

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

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

Paraméterek

szElementId
Egy HTML-elem azonosítója.

ppdisp
Mutató IDispatch a kért elemre vagy elemgyűjteményre.

pbCollection
Azt BOOL jelzi, hogy az objektum ppdisp egyetlen elem vagy elemgyűjtemény-e.

pphtmlElement
Mutató IHTMLElement a kért elemre.

Visszaadott érték

Egy standard HRESULT érték.

Megjegyzések

Használja az első túlterhelést, ha olyan körülményeket kell kezelnie, amelyekben egynél több elem is lehet a megadott azonosítóval. Az utolsó paraméterrel megállapíthatja, hogy a visszaadott felület mutatója gyűjteményre vagy egyetlen elemre mutat-e. Ha az illesztőmutató egy gyűjteményen található, lekérdezheti és IHTMLElementCollection a tulajdonságával item rendezési pozíció alapján hivatkozhat az elemekre.

A második túlterhelés meghiúsul, ha az oldalon több elem is található azonos azonosítóval.

CDHtmlDialog::GetElementHtml

Lekéri a /> által azonosított HTML-elem tulajdonságát .

BSTR GetElementHtml(LPCTSTR szElementId);

Paraméterek

szElementId
Egy HTML-elem azonosítója.

Visszaadott érték

Az innerHTML elem által szElementId azonosított HTML-elem tulajdonsága, vagy NULL ha az elem nem található.

CDHtmlDialog::GetElementInterface

Lekéri a kért felületmutatót a megadott HTML-elemből szElementId.

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

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

Paraméterek

szElementId
Egy HTML-elem azonosítója.

ppvObj
Az elem megtalálása és a lekérdezés sikeressége esetén a kért felületmutatóval kitöltendő mutató címe.

refiid
A kért felület felületazonosítója (IID).

Visszaadott érték

Egy standard HRESULT érték.

Example

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

A lekéri a tulajdonság által dispId azonosított szElementIdtulajdonság értékét a megadott HTML-elemből.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Paraméterek

szElementId
Egy HTML-elem azonosítója.

dispId
Egy tulajdonság feladóazonosítója.

Visszaadott érték

A tulajdonság vagy egy üres változat értéke, ha a tulajdonság vagy elem nem található.

CDHtmlDialog::GetElementText

Lekéri a /> által azonosított HTML-elem tulajdonságát .

BSTR GetElementText(LPCTSTR szElementId);

Paraméterek

szElementId
Egy HTML-elem azonosítója.

Visszaadott érték

A innerText tulajdonság vagy elem által szElementIdNULL azonosított HTML-elem tulajdonsága.

CDHtmlDialog::GetEvent

IHTMLEventObj Az aktuális eseményobjektumra mutató mutatót adja vissza.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Paraméterek

ppEventObj
Az illesztőmutatóval IHTMLEventObj kitöltendő mutató címe.

Visszaadott érték

Egy standard HRESULT érték.

Megjegyzések

Ezt a függvényt csak EGY DHTML eseménykezelőből kell meghívni.

CDHtmlDialog::GetExternal

Lekéri a gazdagép felületét IDispatch .

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Paraméterek

ppDispatch
Lásd ppDispatch a Windows SDK-ban IDocHostUIHandler::GetExternal .

Visszaadott érték

Sikeres vagy E_NOTIMPL sikertelen eredményre ad S_OK vissza.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::GetExternal.

CDHtmlDialog::GetHostInfo

Lekéri a gazdagép felhasználói felületének képességeit.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Paraméterek

pInfo
Lásd pInfo a Windows SDK-ban IDocHostUIHandler::GetHostInfo .

Visszaadott érték

Visszatér S_OK.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::GetHostInfo.

CDHtmlDialog::GetOptionKeyPath

Lekéri a beállításkulcsot, amely alatt a felhasználói beállítások vannak tárolva.

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

Paraméterek

pchKey
Lásd pchKey a Windows SDK-ban IDocHostUIHandler::GetOptionKeyPath .

dw
Lásd dw a Windows SDK-ban IDocHostUIHandler::GetOptionKeyPath .

Visszaadott érték

Visszatér E_NOTIMPL.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::GetOptionKeyPath.

CDHtmlDialog::HideUI

Elrejti a gazdagép felhasználói felületét.

STDMETHOD(HideUI)(void);

Visszaadott érték

Visszatér E_NOTIMPL.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::HideUI.

CDHtmlDialog::IsExternalDispatchSafe

Azt jelzi, hogy a gazdagép IDispatch felülete biztonságos-e a szkripteléshez.

virtual BOOL IsExternalDispatchSafe();

Visszaadott érték

Visszatér FALSE.

CDHtmlDialog::LoadFromResource

Betölti a megadott erőforrást a WebBrowser vezérlőbe a DHTML párbeszédpanelen.

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

Paraméterek

lpszResource
A betöltendő erőforrás nevét tartalmazó sztringre mutató mutató.

nRes
A betöltendő erőforrás azonosítója.

Visszaadott érték

sikeres TRUE; egyéb esetben FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Azt jelzi, hogy a HTML-dokumentum címét használja-e a párbeszédpanel felirataként.

BOOL m_bUseHtmlTitle;

Megjegyzések

Ha m_bUseHtmlTitle igen TRUE, a párbeszédpanel felirata megegyezik a HTML-dokumentum címével; ellenkező esetben a rendszer a párbeszédpanel-erőforrásban lévő feliratot használja.

CDHtmlDialog::m_nHtmlResID

Megjelenítendő HTML-erőforrás erőforrás-azonosítója.

UINT m_nHtmlResID;

Example

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

CDHtmlDialog::m_pBrowserApp

Mutató egy webböngésző-alkalmazáshoz.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Egy HTML-dokumentumra mutató mutató.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

Az aktuális URL-cím.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

A HTML-erőforrás-azonosító sztringverziója.

LPTSTR m_szHtmlResID;

Example

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

CDHtmlDialog::Navigate

A megadott URL-cím lpszURLalapján azonosított erőforrásra navigál.

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

Paraméterek

lpszURL
Mutató a megcélzandó URL-címet tartalmazó sztringre.

dwFlags
Egy változó jelzői, amelyek meghatározzák, hogy az erőforrást fel kell-e adni az előzménylistára, beolvassa-e a gyorsítótárba, vagy írja-e a gyorsítótárból, és hogy az erőforrást egy új ablakban szeretné-e megjeleníteni. A változó az enumerálás által BrowserNavConstants meghatározott értékek kombinációja lehet.

lpszTargetFrameName
Mutató egy sztringre, amely annak a keretnek a nevét tartalmazza, amelyben az erőforrást meg szeretné jeleníteni.

lpszHeaders
Egy olyan értékre mutató mutató, amely megadja a kiszolgálónak küldendő HTTP-fejléceket. Ezek az élőfejek bekerülnek az Internet Explorer alapértelmezett fejléceibe. A fejlécek olyan információkat adhatnak meg, mint a kiszolgáló által megkövetelt művelet, a kiszolgálónak átadott adatok típusa vagy egy állapotkód. Ezt a paramétert a rendszer figyelmen kívül hagyja, ha az URL-cím nem HTTP-URL- cím.

lpvPostData
Mutató a HTTP POST tranzakcióval küldendő adatokra. A POST tranzakció például egy HTML-űrlap által gyűjtött adatok küldésére szolgál. Ha ez a paraméter nem ad meg semmilyen utólagos adatot, Navigate http GET tranzakciót ad ki. Ezt a paramétert a rendszer figyelmen kívül hagyja, ha az URL-cím nem HTTP-URL- cím.

dwPostDataLen
A HTTP POST tranzakcióval küldendő adatok. A POST tranzakció például egy HTML-űrlap által gyűjtött adatok küldésére szolgál. Ha ez a paraméter nem ad meg semmilyen utólagos adatot, Navigate http GET tranzakciót ad ki. Ezt a paramétert a rendszer figyelmen kívül hagyja, ha az URL-cím nem HTTP-URL- cím.

CDHtmlDialog::OnBeforeNavigate

A keretrendszer meghívta, hogy egy eseményt aktiváljon a navigáció előtt.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Paraméterek

pDisp
Egy objektumra mutató IDispatch mutató.

szUrl
A navigáláshoz az URL-címet tartalmazó sztringre mutató mutató.

CDHtmlDialog::OnDocumentComplete

A keretrendszer meghívta, hogy értesítse az alkalmazást, ha egy dokumentum elérte az állapotot READYSTATE_COMPLETE .

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Paraméterek

pDisp
Egy objektumra mutató IDispatch mutató.

szUrl
Mutató egy sztringre, amely tartalmazza a navigált URL-címet.

CDHtmlDialog::OnDocWindowActivate

A keretrendszer meghívja a dokumentumablak aktiválása vagy inaktiválása esetén.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Paraméterek

fActivate
Lásd fActivate a Windows SDK-ban IDocHostUIHandler::OnDocWindowActivate .

Visszaadott érték

Visszatér E_NOTIMPL.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::OnDocWindowActivate.

CDHtmlDialog::OnFrameWindowActivate

A keretrendszer meghívja a keretablak aktiválása vagy inaktiválása esetén.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Paraméterek

fActivate
Lásd fActivate a Windows SDK-ban IDocHostUIHandler::OnFrameWindowActivate .

Visszaadott érték

Visszatér E_NOTIMPL.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::OnFrameWindowActivate.

CDHtmlDialog::OnInitDialog

Az üzenetre WM_INITDIALOG válaszul meghívva.

virtual BOOL OnInitDialog();

Visszaadott érték

Az alapértelmezett implementáció ad TRUEvissza.

Megjegyzések

Ezt az üzenetet a rendszer a párbeszédpanel megjelenése előtt közvetlenül a párbeszédpanel megjelenése előtt megjelenő , CreateIndirectvagy DoModal hívások során Createküldi el a párbeszédpanelre.

Bírálja felül ezt a tagfüggvényt, ha speciális feldolgozást kell végrehajtania a párbeszédpanel inicializálásakor. A felülírt verzióban először hívja meg az alaposztályt OnInitDialog , de hagyja figyelmen kívül a visszatérési értékét. Általában a felülírt tagfüggvényből fog visszatérni TRUE .

A Windows az OnInitDialog üzenettérkép helyett az összes Microsoft Foundation Osztálytár párbeszédpanelen szokásos globális párbeszédpanelen keresztül hívja meg a függvényt, így ehhez a tagfüggvényhez nincs szükség üzenettérkép-bejegyzésre.

CDHtmlDialog::OnNavigateComplete

A keretrendszer meghívta a megadott URL-címre való navigálás után.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Paraméterek

pDisp
Egy objektumra mutató IDispatch mutató.

szUrl
Mutató egy sztringre, amely tartalmazza a navigált URL-címet.

CDHtmlDialog::ResizeBorder

Riasztást küld az objektumról, amelynek át kell méreteznie a szegélyterületét.

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

Paraméterek

prcBorder
Lásd prcBorder a Windows SDK-ban IDocHostUIHandler::ResizeBorder .

pUIWindow
Lásd pUIWindow a Windows SDK-ban IDocHostUIHandler::ResizeBorder .

fFrameWindow
Lásd fFrameWindow a Windows SDK-ban IDocHostUIHandler::ResizeBorder .

Visszaadott érték

E_NOTIMPL ad vissza.

CDHtmlDialog::SetControlProperty

Egy ActiveX-vezérlő tulajdonságát új értékre állítja.

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

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

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

Paraméterek

szElementId
Egy ActiveX-vezérlő HTML-azonosítója.

dispId
A beállítani kívánt tulajdonság kézbesítési azonosítója.

pVar
Az új tulajdonságértéket VARIANT tartalmazó mutató.

pdispControl
Mutasson egy ActiveX-vezérlő felületére IDispatch .

szPropName
A beállítani kívánt tulajdonság nevét tartalmazó sztring.

CDHtmlDialog::SetElementHtml

Beállítja egy innerHTML HTML-elem tulajdonságát.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Paraméterek

szElementId
Egy HTML-elem azonosítója.

bstrText
A tulajdonság új értéke innerHTML .

punkElem
Egy IUnknown HTML-elem mutatója.

CDHtmlDialog::SetElementProperty

Beállít egy HTML-elem tulajdonságát.

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

Paraméterek

szElementId
Egy HTML-elem azonosítója.

dispId
A beállítani kívánt tulajdonság kézbesítési azonosítója.

pVar
A tulajdonság új értéke.

CDHtmlDialog::SetElementText

Beállítja egy innerText HTML-elem tulajdonságát.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Paraméterek

szElementId
Egy HTML-elem azonosítója.

bstrText
A tulajdonság új értéke innerText .

punkElem
Egy IUnknown HTML-elem mutatója.

CDHtmlDialog::SetExternalDispatch

Beállítja a gazdagép felületét IDispatch .

void SetExternalDispatch(IDispatch* pdispExternal);

Paraméterek

pdispExternal
Az új IDispatch felület.

CDHtmlDialog::SetHostFlags

Beállítja a gazdagép felhasználói felületének jelzőit.

void SetHostFlags(DWORD dwFlags);

Paraméterek

dwFlags
A lehetséges értékekről a Windows SDK-ban olvashat DOCHOSTUIFLAG .

CDHtmlDialog::ShowContextMenu

A helyi menü megjelenésekor hívható meg.

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

Paraméterek

dwID
Lásd dwID a Windows SDK-ban IDocHostUIHandler::ShowContextMenu .

ppt
Lásd ppt a Windows SDK-ban IDocHostUIHandler::ShowContextMenu .

pcmdtReserved
Lásd pcmdtReserved a Windows SDK-ban IDocHostUIHandler::ShowContextMenu .

pdispReserved
Lásd pdispReserved a Windows SDK-ban IDocHostUIHandler::ShowContextMenu .

Visszaadott érték

Visszatér S_FALSE.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::ShowContextMenu.

CDHtmlDialog::ShowUI

Megjeleníti a gazdagép felhasználói felületét.

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

Paraméterek

dwID
Lásd dwID a Windows SDK-ban IDocHostUIHandler::ShowUI .

pActiveObject
Lásd pActiveObject a Windows SDK-ban IDocHostUIHandler::ShowUI .

pCommandTarget
Lásd pCommandTarget a Windows SDK-ban IDocHostUIHandler::ShowUI .

pFrame
Lásd pFrame a Windows SDK-ban IDocHostUIHandler::ShowUI .

pDoc
Lásd pDoc a Windows SDK-ban IDocHostUIHandler::ShowUI .

Visszaadott érték

Visszatér S_FALSE.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::ShowUI.

CDHtmlDialog::TranslateAccelerator

A menügyorsítókulcs-üzenetek feldolgozására van meghívva.

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

Paraméterek

lpMsg
Lásd lpMsg a Windows SDK-ban IDocHostUIHandler::TranslateAccelerator .

pguidCmdGroup
Lásd pguidCmdGroup a Windows SDK-ban IDocHostUIHandler::TranslateAccelerator .

nCmdID
Lásd nCmdID a Windows SDK-ban IDocHostUIHandler::TranslateAccelerator .

Visszaadott érték

Visszatér S_FALSE.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::TranslateAccelerator.

CDHtmlDialog::TranslateUrl

A betöltéshez szükséges URL-cím módosítására van meghívva.

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

Paraméterek

dwTranslate
Lásd dwTranslate a Windows SDK-ban IDocHostUIHandler::TranslateUrl .

pchURLIn
Lásd pchURLIn a Windows SDK-ban IDocHostUIHandler::TranslateUrl .

ppchURLOut
Lásd ppchURLOut a Windows SDK-ban IDocHostUIHandler::TranslateUrl .

Visszaadott érték

Visszatér S_FALSE.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::TranslateUrl.

CDHtmlDialog::UpdateUI

Meghívva, hogy értesítse a gazdagépet arról, hogy a parancs állapota megváltozott.

STDMETHOD(UpdateUI)(void);

Visszaadott érték

Visszatér E_NOTIMPL.

Megjegyzések

Ez a tagfüggvény a CDHtmlDialog Windows SDK-ban leírt implementáció IDocHostUIHandler::UpdateUI.

Lásd még

MFC-minta DHtmlExplore
DDX_DHtml Segédmakrók
hierarchiadiagram