Partager via


La classe CDHtmlDialog

Permet de créer des boîtes de dialogue qui utilisent du code HTML plutôt que des ressources de boîte de dialogue pour implémenter leur interface utilisateur.

Syntaxe

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Membres

Constructeurs publics

Nom Description
CDHtmlDialog::CDHtmlDialog Construit un objet CDHtmlDialog.
CDHtmlDialog::~CDHtmlDialog Détruit un objet CDHtmlDialog.

Méthodes publiques

Nom Description
CDHtmlDialog::CanAccessExternal Substituable appelé contrôle d’accès pour déterminer si les objets de script sur la page chargée peuvent accéder à la répartition externe du site de contrôle. Vérifie que la répartition est sécurisée pour le script ou que la zone active autorise les objets qui ne sont pas sécurisés pour le script.
CDHtmlDialog::CreateControlSite Substituable utilisé pour créer une instance de site de contrôle pour héberger le contrôle WebBrowser dans la boîte de dialogue.
CDHtmlDialog::DDX_DHtml_AxControl Échange des données entre une variable membre et la valeur de propriété d’un contrôle ActiveX sur une page HTML.
CDHtmlDialog::DDX_DHtml_CheckBox Échange des données entre une variable membre et une case à cocher sur une page HTML.
CDHtmlDialog::DDX_DHtml_ElementText Échange des données entre une variable membre et toute propriété d’élément HTML sur une page HTML.
CDHtmlDialog::DDX_DHtml_Radio Échange des données entre une variable membre et une case d’option sur une page HTML.
CDHtmlDialog::DDX_DHtml_SelectIndex Obtient ou définit l’index d’une zone de liste sur une page HTML.
CDHtmlDialog::DDX_DHtml_SelectString Obtient ou définit le texte d’affichage d’une entrée de zone de liste (basée sur l’index actuel) sur une page HTML.
CDHtmlDialog::DDX_DHtml_SelectValue Obtient ou définit la valeur d’une entrée de zone de liste (basée sur l’index actuel) sur une page HTML.
CDHtmlDialog::DestroyModeless Détruit une boîte de dialogue sans mode.
CDHtmlDialog::EnableModeless Active les boîtes de dialogue sans mode.
CDHtmlDialog::FilterDataObject Permet à la boîte de dialogue de filtrer les objets de données du Presse-papiers créés par le navigateur hébergé.
CDHtmlDialog::GetControlDispatch Récupère l’interface IDispatch sur un contrôle ActiveX incorporé dans le document HTML.
CDHtmlDialog::GetControlProperty Récupère la propriété demandée du contrôle ActiveX spécifié.
CDHtmlDialog::GetCurrentUrl Récupère l’URL (Uniform Resource Locator) associée au document actif.
CDHtmlDialog::GetDHtmlDocument Récupère l’interface IHTMLDocument2 sur le document HTML actuellement chargé.
CDHtmlDialog::GetDropTarget Appelé par le contrôle WebBrowser contenu lorsqu’il est utilisé comme cible de suppression pour permettre au dialogue de fournir une alternative IDropTarget.
CDHtmlDialog::GetElement Obtient une interface sur un élément HTML.
CDHtmlDialog::GetElementHtml Récupère la innerHTML propriété d’un élément HTML.
CDHtmlDialog::GetElementInterface Récupère le pointeur d’interface demandé à partir d’un élément HTML.
CDHtmlDialog::GetElementProperty Récupère la valeur de la propriété d’un élément HTML.
CDHtmlDialog::GetElementText Récupère la innerText propriété d’un élément HTML.
CDHtmlDialog::GetEvent Obtient le IHTMLEventObj pointeur vers l’objet d’événement actuel.
CDHtmlDialog::GetExternal Obtient l’interface de l’hôte IDispatch .
CDHtmlDialog::GetHostInfo Récupère les fonctionnalités de l’interface utilisateur de l’hôte.
CDHtmlDialog::GetOptionKeyPath Récupère la clé de Registre sous laquelle les préférences utilisateur sont stockées.
CDHtmlDialog::HideUI Masque l’interface utilisateur de l’hôte.
CDHtmlDialog::IsExternalDispatchSafe Indique si l’interface de l’hôte est sécurisée pour l’écriture de IDispatch scripts.
CDHtmlDialog::LoadFromResource Charge la ressource spécifiée dans le contrôle WebBrowser.
CDHtmlDialog::Navigate Accède à l'URL spécifiée.
CDHtmlDialog::OnBeforeNavigate Appelé par l’infrastructure avant le déclenchement d’un événement de navigation.
CDHtmlDialog::OnDocumentComplete Appelé par l’infrastructure pour notifier une application lorsqu’un document a atteint l’état READYSTATE_COMPLETE .
CDHtmlDialog::OnDocWindowActivate Appelé par l’infrastructure lorsque la fenêtre de document est activée ou désactivée.
CDHtmlDialog::OnFrameWindowActivate Appelé par l’infrastructure lorsque la fenêtre frame est activée ou désactivée.
CDHtmlDialog::OnInitDialog Appelé en réponse au WM_INITDIALOG message.
CDHtmlDialog::OnNavigateComplete Appelé par l’infrastructure une fois qu’un événement de navigation est terminé.
CDHtmlDialog::ResizeBorder Avertit l’objet dont il a besoin pour redimensionner son espace de bordure.
CDHtmlDialog::SetControlProperty Définit la propriété d’un contrôle ActiveX sur une nouvelle valeur.
CDHtmlDialog::SetElementHtml Définit la innerHTML propriété d’un élément HTML.
CDHtmlDialog::SetElementProperty Définit une propriété d’un élément HTML.
CDHtmlDialog::SetElementText Définit la innerText propriété d’un élément HTML.
CDHtmlDialog::SetExternalDispatch Définit l’interface de l’hôte IDispatch .
CDHtmlDialog::SetHostFlags Définit les indicateurs d’interface utilisateur de l’hôte.
CDHtmlDialog::ShowContextMenu Appelé lorsqu’un menu contextuel est sur le point d’être affiché.
CDHtmlDialog::ShowUI Affiche l’interface utilisateur de l’hôte.
CDHtmlDialog::TranslateAccelerator Appelé pour traiter les messages de touches d’accélérateur de menu.
CDHtmlDialog::TranslateUrl Appelé pour modifier l’URL à charger.
CDHtmlDialog::UpdateUI Appelé pour avertir l’hôte que l’état de la commande a changé.

