CDHtmlDialog-Klasse

Wird verwendet, um Dialogfelder zu erstellen, die HTML anstelle von Dialogressourcen verwenden, um ihre Benutzeroberfläche zu implementieren.

Syntax

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Member

Öffentliche Konstruktoren

Name	Beschreibung
CDHtmlDialog::CDHtmlDialog	Erstellt ein CDHtmlDialog -Objekt.
CDHtmlDialog::~CDHtmlDialog	Zerstört ein CDHtmlDialog -Objekt.

Öffentliche Methoden

Name	Beschreibung
CDHtmlDialog::CanAccessExternal	Überschreibbar, die als Zugriffsüberprüfung aufgerufen wird, um festzustellen, ob Skriptobjekte auf der geladenen Seite auf die externe Verteilerstelle der Steuerelementwebsite zugreifen können. Überprüft, ob der Versand entweder für skripting sicher ist oder die aktuelle Zone Objekte zulässt, die nicht für skripting sicher sind.
CDHtmlDialog::CreateControlSite	Überschreibbar zum Erstellen einer Steuerelementwebsiteinstanz zum Hosten des WebBrowser-Steuerelements im Dialogfeld.
CDHtmlDialog::DDX_DHtml_AxControl	Austausch von Daten zwischen einer Membervariable und dem Eigenschaftswert eines ActiveX-Steuerelements auf einer HTML-Seite.
CDHtmlDialog::DDX_DHtml_CheckBox	Austausch von Daten zwischen einer Membervariable und einem Kontrollkästchen auf einer HTML-Seite.
CDHtmlDialog::DDX_DHtml_ElementText	Austausch von Daten zwischen einer Membervariable und jeder HTML-Elementeigenschaft auf einer HTML-Seite.
CDHtmlDialog::DDX_DHtml_Radio	Austausch von Daten zwischen einer Membervariable und einem Optionsfeld auf einer HTML-Seite.
CDHtmlDialog::DDX_DHtml_SelectIndex	Ruft den Index eines Listenfelds auf einer HTML-Seite ab oder legt den Index fest.
CDHtmlDialog::DDX_DHtml_SelectString	Dient zum Abrufen oder Festlegen des Anzeigetexts eines Listenfeldeintrags (basierend auf dem aktuellen Index) auf einer HTML-Seite.
CDHtmlDialog::DDX_DHtml_SelectValue	Dient zum Abrufen oder Festlegen des Werts eines Listenfeldeintrags (basierend auf dem aktuellen Index) auf einer HTML-Seite.
CDHtmlDialog::DestroyModeless	Zerstört ein Dialogfeld ohne Modus.
CDHtmlDialog::EnableModeless	Aktiviert Dialogfelder ohne Modus.
CDHtmlDialog::FilterDataObject	Ermöglicht dem Dialogfeld das Filtern von Datenobjekten aus der Zwischenablage, die vom gehosteten Browser erstellt wurden.
CDHtmlDialog::GetControlDispatch	Ruft die IDispatch Schnittstelle eines in das HTML-Dokument eingebetteten ActiveX-Steuerelements ab.
CDHtmlDialog::GetControlProperty	Ruft die angeforderte Eigenschaft des angegebenen ActiveX-Steuerelements ab.
CDHtmlDialog::GetCurrentUrl	Ruft die URL (Uniform Resource Locator) ab, die dem aktuellen Dokument zugeordnet ist.
CDHtmlDialog::GetDHtmlDocument	Ruft die IHTMLDocument2 Schnittstelle im aktuell geladenen HTML-Dokument ab.
CDHtmlDialog::GetDropTarget	Wird vom enthaltenen WebBrowser-Steuerelement aufgerufen, wenn es als Drop-Ziel verwendet wird, damit das Dialogfeld eine Alternative IDropTargetbereitstellen kann.
CDHtmlDialog::GetElement	Ruft eine Schnittstelle für ein HTML-Element ab.
CDHtmlDialog::GetElementHtml	Ruft die innerHTML Eigenschaft eines HTML-Elements ab.
CDHtmlDialog::GetElementInterface	Ruft den angeforderten Schnittstellenzeiger aus einem HTML-Element ab.
CDHtmlDialog::GetElementProperty	Ruft den Wert der Eigenschaft eines HTML-Elements ab.
CDHtmlDialog::GetElementText	Ruft die innerText Eigenschaft eines HTML-Elements ab.
CDHtmlDialog::GetEvent	Ruft den IHTMLEventObj Zeiger auf das aktuelle Ereignisobjekt ab.
CDHtmlDialog::GetExternal	Ruft die Schnittstelle des IDispatch Hosts ab.
CDHtmlDialog::GetHostInfo	Ruft die UI-Funktionen des Hosts ab.
CDHtmlDialog::GetOptionKeyPath	Ruft den Registrierungsschlüssel ab, unter dem Benutzereinstellungen gespeichert werden.
CDHtmlDialog::HideUI	Blendet die Benutzeroberfläche des Hosts aus.
CDHtmlDialog::IsExternalDispatchSafe	Gibt an, ob die Schnittstelle des IDispatch Hosts für skripting sicher ist.
CDHtmlDialog::LoadFromResource	Lädt die angegebene Ressource in das WebBrowser-Steuerelement.
CDHtmlDialog::Navigate	Navigiert zu dem angegebenen URL.
CDHtmlDialog::OnBeforeNavigate	Wird vom Framework aufgerufen, bevor ein Navigationsereignis ausgelöst wird.
CDHtmlDialog::OnDocumentComplete	Vom Framework aufgerufen, um eine Anwendung zu benachrichtigen, wenn ein Dokument den READYSTATE_COMPLETE Status erreicht hat.
CDHtmlDialog::OnDocWindowActivate	Wird vom Framework aufgerufen, wenn das Dokumentfenster aktiviert oder deaktiviert wird.
CDHtmlDialog::OnFrameWindowActivate	Wird vom Framework aufgerufen, wenn das Framefenster aktiviert oder deaktiviert wird.
CDHtmlDialog::OnInitDialog	Wird als Antwort auf die WM_INITDIALOG Nachricht aufgerufen.
CDHtmlDialog::OnNavigateComplete	Wird vom Framework aufgerufen, nachdem ein Navigationsereignis abgeschlossen wurde.
CDHtmlDialog::ResizeBorder	Benachrichtigt das Objekt, dass es die Größe des Rahmenbereichs ändern muss.
CDHtmlDialog::SetControlProperty	Legt die Eigenschaft eines ActiveX-Steuerelements auf einen neuen Wert fest.
CDHtmlDialog::SetElementHtml	Legt die innerHTML Eigenschaft eines HTML-Elements fest.
CDHtmlDialog::SetElementProperty	Legt eine Eigenschaft eines HTML-Elements fest.
CDHtmlDialog::SetElementText	Legt die innerText Eigenschaft eines HTML-Elements fest.
CDHtmlDialog::SetExternalDispatch	Legt die Schnittstelle des IDispatch Hosts fest.
CDHtmlDialog::SetHostFlags	Legt die UI-Flags des Hosts fest.
CDHtmlDialog::ShowContextMenu	Wird aufgerufen, wenn ein Kontextmenü angezeigt werden soll.
CDHtmlDialog::ShowUI	Zeigt die Benutzeroberfläche des Hosts an.
CDHtmlDialog::TranslateAccelerator	Wird aufgerufen, um Tastenkombinationsmeldungen im Menü zu verarbeiten.
CDHtmlDialog::TranslateUrl	Wird aufgerufen, um die zu ladende URL zu ändern.
CDHtmlDialog::UpdateUI	Wird aufgerufen, um den Host zu benachrichtigen, dass sich der Befehlsstatus geändert hat.

