Share via

CDHtmlDialog-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Wordt gebruikt om dialoogvensters te maken die HTML gebruiken in plaats van dialoogvensterbronnen om hun gebruikersinterface te implementeren.

Syntaxis

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Leden

Openbare constructors

Naam Description
CDHtmlDialog::CDHtmlDialog Maakt een CDHtmlDialog-object.
CDHtmlDialog::~CDHtmlDialog Vernietigt een CDHtmlDialog-object.

Openbare methoden

Naam Description
CDHtmlDialog::CanAccessExternal Overschrijfbaar dat wordt aangeroepen als een toegangscontrole om te zien of scriptobjecten op de geladen pagina toegang hebben tot de externe verzending van de beheersite. Controleert of de verzending veilig is voor het uitvoeren van scripts of dat de huidige zone objecten toestaat die niet veilig zijn voor het uitvoeren van scripts.
CDHtmlDialog::CreateControlSite Kan worden overschreven voor het maken van een exemplaar van een besturingssite voor het hosten van het webbrowserbesturingselement in het dialoogvenster.
CDHtmlDialog::DDX_DHtml_AxControl Hiermee worden gegevens uitgewisseld tussen een lidvariabele en de eigenschapswaarde van een ActiveX-besturingselement op een HTML-pagina.
CDHtmlDialog::DDX_DHtml_CheckBox Gegevens uitwisselen tussen een lidvariabele en een selectievakje op een HTML-pagina.
CDHtmlDialog::DDX_DHtml_ElementText Gegevens worden uitgewisseld tussen een lidvariabele en een HTML-elementeigenschap op een HTML-pagina.
CDHtmlDialog::DDX_DHtml_Radio Gegevens uitwisselen tussen een lidvariabele en een keuzerondje op een HTML-pagina.
CDHtmlDialog::DDX_DHtml_SelectIndex Hiermee haalt u de index van een keuzelijst op een HTML-pagina op of stelt u deze in.
CDHtmlDialog::DDX_DHtml_SelectString Hiermee haalt u de weergavetekst van een keuzelijstvermelding (op basis van de huidige index) op een HTML-pagina op of stelt u deze in.
CDHtmlDialog::DDX_DHtml_SelectValue Hiermee haalt u de waarde van een keuzelijstvermelding (op basis van de huidige index) op een HTML-pagina op of stelt u deze in.
CDHtmlDialog::DestroyModeless Vernietigt een modusloos dialoogvenster.
CDHtmlDialog::EnableModeless Hiermee schakelt u modusloze dialoogvensters in.
CDHtmlDialog::FilterDataObject Hiermee kunt u in het dialoogvenster gegevensobjecten van klembord filteren die zijn gemaakt door de gehoste browser.
CDHtmlDialog::GetControlDispatch Haalt de IDispatch interface op een ActiveX-besturingselement op dat is ingesloten in het HTML-document.
CDHtmlDialog::GetControlProperty Haalt de aangevraagde eigenschap van het opgegeven ActiveX-besturingselement op.
CDHtmlDialog::GetCurrentUrl Haalt de URL (Uniform Resource Locator) op die is gekoppeld aan het huidige document.
CDHtmlDialog::GetDHtmlDocument Haalt de IHTMLDocument2 interface op het momenteel geladen HTML-document op.
CDHtmlDialog::GetDropTarget Aangeroepen door het besturingselement ingesloten webbrowser wanneer het wordt gebruikt als een doel voor neerzetten, zodat het dialoogvenster een alternatief IDropTargetkan opgeven.
CDHtmlDialog::GetElement Hiermee haalt u een interface op een HTML-element op.
CDHtmlDialog::GetElementHtml Haalt de innerHTML eigenschap van een HTML-element op.
CDHtmlDialog::GetElementInterface Haalt de aangevraagde interfaceaanwijzer op uit een HTML-element.
CDHtmlDialog::GetElementProperty Haalt de waarde van de eigenschap van een HTML-element op.
CDHtmlDialog::GetElementText Haalt de innerText eigenschap van een HTML-element op.
CDHtmlDialog::GetEvent Hiermee wordt de IHTMLEventObj aanwijzer naar het huidige gebeurtenisobject opgehaald.
CDHtmlDialog::GetExternal Hiermee haalt u de interface van IDispatch de host op.
CDHtmlDialog::GetHostInfo Haalt de ui-mogelijkheden van de host op.
CDHtmlDialog::GetOptionKeyPath Haalt de registersleutel op waaronder gebruikersvoorkeuren worden opgeslagen.
CDHtmlDialog::HideUI Hiermee verbergt u de gebruikersinterface van de host.
CDHtmlDialog::IsExternalDispatchSafe Geeft aan of de interface van IDispatch de host veilig is voor scripting.
CDHtmlDialog::LoadFromResource Laadt de opgegeven resource in het besturingselement Webbrowser.
CDHtmlDialog::Navigate Navigeert naar de opgegeven URL.
CDHtmlDialog::OnBeforeNavigate Wordt aangeroepen door het framework voordat een navigatie-gebeurtenis wordt geactiveerd.
CDHtmlDialog::OnDocumentComplete Aangeroepen door het framework om een toepassing op de hoogte te stellen wanneer een document de READYSTATE_COMPLETE status heeft bereikt.
CDHtmlDialog::OnDocWindowActivate Aangeroepen door het framework wanneer het documentvenster wordt geactiveerd of gedeactiveerd.
CDHtmlDialog::OnFrameWindowActivate Aangeroepen door het framework wanneer het framevenster wordt geactiveerd of gedeactiveerd.
CDHtmlDialog::OnInitDialog Wordt aangeroepen als reactie op het WM_INITDIALOG bericht.
CDHtmlDialog::OnNavigateComplete Aangeroepen door het framework nadat een navigatie-gebeurtenis is voltooid.
CDHtmlDialog::ResizeBorder Hiermee wordt het object gewaarschuwd dat het formaat van de randruimte moet wijzigen.
CDHtmlDialog::SetControlProperty Hiermee stelt u de eigenschap van een ActiveX-besturingselement in op een nieuwe waarde.
CDHtmlDialog::SetElementHtml Hiermee stelt u de innerHTML eigenschap van een HTML-element in.
CDHtmlDialog::SetElementProperty Hiermee stelt u een eigenschap van een HTML-element in.
CDHtmlDialog::SetElementText Hiermee stelt u de innerText eigenschap van een HTML-element in.
CDHtmlDialog::SetExternalDispatch Hiermee stelt u de interface van IDispatch de host in.
CDHtmlDialog::SetHostFlags Hiermee stelt u de ui-vlaggen van de host in.
CDHtmlDialog::ShowContextMenu Wordt aangeroepen wanneer een contextmenu op het punt staat te worden weergegeven.
CDHtmlDialog::ShowUI Toont de gebruikersinterface van de host.
CDHtmlDialog::TranslateAccelerator Aangeroepen om menuversnellerberichten te verwerken.
CDHtmlDialog::TranslateUrl Wordt aangeroepen om de URL te wijzigen die moet worden geladen.
CDHtmlDialog::UpdateUI Wordt aangeroepen om de host te waarschuwen dat de opdrachtstatus is gewijzigd.

