Partager via

Classe CHtmlView

  • Article

Fournit les fonctionnalités du contrôle WebBrowser dans le contexte de l'architecture document/vue de MFC.

Syntaxe

class CHtmlView : public CFormView

Membres

Méthodes publiques

Nom Description
CHtmlView::Create Crée le contrôle WebBrowser.
CHtmlView::CreateControlSite Méthode substituable permettant de créer une instance de site de contrôle pour héberger un contrôle sur le formulaire.
CHtmlView::ExecFormsCommand Exécute la commande spécifiée à l’aide de la méthode IOleCommandTarget::Exec .
CHtmlView::ExecWB Exécute une commande.
CHtmlView::GetAddressBar Détermine si la barre d’adresse de l’objet Internet Explorer est visible. (Contrôle WebBrowser ignoré ; Internet Explorer uniquement.)
CHtmlView::GetApplication Récupère un objet application représentant l’application qui contient l’instance actuelle de l’application Internet Explorer.
CHtmlView::GetBusy Récupère une valeur indiquant si un téléchargement ou une autre activité est toujours en cours.
CHtmlView::GetContainer Récupère le conteneur du contrôle WebBrowser.
CHtmlView::GetFullName Récupère le nom complet, notamment le chemin, de la ressource affichée dans le navigateur web. (Contrôle WebBrowser ignoré ; Internet Explorer uniquement.)
CHtmlView::GetFullScreen Indique si le contrôle WebBrowser fonctionne en mode Plein écran ou en mode Fenêtre normal.
CHtmlView::GetHeight Récupère la hauteur de la fenêtre principale d’Internet Explorer.
CHtmlView::GetHtmlDocument Récupère le document HTML actif.
CHtmlView::GetLeft Récupère les coordonnées d’écran du bord gauche de la fenêtre principale d’Internet Explorer.
CHtmlView::GetLocationName Récupère le nom de la ressource actuellement affichée par WebBrowser.
CHtmlView::GetLocationURL Récupère l’URL de la ressource actuellement affichée par WebBrowser.
CHtmlView::GetMenuBar Récupère une valeur qui détermine si la barre de menus est visible.
CHtmlView::GetOffline Récupère une valeur qui détermine si le contrôle est hors connexion.
CHtmlView::GetParentBrowser Récupère un pointeur vers l’interface IDispatch . Pour plus d’informations, consultez Implémentation de l’interfaceIDispatch.
CHtmlView::GetProperty Récupère la valeur actuelle d’une propriété associée à l’objet donné.
CHtmlView::GetReadyState Récupère l’état Prêt de l’objet WebBrowser.
CHtmlView::GetRegisterAsBrowser Indique si le contrôle WebBrowser est inscrit en tant que navigateur de niveau supérieur pour la résolution de nom cible.
CHtmlView::GetRegisterAsDropTarget Indique si le contrôle WebBrowser est inscrit en tant que cible de déplacement pour la navigation.
CHtmlView::GetSilent Indique si les boîtes de dialogue peuvent être affichées.
CHtmlView::GetSource Code source HTML de la page web.
CHtmlView::GetStatusBar Indique si la barre d’état d’Internet Explorer est visible. (Contrôle WebBrowser ignoré ; Internet Explorer uniquement.)
CHtmlView::GetTheaterMode Indique si le contrôle WebBrowser est en mode Cinéma.
CHtmlView::GetToolBar Récupère une valeur qui détermine si la barre d’outils est visible.
CHtmlView::GetTop Récupère les coordonnées d’écran du bord supérieur de la fenêtre principale d’Internet Explorer.
CHtmlView::GetTopLevelContainer Récupère une valeur indiquant si l’objet actuel est le conteneur de niveau supérieur du contrôle WebBrowser.
CHtmlView::GetType Récupère le nom de type de l’objet document.
CHtmlView::GetVisible Récupère une valeur indiquant si l’objet est visible ou masqué.
CHtmlView::GetWidth Récupère la largeur de la fenêtre principale d’Internet Explorer.
CHtmlView::GoBack Accède à l’élément précédent de l’historique.
CHtmlView::GoForward Accède à l’élément suivant de l’historique.
CHtmlView::GoHome Accède à la page d’accueil ou de démarrage actuelle.
CHtmlView::GoSearch Accède à la page de recherche actuelle.
CHtmlView::LoadFromResource Charge une ressource dans le contrôle WebBrowser.
CHtmlView::Navigate Accède à la ressource identifiée par une URL.
CHtmlView::Navigate2 Accède à la ressource identifiée par une URL ou au fichier identifié par un chemin complet.
CHtmlView::OnBeforeNavigate2 Appelée avant qu’une opération de navigation se produise dans le WebBrowser donné (sur une fenêtre ou un élément frameset).
CHtmlView::OnCommandStateChange Appelé pour avertir une application que l’état activé d’une commande de navigateur web a changé.
CHtmlView::OnDocumentComplete Appelé pour avertir une application qu’un document a atteint l’état READYSTATE_COMPLETE .
CHtmlView::OnDocWindowActivate Appelé à partir de l’implémentation Internet Explorer ou MSHTML de IOleInPlaceActiveObject::OnDocWindowActivate, qui notifie l’objet actif sur place lorsque la fenêtre de document du conteneur est activée ou désactivée.
CHtmlView::OnDownloadBegin Appelé pour avertir une application qu’une opération de navigation commence.
CHtmlView::OnDownloadComplete Appelé quand une opération de navigation aboutit, est interrompue ou échoue.
CHtmlView::OnEnableModeless Appelé pour activer ou désactiver les boîtes de dialogue non modales quand le conteneur crée ou détruit une boîte de dialogue modale.
CHtmlView::OnFilterDataObject Appelé sur l’hôte par Internet Explorer ou MSHTML pour permettre à l’hôte de remplacer un objet de données Internet Explorer ou MSHTML.
CHtmlView::OnFrameWindowActivate Appelé pour IOleInPlaceActiveObject::OnFrameWindowActivate notifier l’objet lorsque la fenêtre frame de niveau supérieur du conteneur est activée ou désactivée.
CHtmlView::OnFullScreen Appelé lorsque la FullScreen propriété a changé.
CHtmlView::OnGetDropTarget Appelé par Internet Explorer ou MSHTML lorsqu’il est utilisé comme cible de suppression pour permettre à l’hôte de fournir une alternative IDropTarget.
CHtmlView::OnGetExternal Appelé par Internet Explorer ou MSHTML pour obtenir l’interface IDispatch de l’hôte.
CHtmlView::OnGetHostInfo Récupère les fonctionnalités d’interface utilisateur de l’hôte Internet Explorer ou MSHTML.
CHtmlView::OnGetOptionKeyPath Retourne la clé de Registre sous laquelle Internet Explorer ou MSHTML stocke les préférences utilisateur.
CHtmlView::OnHideUI Appelé quand Internet Explorer ou MSHTML supprime ses menus et barres d’outils.
CHtmlView::OnMenuBar Appelé lorsque la MenuBar propriété a changé.
CHtmlView::OnNavigateComplete2 Appelé après la navigation vers un lien hypertexte se termine (sur une fenêtre ou un élément frameset).
CHtmlView::OnNavigateError Appelé par l’infrastructure en cas d’échec de la navigation vers un lien hypertexte.
CHtmlView::OnNewWindow2 Appelé quand une fenêtre doit être créée pour afficher une ressource.
CHtmlView::OnProgressChange Appelé pour avertir une application que la progression d’une opération de téléchargement a été mise à jour.
CHtmlView::OnPropertyChange Appelé pour avertir une application que la PutProperty méthode a modifié la valeur d’une propriété.
CHtmlView::OnQuit Appelé pour avertir une application que l’application Internet Explorer est prête à être fermée. (S’applique uniquement à Internet Explorer)
CHtmlView::OnResizeBorder Appelé à partir de l’implémentation Internet Explorer ou MSHTML de IOleInPlaceActiveObject::ResizeBorder, qui avertit l’objet dont il a besoin pour redimensionner son espace de bordure.
CHtmlView::OnShowContextMenu Appelé à partir d’Internet Explorer ou de MSHTML lorsqu’il est sur le point d’afficher son menu contextuel.
CHtmlView::OnShowUI Appelé avant que Internet Explorer ou MSHTML affiche ses menus et barres d’outils.
CHtmlView::OnStatusBar Appelé lorsque la StatusBar propriété a changé.
CHtmlView::OnStatusTextChange Appelé pour avertir une application que le texte de la barre d’état associée au contrôle WebBrowser a changé.
CHtmlView::OnTheaterMode Appelé lorsque la TheaterMode propriété a changé.
CHtmlView::OnTitleChange Appelé pour avertir une application que le titre d’un document contenu dans le contrôle WebBrowser est disponible ou a été modifié.
CHtmlView::OnToolBar Appelé lorsque la ToolBar propriété a changé.
CHtmlView::OnTranslateAccelerator Appelé par Internet Explorer ou MSHTML quand IOleInPlaceActiveObject::TranslateAccelerator ou IOleControlSite::TranslateAccelerator est appelé pour traiter les messages de touches d’accélérateur de menu à partir de la file d’attente de messages du conteneur.
CHtmlView::OnTranslateUrl Appelé par Internet Explorer ou MSHTML pour permettre à l’hôte de modifier l’URL à charger.
CHtmlView::OnUpdateUI Avertit l’hôte que l’état de la commande a changé.
CHtmlView::OnVisible Appelé quand la fenêtre du contrôle WebBrowser doit être affichée/masquée.
CHtmlView::PutProperty Définit la valeur d’une propriété associée à l’objet donné.
CHtmlView::QueryFormsCommand Demande l’état d’une ou plusieurs commandes générées par des événements d’interface utilisateur.
CHtmlView::QueryStatusWB Demande l’état d’une commande actuellement traitée par le contrôle WebBrowser.
CHtmlView::Refresh Recharge le fichier actif.
CHtmlView::Refresh2 Recharge le fichier actif et empêche éventuellement l’envoi de l’en-tête pragma:nocache .
CHtmlView::SetAddressBar Affiche ou masque la barre d’adresse de l’objet Internet Explorer. (Contrôle WebBrowser ignoré ; Internet Explorer uniquement.)
CHtmlView::SetFullScreen Définit une valeur pour déterminer si le contrôle fonctionne en mode Plein écran ou en mode Fenêtre normal. (Contrôle WebBrowser ignoré ; Internet Explorer uniquement.)
CHtmlView::SetHeight Définit la hauteur de la fenêtre principale d’Internet Explorer.
CHtmlView::SetLeft Définit la position horizontale de la fenêtre principale d’Internet Explorer.
CHtmlView::SetMenuBar Définit une valeur pour déterminer si la barre de menus du contrôle est visible. (Contrôle WebBrowser ignoré ; Internet Explorer uniquement.)
CHtmlView::SetOffline Définit une valeur pour déterminer si le contrôle est hors connexion.
CHtmlView::SetRegisterAsBrowser Définit une valeur indiquant si le contrôle WebBrowser est inscrit en tant que navigateur de niveau supérieur pour la résolution de nom cible.
CHtmlView::SetRegisterAsDropTarget Définit une valeur indiquant si le contrôle WebBrowser est inscrit en tant que cible de déplacement pour la navigation.
CHtmlView::SetSilent Définit une valeur pour déterminer si le contrôle affiche les boîtes de dialogue.
CHtmlView::SetStatusBar Définit une valeur pour déterminer si la barre d’état d’Internet Explorer est visible. (Contrôle WebBrowser ignoré ; Internet Explorer uniquement.)
CHtmlView::SetTheaterMode Définit une valeur indiquant si le contrôle WebBrowser est en mode Cinéma.
CHtmlView::SetToolBar Définit une valeur pour déterminer si la barre d’outils du contrôle est visible. (Contrôle WebBrowser ignoré ; Internet Explorer uniquement.)
CHtmlView::SetTop Définit la position verticale de la fenêtre principale d’Internet Explorer.
CHtmlView::SetVisible Définit une valeur indiquant si l’objet est visible ou masqué.
CHtmlView::SetWidth Définit la largeur de la fenêtre principale d’Internet Explorer.
CHtmlView::Stop Arrête l’ouverture d’un fichier.