Öffentliche Datenmember

Name	Beschreibung
CDHtmlDialog::m_bUseHtmlTitle	Gibt an, ob der Titel des HTML-Dokuments als Dialogbeschriftung verwendet werden soll.
CDHtmlDialog::m_nHtmlResID	Die Ressourcen-ID der HTML-Ressource, die angezeigt werden soll.
CDHtmlDialog::m_pBrowserApp	Ein Zeiger auf eine Webbrowseranwendung.
CDHtmlDialog::m_spHtmlDoc	Ein Zeiger auf ein HTML-Dokument.
CDHtmlDialog::m_strCurrentUrl	Die aktuelle URL.
CDHtmlDialog::m_szHtmlResID	Zeichenfolgenversion der HTML-Ressourcen-ID.

Hinweise

CDHtmlDialog kann den HTML-Code laden, der von einer HTML-Ressource oder einer URL angezeigt werden soll.

CDHtmlDialog kann auch den Datenaustausch mit HTML-Steuerelementen durchführen und Ereignisse von HTML-Steuerelementen verarbeiten, z. B. Schaltflächenklicks.

Vererbungshierarchie

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Anforderungen

Header: afxdhtml.h

DDX_DHtml Hilfsmakros

Die DDX_DHtml Hilfsmakros ermöglichen einfachen Zugriff auf die häufig verwendeten Eigenschaften von Steuerelementen auf einer HTML-Seite.