Membres de données publics

Nom Description
CDHtmlDialog::m_bUseHtmlTitle Indique s’il faut utiliser le titre du document HTML comme légende de boîte de dialogue.
CDHtmlDialog::m_nHtmlResID ID de ressource de ressource HTML à afficher.
CDHtmlDialog::m_pBrowserApp Pointeur vers une application de navigateur web.
CDHtmlDialog::m_spHtmlDoc Pointeur vers un document HTML.
CDHtmlDialog::m_strCurrentUrl URL actuelle.
CDHtmlDialog::m_szHtmlResID Version de chaîne de l’ID de ressource HTML.

Notes

CDHtmlDialog peut charger le code HTML à afficher à partir d’une ressource HTML ou d’une URL.

CDHtmlDialog peut également effectuer un échange de données avec des contrôles HTML et gérer des événements à partir de contrôles HTML, tels que des clics de bouton.

Hiérarchie d'héritage

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Spécifications

En-tête : afxdhtml.h

DDX_DHtml Macros d’assistance

Les DDX_DHtml macros d’assistance permettent d’accéder facilement aux propriétés couramment utilisées des contrôles sur une page HTML.

Macros Exchange de données

Nom Description
DDX_DHtml_ElementValue Définit ou récupère la propriété Value du contrôle sélectionné.
DDX_DHtml_ElementInnerText Définit ou récupère le texte entre les balises de début et de fin de l’élément actif.
DDX_DHtml_ElementInnerHtml Définit ou récupère le code HTML entre les balises de début et de fin de l’élément actuel.
DDX_DHtml_Anchor_Href Définit ou récupère l’URL de destination ou le point d’ancrage.
DDX_DHtml_Anchor_Target Définit ou récupère la fenêtre ou le cadre cible.
DDX_DHtml_Img_Src Définit ou récupère le nom d’une image ou d’un clip vidéo dans le document.
DDX_DHtml_Frame_Src Définit ou récupère l’URL du cadre associé.
DDX_DHtml_IFrame_Src Définit ou récupère l’URL du cadre associé.