Notes

Le contrôle WebBrowser est une fenêtre dans laquelle l’utilisateur peut parcourir des sites sur le World Wide Web et des dossiers dans le système de fichiers local et sur un réseau. Le contrôle WebBrowser prend en charge les liens hypertexte, la navigation par URL (Uniform Resource Locator) et tient à jour un historique.

Utilisation de la CHtmlView classe dans une application MFC

Dans l’application d’infrastructure MFC standard (basée sur SDI ou MDI), l’objet de vue dérive fréquemment d’un ensemble de classes spécialisé. Ces classes, toutes dérivées de CView, fournissent des fonctionnalités spécialisées au-delà de celles fournies par CView.

En basant la classe de vue de l’application sur CHtmlView , la vue est fournie avec le contrôle WebBrowser. Cela fait effectivement de l’application un navigateur web. La méthode recommandée pour créer une application de type navigateur web consiste à utiliser l’Assistant Application MFC et à spécifier CHtmlView comme classe de vue. Pour plus d’informations sur l’implémentation et l’utilisation du contrôle WebBrowser dans les applications MFC, consultez Création d’une application de type navigateur web.

Remarque

Le contrôle ActiveX WebBrowser (et par conséquent CHtmlView) est accessible uniquement aux programmes s’exécutant sur Windows NT version 4.0 ou ultérieure avec Internet Explorer 4.0 ou version ultérieure installé.

CHtmlView a été conçu pour les applications qui accèdent au web (et/ou documents HTML). Les fonctions membres CHtmlView suivantes s’appliquent uniquement à l’application Internet Explorer. Ces fonctions réussissent sur le contrôle WebBrowser, mais elles n’ont aucun effet visible.

Hiérarchie d'héritage

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

Spécifications

En-tête : afxhtml.h

CHtmlView::Create

Appelez cette fonction membre pour créer un contrôle webBrowser ou un conteneur pour l’exécutable Internet Explorer.

virtual BOOL Create(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CCreateContext* pContext = NULL);

Paramètres

lpszClassName
Pointe vers une chaîne de caractères terminée par null qui nomme la classe Windows. Le nom de classe peut être n’importe quel nom inscrit auprès de la AfxRegisterWndClass fonction globale ou de la RegisterClass fonction Windows. Si NULL, utilise les attributs par défaut CFrameWnd prédéfinis.

lpszWindowName
Pointe vers une chaîne de caractères terminée par null qui représente le nom de la fenêtre.

dwStyle
Spécifie les attributs de style de fenêtre. Par défaut, les WS_VISIBLE styles Windows sont WS_CHILD définis.

rect
Référence à une RECT structure spécifiant la taille et la position de la fenêtre. La rectDefault valeur permet à Windows de spécifier la taille et la position de la nouvelle fenêtre.

pParentWnd
Pointeur vers la fenêtre parente du contrôle.

nID
Numéro d’ID de la vue. Par défaut, définissez sur AFX_IDW_PANE_FIRST.

pContext
Pointeur vers un CCreateContext. NULL par défaut.

CHtmlView::CreateControlSite

Méthode substituable permettant de créer une instance de site de contrôle pour héberger un contrôle sur le formulaire.

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

Paramètres

pContainer
Pointeur vers un COleControlContainer objet contenant le contrôle.

ppSite
Pointeur vers un pointeur vers un COleControlSite objet, fournissant le site du contrôle.

nID
Identificateur du contrôle à héberger.

clsid
CLSID du contrôle à héberger