Leden van openbare gegevens

Naam Description
CDHtmlDialog::m_bUseHtmlTitle Geeft aan of de titel van het HTML-document moet worden gebruikt als het bijschrift van het dialoogvenster.
CDHtmlDialog::m_nHtmlResID Resource-id van HTML-resource die moet worden weergegeven.
CDHtmlDialog::m_pBrowserApp Een aanwijzer naar een webbrowsertoepassing.
CDHtmlDialog::m_spHtmlDoc Een aanwijzer naar een HTML-document.
CDHtmlDialog::m_strCurrentUrl De huidige URL.
CDHtmlDialog::m_szHtmlResID Tekenreeksversie van de HTML-resource-id.

Opmerkingen

CDHtmlDialog kan de HTML laden die moet worden weergegeven vanuit een HTML-resource of een URL.

CDHtmlDialog kan ook gegevensuitwisseling uitvoeren met HTML-besturingselementen en gebeurtenissen van HTML-besturingselementen verwerken, zoals klikken op knoppen.

Overnamehiërarchie

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Requirements

Rubriek:afxdhtml.h

DDX_DHtml Helper-macro's

Met de DDX_DHtml helpermacro's hebt u eenvoudig toegang tot de veelgebruikte eigenschappen van besturingselementen op een HTML-pagina.

Gegevensuitwisselingsmacro's