CDHtmlDialog::CanAccessExternal

Substituable appelé contrôle d’accès pour déterminer si les objets de script sur la page chargée peuvent accéder à la répartition externe du site de contrôle. Vérifie que la répartition est sécurisée pour le script ou que la zone active autorise les objets qui ne sont pas sécurisés pour le script.

virtual BOOL CanAccessExternal();

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

CDHtmlDialog::CDHtmlDialog

Construit une boîte de dialogue HTML dynamique basée sur des ressources.

CDHtmlDialog();

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

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

Paramètres

lpszTemplateName
Chaîne terminée par null qui est le nom d’une ressource de modèle de boîte de dialogue.

szHtmlResID
Chaîne terminée par null qui est le nom d’une ressource HTML.

pParentWnd
Pointeur vers l’objet de fenêtre parent ou propriétaire (de type CWnd) auquel appartient l’objet de boîte de dialogue. Si c’est NULLle cas, la fenêtre parente de l’objet de boîte de dialogue est définie sur la fenêtre principale de l’application.

nIDTemplate
Contient le numéro d’ID d’une ressource de modèle de boîte de dialogue.

nHtmlResID
Contient le numéro d’ID d’une ressource HTML.

Notes

La deuxième forme du constructeur fournit l’accès à la ressource de boîte de dialogue par le biais du nom du modèle. Le troisième formulaire du constructeur fournit l’accès à la ressource de dialogue par le biais de l’ID du modèle de ressource. En règle générale, l’ID commence par le IDD_ préfixe.

CDHtmlDialog::~CDHtmlDialog

Détruit un objet CDHtmlDialog .

virtual ~CDHtmlDialog();

Notes

La CWnd::DestroyWindow fonction membre doit être utilisée pour détruire les boîtes de dialogue sans mode créées par CDialog::Create.

CDHtmlDialog::CreateControlSite

Substituable utilisé pour créer une instance de site de contrôle pour héberger le contrôle WebBrowser dans la boîte de dialogue.

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

Paramètres

pContainer
Pointeur vers l'objet COleControlContainer.

ppSite
Pointeur vers un pointeur vers un COleControlSite.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0.

Notes

Vous pouvez remplacer cette fonction membre pour retourner une instance de votre propre classe de site de contrôle.

CDHtmlDialog::DDX_DHtml_AxControl

Échange des données entre une variable membre et la valeur de propriété d’un contrôle ActiveX sur une page HTML.

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

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

Paramètres

pDX
Pointeur vers un objet CDataExchange.

szId
Valeur du paramètre ID de la balise d’objet dans la source HTML du contrôle ActiveX.

dispId
ID de répartition de la propriété avec laquelle vous souhaitez échanger des données.

szPropName
Nom de la propriété.

var
Membre de données, de type VARIANT, COleVariantou CComVariant, qui contient la valeur échangée avec la propriété de contrôle ActiveX.

Exemple

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

CDHtmlDialog::DDX_DHtml_CheckBox

Échange des données entre une variable membre et une case à cocher sur une page HTML.

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

Paramètres

pDX
Pointeur vers un objet CDataExchange.

szId
Valeur que vous avez spécifiée pour le paramètre d’ID du contrôle HTML.

value
Valeur échangée.

Exemple

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

CDHtmlDialog::DDX_DHtml_ElementText

Échange des données entre une variable membre et toute propriété d’élément HTML sur une page HTML.

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

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

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

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

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

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

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