Valeur de retour

Retourne TRUE en cas de réussite, FALSE en cas d’échec.

Notes

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

CHtmlView::ExecFormsCommand

Exécute la commande spécifiée à l’aide de la méthode IOleCommandTarget::Exec .

HRESULT ExecFormsCommand(
    DWORD dwCommandID,
    VARIANT* pVarIn,
    VARIANT* pVarOut);

Paramètres

dwCommandID
Commande à exécuter. Cette commande doit appartenir au CMDSETID3_Forms3 groupe.

pVarIn
Pointeur vers une VARIANT structure contenant des arguments d’entrée. Peut être NULL.

pVarOut
Pointeur vers une VARIANT structure pour recevoir la sortie de commande. Peut être NULL.

Valeur de retour

Valeur HRESULT standard. Pour obtenir la liste complète des valeurs possibles, consultez IOleCommandTarget::Exec le Kit de développement logiciel (SDK) Windows.

Notes

ExecFormsCommand implémente le comportement de la IOleCommandTarget::Exec méthode.

CHtmlView::ExecWB

Appelez cette fonction membre pour exécuter une commande dans WebBrowser ou Internet Explorer.

void ExecWB(
    OLECMDID cmdID,
    OLECMDEXECOPT cmdexecopt,
    VARIANT* pvaIn,
    VARIANT* pvaOut);

Paramètres

cmdID
Commande à exécuter.

cmdexecopt
Options définies pour l’exécution de la commande.

pvaIn
Variante utilisée pour spécifier des arguments d’entrée de commande.

pvaOut
Variante utilisée pour spécifier des arguments de sortie de commande.

Notes

Consultez IWebBrowser2::ExecWB le Kit de développement logiciel (SDK) Windows.

CHtmlView::GetAddressBar

Appelez cette fonction membre pour récupérer la barre d’adresses d’Internet Explorer.

BOOL GetAddressBar() const;

Valeur de retour

Différent de zéro si la barre d’adresse est visible ; sinon zéro.

Notes

S’applique à Internet Explorer. Si vous utilisez cet appel avec un contrôle WebBrowser, il ne retourne aucune erreur, mais il ignore cet appel.

CHtmlView::GetApplication

Appelez cette fonction membre pour récupérer l’objet Automation pris en charge par l’application qui contient le contrôle WebBrowser.

LPDISPATCH GetApplication() const;

Valeur de retour

Pointeur vers l’interface IDispatch de l’objet de document actif. Pour plus d’informations, consultez Implémentation de l’interfaceIDispatch.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetBusy

Appelez cette fonction membre pour déterminer si le contrôle WebBrowser est engagé dans une opération de navigation ou de téléchargement.

BOOL GetBusy() const;

Valeur de retour

Différent de zéro si le navigateur web est occupé ; sinon zéro.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetContainer

Appelez cette fonction membre pour récupérer un objet qui prend la valeur du conteneur du navigateur web.

LPDISPATCH GetContainer() const;

Valeur de retour

Pointeur vers l’interface IDispatch de l’objet de document actif.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetFullName

Appelez cette fonction membre pour récupérer le chemin complet du fichier actuellement affiché par Internet Explorer.

CString GetFullName() const;

Valeur de retour

Objet CString contenant le chemin d’accès et le nom du fichier actuellement affiché. Si aucun chemin d’accès et nom de fichier n’existe, GetFullName retourne un fichier vide CString.

Notes

S’applique à Internet Explorer. Si vous utilisez cet appel avec un contrôle WebBrowser, il ne retourne aucune erreur, mais il ignore cet appel.

CHtmlView::GetFullScreen

Appelez cette fonction membre pour déterminer si le contrôle WebBrowser fonctionne en mode plein écran ou en mode fenêtre normal.

BOOL GetFullScreen() const;

Valeur de retour

Différent de zéro si WebBrowser fonctionne en mode plein écran ; sinon zéro.

Notes

En mode plein écran, la fenêtre principale d’Internet Explorer est agrandie et la barre d’état, la barre d’outils, la barre d’outils, la barre de menus et la barre de titre sont masquées.

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetHeight

Appelez cette fonction membre pour récupérer la hauteur, en pixels, de la fenêtre frame du contrôle WebBrowser.

long GetHeight() const;

Valeur de retour

Hauteur de la fenêtre frame du contrôle, en pixels.

CHtmlView::GetHtmlDocument

Appelez cette fonction membre pour récupérer le document HTML du document actif.

LPDISPATCH GetHtmlDocument() const;

Valeur de retour

Pointeur vers l’interface IDispatch de l’objet de document actif.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetLeft

Appelez cette fonction membre pour récupérer la distance entre le bord gauche interne du contrôle WebBrowser et le bord gauche de son conteneur.

long GetLeft() const;

Valeur de retour

Distance de bord gauche, en pixels.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetLocationName

Appelez cette fonction membre pour obtenir le nom de la ressource affichée dans WebBrowser.

CString GetLocationName() const;

Valeur de retour

Objet CString contenant le nom de la ressource actuellement affichée dans WebBrowser.

Notes

Si la ressource est une page HTML sur le World Wide Web, le nom est le titre de cette page. Si la ressource est un dossier ou un fichier sur le réseau ou l’ordinateur local, le nom est le chemin d’accès UNC ou complet du dossier ou du fichier.

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetLocationURL

Appelez cette fonction membre pour récupérer l’URL de la ressource que le contrôle WebBrowser affiche actuellement.

CString GetLocationURL() const;

Valeur de retour

Objet CString contenant l’URL de la ressource actuellement affichée dans WebBrowser.

Notes

Si la ressource est un dossier ou un fichier sur le réseau ou l’ordinateur local, le nom est le chemin d’accès UNC ou complet du dossier ou du fichier.

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetMenuBar

Appelez cette fonction membre pour déterminer si la barre de menus est visible.

BOOL GetMenuBar() const;

Valeur de retour

Différent de zéro si la barre de menus est visible ; sinon zéro.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetOffline

Appelez cette fonction membre pour déterminer si le navigateur web fonctionne hors connexion.

BOOL GetOffline() const;

Valeur de retour

Différent de zéro si le navigateur web est actuellement hors connexion ; sinon zéro.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetParentBrowser

Appelez cette fonction membre pour récupérer un pointeur vers l’objet parent du contrôle WebBrowser.

LPDISPATCH GetParentBrowser() const;

Valeur de retour

Pointeur vers l’interface IDispatch de l’objet qui est le parent du contrôle WebBrowser.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetProperty

Appelez cette fonction membre pour obtenir la valeur de la propriété actuellement associée au contrôle.

BOOL GetProperty(
    LPCTSTR lpszProperty,
    CString& strValue);

COleVariant GetProperty(LPCTSTR lpszProperty);

Paramètres

lpszProperty
Pointeur vers une chaîne contenant la propriété à récupérer.

strValue
Référence à un CString objet qui reçoit la valeur actuelle de la propriété.

Valeur de retour

Dans la première version, sans zéro si elle est terminée avec succès ; sinon zéro. Dans la deuxième version, un COleVariant objet.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetReadyState

Appelez cette fonction membre pour récupérer l’état prêt de l’objet WebBrowser.

READYSTATE GetReadyState() const;

Valeur de retour

Valeur READYSTATE , comme décrit dans le Kit de développement logiciel (SDK) Windows.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetRegisterAsBrowser

Appelez cette fonction membre pour déterminer si l’objet WebBrowser est inscrit en tant que navigateur de niveau supérieur pour la résolution de noms cible.

BOOL GetRegisterAsBrowser() const;

Valeur de retour

Différent de zéro si le navigateur est inscrit en tant que navigateur de niveau supérieur ; sinon zéro.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetRegisterAsDropTarget

Appelez cette fonction membre pour déterminer si le contrôle WebBrowser est inscrit en tant que cible de déplacement pour la navigation.