Naam Description
DDX_DHtml_ElementValue Hiermee stelt u de eigenschap Waarde in of haalt u deze op uit het geselecteerde besturingselement.
DDX_DHtml_ElementInnerText Hiermee stelt u de tekst tussen de begin- en eindtags van het huidige element in of haalt u deze op.
DDX_DHtml_ElementInnerHtml Hiermee stelt u de HTML tussen de begin- en eindtags van het huidige element in of haalt u deze op.
DDX_DHtml_Anchor_Href Hiermee stelt u de doel-URL of het ankerpunt in of haalt u deze op.
DDX_DHtml_Anchor_Target Hiermee stelt u het doelvenster of het doelframe in of haalt u dit op.
DDX_DHtml_Img_Src Hiermee stelt u de naam van een afbeelding of een videoclip in het document in of haalt u deze op.
DDX_DHtml_Frame_Src Hiermee stelt u de URL van het gekoppelde frame in of haalt u deze op.
DDX_DHtml_IFrame_Src Hiermee stelt u de URL van het gekoppelde frame in of haalt u deze op.

CDHtmlDialog::CanAccessExternal

Overschrijfbaar dat wordt aangeroepen als een toegangscontrole om te zien of scriptobjecten op de geladen pagina toegang hebben tot de externe verzending van de beheersite. Controleert of de verzending veilig is voor het uitvoeren van scripts of dat de huidige zone objecten toestaat die niet veilig zijn voor het uitvoeren van scripts.

virtual BOOL CanAccessExternal();

Retourwaarde

Niet-nul indien geslaagd; anders 0.

CDHtmlDialog::CDHtmlDialog

Maakt een dynamisch HTML-dialoogvenster op basis van resources.

CDHtmlDialog();

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

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

Parameterwaarden

lpszTemplateName
De door null beëindigde tekenreeks die de naam is van een dialoogvenstersjabloonresource.

szHtmlResID
De null-beëindigde tekenreeks die de naam is van een HTML-resource.

pParentWnd
Een aanwijzer naar het bovenliggende of eigenaarvensterobject (van het type CWnd) waartoe het dialoogvensterobject behoort. Als dat het NULLis, wordt het bovenliggende venster van het dialoogvenster ingesteld op het hoofdtoepassingsvenster.

nIDTemplate
Bevat het id-nummer van een resource voor een dialoogvenstersjabloon.

nHtmlResID
Bevat het id-nummer van een HTML-resource.

Opmerkingen

De tweede vorm van de constructor biedt toegang tot de dialoogvensterresource via de sjabloonnaam. De derde vorm van de constructor biedt toegang tot de dialoogvensterresource via de id van de resourcesjabloon. Meestal begint de id met het IDD_ voorvoegsel.

CDHtmlDialog::~CDHtmlDialog

Vernietigt een CDHtmlDialog object.

virtual ~CDHtmlDialog();

Opmerkingen

De CWnd::DestroyWindow lidfunctie moet worden gebruikt om modusloze dialoogvensters te vernietigen die door zijn gemaakt CDialog::Create.

CDHtmlDialog::CreateControlSite

Kan worden overschreven voor het maken van een exemplaar van een besturingssite voor het hosten van het webbrowserbesturingselement in het dialoogvenster.

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

Parameterwaarden

pContainer
Een aanwijzer naar het COleControlContainer object.

ppSite
Een aanwijzer naar een aanwijzer naar een COleControlSite.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

U kunt deze lidfunctie overschrijven om een exemplaar van uw eigen siteklasse voor beheer te retourneren.

CDHtmlDialog::DDX_DHtml_AxControl

Hiermee worden gegevens uitgewisseld tussen een lidvariabele en de eigenschapswaarde van een ActiveX-besturingselement op een HTML-pagina.

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

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object.

szId
De waarde van de id-parameter van de objecttag in de HTML-bron voor het ActiveX-besturingselement.

dispId
De verzend-id van de eigenschap waarmee u gegevens wilt uitwisselen.

szPropName
De naam van de eigenschap.

var
Het gegevenslid, van het type VARIANT, COleVariantof CComVariant, dat de waarde bevat die wordt uitgewisseld met de eigenschap ActiveX-besturingselement.

Example

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

CDHtmlDialog::DDX_DHtml_CheckBox

Gegevens uitwisselen tussen een lidvariabele en een selectievakje op een HTML-pagina.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object.

szId
De waarde die u hebt opgegeven voor de id-parameter van het HTML-besturingselement.

value
De waarde die wordt uitgewisseld.

Example

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

CDHtmlDialog::DDX_DHtml_ElementText