Paramètres

pDX
Pointeur vers un objet CDataExchange.

szId
Valeur que vous avez spécifiée pour le paramètre d’ID du contrôle HTML.

dispId
ID de répartition de l’élément HTML avec lequel vous souhaitez échanger des données.

value
Valeur échangée.

CDHtmlDialog::DDX_DHtml_Radio

Échange des données entre une variable membre et une case d’option sur une page HTML.

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

Paramètres

pDX
Pointeur vers un objet CDataExchange.

szId
Valeur que vous avez spécifiée pour le paramètre d’ID du contrôle HTML.

value
Valeur échangée.

CDHtmlDialog::DDX_DHtml_SelectIndex

Obtient ou définit l’index d’une zone de liste sur une page HTML.

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

Paramètres

pDX
Pointeur vers un objet CDataExchange.

szId
Valeur que vous avez spécifiée pour le paramètre du id contrôle HTML.

value
Valeur échangée.

CDHtmlDialog::DDX_DHtml_SelectString

Obtient ou définit le texte d’affichage d’une entrée de zone de liste (basée sur l’index actuel) sur une page HTML.

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

Paramètres

pDX
Pointeur vers un objet CDataExchange.

szId
Valeur que vous avez spécifiée pour le paramètre d’ID du contrôle HTML.

value
Valeur échangée.

CDHtmlDialog::DDX_DHtml_SelectValue

Obtient ou définit la valeur d’une entrée de zone de liste (basée sur l’index actuel) sur une page HTML.

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

Paramètres

pDX
Pointeur vers un objet CDataExchange.

szId
Valeur que vous avez spécifiée pour le paramètre d’ID du contrôle HTML.

value
Valeur échangée.

Exemple

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

CDHtmlDialog::DestroyModeless

Détache une boîte de dialogue sans mode de l’objet CDHtmlDialog et détruit l’objet.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Active les boîtes de dialogue sans mode.

STDMETHOD(EnableModeless)(BOOL fEnable);

Paramètres

fEnable
IDocHostUIHandler::EnableModeless Consultez fEnable le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne E_NOTIMPL.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::EnableModeless, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::FilterDataObject

Permet à la boîte de dialogue de filtrer les objets de données du Presse-papiers créés par le navigateur hébergé.

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

Paramètres

pDO
IDocHostUIHandler::FilterDataObject Consultez pDO le Kit de développement logiciel (SDK) Windows.

ppDORet
IDocHostUIHandler::FilterDataObject Consultez ppDORet le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne S_FALSE.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::FilterDataObject, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::GetControlDispatch

Récupère l’interface IDispatch sur un contrôle ActiveX incorporé dans le document HTML retourné par GetDHtmlDocument.

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

Paramètres

szId
ID HTML d’un contrôle ActiveX.

ppdisp
Interface IDispatch du contrôle si elle se trouve dans la page Web.

Valeur de retour

Valeur HRESULT standard.

CDHtmlDialog::GetControlProperty

Récupère la propriété demandée du contrôle ActiveX spécifié.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Paramètres

szId
ID HTML d’un contrôle ActiveX.

szPropName
Nom d’une propriété dans les paramètres régionaux par défaut de l’utilisateur actuel.

pdispControl
Pointeur IDispatch d’un contrôle ActiveX.

dispId
ID de répartition d’une propriété.

Valeur de retour

Variante contenant la propriété demandée ou une variante vide si le contrôle ou la propriété n’a pas pu être trouvé.

Notes

Les surcharges sont répertoriées du moins efficace en haut à la plus efficace au bas.

CDHtmlDialog::GetCurrentUrl

Récupère l’URL (Uniform Resource Locator) associée au document actif.

void GetCurrentUrl(CString& szUrl);

Paramètres

szUrl
Objet CString contenant l’URL à récupérer.

CDHtmlDialog::GetDHtmlDocument

Récupère l’interface IHTMLDocument2 sur le document HTML actuellement chargé.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Paramètres

