La classe `CDHtmlDialog`

Article
10/12/2023

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

`CDHtmlDialog::Navigate`

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

Partager via

La classe CDHtmlDialog

Syntaxe

Membres

Constructeurs publics

Méthodes publiques

Membres de données publics

Notes

Hiérarchie d'héritage

Spécifications

DDX_DHtml Macros d’assistance

Macros Exchange de données

CDHtmlDialog::CanAccessExternal

Valeur de retour

CDHtmlDialog::CDHtmlDialog

Paramètres

Notes

CDHtmlDialog::~CDHtmlDialog

Notes

CDHtmlDialog::CreateControlSite

Paramètres

Valeur de retour

Notes

CDHtmlDialog::DDX_DHtml_AxControl

Paramètres

Exemple

CDHtmlDialog::DDX_DHtml_CheckBox

Paramètres

Exemple

CDHtmlDialog::DDX_DHtml_ElementText

Paramètres

CDHtmlDialog::DDX_DHtml_Radio

Paramètres

CDHtmlDialog::DDX_DHtml_SelectIndex

Paramètres

CDHtmlDialog::DDX_DHtml_SelectString

Paramètres

CDHtmlDialog::DDX_DHtml_SelectValue

Paramètres

Exemple

CDHtmlDialog::DestroyModeless

CDHtmlDialog::EnableModeless

Paramètres

Valeur de retour

Notes

CDHtmlDialog::FilterDataObject

Paramètres

Valeur de retour

Notes

CDHtmlDialog::GetControlDispatch

Paramètres

Valeur de retour

CDHtmlDialog::GetControlProperty

Paramètres

Valeur de retour

Notes

CDHtmlDialog::GetCurrentUrl

Paramètres

CDHtmlDialog::GetDHtmlDocument

Paramètres

Valeur de retour

CDHtmlDialog::GetDropTarget

Paramètres

Valeur de retour

Notes

CDHtmlDialog::GetElement

Paramètres

Valeur de retour

Notes

CDHtmlDialog::GetElementHtml

Paramètres

Valeur de retour

CDHtmlDialog::GetElementInterface

Paramètres

Valeur de retour

Exemple

CDHtmlDialog::GetElementProperty

Paramètres

Valeur de retour

CDHtmlDialog::GetElementText

La classe `CDHtmlDialog`

`DDX_DHtml` Macros d’assistance

`CDHtmlDialog::CanAccessExternal`

`CDHtmlDialog::CDHtmlDialog`

`CDHtmlDialog::~CDHtmlDialog`

`CDHtmlDialog::CreateControlSite`

`CDHtmlDialog::DDX_DHtml_AxControl`

`CDHtmlDialog::DDX_DHtml_CheckBox`

`CDHtmlDialog::DDX_DHtml_ElementText`

`CDHtmlDialog::DDX_DHtml_Radio`

`CDHtmlDialog::DDX_DHtml_SelectIndex`

`CDHtmlDialog::DDX_DHtml_SelectString`

`CDHtmlDialog::DDX_DHtml_SelectValue`

`CDHtmlDialog::DestroyModeless`

`CDHtmlDialog::EnableModeless`

`CDHtmlDialog::FilterDataObject`

`CDHtmlDialog::GetControlDispatch`

`CDHtmlDialog::GetControlProperty`

`CDHtmlDialog::GetCurrentUrl`

`CDHtmlDialog::GetDHtmlDocument`

`CDHtmlDialog::GetDropTarget`

`CDHtmlDialog::GetElement`

`CDHtmlDialog::GetElementHtml`

`CDHtmlDialog::GetElementInterface`

`CDHtmlDialog::GetElementProperty`

`CDHtmlDialog::GetElementText`

`CDHtmlDialog::GetEvent`

`CDHtmlDialog::GetExternal`

`CDHtmlDialog::GetHostInfo`

`CDHtmlDialog::GetOptionKeyPath`

`CDHtmlDialog::HideUI`

`CDHtmlDialog::IsExternalDispatchSafe`

`CDHtmlDialog::LoadFromResource`

`CDHtmlDialog::m_bUseHtmlTitle`

`CDHtmlDialog::m_nHtmlResID`

`CDHtmlDialog::m_pBrowserApp`

`CDHtmlDialog::m_spHtmlDoc`

`CDHtmlDialog::m_strCurrentUrl`

`CDHtmlDialog::m_szHtmlResID`

`CDHtmlDialog::Navigate`

`CDHtmlDialog::OnBeforeNavigate`

`CDHtmlDialog::OnDocumentComplete`

`CDHtmlDialog::OnDocWindowActivate`

`CDHtmlDialog::OnFrameWindowActivate`

`CDHtmlDialog::OnInitDialog`

`CDHtmlDialog::OnNavigateComplete`

`CDHtmlDialog::ResizeBorder`

`CDHtmlDialog::SetControlProperty`

`CDHtmlDialog::SetElementHtml`

`CDHtmlDialog::SetElementProperty`

`CDHtmlDialog::SetElementText`

`CDHtmlDialog::SetExternalDispatch`

`CDHtmlDialog::SetHostFlags`