Datenaustauschmakros

Name	Beschreibung
DDX_DHtml_ElementValue	Legt die Value-Eigenschaft des ausgewählten Steuerelements fest oder ruft sie ab.
DDX_DHtml_ElementInnerText	Legt den Text zwischen den Start- und Endtags des aktuellen Elements fest oder ruft den Text ab.
DDX_DHtml_ElementInnerHtml	Legt den HTML-Code zwischen den Start- und Endtags des aktuellen Elements fest oder ruft sie ab.
DDX_DHtml_Anchor_Href	Legt die Ziel-URL oder den Ankerpunkt fest oder ruft sie ab.
DDX_DHtml_Anchor_Target	Legt das Zielfenster oder den Zielrahmen fest oder ruft es ab.
DDX_DHtml_Img_Src	Legt den Namen eines Bilds oder eines Videoclips im Dokument fest oder ruft den Namen ab.
DDX_DHtml_Frame_Src	Legt die URL des zugeordneten Frames fest oder ruft sie ab.
DDX_DHtml_IFrame_Src	Legt die URL des zugeordneten Frames fest oder ruft sie ab.

CDHtmlDialog::CanAccessExternal

Überschreibbar, die als Zugriffsüberprüfung aufgerufen wird, um festzustellen, ob Skriptobjekte auf der geladenen Seite auf die externe Verteilerstelle der Steuerelementwebsite zugreifen können. Überprüft, ob der Versand entweder für skripting sicher ist oder die aktuelle Zone Objekte zulässt, die nicht für skripting sicher sind.

virtual BOOL CanAccessExternal();

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

CDHtmlDialog::CDHtmlDialog

Erstellt ein ressourcenbasiertes dynamisches HTML-Dialogfeld.

CDHtmlDialog();

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

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

Parameter

lpszTemplateName
Die mit Null beendete Zeichenfolge, bei der es sich um den Namen einer Dialogfeldvorlagenressource handelt.

szHtmlResID
Die mit Null beendete Zeichenfolge, die den Namen einer HTML-Ressource darstellt.

pParentWnd
Ein Zeiger auf das übergeordnete oder Besitzerfensterobjekt (vom Typ CWnd) zu dem das Dialogobjekt gehört. Wenn dies der Vorgang ist NULL, wird das übergeordnete Fenster des Dialogfeldobjekts auf das Hauptanwendungsfenster festgelegt.

nIDTemplate
Enthält die ID-Nummer einer Dialogfeldvorlagenressource.

nHtmlResID
Enthält die ID-Nummer einer HTML-Ressource.

Hinweise

Die zweite Form des Konstruktors ermöglicht den Zugriff auf die Dialogressource über den Vorlagennamen. Die dritte Form des Konstruktors ermöglicht den Zugriff auf die Dialogressource über die ID der Ressourcenvorlage. In der Regel beginnt die ID mit dem IDD_ Präfix.

CDHtmlDialog::~CDHtmlDialog

Zerstört ein CDHtmlDialog -Objekt.

virtual ~CDHtmlDialog();

Hinweise

Die CWnd::DestroyWindow Memberfunktion muss verwendet werden, um moduslose Dialogfelder zu zerstören, die von CDialog::Create.

CDHtmlDialog::CreateControlSite

Überschreibbar zum Erstellen einer Steuerelementwebsiteinstanz zum Hosten des WebBrowser-Steuerelements im Dialogfeld.

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

Parameter

pContainer
Ein Zeiger auf das COleControlContainer-Objekt.

ppSite
Ein Zeiger auf einen Zeiger auf ein COleControlSite.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

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

CDHtmlDialog::DDX_DHtml_AxControl

Austausch von Daten zwischen einer Membervariable und dem Eigenschaftswert eines ActiveX-Steuerelements auf einer HTML-Seite.

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

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt.

szId
Der Wert des ID-Parameters des Objekttags in der HTML-Quelle für das ActiveX-Steuerelement.