BOOL GetRegisterAsDropTarget() const;

Valeur de retour

Différent de zéro si le navigateur est inscrit en tant que cible de suppression ; sinon zéro.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetSilent

Appelez cette fonction membre pour déterminer si des boîtes de dialogue peuvent être affichées dans le contrôle WebBrowser.

BOOL GetSilent() const;

Valeur de retour

Différent de zéro si les boîtes de dialogue ne peuvent pas être affichées à partir du contrôle WebBrowser ; sinon zéro.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetSource

Appelez cette fonction membre pour récupérer le code source HTML de la page web.

BOOL GetSource(CString& strRef);

Valeur de retour

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

Paramètres

refString
Qui CString contiendra le code source.

Notes

Cette fonction équivaut à la commande « Afficher la source » dans Internet Explorer, sauf que le code source est retourné dans un CString.

CHtmlView::GetStatusBar

Appelez cette fonction membre pour déterminer si le contrôle WebBrowser affiche une barre d’état.

BOOL GetStatusBar() const;

Valeur de retour

Différent de zéro si la barre d’état peut être affichée ; sinon zéro.

Notes

S’applique à Internet Explorer. Si vous utilisez cet appel avec un contrôle WebBrowser, il ne retourne aucune erreur, mais il ignore cet appel.

CHtmlView::GetTheaterMode

Appelez cette fonction membre pour déterminer si le navigateur web est en mode théâtre.

BOOL GetTheaterMode() const;

Valeur de retour

Différent de zéro si le navigateur web est en mode théâtre ; sinon zéro.

Notes

Lorsque le navigateur web est en mode théâtre, la fenêtre principale du navigateur remplit l’écran entier, une barre d’outils avec un ensemble minimal d’outils de navigation s’affiche et la barre d’état apparaît dans le coin supérieur droit de l’écran.

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetToolBar

Appelez cette fonction membre pour déterminer si la barre d’outils est visible.

int GetToolBar() const;

Valeur de retour

Valeur indiquant si la barre d’outils est visible. Différent de zéro si la barre d’outils est visible ; sinon zéro.

CHtmlView::GetTop

Appelez cette fonction membre pour récupérer la coordonnée d’écran du bord supérieur de la fenêtre principale du contrôle WebBrowser.

long GetTop() const;

Valeur de retour

Adresse d’une variable qui reçoit la coordonnée de l’écran du bord supérieur de la fenêtre principale.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetTopLevelContainer

Appelez cette fonction membre pour déterminer si Internet Explorer est le conteneur de niveau supérieur du contrôle WebBrowser.

BOOL GetTopLevelContainer() const;

Valeur de retour

Non différent de zéro du conteneur est le conteneur de niveau supérieur ; sinon zéro.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetType

Appelez cette fonction membre pour récupérer le nom de type du document actif contenu.

CString GetType() const;

Valeur de retour

Objet CString contenant le nom de type du document actif contenu.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetVisible

Appelez cette fonction membre pour déterminer si l’objet contenu est visible.

BOOL GetVisible() const;

Valeur de retour

Différent de zéro si l’objet est visible ; sinon zéro.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GetWidth

Récupère la largeur de la fenêtre principale d’Internet Explorer.

long GetWidth() const;

Valeur de retour

Largeur actuelle de la fenêtre, en pixels.

CHtmlView::GoBack

Navigue vers l’arrière d’un élément dans la liste d’historiques.

void GoBack();

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GoForward

Navigue vers l’avant un élément dans la liste d’historiques.

void GoForward();

CHtmlView::GoHome

Accès à la page d’accueil ou de démarrage actuelle spécifiée dans la boîte de dialogue Options Internet d’Internet Explorer ou dans la boîte de dialogue Propriétés Internet, accessible depuis le Panneau de configuration.

void GoHome();

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::GoSearch

Accède à la page de recherche active, comme spécifié dans la boîte de dialogue Options Internet Explorer ou dans la boîte de dialogue Propriétés Internet, accessible à partir du Panneau de configuration.

void GoSearch();

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::LoadFromResource

Appelez cette fonction membre pour charger la ressource spécifiée dans le contrôle WebBrowser.

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 mémoire tampon contenant le nom de la ressource à charger.

Valeur de retour

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

Notes

S’applique à Internet Explorer et à WebBrowser.

Appelez cette fonction membre pour accéder à la ressource identifiée par une URL.

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

Paramètres

URL
Chaîne allouée par l’appelant qui contient l’URL à accéder ou le chemin complet du fichier à afficher.

dwFlags
Indicateurs d’une variable qui spécifie s’il faut ajouter la ressource à la liste d’historiques, lire ou écrire à partir du cache et 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 éléments tels que l’action requise du serveur, le type de données transmises au serveur ou un code d’état. Ce paramètre est ignoré s’il URL ne s’agit pas d’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é s’il URL ne s’agit pas d’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é s’il URL ne s’agit pas d’une URL HTTP.

Notes

S’applique à Internet Explorer et à WebBrowser.

Appelez cette fonction membre pour accéder à la ressource identifiée par une URL ou au fichier identifié par un chemin d’accès complet.

void Navigate2(
    LPITEMIDLIST pIDL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL);

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

void Navigate2(
    LPCTSTR lpszURL,
    DWORD dwFlags,
    CByteArray& baPostedData,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeader = NULL);

Paramètres

pIDL
Pointeur vers une ITEMIDLIST structure.

dwFlags
Indicateurs d’une variable qui spécifie s’il faut ajouter la ressource à la liste d’historiques, lire ou écrire à partir du cache et 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.

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

lpvPostData
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, Navigate2 émet une transaction HTTP GET. Ce paramètre est ignoré s’il URL n’est pas une URL HTTP ou HTTPS.

dwPostDataLen
Longueur en octets des données pointées par le lpvPostData paramètre.

lpszHeaders
Pointeur vers une valeur qui spécifie les en-têtes HTTP ou HTTPS à 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 éléments tels que l’action requise du serveur, le type de données transmises au serveur ou un code d’état. Ce paramètre est ignoré s’il URL n’est pas une URL HTTP ou HTTPS.

baPostedData
Référence à un objet CByteArray.

Notes

Cette fonction membre étend la fonction membre en prenant en charge la Navigate navigation sur des dossiers spéciaux, tels que Bureau et Mon ordinateur, qui sont représentés par le paramètre pIDL.

S’applique à Internet Explorer et à WebBrowser.

Exemple

void CMyHtmlView::OnGoToMicrosoft()
{
   Navigate2(_T("http://home.microsoft.com"));
}

CHtmlView::OnBeforeNavigate2

Cette fonction membre est appelée par l’infrastructure pour déclencher un événement avant qu’une opération de navigation se produise dans le navigateur web.

virtual void OnBeforeNavigate2(
    LPCTSTR lpszURL,
    DWORD nFlags,
    LPCTSTR lpszTargetFrameName,
    CByteArray& baPostedData,
    LPCTSTR lpszHeaders,
    BOOL* pbCancel);

Paramètres

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

nFlags
Réservé pour un usage futur.

lpszTargetFrameName
Chaîne qui contient le nom de l’image dans laquelle afficher la ressource, ou NULL si aucune trame nommée n’est ciblée pour la ressource.

baPostedData
Référence à un CByteArray objet contenant les données à envoyer au serveur si la transaction HTTP POST est utilisée.

lpszHeaders
Pointeur vers une chaîne contenant d’autres en-têtes HTTP à envoyer au serveur (URL HTTP uniquement). Les en-têtes peuvent spécifier des éléments tels que l’action requise du serveur, le type de données transmises au serveur ou un code d’état.

pbCancel
Pointeur vers un indicateur d’annulation. Une application peut définir ce paramètre sur différent de zéro pour annuler l’opération de navigation, ou sur zéro pour l’autoriser à continuer.

CHtmlView::OnCommandStateChange