Gegevens worden uitgewisseld tussen een lidvariabele en een HTML-elementeigenschap op een HTML-pagina.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object.

szId
De waarde die u hebt opgegeven voor de id-parameter van het HTML-besturingselement.

dispId
De verzend-id van het HTML-element waarmee u gegevens wilt uitwisselen.

value
De waarde die wordt uitgewisseld.

CDHtmlDialog::DDX_DHtml_Radio

Gegevens uitwisselen tussen een lidvariabele en een keuzerondje op een HTML-pagina.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object.

szId
De waarde die u hebt opgegeven voor de id-parameter van het HTML-besturingselement.

value
De waarde die wordt uitgewisseld.

CDHtmlDialog::DDX_DHtml_SelectIndex

Hiermee haalt u de index van een keuzelijst op een HTML-pagina op of stelt u deze in.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object.

szId
De waarde die u hebt opgegeven voor de parameter van id het HTML-besturingselement.

value
De waarde die wordt uitgewisseld.

CDHtmlDialog::DDX_DHtml_SelectString

Hiermee haalt u de weergavetekst van een keuzelijstvermelding (op basis van de huidige index) op een HTML-pagina op of stelt u deze in.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object.

szId
De waarde die u hebt opgegeven voor de id-parameter van het HTML-besturingselement.

value
De waarde die wordt uitgewisseld.

CDHtmlDialog::DDX_DHtml_SelectValue

Hiermee haalt u de waarde van een keuzelijstvermelding (op basis van de huidige index) op een HTML-pagina op of stelt u deze in.

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

Parameterwaarden

pDX
Een aanwijzer naar een CDataExchange object.

szId
De waarde die u hebt opgegeven voor de id-parameter van het HTML-besturingselement.

value
De waarde die wordt uitgewisseld.

Example

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

CDHtmlDialog::DestroyModeless

Hiermee wordt een modusloos dialoogvenster van het CDHtmlDialog object losgekoppeld en wordt het object vernietigd.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Hiermee schakelt u modusloze dialoogvensters in.

STDMETHOD(EnableModeless)(BOOL fEnable);

Parameterwaarden

fEnable
Zie fEnable in IDocHostUIHandler::EnableModeless de Windows SDK.

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::EnableModeless, zoals beschreven in de Windows SDK.

CDHtmlDialog::FilterDataObject

Hiermee kunt u in het dialoogvenster gegevensobjecten van klembord filteren die zijn gemaakt door de gehoste browser.

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

Parameterwaarden

pDO
Zie pDO in IDocHostUIHandler::FilterDataObject de Windows SDK.

ppDORet
Zie ppDORet in IDocHostUIHandler::FilterDataObject de Windows SDK.

Retourwaarde

Retourneert S_FALSE.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::FilterDataObject, zoals beschreven in de Windows SDK.

CDHtmlDialog::GetControlDispatch

Haalt de IDispatch interface op een ActiveX-besturingselement op dat is ingesloten in het HTML-document dat wordt geretourneerd door GetDHtmlDocument.

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

Parameterwaarden

szId
De HTML-id van een ActiveX-besturingselement.

ppdisp
De IDispatch interface van het besturingselement, indien gevonden op de webpagina.

Retourwaarde

Een standaardwaarde HRESULT .

CDHtmlDialog::GetControlProperty

Haalt de aangevraagde eigenschap van het opgegeven ActiveX-besturingselement op.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Parameterwaarden

szId
De HTML-id van een ActiveX-besturingselement.

szPropName
De naam van een eigenschap in de standaardlandinstelling van de huidige gebruiker.

pdispControl
De IDispatch aanwijzer van een ActiveX-besturingselement.

dispId
De verzend-id van een eigenschap.

Retourwaarde

Een variant met de aangevraagde eigenschap of een lege variant als het besturingselement of de eigenschap niet kan worden gevonden.

Opmerkingen

De overbelastingen worden vermeld van minimaal efficiënt bovenaan tot meest efficiënt onderaan.

CDHtmlDialog::GetCurrentUrl

Haalt de URL (Uniform Resource Locator) op die is gekoppeld aan het huidige document.

void GetCurrentUrl(CString& szUrl);

Parameterwaarden

szUrl
Een CString object met de URL die moet worden opgehaald.

CDHtmlDialog::GetDHtmlDocument

Haalt de IHTMLDocument2 interface op het momenteel geladen HTML-document op.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Parameterwaarden