dispId
Die Verteiler-ID der Eigenschaft, mit der Sie Daten austauschen möchten.

szPropName
Der Name der Eigenschaft.

var
Der Datenmemmm, vom Typ VARIANT, COleVariantoder CComVariantvom Typ , der den Wert enthält, der mit der ActiveX-Steuerelementeigenschaft ausgetauscht wird.

Beispiel

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

CDHtmlDialog::DDX_DHtml_CheckBox

Austausch von Daten zwischen einer Membervariable und einem Kontrollkästchen auf einer HTML-Seite.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt.

szId
Der Wert, den Sie für den ID-Parameter des HTML-Steuerelements angegeben haben.

value
Der Wert, der ausgetauscht wird.

Beispiel

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

CDHtmlDialog::DDX_DHtml_ElementText

Austausch von Daten zwischen einer Membervariable und jeder HTML-Elementeigenschaft auf einer HTML-Seite.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt.

szId
Der Wert, den Sie für den ID-Parameter des HTML-Steuerelements angegeben haben.

dispId
Die Verteiler-ID des HTML-Elements, mit dem Sie Daten austauschen möchten.

value
Der Wert, der ausgetauscht wird.

CDHtmlDialog::DDX_DHtml_Radio

Austausch von Daten zwischen einer Membervariable und einem Optionsfeld auf einer HTML-Seite.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt.

szId
Der Wert, den Sie für den ID-Parameter des HTML-Steuerelements angegeben haben.

value
Der Wert, der ausgetauscht wird.

CDHtmlDialog::DDX_DHtml_SelectIndex

Ruft den Index eines Listenfelds auf einer HTML-Seite ab oder legt den Index fest.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt.

szId
Der Wert, den Sie für den Parameter des HTML-Steuerelements id angegeben haben.

value
Der Wert, der ausgetauscht wird.

CDHtmlDialog::DDX_DHtml_SelectString

Dient zum Abrufen oder Festlegen des Anzeigetexts eines Listenfeldeintrags (basierend auf dem aktuellen Index) auf einer HTML-Seite.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt.

szId
Der Wert, den Sie für den ID-Parameter des HTML-Steuerelements angegeben haben.

value
Der Wert, der ausgetauscht wird.

CDHtmlDialog::DDX_DHtml_SelectValue

Dient zum Abrufen oder Festlegen des Werts eines Listenfeldeintrags (basierend auf dem aktuellen Index) auf einer HTML-Seite.

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

Parameter

pDX
Ein Zeiger auf ein CDataExchange-Objekt.

szId
Der Wert, den Sie für den ID-Parameter des HTML-Steuerelements angegeben haben.

value
Der Wert, der ausgetauscht wird.

Beispiel

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

CDHtmlDialog::DestroyModeless

Trennt ein Dialogfeld ohne Modus vom CDHtmlDialog Objekt und zerstört das Objekt.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Aktiviert Dialogfelder ohne Modus.

STDMETHOD(EnableModeless)(BOOL fEnable);

Parameter

fEnable
Siehe fEnable im IDocHostUIHandler::EnableModeless Windows SDK.

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::EnableModeless, wie im Windows SDK beschrieben.

CDHtmlDialog::FilterDataObject

Ermöglicht dem Dialogfeld das Filtern von Datenobjekten aus der Zwischenablage, die vom gehosteten Browser erstellt wurden.

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

Parameter

pDO
Siehe pDO im IDocHostUIHandler::FilterDataObject Windows SDK.

ppDORet
Siehe ppDORet im IDocHostUIHandler::FilterDataObject Windows SDK.

Rückgabewert

Gibt S_FALSE zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::FilterDataObject, wie im Windows SDK beschrieben.

CDHtmlDialog::GetControlDispatch

Ruft die IDispatch Schnittstelle für ein ActiveX-Steuerelement ab, das in das html-Dokument eingebettet ist, von GetDHtmlDocumentdem zurückgegeben wird.

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

Parameter

szId
Die HTML-ID eines ActiveX-Steuerelements.

ppdisp
Die IDispatch Schnittstelle des Steuerelements, wenn es auf der Webseite zu finden ist.

Rückgabewert

Ein Standard HRESULT -Wert.

CDHtmlDialog::GetControlProperty

Ruft die angeforderte Eigenschaft des angegebenen ActiveX-Steuerelements ab.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Parameter

