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.
class CDHtmlDialog : public CDialog, public CDHtmlEventSink
Nom | Description |
---|---|
CDHtmlDialog::CDHtmlDialog |
Construit un objet CDHtmlDialog. |
CDHtmlDialog::~CDHtmlDialog |
Détruit un objet CDHtmlDialog. |
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é. |
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. |
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.
CDHtmlSinkHandlerBase2
CDHtmlSinkHandlerBase1
CDHtmlSinkHandler
CDHtmlEventSink
CDHtmlDialog
En-tête : afxdhtml.h
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.
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é. |
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 différente de zéro cas de réussite ; sinon, 0.
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);
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 NULL
le 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.
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.
Détruit un objet CDHtmlDialog
.
virtual ~CDHtmlDialog();
La CWnd::DestroyWindow
fonction membre doit être utilisée pour détruire les boîtes de dialogue sans mode créées par CDialog::Create
.
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 */);
pContainer
Pointeur vers l'objet COleControlContainer
.
ppSite
Pointeur vers un pointeur vers un COleControlSite
.
Valeur différente de zéro cas de réussite ; sinon, 0.
Vous pouvez remplacer cette fonction membre pour retourner une instance de votre propre classe de site de contrôle.
É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);
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
, COleVariant
ou CComVariant
, qui contient la valeur échangée avec la propriété de contrôle ActiveX.
// COleVariant m_varSliderValue;
DDX_DHtml_AxControl(pDX, _T("slider1"), 0x0b /* Value */, m_varSliderValue);
É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);
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.
// int m_nItalic;
DDX_DHtml_CheckBox(pDX, L"italic", m_nItalic);
É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);
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.
É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);
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.
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);
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.
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);
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.
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);
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.
// CString m_strBlurDir;
DDX_DHtml_SelectValue(pDX, L"blurDir", m_strBlurDir);
Détache une boîte de dialogue sans mode de l’objet CDHtmlDialog
et détruit l’objet.
void DestroyModeless();
Active les boîtes de dialogue sans mode.
STDMETHOD(EnableModeless)(BOOL fEnable);
fEnable
IDocHostUIHandler::EnableModeless
Consultez fEnable
le Kit de développement logiciel (SDK) Windows.
Retourne E_NOTIMPL
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::EnableModeless
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
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);
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.
Retourne S_FALSE
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::FilterDataObject
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
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);
szId
ID HTML d’un contrôle ActiveX.
ppdisp
Interface IDispatch
du contrôle si elle se trouve dans la page Web.
Valeur HRESULT
standard.
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);
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é.
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é.
Les surcharges sont répertoriées du moins efficace en haut à la plus efficace au bas.
Récupère l’URL (Uniform Resource Locator) associée au document actif.
void GetCurrentUrl(CString& szUrl);
szUrl
Objet CString
contenant l’URL à récupérer.
Récupère l’interface IHTMLDocument2
sur le document HTML actuellement chargé.
HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);
**pphtmlDoc
Pointeur vers un pointeur vers un document HTML.
Une norme HRESULT
. Retourne S_OK
en cas de réussite.
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);
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.
Retourne E_NOTIMPL
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::GetDropTarget
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
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);
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 HRESULT
standard.
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.
Récupère la innerHTML
propriété de l’élément HTML identifié par szElementId
.
BSTR GetElementHtml(LPCTSTR szElementId);
szElementId
ID d’un élément HTML.
Propriété innerHTML
de l’élément HTML identifié par szElementId
ou NULL
si l’élément est introuvable.
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);
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 HRESULT
standard.
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));
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);
szElementId
ID d’un élément HTML.
dispId
ID de répartition d’une propriété.
Valeur de la propriété ou d’une variante vide si la propriété ou l’élément est introuvable.
Récupère la innerText
propriété de l’élément HTML identifié par szElementId
.
BSTR GetElementText(LPCTSTR szElementId);
szElementId
ID d’un élément HTML.
Propriété innerText
de l’élément HTML identifié par szElementId
ou NULL
si la propriété ou l’élément est introuvable.
Retourne le IHTMLEventObj
pointeur vers l’objet d’événement actuel.
HRESULT GetEvent(IHTMLEventObj** ppEventObj);
ppEventObj
Adresse d’un pointeur qui sera rempli avec le pointeur d’interface IHTMLEventObj
.
Valeur HRESULT
standard.
Cette fonction ne doit être appelée qu’à partir d’un gestionnaire d’événements DHTML.
Obtient l’interface de l’hôte IDispatch
.
STDMETHOD(GetExternal)(IDispatch** ppDispatch);
ppDispatch
IDocHostUIHandler::GetExternal
Consultez ppDispatch
le Kit de développement logiciel (SDK) Windows.
Retourne S_OK
une valeur réussie ou E_NOTIMPL
en cas d’échec.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::GetExternal
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Récupère les fonctionnalités de l’interface utilisateur de l’hôte.
STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);
pInfo
IDocHostUIHandler::GetHostInfo
Consultez pInfo
le Kit de développement logiciel (SDK) Windows.
Retourne S_OK
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::GetHostInfo
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Récupère la clé de Registre sous laquelle les préférences utilisateur sont stockées.
STDMETHOD(GetOptionKeyPath)(
LPOLESTR* pchKey,
DWORD dw);
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.
Retourne E_NOTIMPL
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::GetOptionKeyPath
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Masque l’interface utilisateur de l’hôte.
STDMETHOD(HideUI)(void);
Retourne E_NOTIMPL
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::HideUI
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Indique si l’interface de l’hôte est sécurisée pour l’écriture de IDispatch
scripts.
virtual BOOL IsExternalDispatchSafe();
Retourne FALSE
.
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);
lpszResource
Pointeur vers une chaîne contenant le nom de la ressource à charger.
nRes
ID de la ressource à charger.
TRUE
en cas de réussite ; sinon, FALSE
.
Indique s’il faut utiliser le titre du document HTML comme légende de boîte de dialogue.
BOOL m_bUseHtmlTitle;
Si m_bUseHtmlTitle
c’est TRUE
le 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.
ID de ressource de ressource HTML à afficher.
UINT m_nHtmlResID;
CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
mydialog.m_nHtmlResID = IDR_HTML_MYDHTMLDLG;
mydialog.DoModal();
Pointeur vers une application de navigateur web.
CComPtr <IWebBrowser2> m_pBrowserApp;
Pointeur vers un document HTML.
CComPtr<IHTMLDocument2> m_spHtmlDoc;
URL actuelle.
CString m_strCurrentUrl;
Version de chaîne de l’ID de ressource HTML.
LPTSTR m_szHtmlResID;
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);
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.
Appelé par l’infrastructure pour déclencher un événement avant qu’une navigation ne se produise.
virtual void OnBeforeNavigate(
LPDISPATCH pDisp,
LPCTSTR szUrl);
pDisp
Pointeur vers un objet IDispatch
.
szUrl
Pointeur vers une chaîne contenant l’URL vers laquelle accéder.
Appelé par l’infrastructure pour notifier une application lorsqu’un document a atteint l’état READYSTATE_COMPLETE
.
virtual void OnDocumentComplete(
LPDISPATCH pDisp,
LPCTSTR szUrl);
pDisp
Pointeur vers un objet IDispatch
.
szUrl
Pointeur vers une chaîne contenant l’URL à laquelle vous avez accédé.
Appelé par l’infrastructure lorsque la fenêtre de document est activée ou désactivée.
STDMETHOD(OnDocWindowActivate)(BOOL fActivate);
fActivate
IDocHostUIHandler::OnDocWindowActivate
Consultez fActivate
le Kit de développement logiciel (SDK) Windows.
Retourne E_NOTIMPL
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::OnDocWindowActivate
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Appelé par l’infrastructure lorsque la fenêtre frame est activée ou désactivée.
STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);
fActivate
IDocHostUIHandler::OnFrameWindowActivate
Consultez fActivate
le Kit de développement logiciel (SDK) Windows.
Retourne E_NOTIMPL
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::OnFrameWindowActivate
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Appelé en réponse au WM_INITDIALOG
message.
virtual BOOL OnInitDialog();
L'implémentation par défaut retourne la valeur TRUE
.
Ce message est envoyé à la boîte de dialogue pendant le Create
, CreateIndirect
ou 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.
Appelé par l’infrastructure après la fin de la navigation vers l’URL spécifiée.
virtual void OnNavigateComplete(
LPDISPATCH pDisp,
LPCTSTR szUrl);
pDisp
Pointeur vers un objet IDispatch
.
szUrl
Pointeur vers une chaîne contenant l’URL à laquelle vous avez accédé.
Avertit l’objet dont il a besoin pour redimensionner son espace de bordure.
STDMETHOD(ResizeBorder)(
LPCRECT prcBorder,
IOleInPlaceUIWindow* pUIWindow,
BOOL fRameWindow);
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.
Retourne E_NOTIMPL.
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);
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.
Définit la innerHTML
propriété d’un élément HTML.
void SetElementHtml(
LPCTSTR szElementId,
BSTR bstrText);
void SetElementHtml(
IUnknown* punkElem,
BSTR bstrText);
szElementId
ID d’un élément HTML.
bstrText
Nouvelle valeur de la propriété innerHTML
.
punkElem
Pointeur IUnknown
d’un élément HTML.
Définit une propriété d’un élément HTML.
void SetElementProperty(
LPCTSTR szElementId,
DISPID dispId,
VARIANT* pVar);
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é .
Définit la innerText
propriété d’un élément HTML.
void SetElementText(
LPCTSTR szElementId,
BSTR bstrText);
void SetElementText(
IUnknown* punkElem,
BSTR bstrText);
szElementId
ID d’un élément HTML.
bstrText
Nouvelle valeur de la propriété innerText
.
punkElem
Pointeur IUnknown
d’un élément HTML.
Définit l’interface de l’hôte IDispatch
.
void SetExternalDispatch(IDispatch* pdispExternal);
pdispExternal
Nouvelle IDispatch
interface.
Définit les indicateurs d’interface utilisateur de l’hôte.
void SetHostFlags(DWORD dwFlags);
dwFlags
Pour connaître les valeurs possibles, consultez DOCHOSTUIFLAG
le Kit de développement logiciel (SDK) Windows.
Appelé lorsqu’un menu contextuel est sur le point d’être affiché.
STDMETHOD(ShowContextMenu)(
DWORD dwID,
POINT* ppt,
IUnknown* pcmdtReserved,
IDispatch* pdispReserved);
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.
Retourne S_FALSE
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::ShowContextMenu
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Affiche l’interface utilisateur de l’hôte.
STDMETHOD(ShowUI)(
DWORD dwID,
IOleInPlaceActiveObject* pActiveObject,
IOleCommandTarget* pCommandTarget,
IOleInPlaceFrame* pFrame,
IOleInPlaceUIWindow* pDoc);
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.
Retourne S_FALSE
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::ShowUI
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Appelé pour traiter les messages de touches d’accélérateur de menu.
STDMETHOD(TranslateAccelerator)(
LPMSG lpMsg,
const GUID* pguidCmdGroup,
DWORD nCmdID);
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.
Retourne S_FALSE
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::TranslateAccelerator
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Appelé pour modifier l’URL à charger.
STDMETHOD(TranslateUrl)(
DWORD dwTranslate,
OLECHAR* pchURLIn,
OLECHAR** ppchURLOut);
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.
Retourne S_FALSE
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::TranslateUrl
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Appelé pour avertir l’hôte que l’état de la commande a changé.
STDMETHOD(UpdateUI)(void);
Retourne E_NOTIMPL
.
Cette fonction membre est l’implémentation CDHtmlDialog
de IDocHostUIHandler::UpdateUI
, comme décrit dans le Kit de développement logiciel (SDK) Windows.
Exemple MFC DHtmlExplore
DDX_DHtml
Macros d’assistance
Graphique hiérarchique