**pphtmlDoc Een aanwijzer naar een HTML-document.

Retourwaarde

Een standaard HRESULT. Retourneert S_OK als dit lukt.

CDHtmlDialog::GetDropTarget

Aangeroepen door het besturingselement ingesloten webbrowser wanneer het wordt gebruikt als een doel voor neerzetten, zodat het dialoogvenster een alternatief IDropTargetkan opgeven.

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

Parameterwaarden

pDropTarget
Zie pDropTarget in IDocHostUIHandler::GetDropTarget de Windows SDK.

ppDropTarget
Zie ppDropTarget in IDocHostUIHandler::GetDropTarget de Windows SDK.

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::GetDropTarget, zoals beschreven in de Windows SDK.

CDHtmlDialog::GetElement

Retourneert een interface op het HTML-element dat is opgegeven door szElementId.

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

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

Parameterwaarden

szElementId
De id van een HTML-element.

ppdisp
Een IDispatch aanwijzer naar het aangevraagde element of de verzameling elementen.

pbCollection
Een BOOL die aangeeft of het object dat wordt vertegenwoordigd door ppdisp één element of een verzameling elementen is.

pphtmlElement
Een IHTMLElement aanwijzer naar het aangevraagde element.

Retourwaarde

Een standaardwaarde HRESULT .

Opmerkingen

Gebruik de eerste overbelasting als u voorwaarden wilt afhandelen waarin er meer dan één element met de opgegeven id kan zijn. U kunt de laatste parameter gebruiken om erachter te komen of de geretourneerde interfacepointer naar een verzameling of één item gaat. Als de interfaceaanwijzer zich in een verzameling bevindt, kunt u een query uitvoeren op de IHTMLElementCollection eigenschap en de eigenschap ervan gebruiken item om te verwijzen naar de elementen op rangschikkelijke positie.

De tweede overbelasting mislukt als er meer dan één element is met dezelfde id op de pagina.

CDHtmlDialog::GetElementHtml

Haalt de innerHTML eigenschap op van het HTML-element dat is geïdentificeerd door szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

Parameterwaarden

szElementId
De id van een HTML-element.

Retourwaarde

De innerHTML eigenschap van het HTML-element dat is geïdentificeerd door szElementId of NULL als het element niet kan worden gevonden.

CDHtmlDialog::GetElementInterface

Haalt de aangevraagde interfacepointer op uit het HTML-element dat is geïdentificeerd door szElementId.

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

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

Parameterwaarden

szElementId
De id van een HTML-element.

ppvObj
Adres van een aanwijzer die wordt gevuld met de aangevraagde interfacepointer als het element wordt gevonden en de query slaagt.

refiid
De interface-id (IID) van de aangevraagde interface.

Retourwaarde

Een standaardwaarde HRESULT .

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

Haalt de waarde op van de eigenschap die is geïdentificeerd door het HTML-element dat is geïdentificeerd dispId door szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Parameterwaarden

szElementId
De id van een HTML-element.

dispId
De verzend-id van een eigenschap.

Retourwaarde

De waarde van de eigenschap of een lege variant als de eigenschap of het element niet kan worden gevonden.

CDHtmlDialog::GetElementText

Haalt de innerText eigenschap op van het HTML-element dat is geïdentificeerd door szElementId.

BSTR GetElementText(LPCTSTR szElementId);

Parameterwaarden

szElementId
De id van een HTML-element.

Retourwaarde

De innerText eigenschap van het HTML-element dat is geïdentificeerd door szElementId of NULL als de eigenschap of het element niet kan worden gevonden.

CDHtmlDialog::GetEvent

Retourneert de IHTMLEventObj aanwijzer naar het huidige gebeurtenisobject.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Parameterwaarden

ppEventObj
Adres van een aanwijzer die wordt gevuld met de IHTMLEventObj interfacepointer.

Retourwaarde

Een standaardwaarde HRESULT .

Opmerkingen

Deze functie mag alleen worden aangeroepen vanuit een DHTML-gebeurtenis-handler.

CDHtmlDialog::GetExternal

Hiermee haalt u de interface van IDispatch de host op.

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Parameterwaarden

ppDispatch
Zie ppDispatch in IDocHostUIHandler::GetExternal de Windows SDK.

Retourwaarde

Retourneert S_OK een succes of E_NOTIMPL fout.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::GetExternal, zoals beschreven in de Windows SDK.