Cette fonction membre est appelée par l’infrastructure pour avertir une application que l’état activé d’une commande de navigateur web a changé.

virtual void OnCommandStateChange(
    long nCommand,
    BOOL bEnable);

Paramètres

nCommand
Identificateur de la commande dont l’état activé a changé.

bEnable
État activé. Ce paramètre n’est pas différent de zéro si la commande est activée ou zéro si elle est désactivée.

CHtmlView::OnDocumentComplete

Cette fonction membre est appelée par l’infrastructure pour informer une application qu’un document a atteint l’état READYSTATE_COMPLETE .

virtual void OnDocumentComplete(LPCTSTR lpszURL);

Paramètres

lpszURL
Pointeur vers une chaîne qui prend la valeur de l’URL, du nom de fichier UNC ou d’un PIDL (pointeur vers une liste d’identificateurs d’élément) qui a été accédée.

Notes

Toutes les images ne déclenchent pas cet événement, mais chaque image qui déclenche un OnDownloadBegin événement déclenche un événement correspondant OnDocumentComplete .

L’URL indiquée par lpszURL peut être différente de l’URL vers laquelle le navigateur a été informé pour accéder, car cette URL est l’URL canonique et qualifiée. Par exemple, si une application spécifie une URL d’un "www.microsoft.com" appel à Navigate ou Navigate2, l’URL transmise sera OnNavigateComplete2 "<https://www.microsoft.com/>". En outre, si le serveur a redirigé le navigateur vers une autre URL, l’URL redirigée est reflétée ici.

CHtmlView::OnDocWindowActivate

Appelé à partir de l’implémentation Internet Explorer ou MSHTML de IOleInPlaceActiveObject::OnDocWindowActivate, qui notifie l’objet actif sur place lorsque la fenêtre de document du conteneur est activée ou désactivée.

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

Paramètres

fActivate
Indique l’état de la fenêtre de document. Si cette valeur n’est pas nulle, la fenêtre est activée. Si cette valeur est égale à zéro, la fenêtre est désactivée.

Valeur de retour

S_OK si elle réussit ou si un code d’erreur OLE est défini dans le cas contraire.

Notes

Remplacez OnDocWindowActivate la réaction à la OnDocWindowActivate notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::OnDocWindowActivate le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnDownloadBegin

Cette fonction membre est appelée par l’infrastructure pour commencer à télécharger un document.

virtual void OnDownloadBegin();

Notes

Cet événement est déclenché peu après l’événement OnBeforeNavigate2 , sauf si la navigation est annulée. Toute animation ou « occupé » indique que le conteneur doit être connecté à cet événement.

CHtmlView::OnDownloadComplete

Cette fonction membre est appelée par l’infrastructure pour indiquer qu’une opération de navigation s’est terminée, a été arrêtée ou a échoué.

virtual void OnDownloadComplete();

CHtmlView::OnEnableModeless

Appelé quand Internet Explorer ou MSHTML affiche l’interface utilisateur modale.

virtual HRESULT OnEnableModeless(BOOL fEnable);

Paramètres

fEnable
Indique si les boîtes de dialogue sans mode de l’hôte sont activées ou désactivées. Si cette valeur n’est pas différente de zéro, les boîtes de dialogue sans mode sont activées. Si cette valeur est égale à zéro, les boîtes de dialogue sans mode sont désactivées.

Valeur de retour

S_OK si elle réussit ou si un code d’erreur OLE est défini dans le cas contraire.

Notes

Active ou désactive les boîtes de dialogue sans mode lorsque le conteneur crée ou détruit une boîte de dialogue modale. Remplacez OnEnableModeless la réaction à la EnableModeless notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::EnableModeless le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnFilterDataObject

Appelé sur l’hôte par Internet Explorer ou MSHTML pour permettre à l’hôte de remplacer un objet de données Internet Explorer ou MSHTML.

virtual HRESULT OnFilterDataObject(
    LPDATAOBJECT pDataObject,
    LPDATAOBJECT* ppDataObject);

Paramètres

pDataObject
Adresse de l’interface IDataObject fournie par Internet Explorer ou MSHTML.

ppDataObject
Adresse qui reçoit le pointeur d’interface IDataObject fourni par l’hôte. Le contenu de ce paramètre doit toujours être initialisé NULL, même si la méthode échoue.

Valeur de retour

S_OK si l’objet de données est remplacé, S_FALSE si l’objet de données n’est pas remplacé ou si un code d’erreur OLE est défini si une erreur se produit.

Notes

Remplacez OnFilterDataObject la réaction à la FilterDataObject notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::FilterDataObject le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnFrameWindowActivate

Appelé pour IOleInPlaceActiveObject::OnFrameWindowActivate notifier l’objet lorsque la fenêtre frame de niveau supérieur du conteneur est activée ou désactivée.

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

Paramètres

fActivate
Indique l’état de la fenêtre frame de niveau supérieur du conteneur. Si cette valeur n’est pas nulle, la fenêtre est activée. Si cette valeur est égale à zéro, la fenêtre est désactivée.

Valeur de retour

S_OK si elle réussit ou si un code d’erreur OLE est défini dans le cas contraire.

Notes

Remplacez OnFrameWindowActivate la réaction à la OnFrameWindowActivate notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::OnFrameWindowActivate le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnFullScreen

Cette fonction membre est appelée par l’infrastructure lorsque la FullScreen propriété a changé.

virtual void OnFullScreen(BOOL bFullScreen);

Paramètres

bFullScreen
Différent de zéro si Internet Explorer est en mode plein écran ; zéro sinon.

CHtmlView::OnGetDropTarget

Appelé par Internet Explorer ou MSHTML lorsqu’il est utilisé comme cible de suppression pour permettre à l’hôte de fournir une alternative IDropTarget.

virtual HRESULT OnGetDropTarget(
    LPDROPTARGET pDropTarget,
    LPDROPTARGET* ppDropTarget);

Paramètres

pDropTarget
IDropTarget Internet Explorer ou MSHTML propose d’utiliser.

ppDropTarget
Adresse du pointeur d’interface IDropTarget que l’hôte IDropTarget souhaite fournir.

Valeur de retour

Consultez IDocHostUIHandler::GetDropTarget le Kit de développement logiciel (SDK) Windows pour obtenir la liste des codes de retour.

Notes

Remplacez OnGetDropTarget la réaction à la GetDropTarget notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::GetDropTarget le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnGetExternal

Appelé par Internet Explorer ou MSHTML pour obtenir l’interface IDispatch de l’hôte.

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

Paramètres

lppDispatch
Pointeur vers l’adresse qui reçoit le IDispatch pointeur d’interface de l’application hôte. Si l’hôte expose une interface Automation, il peut fournir une référence à Internet Explorer ou MSHTML via ce paramètre. Le contenu de ce paramètre doit toujours être initialisé NULL, même si la méthode échoue.

Valeur de retour

S_OK si elle réussit ou si un code d’erreur OLE est défini dans le cas contraire.

Notes

Remplacez OnGetExternal la réaction à la GetExternal notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::GetExternal le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnGetHostInfo

Récupère les fonctionnalités d’interface utilisateur de l’hôte Internet Explorer ou MSHTML.

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

Paramètres

pInfo
Adresse d’une DOCHOSTUIINFO structure qui reçoit les fonctionnalités de l’interface utilisateur de l’hôte.

Valeur de retour

S_OK si elle réussit ou si un code d’erreur OLE est défini dans le cas contraire.

Notes

Remplacez OnGetHostInfo la réaction à la GetHostInfo notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::GetHostInfo le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnGetOptionKeyPath

Appelez cette fonction membre pour obtenir la clé de Registre sous laquelle Internet Explorer ou MSHTML stocke les préférences utilisateur.

virtual HRESULT OnGetOptionKeyPath(
    LPOLESTR* pchKey,
    DWORD dwReserved);

Paramètres