szId
Die HTML-ID eines ActiveX-Steuerelements.

szPropName
Der Name einer Eigenschaft im Standardgebietsschema des aktuellen Benutzers.

pdispControl
Der IDispatch Zeiger eines ActiveX-Steuerelements.

dispId
Die Verteiler-ID einer Eigenschaft.

Rückgabewert

Eine Variante, die die angeforderte Eigenschaft oder eine leere Variante enthält, wenn das Steuerelement oder die Eigenschaft nicht gefunden werden konnte.

Hinweise

Die Überladungen werden von der geringsten Effizienz oben bis zur effizientesten am unteren Rand aufgelistet.

CDHtmlDialog::GetCurrentUrl

Ruft die URL (Uniform Resource Locator) ab, die dem aktuellen Dokument zugeordnet ist.

void GetCurrentUrl(CString& szUrl);

Parameter

szUrl
Ein CString Objekt, das die abzurufende URL enthält.

CDHtmlDialog::GetDHtmlDocument

Ruft die IHTMLDocument2 Schnittstelle im aktuell geladenen HTML-Dokument ab.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Parameter

**pphtmlDoc Ein Zeiger auf einen Zeiger auf ein HTML-Dokument.

Rückgabewert

Ein Standard HRESULT. Gibt bei Erfolg S_OK zurück.

CDHtmlDialog::GetDropTarget

Wird vom enthaltenen WebBrowser-Steuerelement aufgerufen, wenn es als Drop-Ziel verwendet wird, damit das Dialogfeld eine Alternative IDropTargetbereitstellen kann.

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

Parameter

pDropTarget
Siehe pDropTarget im IDocHostUIHandler::GetDropTarget Windows SDK.

ppDropTarget
Siehe ppDropTarget im IDocHostUIHandler::GetDropTarget Windows SDK.

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::GetDropTarget, wie im Windows SDK beschrieben.

CDHtmlDialog::GetElement

Gibt eine Schnittstelle für das html-Element zurück, das durch szElementId.

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

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

Parameter

szElementId
Die ID eines HTML-Elements.

ppdisp
Ein IDispatch Zeiger auf das angeforderte Element oder die Auflistung von Elementen.

pbCollection
Ein BOOL Wert, der angibt, ob das dargestellte ppdisp Objekt ein einzelnes Element oder eine Auflistung von Elementen ist.

pphtmlElement
Ein IHTMLElement Zeiger auf das angeforderte Element.

Rückgabewert

Ein Standard HRESULT -Wert.

Hinweise

Verwenden Sie die erste Überladung, wenn Sie Bedingungen behandeln müssen, in denen es möglicherweise mehrere Elemente mit der angegebenen ID gibt. Mit dem letzten Parameter können Sie herausfinden, ob der zurückgegebene Schnittstellenzeiger auf eine Auflistung oder ein einzelnes Element verweist. Wenn sich der Schnittstellenzeiger auf einer Auflistung befindet, können Sie die IHTMLElementCollection Eigenschaft abfragen und verwenden item , um auf die Elemente nach Ordnungsposition zu verweisen.

Die zweite Überladung schlägt fehl, wenn mehrere Elemente mit derselben ID auf der Seite vorhanden sind.

CDHtmlDialog::GetElementHtml

Ruft die innerHTML Eigenschaft des HTML-Elements ab, das durch szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

Parameter

szElementId
Die ID eines HTML-Elements.

Rückgabewert

Die innerHTML Eigenschaft des html-Elements, das von szElementId oder NULL wenn das Element nicht gefunden werden konnte.

CDHtmlDialog::GetElementInterface

Ruft den angeforderten Schnittstellenzeiger aus dem html-Element ab, das von szElementId.

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

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

Parameter

szElementId
Die ID eines HTML-Elements.

ppvObj
Adresse eines Zeigers, der mit dem angeforderten Schnittstellenzeiger gefüllt wird, wenn das Element gefunden wird und die Abfrage erfolgreich ausgeführt wird.

refiid
Die Schnittstellen-ID (IID) der angeforderten Schnittstelle.

Rückgabewert

Ein Standard HRESULT -Wert.

Beispiel

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

Ruft den Wert der Eigenschaft ab, die von dispId dem html-Element identifiziert wird, das durch szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Parameter

szElementId
Die ID eines HTML-Elements.

dispId
Die Verteiler-ID einer Eigenschaft.