CDHtmlDialog::GetHostInfo

Haalt de ui-mogelijkheden van de host op.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Parameterwaarden

pInfo
Zie pInfo in IDocHostUIHandler::GetHostInfo de Windows SDK.

Retourwaarde

Retourneert S_OK.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::GetHostInfo, zoals beschreven in de Windows SDK.

CDHtmlDialog::GetOptionKeyPath

Haalt de registersleutel op waaronder gebruikersvoorkeuren worden opgeslagen.

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

Parameterwaarden

pchKey
Zie pchKey in IDocHostUIHandler::GetOptionKeyPath de Windows SDK.

dw
Zie dw in IDocHostUIHandler::GetOptionKeyPath de Windows SDK.

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::GetOptionKeyPath, zoals beschreven in de Windows SDK.

CDHtmlDialog::HideUI

Hiermee verbergt u de gebruikersinterface van de host.

STDMETHOD(HideUI)(void);

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::HideUI, zoals beschreven in de Windows SDK.

CDHtmlDialog::IsExternalDispatchSafe

Geeft aan of de interface van IDispatch de host veilig is voor scripting.

virtual BOOL IsExternalDispatchSafe();

Retourwaarde

Retourneert FALSE.

CDHtmlDialog::LoadFromResource

Laadt de opgegeven resource in het besturingselement Webbrowser in het dialoogvenster DHTML.

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

Parameterwaarden

lpszResource
Een aanwijzer naar een tekenreeks met de naam van de resource die moet worden geladen.

nRes
De id van de resource die moet worden geladen.

Retourwaarde

TRUE indien geslaagd; anders FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Geeft aan of de titel van het HTML-document moet worden gebruikt als het bijschrift van het dialoogvenster.

BOOL m_bUseHtmlTitle;

Opmerkingen

Als m_bUseHtmlTitle dat het is TRUE, wordt het dialoogvensterbijschrift ingesteld op de titel van het HTML-document. Anders wordt het bijschrift in de dialoogvensterresource gebruikt.

CDHtmlDialog::m_nHtmlResID

Resource-id van HTML-resource die moet worden weergegeven.

UINT m_nHtmlResID;

Example

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

CDHtmlDialog::m_pBrowserApp

Een aanwijzer naar een webbrowsertoepassing.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Een aanwijzer naar een HTML-document.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

De huidige URL.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

Tekenreeksversie van de HTML-resource-id.

LPTSTR m_szHtmlResID;

Example

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

Hiermee gaat u naar de resource die wordt geïdentificeerd door de URL die is opgegeven door lpszURL.

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

Parameterwaarden

lpszURL
Een aanwijzer naar een tekenreeks die de URL bevat waarop de url moet worden gericht.

dwFlags
De vlaggen van een variabele die aangeeft of de resource moet worden toegevoegd aan de geschiedenislijst, of de resource moet worden gelezen of geschreven vanuit de cache en of de resource in een nieuw venster moet worden weergegeven. De variabele kan een combinatie zijn van de waarden die zijn gedefinieerd door de BrowserNavConstants opsomming.

lpszTargetFrameName
Een aanwijzer naar een tekenreeks die de naam van het frame bevat waarin de resource moet worden weergegeven.

lpszHeaders
Een aanwijzer naar een waarde die de HTTP-headers aangeeft die naar de server moeten worden verzonden. Deze headers worden toegevoegd aan de standaard Kopteksten van Internet Explorer. De headers kunnen informatie opgeven zoals de actie die nodig is voor de server, het type gegevens dat wordt doorgegeven aan de server of een statuscode. Deze parameter wordt genegeerd als de URL geen HTTP-URL is.

lpvPostData
Een aanwijzer naar de gegevens die moeten worden verzonden met de HTTP POST-transactie. De POST-transactie wordt bijvoorbeeld gebruikt om gegevens te verzenden die zijn verzameld door een HTML-formulier. Als met deze parameter geen postgegevens worden opgegeven, Navigate geeft u een HTTP GET-transactie uit. Deze parameter wordt genegeerd als de URL geen HTTP-URL is.

dwPostDataLen
Gegevens die moeten worden verzonden met de HTTP POST-transactie. De POST-transactie wordt bijvoorbeeld gebruikt om gegevens te verzenden die zijn verzameld door een HTML-formulier. Als met deze parameter geen postgegevens worden opgegeven, Navigate geeft u een HTTP GET-transactie uit. Deze parameter wordt genegeerd als URL geen HTTP-URL is.