pchKey
Adresse d’une LPOLESTR chaîne de sous-clé de Registre où l’hôte stocke ses options par défaut. Cette sous-clé se trouve sous la HKEY_CURRENT_USER clé. Allouez cette mémoire à l’aide CoTaskMemAllocde . L’application appelante est chargée de libérer cette mémoire à l’aide CoTaskMemFreede . Ce paramètre doit toujours être initialisé NULL, même si la méthode échoue.

dwReserved
Réservé pour un usage futur. Pas utilisé pour l'instant.

Valeur de retour

S_OK si elle réussit ou S_FALSE si elle réussit. Si S_FALSE, Internet Explorer ou MSHTML est défini par défaut sur ses propres options utilisateur.

Notes

Remplacez OnGetOptionKeyPath la réaction à la GetOptionKeyPath notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::GetOptionKeyPath le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnHideUI

Cette fonction membre est appelée par l’infrastructure quand Internet Explorer ou MSHTML supprime ses menus et barres d’outils.

virtual HRESULT OnHideUI();

Valeur de retour

S_OK si elle réussit ou si un code d’erreur OLE est défini dans le cas contraire.

Notes

Remplacez OnHideUI la réaction à la HideUI notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::HideUI le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnMenuBar

Cette fonction membre est appelée par l’infrastructure lorsque la MenuBar propriété a changé.

virtual void OnMenuBar(BOOL bMenuBar);

Paramètres

bMenuBar
Différent de zéro si la barre de menus Internet Explorer est visible ; zéro sinon.

CHtmlView::OnNavigateComplete2

Cette fonction membre est appelée par l’infrastructure une fois la navigation vers un lien hypertexte terminé (sur une fenêtre ou un élément frameset).

virtual void OnNavigateComplete2(LPCTSTR strURL);

Paramètres

strURL
Expression de chaîne qui prend la valeur de l’URL, du nom de fichier UNC ou du code PIDL (pointeur vers une liste d’identificateurs d’élément) qui a été accédée.

Notes

Le paramètre d’URL peut être un code PIDL s’il existe une entité d’espace de noms d’interpréteur de commandes pour laquelle aucune représentation d’URL n’est disponible.

L’URL contenue dans strURL peut être différente de l’URL vers laquelle le navigateur a été informé pour accéder, car cette URL est l’URL canonique et qualifiée. Par exemple, si une application spécifie une URL d’un "www.microsoft.com" appel à Navigate ou Navigate2, l’URL transmise sera OnNavigateComplete2 "<https://www.microsoft.com/>". En outre, si le serveur a redirigé le navigateur vers une autre URL, l’URL redirigée est reflétée ici.

CHtmlView::OnNavigateError

Appelé par l’infrastructure en cas d’échec de la navigation vers un lien hypertexte.

virtual void OnNavigateError(
    LPCTSTR lpszURL,
    LPCTSTR lpszFrame,
    DWORD dwError,
    BOOL* pbCancel);

Paramètres

lpszURL
URL pour laquelle la navigation a échoué.

lpszFrame
Nom du frame dans lequel la ressource doit être affichée, ou NULL si aucune trame nommée n’a été ciblée pour la ressource.

dwError
Code d’état d’erreur, le cas échéant. Pour obtenir la liste des codes d’état HTTP et possiblesHRESULT, consultez NavigateError Les codes d’état d’événement.

pbCancel
Spécifie s’il faut annuler la navigation vers une page d’erreur ou toute autre recherche automatique. Si TRUE (valeur par défaut), poursuivez la navigation vers une page d’erreur ou une recherche automatique ; si FALSE, annulez la navigation vers une page d’erreur ou la recherche automatique.

Notes

Remplacez cette méthode pour fournir une gestion personnalisée des erreurs de navigation.

Pour plus d’informations, consultez DWebBrowserEvents2::NavigateError

CHtmlView::OnNewWindow2

Cette fonction membre est appelée par l’infrastructure lorsqu’une nouvelle fenêtre doit être créée pour afficher une ressource.

virtual void OnNewWindow2(
    LPDISPATCH* ppDisp,
    BOOL* Cancel);

Paramètres

ppDisp
Pointeur vers un pointeur d’interface qui, éventuellement, reçoit le IDispatch pointeur d’interface d’un nouvel objet WebBrowser ou Internet Explorer.

Cancel
Pointeur vers un indicateur d’annulation. Une application peut définir ce paramètre sur différent de zéro pour annuler l’opération de navigation, ou sur zéro pour l’autoriser à continuer.

Notes

Cet événement précède la création d’une nouvelle fenêtre à partir de WebBrowser.

CHtmlView::OnProgressChange

Cette fonction membre est appelée par l’infrastructure pour informer une application que la progression d’une opération de téléchargement a été mise à jour.

virtual void OnProgressChange(
    long nProgress,
    long nProgressMax);

Paramètres

nProgress
Quantité totale de progression à afficher, ou -1 lorsque la progression est terminée.

nProgressMax
Valeur de progression maximale.

Notes

Le conteneur peut utiliser les informations fournies par cet événement pour afficher le nombre d’octets téléchargés jusqu’à présent ou pour mettre à jour un indicateur de progression.

CHtmlView::OnPropertyChange

Cette fonction membre est appelée par l’infrastructure pour notifier une application qui PutProperty a modifié la valeur d’une propriété.

virtual void OnPropertyChange(LPCTSTR lpszProperty);

Paramètres

lpszProperty
Pointeur vers une chaîne contenant le nom de la propriété.

CHtmlView::OnQuit

Cette fonction membre est appelée par l’infrastructure pour notifier une application que l’application Internet Explorer est prête à quitter.

virtual void OnQuit();

CHtmlView::OnResizeBorder

Appelé à partir de l’implémentation Internet Explorer ou MSHTML de IOleInPlaceActiveObject::ResizeBorder, qui avertit l’objet dont il a besoin pour redimensionner son espace de bordure.

virtual HRESULT OnResizeBorder(
    LPCRECT prcBorder,
    LPOLEINPLACEUIWINDOW pUIWindow,
    BOOL fFrameWindow);

Paramètres

prcBorder
Nouveau rectangle externe pour l’espace de bordure.

pUIWindow
Pointeur vers l’interface de l’objet frame ou fenêtre de document dont la bordure a changé.

fFrameWindow
TRUE si la fenêtre frame appelle IOleInPlaceActiveObject::ResizeBorder, sinon FALSE.

Valeur de retour

S_OK si elle réussit ou si un code d’erreur OLE est défini dans le cas contraire.

Notes

Remplacez OnResizeBorder la réaction à la ResizeBorder notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::ResizeBorder le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnShowContextMenu

Appelé à partir d’Internet Explorer ou de MSHTML lorsqu’il est sur le point d’afficher son menu contextuel.

virtual HRESULT OnShowContextMenu(
    DWORD dwID,
    LPPOINT ppt,
    LPUNKNOWN pcmdtReserved,
    LPDISPATCH pdispReserved);

Paramètres

dwID
Identificateur du menu contextuel à afficher. Consultez IDocHostUIHandler::ShowContextMenu le Kit de développement logiciel (SDK) Windows pour obtenir la liste des valeurs.

ppt
Coordonnées de l’écran pour le menu.

pcmdtReserved
IOleCommandTarget interface utilisée pour interroger l’état de la commande et exécuter des commandes sur cet objet.

pdispReserved
IDispatch interface de l’objet aux coordonnées de l’écran. Cela permet à un hôte de différencier des objets particuliers pour fournir un contexte plus spécifique.

Valeur de retour

Consultez IDocHostUIHandler::ShowContextMenu le Kit de développement logiciel (SDK) Windows pour obtenir la liste des valeurs.

Notes

Remplacez OnShowContextMenu la réaction à la ShowContextMenu notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::ShowContextMenu le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnShowUI

Appelé avant que Internet Explorer ou MSHTML affiche ses menus et barres d’outils.