Rückgabewert

Der Wert der Eigenschaft oder einer leeren Variante, wenn die Eigenschaft oder das Element nicht gefunden werden konnte.

CDHtmlDialog::GetElementText

Ruft die innerText Eigenschaft des HTML-Elements ab, das durch szElementId.

BSTR GetElementText(LPCTSTR szElementId);

Parameter

szElementId
Die ID eines HTML-Elements.

Rückgabewert

Die innerText Eigenschaft des html-Elements, das durch szElementId oder NULL wenn die Eigenschaft oder das Element nicht gefunden werden konnte.

CDHtmlDialog::GetEvent

Gibt den IHTMLEventObj Zeiger auf das aktuelle Ereignisobjekt zurück.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Parameter

ppEventObj
Adresse eines Zeigers, der mit dem IHTMLEventObj Schnittstellenzeiger gefüllt wird.

Rückgabewert

Ein Standard HRESULT -Wert.

Hinweise

Diese Funktion sollte nur innerhalb eines DHTML-Ereignishandlers aufgerufen werden.

CDHtmlDialog::GetExternal

Ruft die Schnittstelle des IDispatch Hosts ab.

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Parameter

ppDispatch
Siehe ppDispatch im IDocHostUIHandler::GetExternal Windows SDK.

Rückgabewert

Gibt bei Erfolg oder E_NOTIMPL bei Fehlern zurückS_OK.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::GetExternal, wie im Windows SDK beschrieben.

CDHtmlDialog::GetHostInfo

Ruft die UI-Funktionen des Hosts ab.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Parameter

pInfo
Siehe pInfo im IDocHostUIHandler::GetHostInfo Windows SDK.

Rückgabewert

Gibt S_OK zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::GetHostInfo, wie im Windows SDK beschrieben.

CDHtmlDialog::GetOptionKeyPath

Ruft den Registrierungsschlüssel ab, unter dem Benutzereinstellungen gespeichert werden.

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

Parameter

pchKey
Siehe pchKey im IDocHostUIHandler::GetOptionKeyPath Windows SDK.

dw
Siehe dw im IDocHostUIHandler::GetOptionKeyPath Windows SDK.

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::GetOptionKeyPath, wie im Windows SDK beschrieben.

CDHtmlDialog::HideUI

Blendet die Benutzeroberfläche des Hosts aus.

STDMETHOD(HideUI)(void);

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::HideUI, wie im Windows SDK beschrieben.

CDHtmlDialog::IsExternalDispatchSafe

Gibt an, ob die Schnittstelle des IDispatch Hosts für skripting sicher ist.

virtual BOOL IsExternalDispatchSafe();

Rückgabewert

Gibt FALSE zurück.

CDHtmlDialog::LoadFromResource

Lädt die angegebene Ressource im Dialogfeld DHTML in das WebBrowser-Steuerelement.

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

Parameter

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

nRes
Die ID der zu ladenden Ressource

Rückgabewert

TRUE, wenn erfolgreich, andernfalls FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Gibt an, ob der Titel des HTML-Dokuments als Dialogbeschriftung verwendet werden soll.

BOOL m_bUseHtmlTitle;

Hinweise

Ist m_bUseHtmlTitle dies TRUEder Wert, wird die Beschriftung des Dialogfelds auf den Titel des HTML-Dokuments festgelegt. Andernfalls wird die Beschriftung in der Dialogressource verwendet.

CDHtmlDialog::m_nHtmlResID

Die Ressourcen-ID der HTML-Ressource, die angezeigt werden soll.

UINT m_nHtmlResID;

Beispiel

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

CDHtmlDialog::m_pBrowserApp

Ein Zeiger auf eine Webbrowseranwendung.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Ein Zeiger auf ein HTML-Dokument.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

Die aktuelle URL.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

Zeichenfolgenversion der HTML-Ressourcen-ID.

LPTSTR m_szHtmlResID;

Beispiel

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

CDHtmlDialog::Navigate

Navigiert zu der Ressource, die von der URL identifiziert wird, die durch lpszURLangegeben wird.

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

Parameter

lpszURL
Ein Zeiger auf eine Zeichenfolge, die die URL enthält, die als Ziel verwendet werden soll.

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

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

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

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

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

CDHtmlDialog::OnBeforeNavigate

Wird vom Framework aufgerufen, damit ein Ereignis ausgelöst wird, bevor eine Navigation auftritt.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parameter