CDHtmlDialog::OnBeforeNavigate

Aangeroepen door het framework om ervoor te zorgen dat een gebeurtenis wordt geactiveerd voordat er een navigatie plaatsvindt.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parameterwaarden

pDisp
Een aanwijzer naar een IDispatch object.

szUrl
Een aanwijzer naar een tekenreeks met de URL waarnaar u wilt navigeren.

CDHtmlDialog::OnDocumentComplete

Wordt aangeroepen door het framework om een toepassing op de hoogte te stellen wanneer een document de READYSTATE_COMPLETE status heeft bereikt.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parameterwaarden

pDisp
Een aanwijzer naar een IDispatch object.

szUrl
Een aanwijzer naar een tekenreeks met de URL waarnaar is genavigeerd.

CDHtmlDialog::OnDocWindowActivate

Aangeroepen door het framework wanneer het documentvenster wordt geactiveerd of gedeactiveerd.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Parameterwaarden

fActivate
Zie fActivate in IDocHostUIHandler::OnDocWindowActivate de Windows SDK.

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::OnDocWindowActivate, zoals beschreven in de Windows SDK.

CDHtmlDialog::OnFrameWindowActivate

Aangeroepen door het framework wanneer het framevenster wordt geactiveerd of gedeactiveerd.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Parameterwaarden

fActivate
Zie fActivate in IDocHostUIHandler::OnFrameWindowActivate de Windows SDK.

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::OnFrameWindowActivate, zoals beschreven in de Windows SDK.

CDHtmlDialog::OnInitDialog

Wordt aangeroepen als reactie op het WM_INITDIALOG bericht.

virtual BOOL OnInitDialog();

Retourwaarde

De standaard implementatie retourneert TRUE.

Opmerkingen

Dit bericht wordt verzonden naar het dialoogvenster tijdens de Create, CreateIndirectof DoModal oproepen, die direct plaatsvinden voordat het dialoogvenster wordt weergegeven.

Overschrijf deze lidfunctie als u speciale verwerking moet uitvoeren wanneer het dialoogvenster wordt geïnitialiseerd. Roep in de overschreven versie eerst de basisklasse OnInitDialog aan, maar negeer de retourwaarde. Normaal gesproken retourneert TRUE u de functie overschreven leden.

Windows roept de OnInitDialog functie aan via de standaard algemene dialoogvensterprocedure die gebruikelijk is voor alle dialoogvensters van Microsoft Foundation Class Library, in plaats van via uw berichtkaart, zodat u geen berichtkaartvermelding nodig hebt voor deze lidfunctie.

CDHtmlDialog::OnNavigateComplete

Aangeroepen door het framework nadat de navigatie naar de opgegeven URL is voltooid.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parameterwaarden

pDisp
Een aanwijzer naar een IDispatch object.

szUrl
Een aanwijzer naar een tekenreeks met de URL waarnaar is genavigeerd.

CDHtmlDialog::ResizeBorder

Hiermee wordt het object gewaarschuwd dat het formaat van de randruimte moet wijzigen.

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

Parameterwaarden

prcBorder
Zie prcBorder in IDocHostUIHandler::ResizeBorder de Windows SDK.

pUIWindow
Zie pUIWindow in IDocHostUIHandler::ResizeBorder de Windows SDK.

fFrameWindow
Zie fFrameWindow in IDocHostUIHandler::ResizeBorder de Windows SDK.

Retourwaarde

Retourneert E_NOTIMPL.

CDHtmlDialog::SetControlProperty

Hiermee stelt u de eigenschap van een ActiveX-besturingselement in op een nieuwe waarde.

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

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

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

Parameterwaarden

szElementId
De HTML-id van een ActiveX-besturingselement.

dispId
De verzend-id van de eigenschap die moet worden ingesteld.

pVar
Aanwijzer naar een VARIANT met de nieuwe eigenschapswaarde.

pdispControl
Aanwijzer naar de interface van IDispatch een ActiveX-besturingselement.

szPropName
Tekenreeks met de naam van de eigenschap die moet worden ingesteld.

CDHtmlDialog::SetElementHtml

Hiermee stelt u de innerHTML eigenschap van een HTML-element in.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Parameterwaarden

szElementId
De id van een HTML-element.

bstrText
De nieuwe waarde van de innerHTML eigenschap.