**pphtmlDoc Pointeur vers un pointeur vers un document HTML.

Valeur de retour

Une norme HRESULT. Retourne S_OK en cas de réussite.

CDHtmlDialog::GetDropTarget

Appelé par le contrôle WebBrowser contenu lorsqu’il est utilisé comme cible de suppression pour permettre au dialogue de fournir une alternative IDropTarget.

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

Paramètres

pDropTarget
IDocHostUIHandler::GetDropTarget Consultez pDropTarget le Kit de développement logiciel (SDK) Windows.

ppDropTarget
IDocHostUIHandler::GetDropTarget Consultez ppDropTarget le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne E_NOTIMPL.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::GetDropTarget, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::GetElement

Retourne une interface sur l’élément HTML spécifié par szElementId.

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

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

Paramètres

szElementId
ID d’un élément HTML.

ppdisp
Pointeur IDispatch vers l’élément ou la collection d’éléments demandés.

pbCollection
Indique BOOL si l’objet représenté par ppdisp est un élément unique ou une collection d’éléments.

pphtmlElement
Pointeur IHTMLElement vers l’élément demandé.

Valeur de retour

Valeur HRESULT standard.

Notes

Utilisez la première surcharge si vous devez gérer les conditions dans lesquelles il peut y avoir plusieurs éléments avec l’ID spécifié. Vous pouvez utiliser le dernier paramètre pour déterminer si le pointeur d’interface retourné est vers une collection ou un seul élément. Si le pointeur d’interface se trouve sur une collection, vous pouvez rechercher et IHTMLElementCollection utiliser sa item propriété pour faire référence aux éléments par position ordinale.

La deuxième surcharge échoue si plusieurs éléments ont le même ID dans la page.

CDHtmlDialog::GetElementHtml

Récupère la innerHTML propriété de l’élément HTML identifié par szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

Paramètres

szElementId
ID d’un élément HTML.

Valeur de retour

Propriété innerHTML de l’élément HTML identifié par szElementId ou NULL si l’élément est introuvable.

CDHtmlDialog::GetElementInterface

Récupère le pointeur d’interface demandé à partir de l’élément HTML identifié par szElementId.

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

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

Paramètres

szElementId
ID d’un élément HTML.

ppvObj
Adresse d’un pointeur qui sera rempli avec le pointeur d’interface demandé si l’élément est trouvé et que la requête réussit.

refiid
ID d’interface (IID) de l’interface demandée.

Valeur de retour

Valeur HRESULT standard.

Exemple

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

Récupère la valeur de la propriété identifiée par dispId l’élément HTML identifié par szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Paramètres

szElementId
ID d’un élément HTML.

dispId
ID de répartition d’une propriété.

Valeur de retour

Valeur de la propriété ou d’une variante vide si la propriété ou l’élément est introuvable.

CDHtmlDialog::GetElementText

Récupère la innerText propriété de l’élément HTML identifié par szElementId.

BSTR GetElementText(LPCTSTR szElementId);

Paramètres

szElementId
ID d’un élément HTML.

Valeur de retour

Propriété innerText de l’élément HTML identifié par szElementId ou NULL si la propriété ou l’élément est introuvable.

CDHtmlDialog::GetEvent

Retourne le IHTMLEventObj pointeur vers l’objet d’événement actuel.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Paramètres

ppEventObj
Adresse d’un pointeur qui sera rempli avec le pointeur d’interface IHTMLEventObj .

Valeur de retour

Valeur HRESULT standard.

Notes

Cette fonction ne doit être appelée qu’à partir d’un gestionnaire d’événements DHTML.

CDHtmlDialog::GetExternal

Obtient l’interface de l’hôte IDispatch .

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Paramètres

ppDispatch
IDocHostUIHandler::GetExternal Consultez ppDispatch le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne S_OK une valeur réussie ou E_NOTIMPL en cas d’échec.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::GetExternal, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::GetHostInfo

Récupère les fonctionnalités de l’interface utilisateur de l’hôte.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Paramètres