pDisp
Ein Zeiger auf ein IDispatch -Objekt.

szUrl
Ein Zeiger auf eine Zeichenfolge, die die URL enthält, zu der navigiert werden soll.

CDHtmlDialog::OnDocumentComplete

Vom Framework aufgerufen, um eine Anwendung zu benachrichtigen, wenn ein Dokument den READYSTATE_COMPLETE Status erreicht hat.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parameter

pDisp
Ein Zeiger auf ein IDispatch -Objekt.

szUrl
Ein Zeiger auf eine Zeichenfolge mit der URL, zu der navigiert wurde.

CDHtmlDialog::OnDocWindowActivate

Wird vom Framework aufgerufen, wenn das Dokumentfenster aktiviert oder deaktiviert wird.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Parameter

fActivate
Siehe fActivate im IDocHostUIHandler::OnDocWindowActivate Windows SDK.

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::OnDocWindowActivate, wie im Windows SDK beschrieben.

CDHtmlDialog::OnFrameWindowActivate

Wird vom Framework aufgerufen, wenn das Framefenster aktiviert oder deaktiviert wird.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Parameter

fActivate
Siehe fActivate im IDocHostUIHandler::OnFrameWindowActivate Windows SDK.

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::OnFrameWindowActivate, wie im Windows SDK beschrieben.

CDHtmlDialog::OnInitDialog

Wird als Antwort auf die WM_INITDIALOG Nachricht aufgerufen.

virtual BOOL OnInitDialog();

Rückgabewert

Die Standardimplementierung gibt TRUE zurück.

Hinweise

Diese Nachricht wird während des Dialogfelds während des CreateDialogfelds CreateIndirectoder DoModal der Anrufe gesendet, die unmittelbar vor der Anzeige des Dialogfelds auftreten.

Überschreiben Sie diese Memberfunktion, wenn Sie eine spezielle Verarbeitung ausführen müssen, wenn das Dialogfeld initialisiert wird. Rufen Sie in der überschriebenen Version zuerst die Basisklasse OnInitDialog auf, ignorieren Sie jedoch den Rückgabewert. Normalerweise kehren Sie von der überschriebenen Memberfunktion zurück TRUE .

Windows ruft die OnInitDialog Funktion über die standardmäßige globale Dialogfeld-Prozedur auf, die allen Dialogfeldern der Microsoft Foundation-Klassenbibliothek gemeinsam ist, anstatt über Ihre Nachrichtenzuordnung, sodass Sie keinen Meldungszuordnungseintrag für diese Memberfunktion benötigen.

CDHtmlDialog::OnNavigateComplete

Wird vom Framework aufgerufen, nachdem die Navigation zur angegebenen URL abgeschlossen wurde.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parameter

pDisp
Ein Zeiger auf ein IDispatch -Objekt.

szUrl
Ein Zeiger auf eine Zeichenfolge mit der URL, zu der navigiert wurde.

CDHtmlDialog::ResizeBorder

Benachrichtigt das Objekt, dass es die Größe des Rahmenbereichs ändern muss.

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

Parameter

prcBorder
Siehe prcBorder im IDocHostUIHandler::ResizeBorder Windows SDK.

pUIWindow
Siehe pUIWindow im IDocHostUIHandler::ResizeBorder Windows SDK.

fFrameWindow
Siehe fFrameWindow im IDocHostUIHandler::ResizeBorder Windows SDK.

Rückgabewert

Gibt E_NOTIMPL zurück.

CDHtmlDialog::SetControlProperty

Legt die Eigenschaft eines ActiveX-Steuerelements auf einen neuen Wert fest.

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

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

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

Parameter

szElementId
Die HTML-ID eines ActiveX-Steuerelements.

dispId
Die Verteiler-ID der festzulegenden Eigenschaft.

pVar
Zeiger auf einen VARIANT , der den neuen Eigenschaftswert enthält.

pdispControl
Zeiger auf die Schnittstelle eines ActiveX-Steuerelements IDispatch .

szPropName
Zeichenfolge, die den Namen der festzulegenden Eigenschaft enthält.

CDHtmlDialog::SetElementHtml

Legt die innerHTML Eigenschaft eines HTML-Elements fest.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Parameter

szElementId
Die ID eines HTML-Elements.

bstrText
Der neue Wert der innerHTML-Eigenschaft.