punkElem
De IUnknown aanwijzer van een HTML-element.

CDHtmlDialog::SetElementProperty

Hiermee stelt u een eigenschap van een HTML-element in.

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

Parameterwaarden

szElementId
De id van een HTML-element.

dispId
De verzend-id van de eigenschap die moet worden ingesteld.

pVar
De nieuwe waarde van de eigenschap.

CDHtmlDialog::SetElementText

Hiermee stelt u de innerText eigenschap van een HTML-element in.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Parameterwaarden

szElementId
De id van een HTML-element.

bstrText
De nieuwe waarde van de innerText eigenschap.

punkElem
De IUnknown aanwijzer van een HTML-element.

CDHtmlDialog::SetExternalDispatch

Hiermee stelt u de interface van IDispatch de host in.

void SetExternalDispatch(IDispatch* pdispExternal);

Parameterwaarden

pdispExternal
De nieuwe IDispatch interface.

CDHtmlDialog::SetHostFlags

Hiermee stelt u de vlaggen voor de hostgebruikersinterface in.

void SetHostFlags(DWORD dwFlags);

Parameterwaarden

dwFlags
Zie de Windows SDK voor mogelijke waarden DOCHOSTUIFLAG .

CDHtmlDialog::ShowContextMenu

Wordt aangeroepen wanneer een contextmenu op het punt staat te worden weergegeven.

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

Parameterwaarden

dwID
Zie dwID in IDocHostUIHandler::ShowContextMenu de Windows SDK.

ppt
Zie ppt in IDocHostUIHandler::ShowContextMenu de Windows SDK.

pcmdtReserved
Zie pcmdtReserved in IDocHostUIHandler::ShowContextMenu de Windows SDK.

pdispReserved
Zie pdispReserved in IDocHostUIHandler::ShowContextMenu de Windows SDK.

Retourwaarde

Retourneert S_FALSE.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::ShowContextMenu, zoals beschreven in de Windows SDK.

CDHtmlDialog::ShowUI

Toont de gebruikersinterface van de host.

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

Parameterwaarden

dwID
Zie dwID in IDocHostUIHandler::ShowUI de Windows SDK.

pActiveObject
Zie pActiveObject in IDocHostUIHandler::ShowUI de Windows SDK.

pCommandTarget
Zie pCommandTarget in IDocHostUIHandler::ShowUI de Windows SDK.

pFrame
Zie pFrame in IDocHostUIHandler::ShowUI de Windows SDK.

pDoc
Zie pDoc in IDocHostUIHandler::ShowUI de Windows SDK.

Retourwaarde

Retourneert S_FALSE.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::ShowUI, zoals beschreven in de Windows SDK.

CDHtmlDialog::TranslateAccelerator

Aangeroepen om menuversnellerberichten te verwerken.

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

Parameterwaarden

lpMsg
Zie lpMsg in IDocHostUIHandler::TranslateAccelerator de Windows SDK.

pguidCmdGroup
Zie pguidCmdGroup in IDocHostUIHandler::TranslateAccelerator de Windows SDK.

nCmdID
Zie nCmdID in IDocHostUIHandler::TranslateAccelerator de Windows SDK.

Retourwaarde

Retourneert S_FALSE.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::TranslateAccelerator, zoals beschreven in de Windows SDK.

CDHtmlDialog::TranslateUrl

Wordt aangeroepen om de URL te wijzigen die moet worden geladen.

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

Parameterwaarden

dwTranslate
Zie dwTranslate in IDocHostUIHandler::TranslateUrl de Windows SDK.

pchURLIn
Zie pchURLIn in IDocHostUIHandler::TranslateUrl de Windows SDK.

ppchURLOut
Zie ppchURLOut in IDocHostUIHandler::TranslateUrl de Windows SDK.

Retourwaarde

Retourneert S_FALSE.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::TranslateUrl, zoals beschreven in de Windows SDK.

CDHtmlDialog::UpdateUI

Wordt aangeroepen om de host te waarschuwen dat de opdrachtstatus is gewijzigd.

STDMETHOD(UpdateUI)(void);

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Deze lidfunctie is de CDHtmlDialog implementatie van IDocHostUIHandler::UpdateUI, zoals beschreven in de Windows SDK.

Zie ook

MFC-voorbeeld DHtmlExplore
DDX_DHtml Helper-macro's
Hiërarchiegrafiek

  • Last updated on