virtual HRESULT OnShowUI(
    DWORD dwID,
    LPOLEINPLACEACTIVEOBJECT pActiveObject,
    LPOLECOMMANDTARGET pCommandTarget,
    LPOLEINPLACEFRAME pFrame,
    LPOLEINPLACEUIWINDOW pDoc);

Paramètres

dwID
Réservé pour un usage futur.

pActiveObject
IOleInPlaceActiveObject interface de l’objet actif.

pCommandTarget
IOleCommandTarget interface de l’objet.

pFrame
IOleInPlaceFrame interface de l’objet. Cela est nécessaire pour les menus et les barres d’outils.

pDoc
IOleInPlaceUIWindow interface de l’objet. Cela est nécessaire pour les barres d’outils.

Valeur de retour

Consultez IDocHostUIHandler::ShowUI le Kit de développement logiciel (SDK) Windows pour obtenir la liste des valeurs.

Notes

Remplacez OnShowUI la réaction à la ShowUI notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::ShowUI le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnStatusBar

Cette fonction membre est appelée par l’infrastructure lorsque la StatusBar propriété a changé.

virtual void OnStatusBar(BOOL bStatusBar);

Paramètres

bStatusBar
Différent de zéro si la barre d’état d’Internet Explorer est visible ou nulle sinon.

CHtmlView::OnStatusTextChange

Cette fonction membre est appelée par l’infrastructure pour avertir une application que le texte de la barre d’état associée au contrôle WebBrowser a changé.

virtual void OnStatusTextChange(LPCTSTR lpszText);

Paramètres

lpszText
Chaîne qui contient le nouveau texte de la barre d’état.

CHtmlView::OnTheaterMode

Cette fonction membre est appelée par l’infrastructure lorsque la TheaterMode propriété a changé.

virtual void OnTheaterMode(BOOL bTheaterMode);

Paramètres

bTheaterMode
Différent de zéro si Internet Explorer est en mode théâtre ; zéro sinon.

CHtmlView::OnTitleChange

Cette fonction membre est appelée par l’infrastructure pour notifier une application si le titre d’un document dans le contrôle WebBrowser devient disponible ou modifie.

virtual void OnTitleChange(LPCTSTR lpszText);

Paramètres

lpszText
Nouveau titre du document.

Notes

Pour html, le titre peut changer ; pendant le téléchargement du code HTML, l’URL du document est définie comme titre. Une fois le titre réel (s’il en existe un) analysé à partir du code HTML, le titre est modifié pour refléter le titre réel.

CHtmlView::OnToolBar

Cette fonction membre est appelée par l’infrastructure lorsque la ToolBar propriété a changé.

virtual void OnToolBar(BOOL bToolBar);

Paramètres

bToolBar
Différent de zéro si la barre d’outils d’Internet Explorer est visible ou nulle sinon.

CHtmlView::OnTranslateAccelerator

Appelé par Internet Explorer ou MSHTML quand IOleInPlaceActiveObject::TranslateAccelerator ou IOleControlSite::TranslateAccelerator est appelé pour traiter les messages de touches d’accélérateur de menu à partir de la file d’attente de messages du conteneur.

virtual HRESULT OnTranslateAccelerator(
    LPMSG lpMsg,
    const GUID* pguidCmdGroup,
    DWORD nCmdID);

Paramètres

lpMsg
Pointe vers le message qui peut avoir besoin d’être traduit.

pguidCmdGroup
Identificateur du groupe de commandes.

nCmdID
Identificateur de commande.

Valeur de retour

S_OK si elle réussit ou S_FALSE si elle réussit.

Notes

Remplacez OnTranslateAccelerator la réaction à la TranslateAccelerator notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::TranslateAccelerator le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnTranslateUrl

Appelé par Internet Explorer ou MSHTML pour permettre à l’hôte de modifier l’URL à charger.

virtual HRESULT OnTranslateUrl(
    DWORD dwTranslate,
    OLECHAR* pchURLIn,
    OLECHAR** ppchURLOut);

Paramètres

dwTranslate
Réservé pour un usage futur.

pchURLIn
Adresse d’une chaîne fournie par Internet Explorer ou MSHTML qui représente l’URL à traduire.

ppchURLOut
Adresse d’un pointeur de chaîne qui reçoit l’adresse de l’URL traduite. L’hôte alloue la mémoire tampon à l’aide de l’allocateur de mémoire de tâche. Le contenu de ce paramètre doit toujours être initialisé NULL, même si l’URL n’est pas traduite ou si la méthode échoue.

Valeur de retour

S_OK si l’URL a été traduite, S_FALSE si l’URL n’a pas été traduite, ou un code d’erreur OLE défini si une erreur s’est produite.

Notes

Remplacez OnTranslateUrl la réaction à la TranslateUrl notification à partir du contrôle Microsoft Web Browser. Pour plus d’informations, consultez IDocHostUIHandler::TranslateUrl le Kit de développement logiciel (SDK) Windows.

CHtmlView::OnUpdateUI

Avertit l’hôte que l’état de la commande a changé.

virtual HRESULT OnUpdateUI();

Valeur de retour

S_OK si elle réussit ou si un code d’erreur OLE est défini dans le cas contraire.

Notes

L’hôte doit mettre à jour l’état des boutons de barre d’outils. Cette méthode est appelée indépendamment de la valeur de retour de ShowUI. Remplacez OnUpdateUI la réaction à la UpdateUI notification à partir du contrôle Microsoft Web Browser.

CHtmlView::OnVisible

Cette fonction membre est appelée par l’infrastructure lorsque la fenêtre de WebBrowser doit être affichée ou masquée.

virtual void OnVisible(BOOL bVisible);

Paramètres

bVisible
Différent de zéro si l’objet est visible ou zéro dans le cas contraire.

Notes

Cela permet à la fenêtre hôte du contrôle d’objet de se comporter de la même façon que la fenêtre Internet Explorer se comporte.

CHtmlView::PutProperty

Appelez cette fonction membre pour définir la propriété associée à un objet donné.

void PutProperty(
    LPCTSTR lpszProperty,
    const VARIANT& vtValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    double dValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    long lValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    LPCTSTR lpszValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    short nValue);

Paramètres

lpszProperty
Chaîne contenant la propriété à définir.

vtValue
Nouvelle valeur de la propriété indiquée par lpszProperty.

lpszPropertyName
Pointeur vers une chaîne contenant le nom de la propriété à définir.

dValue
Nouvelle valeur de la propriété .

lValue
Nouvelle valeur de la propriété .

lpszValue
Pointeur vers une chaîne contenant la nouvelle valeur de la propriété.

nValue
Nouvelle valeur de la propriété .

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::QueryFormsCommand

Demande l’état d’une ou plusieurs commandes générées par des événements d’interface utilisateur.

HRESULT QueryFormsCommand(
    DWORD dwCommandID,
    BOOL* pbSupported,
    BOOL* pbEnabled,
    BOOL* pbChecked);

Paramètres

dwCommandID
Identificateur de la commande interrogée.

pbSupported
Pointeur vers un BOOL spécifiant si la commande (identifiée par dwCommandID) est prise en charge. Si TRUE, la commande est prise en charge ; sinon FALSE.

pbEnabled
Pointeur vers un BOOL spécifiant si la commande (identifiée par dwCommandID) est activée. Si TRUE, la commande est prise en charge ; sinon FALSE.

pbChecked
Pointeur vers un BOOL spécifiant si la commande (identifiée par dwCommandID) est cochée. Si TRUE, la commande est prise en charge ; sinon FALSE.

Valeur de retour

Valeur HRESULT standard. Pour obtenir la liste complète des valeurs possibles, consultez IOleCommandTarget::QueryStatus le Kit de développement logiciel (SDK) Windows.

Notes

QueryFormsCommand implémente le comportement de la IOleCommandTarget::QueryStatus méthode.