pInfo
IDocHostUIHandler::GetHostInfo Consultez pInfo le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne S_OK.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::GetHostInfo, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::GetOptionKeyPath

Récupère la clé de Registre sous laquelle les préférences utilisateur sont stockées.

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

Paramètres

pchKey
IDocHostUIHandler::GetOptionKeyPath Consultez pchKey le Kit de développement logiciel (SDK) Windows.

dw
IDocHostUIHandler::GetOptionKeyPath Consultez dw le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne E_NOTIMPL.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::GetOptionKeyPath, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::HideUI

Masque l’interface utilisateur de l’hôte.

STDMETHOD(HideUI)(void);

Valeur de retour

Retourne E_NOTIMPL.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::HideUI, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::IsExternalDispatchSafe

Indique si l’interface de l’hôte est sécurisée pour l’écriture de IDispatch scripts.

virtual BOOL IsExternalDispatchSafe();

Valeur de retour

Retourne FALSE.

CDHtmlDialog::LoadFromResource

Charge la ressource spécifiée dans le contrôle WebBrowser dans la boîte de dialogue DHTML.

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

Paramètres

lpszResource
Pointeur vers une chaîne contenant le nom de la ressource à charger.

nRes
ID de la ressource à charger.

Valeur de retour

TRUE en cas de réussite ; sinon, FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Indique s’il faut utiliser le titre du document HTML comme légende de boîte de dialogue.

BOOL m_bUseHtmlTitle;

Notes

Si m_bUseHtmlTitle c’est TRUEle cas, la légende de boîte de dialogue est définie sur le titre du document HTML ; sinon, la légende de la ressource de boîte de dialogue est utilisée.

CDHtmlDialog::m_nHtmlResID

ID de ressource de ressource HTML à afficher.

UINT m_nHtmlResID;

Exemple

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

CDHtmlDialog::m_pBrowserApp

Pointeur vers une application de navigateur web.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Pointeur vers un document HTML.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

URL actuelle.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

Version de chaîne de l’ID de ressource HTML.

LPTSTR m_szHtmlResID;

Exemple

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

Accède à la ressource identifiée par l’URL spécifiée par lpszURL.

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

Paramètres

lpszURL
Pointeur vers une chaîne contenant l’URL à cibler.

dwFlags
Indicateurs d’une variable qui spécifie s’il faut ajouter la ressource à la liste d’historiques, s’il faut lire dans le cache ou écrire à partir du cache et s’il faut afficher la ressource dans une nouvelle fenêtre. La variable peut être une combinaison des valeurs définies par l’énumération BrowserNavConstants .

lpszTargetFrameName
Pointeur vers une chaîne qui contient le nom du cadre dans lequel afficher la ressource.

lpszHeaders
Pointeur vers une valeur qui spécifie les en-têtes HTTP à envoyer au serveur. Ces en-têtes sont ajoutés aux en-têtes Internet Explorer par défaut. Les en-têtes peuvent spécifier des informations telles que l’action requise du serveur, le type de données transmises au serveur ou un code d’état. Ce paramètre est ignoré si l’URL n’est pas une URL HTTP.

lpvPostData
Pointeur vers les données à envoyer avec la transaction HTTP POST. Par exemple, la transaction POST est utilisée pour envoyer des données collectées par un formulaire HTML. Si ce paramètre ne spécifie aucune publication de données, Navigate émet une transaction HTTP GET. Ce paramètre est ignoré si l’URL n’est pas une URL HTTP.

dwPostDataLen
Données à envoyer avec la transaction HTTP POST. Par exemple, la transaction POST est utilisée pour envoyer des données collectées par un formulaire HTML. Si ce paramètre ne spécifie aucune publication de données, Navigate émet une transaction HTTP GET. Ce paramètre est ignoré si l’URL n’est pas une URL HTTP.

CDHtmlDialog::OnBeforeNavigate

Appelé par l’infrastructure pour déclencher un événement avant qu’une navigation ne se produise.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Paramètres