punkElem
Der IUnknown Zeiger eines HTML-Elements.

CDHtmlDialog::SetElementProperty

Legt eine Eigenschaft eines HTML-Elements fest.

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

Parameter

szElementId
Die ID eines HTML-Elements.

dispId
Die Verteiler-ID der festzulegenden Eigenschaft.

pVar
Der neue Wert der -Eigenschaft.

CDHtmlDialog::SetElementText

Legt die innerText Eigenschaft eines HTML-Elements fest.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Parameter

szElementId
Die ID eines HTML-Elements.

bstrText
Der neue Wert der innerText-Eigenschaft.

punkElem
Der IUnknown Zeiger eines HTML-Elements.

CDHtmlDialog::SetExternalDispatch

Legt die Schnittstelle des IDispatch Hosts fest.

void SetExternalDispatch(IDispatch* pdispExternal);

Parameter

pdispExternal
Die neue IDispatch Schnittstelle.

CDHtmlDialog::SetHostFlags

Legt die Host-UI-Flags fest.

void SetHostFlags(DWORD dwFlags);

Parameter

dwFlags
Mögliche Werte finden Sie DOCHOSTUIFLAG im Windows SDK.

CDHtmlDialog::ShowContextMenu

Wird aufgerufen, wenn ein Kontextmenü angezeigt werden soll.

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

Parameter

dwID
Siehe dwID im IDocHostUIHandler::ShowContextMenu Windows SDK.

ppt
Siehe ppt im IDocHostUIHandler::ShowContextMenu Windows SDK.

pcmdtReserved
Siehe pcmdtReserved im IDocHostUIHandler::ShowContextMenu Windows SDK.

pdispReserved
Siehe pdispReserved im IDocHostUIHandler::ShowContextMenu Windows SDK.

Rückgabewert

Gibt S_FALSE zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::ShowContextMenu, wie im Windows SDK beschrieben.

CDHtmlDialog::ShowUI

Zeigt die Benutzeroberfläche des Hosts an.

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

Parameter

dwID
Siehe dwID im IDocHostUIHandler::ShowUI Windows SDK.

pActiveObject
Siehe pActiveObject im IDocHostUIHandler::ShowUI Windows SDK.

pCommandTarget
Siehe pCommandTarget im IDocHostUIHandler::ShowUI Windows SDK.

pFrame
Siehe pFrame im IDocHostUIHandler::ShowUI Windows SDK.

pDoc
Siehe pDoc im IDocHostUIHandler::ShowUI Windows SDK.

Rückgabewert

Gibt S_FALSE zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::ShowUI, wie im Windows SDK beschrieben.

CDHtmlDialog::TranslateAccelerator

Wird aufgerufen, um Tastenkombinationsmeldungen im Menü zu verarbeiten.

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

Parameter

lpMsg
Siehe lpMsg im IDocHostUIHandler::TranslateAccelerator Windows SDK.

pguidCmdGroup
Siehe pguidCmdGroup im IDocHostUIHandler::TranslateAccelerator Windows SDK.

nCmdID
Siehe nCmdID im IDocHostUIHandler::TranslateAccelerator Windows SDK.

Rückgabewert

Gibt S_FALSE zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::TranslateAccelerator, wie im Windows SDK beschrieben.

CDHtmlDialog::TranslateUrl

Wird aufgerufen, um die zu ladende URL zu ändern.

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

Parameter

dwTranslate
Siehe dwTranslate im IDocHostUIHandler::TranslateUrl Windows SDK.

pchURLIn
Siehe pchURLIn im IDocHostUIHandler::TranslateUrl Windows SDK.

ppchURLOut
Siehe ppchURLOut im IDocHostUIHandler::TranslateUrl Windows SDK.

Rückgabewert

Gibt S_FALSE zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::TranslateUrl, wie im Windows SDK beschrieben.

CDHtmlDialog::UpdateUI

Wird aufgerufen, um den Host zu benachrichtigen, dass sich der Befehlsstatus geändert hat.

STDMETHOD(UpdateUI)(void);

Rückgabewert

Gibt E_NOTIMPL zurück.

Hinweise

Diese Memberfunktion ist die CDHtmlDialog Implementierung von IDocHostUIHandler::UpdateUI, wie im Windows SDK beschrieben.

Siehe auch

MFC-Beispiel DHtmlExplore
DDX_DHtml Hilfsmakros
Hierarchiediagramm