CHtmlView::QueryStatusWB

Appelez cette fonction membre pour interroger un état de commande.

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

Paramètres

cmdID
Valeur OLECMDID de la commande pour laquelle l’appelant a besoin d’informations d’état.

Valeur de retour

Adresse de la OLECMDF valeur qui reçoit l’état de la commande.

Notes

QueryStatusWB implémente le comportement de la IOleCommandTarget::QueryStatus méthode.

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::Refresh

Recharge l’URL ou le fichier que le navigateur web affiche actuellement.

void Refresh();

Notes

Refresh ne contient aucun paramètre pour définir le niveau d’actualisation.

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::Refresh2

Recharge le fichier actuellement affiché par Internet Explorer.

void Refresh2(int nLevel);

Paramètres

nLevel
Adresse de la variable spécifiant le niveau d’actualisation. Les variables possibles sont définies dans RefreshConstants, dans le Kit de développement logiciel (SDK) Windows.

Notes

Contrairement Refreshà , Refresh2 contient un paramètre qui spécifie le niveau d’actualisation.

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::SetAddressBar

Appelez cette fonction membre pour afficher ou masquer la barre d’adresse de l’objet Internet Explorer.

void SetAddressBar(BOOL bNewValue);

Paramètres

bNewValue
Non différent de zéro pour afficher la barre d’adresse ; sinon zéro.

Notes

S’applique à Internet Explorer. Si vous utilisez cet appel avec un contrôle WebBrowser, il ne retourne aucune erreur, mais il ignore cet appel.

CHtmlView::SetFullScreen

Appelez cette fonction membre pour définir Internet Explorer sur le mode fenêtre plein écran ou normal.

void SetFullScreen(BOOL bNewValue);

Paramètres

bNewValue
Différent de zéro pour le mode plein écran ; sinon zéro.

Notes

En mode plein écran, la fenêtre principale d’Internet Explorer est agrandie et la barre d’état, la barre d’outils, la barre d’outils, la barre de menus et la barre de titre sont masquées.

S’applique à Internet Explorer. Si vous utilisez cet appel avec un contrôle WebBrowser, il ne retourne aucune erreur, mais il ignore cet appel.

CHtmlView::SetHeight

Appelez cette fonction membre pour définir la hauteur de la fenêtre principale d’Internet Explorer.

void SetHeight(long nNewValue);

Paramètres

nNewValue
Hauteur, en pixels, de la fenêtre principale.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::SetLeft

Définit la position horizontale de la fenêtre principale d’Internet Explorer.

void SetLeft(long nNewValue);

Paramètres

nNewValue
Coordonnée de l’écran du bord gauche de la fenêtre principale.

CHtmlView::SetMenuBar

Appelez cette fonction membre pour afficher ou masquer la barre de menus Internet Explorer.

void SetMenuBar(BOOL bNewValue);

Paramètres

bNewValue
Non différent de zéro pour afficher la barre de menus ; sinon zéro.

Notes

S’applique à Internet Explorer. Si vous utilisez cet appel avec un contrôle WebBrowser, il ne retourne aucune erreur, mais il ignore cet appel.

CHtmlView::SetOffline

Appelez cette fonction membre pour définir une valeur indiquant si le contrôle WebBrowser fonctionne actuellement en mode hors connexion.

void SetOffline(BOOL bNewValue);

Paramètres

bNewValue
Non différent de zéro pour lire à partir du cache local ; sinon zéro.

Notes

En mode hors connexion, le navigateur lit les pages HTML à partir du cache local plutôt que du document source.

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::SetRegisterAsBrowser

Appelez cette fonction membre pour définir une valeur indiquant si le contrôle WebBrowser est inscrit en tant que navigateur de niveau supérieur pour la résolution de noms cible.

void SetRegisterAsBrowser(BOOL bNewValue);

Paramètres

bNewValue
Détermine si Internet Explorer est inscrit en tant que navigateur de niveau supérieur. Si ce n’est pas différent de zéro, le navigateur web est inscrit en tant que navigateur de niveau supérieur ; si zéro n’est pas un navigateur de niveau supérieur. La valeur par défaut est zéro.

Notes

Un navigateur de niveau supérieur est le navigateur défini dans le Registre comme navigateur par défaut.

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::SetRegisterAsDropTarget

Appelez cette fonction membre pour définir une valeur indiquant si le contrôle WebBrowser est inscrit en tant que cible de déplacement pour la navigation.

void SetRegisterAsDropTarget(BOOL bNewValue);

Paramètres

bNewValue
Détermine si le contrôle WebBrowser est inscrit en tant que cible de déplacement pour la navigation. Si ce n’est pas différent de zéro, l’objet est inscrit en tant que cible de suppression ; si zéro, ce n’est pas une cible de suppression.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::SetSilent

Appelez cette fonction membre pour définir une valeur indiquant si des boîtes de dialogue peuvent être affichées.

void SetSilent(BOOL bNewValue);

Paramètres

bNewValue
Si ce n’est pas différent de zéro, les boîtes de dialogue ne sont pas affichées ; si zéro, les boîtes de dialogue sont affichées. La valeur par défaut est zéro.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::SetStatusBar

Appelez cette fonction membre pour afficher la barre d’état.

void SetStatusBar(BOOL bNewValue);

Paramètres

bNewValue
Différent de zéro si la barre d’état est visible ; sinon zéro.

Notes

S’applique à Internet Explorer. Si vous utilisez cet appel avec un contrôle WebBrowser, il ne retourne aucune erreur, mais il ignore cet appel.

CHtmlView::SetTheaterMode

Appelez cette fonction membre pour définir une valeur indiquant si le contrôle WebBrowser est en mode théâtre.

void SetTheaterMode(BOOL bNewValue);

Paramètres

bNewValue
Non zéro pour définir le contrôle WebBrowser sur le mode théâtre ; sinon zéro. La valeur par défaut est zéro.

Notes

Lorsque le navigateur web est en mode théâtre, la fenêtre principale du navigateur remplit l’écran entier, une barre d’outils avec un ensemble minimal d’outils de navigation s’affiche et la barre d’état apparaît dans le coin supérieur droit de l’écran.

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::SetToolBar

Appelez cette fonction membre pour afficher ou masquer la barre d’outils Internet Explorer.

void SetToolBar(int nNewValue);

Paramètres

nNewValue
Indique s’il faut afficher la barre d’outils. Différent de zéro si la barre d’outils doit être affichée ; sinon zéro.

Notes

S’applique à Internet Explorer. Si vous utilisez cet appel avec un contrôle WebBrowser, il ne retourne aucune erreur, mais il ignore cet appel.

CHtmlView::SetTop

Appelez cette fonction membre pour définir la distance entre le bord supérieur interne du contrôle WebBrowser et le bord supérieur de son conteneur

void SetTop(long nNewValue);

Paramètres

nNewValue
Coordonnée de l’écran du bord supérieur de la fenêtre principale.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::SetVisible

Appelez cette fonction membre pour définir l’état de visibilité du contrôle WebBrowser.

void SetVisible(BOOL bNewValue);

Paramètres

bNewValue
Différent de zéro si le contrôle est visible ; sinon zéro.

Notes

S’applique à Internet Explorer et à WebBrowser.

CHtmlView::SetWidth

Définit la largeur de la fenêtre principale d’Internet Explorer.

void SetWidth(long nNewValue);

Paramètres

nNewValue
Largeur, en pixels, de la fenêtre principale d’Internet Explorer.

CHtmlView::Stop

Appelez cette fonction membre pour annuler toute opération de navigation ou de téléchargement en attente et arrêter tous les éléments de page dynamiques, tels que les sons d’arrière-plan et les animations.

void Stop();

Notes

S’applique à Internet Explorer et à WebBrowser.

Voir aussi

Exemple MFC MFCIE
CFormView, classe
Graphique hiérarchique
IWebBrowser2