pDisp
Pointeur vers un objet IDispatch .

szUrl
Pointeur vers une chaîne contenant l’URL vers laquelle accéder.

CDHtmlDialog::OnDocumentComplete

Appelé par l’infrastructure pour notifier une application lorsqu’un document a atteint l’état READYSTATE_COMPLETE .

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Paramètres

pDisp
Pointeur vers un objet IDispatch .

szUrl
Pointeur vers une chaîne contenant l’URL à laquelle vous avez accédé.

CDHtmlDialog::OnDocWindowActivate

Appelé par l’infrastructure lorsque la fenêtre de document est activée ou désactivée.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Paramètres

fActivate
IDocHostUIHandler::OnDocWindowActivate Consultez fActivate le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne E_NOTIMPL.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::OnDocWindowActivate, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::OnFrameWindowActivate

Appelé par l’infrastructure lorsque la fenêtre frame est activée ou désactivée.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Paramètres

fActivate
IDocHostUIHandler::OnFrameWindowActivate Consultez fActivate le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne E_NOTIMPL.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::OnFrameWindowActivate, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::OnInitDialog

Appelé en réponse au WM_INITDIALOG message.

virtual BOOL OnInitDialog();

Valeur de retour

L'implémentation par défaut retourne la valeur TRUE.

Notes

Ce message est envoyé à la boîte de dialogue pendant le Create, CreateIndirectou DoModal les appels, qui se produisent immédiatement avant l’affichage de la boîte de dialogue.

Remplacez cette fonction membre si vous devez effectuer un traitement spécial lorsque la boîte de dialogue est initialisée. Dans la version substituée, appelez d’abord la classe OnInitDialog de base, mais ignorez sa valeur de retour. Vous retournerez normalement TRUE à partir de votre fonction membre substituée.

Windows appelle la OnInitDialog fonction par le biais de la procédure de boîte de dialogue globale standard commune à toutes les boîtes de dialogue bibliothèque de classes Microsoft Foundation, plutôt que par le biais de votre carte de messages. Vous n’avez donc pas besoin d’une entrée de mappage de messages pour cette fonction membre.

CDHtmlDialog::OnNavigateComplete

Appelé par l’infrastructure après la fin de la navigation vers l’URL spécifiée.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Paramètres

pDisp
Pointeur vers un objet IDispatch .

szUrl
Pointeur vers une chaîne contenant l’URL à laquelle vous avez accédé.

CDHtmlDialog::ResizeBorder

Avertit l’objet dont il a besoin pour redimensionner son espace de bordure.

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

Paramètres

prcBorder
IDocHostUIHandler::ResizeBorder Consultez prcBorder le Kit de développement logiciel (SDK) Windows.

pUIWindow
IDocHostUIHandler::ResizeBorder Consultez pUIWindow le Kit de développement logiciel (SDK) Windows.

fFrameWindow
IDocHostUIHandler::ResizeBorder Consultez fFrameWindow le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne E_NOTIMPL.

CDHtmlDialog::SetControlProperty

Définit la propriété d’un contrôle ActiveX sur une nouvelle valeur.

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ètres

szElementId
ID HTML d’un contrôle ActiveX.

dispId
ID de répartition de la propriété à définir.

pVar
Pointeur vers une VARIANT valeur contenant la nouvelle propriété.

pdispControl
Pointeur vers l’interface d’un IDispatch contrôle ActiveX.

szPropName
Chaîne contenant le nom de la propriété à définir.

CDHtmlDialog::SetElementHtml

Définit la innerHTML propriété d’un élément HTML.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Paramètres

szElementId
ID d’un élément HTML.

bstrText
Nouvelle valeur de la propriété innerHTML.

punkElem
Pointeur IUnknown d’un élément HTML.

CDHtmlDialog::SetElementProperty

Définit une propriété d’un élément HTML.

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

Paramètres

szElementId
ID d’un élément HTML.

dispId
ID de répartition de la propriété à définir.

pVar
Nouvelle valeur de la propriété .

CDHtmlDialog::SetElementText

Définit la innerText propriété d’un élément HTML.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Paramètres

szElementId
ID d’un élément HTML.

bstrText
Nouvelle valeur de la propriété innerText.

punkElem
Pointeur IUnknown d’un élément HTML.

CDHtmlDialog::SetExternalDispatch

Définit l’interface de l’hôte IDispatch .

void SetExternalDispatch(IDispatch* pdispExternal);

Paramètres

pdispExternal
Nouvelle IDispatch interface.

CDHtmlDialog::SetHostFlags

Définit les indicateurs d’interface utilisateur de l’hôte.

void SetHostFlags(DWORD dwFlags);

Paramètres

dwFlags
Pour connaître les valeurs possibles, consultez DOCHOSTUIFLAG le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::ShowContextMenu

Appelé lorsqu’un menu contextuel est sur le point d’être affiché.

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

Paramètres

dwID
IDocHostUIHandler::ShowContextMenu Consultez dwID le Kit de développement logiciel (SDK) Windows.

ppt
IDocHostUIHandler::ShowContextMenu Consultez ppt le Kit de développement logiciel (SDK) Windows.

pcmdtReserved
IDocHostUIHandler::ShowContextMenu Consultez pcmdtReserved le Kit de développement logiciel (SDK) Windows.

pdispReserved
IDocHostUIHandler::ShowContextMenu Consultez pdispReserved le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne S_FALSE.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::ShowContextMenu, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::ShowUI

Affiche l’interface utilisateur de l’hôte.

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

Paramètres

dwID
IDocHostUIHandler::ShowUI Consultez dwID le Kit de développement logiciel (SDK) Windows.

pActiveObject
IDocHostUIHandler::ShowUI Consultez pActiveObject le Kit de développement logiciel (SDK) Windows.

pCommandTarget
IDocHostUIHandler::ShowUI Consultez pCommandTarget le Kit de développement logiciel (SDK) Windows.

pFrame
IDocHostUIHandler::ShowUI Consultez pFrame le Kit de développement logiciel (SDK) Windows.

pDoc
IDocHostUIHandler::ShowUI Consultez pDoc le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne S_FALSE.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::ShowUI, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::TranslateAccelerator

Appelé pour traiter les messages de touches d’accélérateur de menu.

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

Paramètres

lpMsg
IDocHostUIHandler::TranslateAccelerator Consultez lpMsg le Kit de développement logiciel (SDK) Windows.

pguidCmdGroup
IDocHostUIHandler::TranslateAccelerator Consultez pguidCmdGroup le Kit de développement logiciel (SDK) Windows.

nCmdID
IDocHostUIHandler::TranslateAccelerator Consultez nCmdID le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne S_FALSE.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::TranslateAccelerator, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::TranslateUrl

Appelé pour modifier l’URL à charger.

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

Paramètres

dwTranslate
IDocHostUIHandler::TranslateUrl Consultez dwTranslate le Kit de développement logiciel (SDK) Windows.

pchURLIn
IDocHostUIHandler::TranslateUrl Consultez pchURLIn le Kit de développement logiciel (SDK) Windows.

ppchURLOut
IDocHostUIHandler::TranslateUrl Consultez ppchURLOut le Kit de développement logiciel (SDK) Windows.

Valeur de retour

Retourne S_FALSE.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::TranslateUrl, comme décrit dans le Kit de développement logiciel (SDK) Windows.

CDHtmlDialog::UpdateUI

Appelé pour avertir l’hôte que l’état de la commande a changé.

STDMETHOD(UpdateUI)(void);

Valeur de retour

Retourne E_NOTIMPL.

Notes

Cette fonction membre est l’implémentation CDHtmlDialog de IDocHostUIHandler::UpdateUI, comme décrit dans le Kit de développement logiciel (SDK) Windows.

Voir aussi

Exemple MFC DHtmlExplore
DDX_DHtml Macros d’assistance
Graphique hiérarchique