Classe CHtmlView

Fornisce la funzionalità del controllo WebBrowser nel contesto dell'architettura documento/visualizzazione di MFC.

Sintassi

class CHtmlView : public CFormView

Membri

Metodi pubblici

Nome	Descrizione
CHtmlView::Create	Crea il controllo WebBrowser.
CHtmlView::CreateControlSite	Overridable usato per creare un'istanza del sito del controllo per ospitare un controllo nel form.
CHtmlView::ExecFormsCommand	Esegue il comando specificato usando il metodo IOleCommandTarget::Exec .
CHtmlView::ExecWB	Esegue un comando.
CHtmlView::GetAddressBar	Determina se la barra degli indirizzi dell'oggetto Internet Explorer è visibile. Il controllo WebBrowser viene ignorato; solo Internet Explorer.
CHtmlView::GetApplication	Recupera un oggetto applicazione che rappresenta l'applicazione contenente l'istanza corrente dell'applicazione Internet Explorer.
CHtmlView::GetBusy	Recupera un valore che indica se è ancora in corso un download o un'altra attività.
CHtmlView::GetContainer	Recupera il contenitore del controllo WebBrowser.
CHtmlView::GetFullName	Recupera il nome completo, incluso il percorso, della risorsa visualizzata nel Web browser. Il controllo WebBrowser viene ignorato; solo Internet Explorer.
CHtmlView::GetFullScreen	Indica se il controllo WebBrowser opera in modalità a schermo intero o in modalità normale.
CHtmlView::GetHeight	Recupera l'altezza della finestra principale di Internet Explorer.
CHtmlView::GetHtmlDocument	Recupera il documento HTML attivo.
CHtmlView::GetLeft	Recupera le coordinate dello schermo del bordo sinistro della finestra principale di Internet Explorer.
CHtmlView::GetLocationName	Recupera il nome della risorsa che è attualmente visualizzata in WebBrowser
CHtmlView::GetLocationURL	Recupera l'URL della risorsa che è attualmente visualizzata in WebBrowser.
CHtmlView::GetMenuBar	Recupera un valore che determina se la barra dei menu è visibile.
CHtmlView::GetOffline	Recupera un valore che determina se il controllo è offline.
CHtmlView::GetParentBrowser	Recupera un puntatore all'interfaccia IDispatch . Per altre informazioni, vedere Implementazione dell'interfacciaIDispatch.
CHtmlView::GetProperty	Recupera il valore corrente di una proprietà associata all'oggetto specificato.
CHtmlView::GetReadyState	Recupera lo stato di pronto dell'oggetto del Web browser.
CHtmlView::GetRegisterAsBrowser	Indica se il controllo WebBrowser viene registrato come browser di livello superiore per la risoluzione dei nomi di destinazione.
CHtmlView::GetRegisterAsDropTarget	Indica se il controllo WebBrowser viene registrato come destinazione di rilascio per la navigazione.
CHtmlView::GetSilent	Indica se è possibile visualizzare qualsiasi finestra di dialogo.
CHtmlView::GetSource	Il codice sorgente HTML della pagina Web.
CHtmlView::GetStatusBar	Indica se la barra di stato di Internet Explorer è visibile. Il controllo WebBrowser viene ignorato; solo Internet Explorer.
CHtmlView::GetTheaterMode	Indica se il controllo WebBrowser è in modalità schermo intero.
CHtmlView::GetToolBar	Recupera un valore che determina se la barra degli strumenti è visibile.
CHtmlView::GetTop	Recupera le coordinate dello schermo del bordo destro della finestra principale di Internet Explorer.
CHtmlView::GetTopLevelContainer	Recupera un valore che indica se l'oggetto corrente è il contenitore di livello superiore del controllo WebBrowser.
CHtmlView::GetType	Recupera il nome del tipo dell'oggetto documento.
CHtmlView::GetVisible	Recupera un valore che indica se l'oggetto è visibile o nascosto.
CHtmlView::GetWidth	Recupera la larghezza della finestra principale di Internet Explorer.
CHtmlView::GoBack	Passa all'elemento precedente nell'elenco di cronologia.
CHtmlView::GoForward	Passa all'elemento successivo nell'elenco di cronologia.
CHtmlView::GoHome	Consente di passare alla home page o alla pagina iniziale corrente.
CHtmlView::GoSearch	Passa alla pagina di ricerca corrente.
CHtmlView::LoadFromResource	Carica una risorsa nel controllo WebBrowser.
CHtmlView::Navigate	Passa alla risorsa identificata da un URL.
CHtmlView::Navigate2	Passa alla risorsa identificata da un URL o al file identificato da un percorso completo.
CHtmlView::OnBeforeNavigate2	Chiamato prima che si verifichi un'operazione di navigazione nel webBrowser specificato (in un elemento window o frameset).
CHtmlView::OnCommandStateChange	Chiamata eseguita per notificare a un'applicazione che lo stato di abilitazione di un comando del Web browser è cambiato.
CHtmlView::OnDocumentComplete	Chiamata eseguita per notificare a un'applicazione che un documento ha raggiunto lo stato READYSTATE_COMPLETE .
CHtmlView::OnDocWindowActivate	Chiamato dall'implementazione di Internet Explorer o MSHTML di IOleInPlaceActiveObject::OnDocWindowActivate, che notifica all'oggetto sul posto attivo quando la finestra del documento del contenitore viene attivata o disattivata.
CHtmlView::OnDownloadBegin	Chiamata eseguita per notificare a un'applicazione l'inizio di un'operazione di navigazione.
CHtmlView::OnDownloadComplete	Chiamata eseguita quando un'operazione di navigazione termina, viene bloccata o ha esito negativo.
CHtmlView::OnEnableModeless	Chiamata eseguita per abilitare o disabilitare le finestre di dialogo non modali quando un contenitore crea o elimina una finestra di dialogo modale.
CHtmlView::OnFilterDataObject	Chiamata eseguita sull'host da Internet Explorer o MSHTML per consentire all'host di sostituire l'oggetto dati di Internet Explorer o MSHTML.
CHtmlView::OnFrameWindowActivate	Viene chiamato da IOleInPlaceActiveObject::OnFrameWindowActivate per notificare all'oggetto quando la finestra cornice di primo livello del contenitore viene attivata o disattivata.
CHtmlView::OnFullScreen	Chiamato quando la FullScreen proprietà è stata modificata.
CHtmlView::OnGetDropTarget	Chiamato da Internet Explorer o MSHTML quando viene usato come destinazione di rilascio per consentire all'host di fornire un'alternativa IDropTarget.
CHtmlView::OnGetExternal	Chiamata eseguita da Internet Explorer o MSHTML per ottenere l'interfaccia dell'host IDispatch .
CHtmlView::OnGetHostInfo	Recupera le funzionalità dell'interfaccia utente dell'host di Internet Explorer o MSHTML.
CHtmlView::OnGetOptionKeyPath	Restituisce la chiave del Registro di sistema in cui Internet Explorer o MSHTML archivia le preferenze dell'utente.
CHtmlView::OnHideUI	Chiamata eseguita quando Internet Explorer o MSHTML rimuove i menu e le barre degli strumenti.
CHtmlView::OnMenuBar	Chiamato quando la MenuBar proprietà è stata modificata.
CHtmlView::OnNavigateComplete2	Chiamato dopo il completamento dello spostamento a un collegamento ipertestuale (in un elemento window o frameset).
CHtmlView::OnNavigateError	Chiamata eseguita dal framework in caso di errore di un collegamento ipertestuale.
CHtmlView::OnNewWindow2	Chiamata eseguita quando occorre creare una nuova finestra per visualizzare una risorsa.
CHtmlView::OnProgressChange	Chiamata eseguita per notificare a un'applicazione che lo stato di avanzamento di un'operazione di download è stato aggiornato.
CHtmlView::OnPropertyChange	Chiamato per notificare a un'applicazione che il PutProperty metodo ha modificato il valore di una proprietà.
CHtmlView::OnQuit	Chiamata eseguita per notificare a un'applicazione che l'applicazione Internet Explorer è pronta per essere chiusa (si applica solo a Internet Explorer).
CHtmlView::OnResizeBorder	Chiamato dall'implementazione di Internet Explorer o MSHTML di IOleInPlaceActiveObject::ResizeBorder, che avvisa l'oggetto che deve ridimensionare lo spazio del bordo.
CHtmlView::OnShowContextMenu	Chiamato da Internet Explorer o MSHTML quando sta per visualizzare il relativo menu di scelta rapida.
CHtmlView::OnShowUI	Chiamata eseguita prima che Internet Explorer o MSHTML visualizzi i menu e le barre degli strumenti.
CHtmlView::OnStatusBar	Chiamato quando la StatusBar proprietà è stata modificata.
CHtmlView::OnStatusTextChange	Chiamata eseguita per notificare a un'applicazione che il testo della barra di stato associata al controllo WebBrowser è cambiato.
CHtmlView::OnTheaterMode	Chiamato quando la TheaterMode proprietà è stata modificata.
CHtmlView::OnTitleChange	Chiamata eseguita per notificare a un'applicazione che il titolo di un documento nel controllo WebBrowser diviene disponibile o cambia.
CHtmlView::OnToolBar	Chiamato quando la ToolBar proprietà è stata modificata.
CHtmlView::OnTranslateAccelerator	Chiamato da Internet Explorer o MSHTML quando IOleInPlaceActiveObject::TranslateAccelerator o IOleControlSite::TranslateAccelerator viene chiamato per elaborare i messaggi di tasti di scelta rapida del menu dalla coda dei messaggi del contenitore.
CHtmlView::OnTranslateUrl	Chiamata eseguita da Internet Explorer o MSHTML per consentire all'host la possibilità di modificare l'URL che deve essere caricato.
CHtmlView::OnUpdateUI	Notifica all'host che lo stato del comando è stato modificato.
CHtmlView::OnVisible	Chiamata eseguita quando la finestra del controllo WebBrowser deve essere mostrata o nascosta.
CHtmlView::PutProperty	Imposta il valore di una proprietà associata all'oggetto specificato.
CHtmlView::QueryFormsCommand	Query per lo stato di uno o più comandi generati dagli eventi dell'interfaccia utente.
CHtmlView::QueryStatusWB	Esegue la query dello stato di un comando elaborato dal controllo WebBrowser.
CHtmlView::Refresh	Ricarica il file corrente.
CHtmlView::Refresh2	Ricarica il file corrente e, facoltativamente, impedisce l'invio dell'intestazione pragma:nocache .
CHtmlView::SetAddressBar	Mostra o nasconde la barra degli indirizzi dell'oggetto Internet Explorer. Il controllo WebBrowser viene ignorato; solo Internet Explorer.
CHtmlView::SetFullScreen	Imposta un valore per determinare se il controllo opera in modalità a schermo intero o in modalità normale. Il controllo WebBrowser viene ignorato; solo Internet Explorer.
CHtmlView::SetHeight	Imposta l'altezza della finestra principale di Internet Explorer.
CHtmlView::SetLeft	Imposta la posizione orizzontale della finestra principale di Internet Explorer.
CHtmlView::SetMenuBar	Imposta un valore per determinare se la barra dei menu del controllo è visibile. Il controllo WebBrowser viene ignorato; solo Internet Explorer.
CHtmlView::SetOffline	Imposta un valore per determinare se il controllo è offline.
CHtmlView::SetRegisterAsBrowser	Imposta un valore che indica se il controllo WebBrowser viene registrato come browser di livello superiore per la risoluzione dei nomi di destinazione.
CHtmlView::SetRegisterAsDropTarget	Imposta un valore che indica se il controllo WebBrowser viene registrato come destinazione di rilascio per la navigazione.
CHtmlView::SetSilent	Imposta un valore per determinare se il controllo consente di visualizzare finestre di dialogo.
CHtmlView::SetStatusBar	Imposta un valore per determinare se la barra di stato di Internet Explorer è visibile. Il controllo WebBrowser viene ignorato; solo Internet Explorer.
CHtmlView::SetTheaterMode	Imposta un valore che indica se il controllo WebBrowser è in modalità schermo intero.
CHtmlView::SetToolBar	Imposta un valore per determinare se la barra degli strumenti del controllo è visibile. Il controllo WebBrowser viene ignorato; solo Internet Explorer.
CHtmlView::SetTop	Imposta la posizione verticale della finestra principale di Internet Explorer.
CHtmlView::SetVisible	Imposta un valore che indica se l'oggetto è visibile o nascosto.
CHtmlView::SetWidth	Imposta la larghezza della finestra principale di Internet Explorer.
CHtmlView::Stop	Interrompe l'apertura di un file.

Osservazioni:

Il controllo WebBrowser è una finestra in cui l'utente può esplorare i siti nel World Wide Web e le cartelle nel file system locale e in una rete. Il controllo WebBrowser supporta collegamenti ipertestuali, la navigazione con URL (Uniform Resource Locator) e conserva un elenco di cronologia.

Uso della CHtmlView classe in un'applicazione MFC

Nell'applicazione framework MFC standard (basata su SDI o MDI) l'oggetto visualizzazione deriva comunemente da un set di classi specializzato. Queste classi, tutte derivate da CView, offrono funzionalità specializzate oltre a quelle fornite da CView.

Basando la classe visualizzazione dell'applicazione su CHtmlView fornisce la visualizzazione con il controllo WebBrowser. Ciò rende effettivamente l'applicazione un Web browser. Il metodo preferito per creare un'applicazione di tipo Web browser consiste nell'usare la Creazione guidata applicazione MFC e specificare CHtmlView come classe visualizzazione. Per altre informazioni sull'implementazione e sull'uso del controllo WebBrowser all'interno delle applicazioni MFC, vedere Creazione di un'applicazione MFC di tipo Web browser.

Nota

Il controllo ActiveX WebBrowser (e quindi CHtmlView) è disponibile solo per i programmi in esecuzione in Windows NT 4.0 o versioni successive, in cui è installato Internet Explorer 4.0 o versione successiva.

CHtmlView è progettato per le applicazioni che accedono al Web (e/o documenti HTML). Le funzioni membro CHtmlView seguenti sono relative solo all'applicazione Internet Explorer. Queste funzioni avranno esito positivo nel controllo WebBrowser, ma non avranno alcun effetto visibile.

• GetAddressBar
• GetFullName
• GetStatusBar
• SetAddressBar
• SetFullScreen
• SetMenuBar
• SetStatusBar
• SetToolBar

Gerarchia di ereditarietà

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

Requisiti

Intestazione: afxhtml.h

CHtmlView::Create

Chiamare questa funzione membro per creare un controllo WebBrowser o un contenitore per l'eseguibile di Internet Explorer.

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

Parametri

lpszClassName
Punta a una stringa di caratteri con terminazione Null che denomina la classe Windows. Il nome della classe può essere qualsiasi nome registrato con la AfxRegisterWndClass funzione globale o la RegisterClass funzione Windows. Se NULL, usa gli attributi predefiniti CFrameWnd .

lpszWindowName
Punta a una stringa di caratteri con terminazione Null che rappresenta il nome della finestra.

dwStyle
Specifica gli attributi dello stile della finestra. Per impostazione predefinita, gli WS_VISIBLE stili e WS_CHILD Windows sono impostati.

rect
Riferimento a una RECT struttura che specifica le dimensioni e la posizione della finestra. Il rectDefault valore consente a Windows di specificare le dimensioni e la posizione della nuova finestra.

pParentWnd
Puntatore alla finestra padre del controllo.

nID
Numero ID della visualizzazione. Per impostazione predefinita, impostare su AFX_IDW_PANE_FIRST.

pContext
Puntatore a un oggetto CCreateContext. NULL per impostazione predefinita.

CHtmlView::CreateControlSite

Overridable usato per creare un'istanza del sito del controllo per ospitare un controllo nel form.

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

Parametri

pContainer
Puntatore a un COleControlContainer oggetto contenente il controllo .

ppSite
Puntatore a un puntatore a un COleControlSite oggetto, fornendo il sito per il controllo.

nID
Identificatore del controllo da ospitare.

clsid
CLSID del controllo da ospitare

Valore restituito

Restituisce TRUE in caso di esito positivo, FALSE in caso di errore.

Osservazioni:

È possibile eseguire l'override di questa funzione membro per restituire un'istanza della classe del sito di controllo personalizzata.

CHtmlView::ExecFormsCommand

Esegue il comando specificato usando il metodo IOleCommandTarget::Exec .

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

Parametri

dwCommandID
Comando da eseguire. Questo comando deve appartenere al CMDSETID3_Forms3 gruppo.

pVarIn
Puntatore a una VARIANT struttura contenente argomenti di input. Può essere NULL.

pVarOut
Puntatore a una VARIANT struttura per ricevere l'output del comando. Può essere NULL.

Valore restituito

Un valore HRESULT standard. Per un elenco completo dei valori possibili, vedere IOleCommandTarget::Exec in Windows SDK.

Osservazioni:

ExecFormsCommand implementa il comportamento del IOleCommandTarget::Exec metodo .

CHtmlView::ExecWB

Chiamare questa funzione membro per eseguire un comando in WebBrowser o Internet Explorer.

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

Parametri

cmdID
Comando da eseguire.

cmdexecopt
Opzioni impostate per l'esecuzione del comando.

pvaIn
Variante utilizzata per specificare gli argomenti di input del comando.

pvaOut
Variante utilizzata per specificare gli argomenti di output dei comandi.

Osservazioni:

Vedere IWebBrowser2::ExecWB in Windows SDK.

CHtmlView::GetAddressBar

Chiamare questa funzione membro per recuperare la barra degli indirizzi di Internet Explorer.

BOOL GetAddressBar() const;

Valore restituito

Diverso da zero se la barra degli indirizzi è visibile; in caso contrario, zero.

Osservazioni:

Si applica a Internet Explorer. Se si utilizza questa chiamata con un controllo WebBrowser, non verrà restituito alcun errore, ma questa chiamata verrà ignorata.

CHtmlView::GetApplication

Chiamare questa funzione membro per recuperare l'oggetto di automazione supportato dall'applicazione che contiene il controllo WebBrowser.

LPDISPATCH GetApplication() const;

Valore restituito

Puntatore all'interfaccia IDispatch dell'oggetto documento attivo. Per altre informazioni, vedere Implementazione dell'interfacciaIDispatch.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetBusy

Chiamare questa funzione membro per determinare se il controllo WebBrowser è impegnato in un'operazione di navigazione o download.

BOOL GetBusy() const;

Valore restituito

Diverso da zero se il Web browser è occupato; in caso contrario, zero.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetContainer

Chiamare questa funzione membro per recuperare un oggetto che restituisce il contenitore del Web browser.

LPDISPATCH GetContainer() const;

Valore restituito

Puntatore all'interfaccia IDispatch dell'oggetto documento attivo.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetFullName

Chiamare questa funzione membro per recuperare il percorso completo del file attualmente visualizzato da Internet Explorer.

CString GetFullName() const;

Valore restituito

Oggetto CString contenente il percorso e il nome del file attualmente visualizzato. Se non esiste alcun percorso e nome file, GetFullName restituisce un oggetto vuoto CString.

Osservazioni:

Si applica a Internet Explorer. Se si utilizza questa chiamata con un controllo WebBrowser, non verrà restituito alcun errore, ma questa chiamata verrà ignorata.

CHtmlView::GetFullScreen

Chiamare questa funzione membro per determinare se il controllo WebBrowser funziona in modalità schermo intero o in modalità finestra normale.

BOOL GetFullScreen() const;

Valore restituito

Diverso da zero se WebBrowser funziona in modalità schermo intero; in caso contrario, zero.

Osservazioni:

In modalità schermo intero, la finestra principale di Internet Explorer è ingrandita e la barra di stato, la barra degli strumenti, la barra dei menu e la barra del titolo sono nascoste.

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetHeight

Chiamare questa funzione membro per recuperare l'altezza, in pixel, della finestra cornice del controllo WebBrowser.

long GetHeight() const;

Valore restituito

Altezza della finestra cornice del controllo, espressa in pixel.

CHtmlView::GetHtmlDocument

Chiamare questa funzione membro per recuperare il documento HTML per il documento attivo.

LPDISPATCH GetHtmlDocument() const;

Valore restituito

Puntatore all'interfaccia IDispatch dell'oggetto documento attivo.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetLeft

Chiamare questa funzione membro per recuperare la distanza tra il bordo sinistro interno del controllo WebBrowser e il bordo sinistro del contenitore.

long GetLeft() const;

Valore restituito

Distanza del bordo sinistro, espressa in pixel.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetLocationName

Chiamare questa funzione membro per ottenere il nome della risorsa visualizzata in WebBrowser.

CString GetLocationName() const;

Valore restituito

Oggetto CString contenente il nome della risorsa attualmente visualizzata in WebBrowser.

Osservazioni:

Se la risorsa è una pagina HTML nel World Wide Web, il nome è il titolo di tale pagina. Se la risorsa è una cartella o un file nella rete o nel computer locale, il nome è il percorso UNC o completo della cartella o del file.

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetLocationURL

Chiamare questa funzione membro per recuperare l'URL della risorsa attualmente visualizzata dal controllo WebBrowser.

CString GetLocationURL() const;

Valore restituito

Oggetto CString contenente l'URL della risorsa attualmente visualizzata in WebBrowser.

Osservazioni:

Se la risorsa è una cartella o un file nella rete o nel computer locale, il nome è il percorso UNC o completo della cartella o del file.

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetMenuBar

Chiamare questa funzione membro per determinare se la barra dei menu è visibile.

BOOL GetMenuBar() const;

Valore restituito

Diverso da zero se la barra dei menu è visibile; in caso contrario, zero.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetOffline

Chiamare questa funzione membro per determinare se il Web browser funziona offline.

BOOL GetOffline() const;

Valore restituito

Diverso da zero se il Web browser è attualmente offline; in caso contrario, zero.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetParentBrowser

Chiamare questa funzione membro per recuperare un puntatore all'oggetto padre del controllo WebBrowser.

LPDISPATCH GetParentBrowser() const;

Valore restituito

Puntatore all'interfaccia IDispatch dell'oggetto padre del controllo WebBrowser.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetProperty

Chiamare questa funzione membro per ottenere il valore della proprietà attualmente associata al controllo .

BOOL GetProperty(
    LPCTSTR lpszProperty,
    CString& strValue);

COleVariant GetProperty(LPCTSTR lpszProperty);

Parametri

lpszProperty
Puntatore a una stringa contenente la proprietà da recuperare.

strValue
Riferimento a un CString oggetto che riceve il valore corrente della proprietà.

Valore restituito

Nella prima versione, diverso da zero se completato correttamente; in caso contrario, zero. Nella seconda versione, un COleVariant oggetto .

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetReadyState

Chiamare questa funzione membro per recuperare lo stato pronto dell'oggetto WebBrowser.

READYSTATE GetReadyState() const;

Valore restituito

Valore READYSTATE , come descritto in Windows SDK.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetRegisterAsBrowser

Chiamare questa funzione membro per determinare se l'oggetto WebBrowser è registrato come browser di primo livello per la risoluzione dei nomi di destinazione.

BOOL GetRegisterAsBrowser() const;

Valore restituito

Diverso da zero se il browser è registrato come browser di primo livello; in caso contrario, zero.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetRegisterAsDropTarget

Chiamare questa funzione membro per determinare se il controllo WebBrowser è registrato come destinazione di rilascio per la navigazione.

BOOL GetRegisterAsDropTarget() const;

Valore restituito

Diverso da zero se il browser è registrato come destinazione di rilascio; in caso contrario, zero.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetSilent

Chiamare questa funzione membro per determinare se le finestre di dialogo possono essere visualizzate nel controllo WebBrowser.

BOOL GetSilent() const;

Valore restituito

Diverso da zero se le finestre di dialogo non possono essere visualizzate dal controllo WebBrowser; in caso contrario, zero.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetSource

Chiamare questa funzione membro per recuperare il codice sorgente HTML per la pagina Web.

BOOL GetSource(CString& strRef);

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Parametri

refString
Oggetto CString che conterrà il codice sorgente.

Osservazioni:

Questa funzione equivale al comando "Visualizza origine" in Internet Explorer, ad eccezione del fatto che il codice sorgente viene restituito in un oggetto CString.

CHtmlView::GetStatusBar

Chiamare questa funzione membro per determinare se il controllo WebBrowser visualizza una barra di stato.

BOOL GetStatusBar() const;

Valore restituito

Diverso da zero se è possibile visualizzare la barra di stato; in caso contrario, zero.

Osservazioni:

Si applica a Internet Explorer. Se si utilizza questa chiamata con un controllo WebBrowser, non verrà restituito alcun errore, ma questa chiamata verrà ignorata.

CHtmlView::GetTheaterMode

Chiamare questa funzione membro per determinare se il Web browser è in modalità teatro.

BOOL GetTheaterMode() const;

Valore restituito

Diverso da zero se il Web browser è in modalità teatro; in caso contrario, zero.

Osservazioni:

Quando il Web browser è in modalità teatro, la finestra principale del browser riempie l'intera schermata, viene visualizzata una barra degli strumenti con un set minimo di strumenti di spostamento e la barra di stato viene visualizzata nell'angolo superiore destro dello schermo.

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetToolBar

Chiamare questa funzione membro per determinare se la barra degli strumenti è visibile.

int GetToolBar() const;

Valore restituito

Valore che indica se la barra degli strumenti è visibile. Diverso da zero se la barra degli strumenti è visibile; in caso contrario, zero.

CHtmlView::GetTop

Chiamare questa funzione membro per recuperare la coordinata dello schermo del bordo superiore della finestra principale del controllo WebBrowser.

long GetTop() const;

Valore restituito

Indirizzo di una variabile che riceve la coordinata dello schermo del bordo superiore della finestra principale.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetTopLevelContainer

Chiamare questa funzione membro per determinare se Internet Explorer è il contenitore di primo livello del controllo WebBrowser.

BOOL GetTopLevelContainer() const;

Valore restituito

Diverso da zero il contenitore è il contenitore di primo livello; in caso contrario, zero.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetType

Chiamare questa funzione membro per recuperare il nome del tipo del documento attivo contenuto.

CString GetType() const;

Valore restituito

Oggetto CString contenente il nome del tipo del documento attivo contenuto.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetVisible

Chiamare questa funzione membro per determinare se l'oggetto contenuto è visibile.

BOOL GetVisible() const;

Valore restituito

Diverso da zero se l'oggetto è visibile; in caso contrario, zero.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GetWidth

Recupera la larghezza della finestra principale di Internet Explorer.

long GetWidth() const;

Valore restituito

Larghezza corrente della finestra, in pixel.

CHtmlView::GoBack

Consente di spostarsi all'indietro di un elemento nell'elenco della cronologia.

void GoBack();

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GoForward

Sposta in avanti un elemento nell'elenco della cronologia.

void GoForward();

CHtmlView::GoHome

Passa alla home page o alla pagina iniziale corrente specificata nella finestra di dialogo Opzioni Internet di Internet Explorer o nella finestra di dialogo Proprietà Internet, accessibili dal Pannello di controllo.

void GoHome();

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::GoSearch

Passa alla pagina di ricerca corrente, come specificato nella finestra di dialogo Opzioni Internet di Internet Explorer o nella finestra di dialogo Proprietà Internet, a cui si accede dalla Pannello di controllo.

void GoSearch();

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::LoadFromResource

Chiamare questa funzione membro per caricare la risorsa specificata nel controllo WebBrowser.

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

Parametri

lpszResource
Puntatore a una stringa contenente il nome della risorsa da caricare.

nRes
ID del buffer contenente il nome della risorsa da caricare.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::Navigate

Chiamare questa funzione membro per passare alla risorsa identificata da un URL.

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

Parametri

URL
Stringa allocata dal chiamante che contiene l'URL a cui passare o il percorso completo del file da visualizzare.

dwFlags
Flag di una variabile che specifica se aggiungere la risorsa all'elenco di cronologia, se leggere o scrivere dalla cache e se visualizzare la risorsa in una nuova finestra. La variabile può essere una combinazione dei valori definiti dall'enumerazione BrowserNavConstants .

lpszTargetFrameName
Puntatore a una stringa contenente il nome del frame in cui visualizzare la risorsa.

lpszHeaders
Puntatore a un valore che specifica le intestazioni HTTP da inviare al server. Queste intestazioni vengono aggiunte alle intestazioni predefinite di Internet Explorer. Le intestazioni possono specificare elementi come l'azione richiesta del server, il tipo di dati passati al server o un codice di stato. Questo parametro viene ignorato se URL non è un URL HTTP.

lpvPostData
Puntatore ai dati da inviare con la transazione HTTP POST. Ad esempio, la transazione POST viene usata per inviare i dati raccolti da un modulo HTML. Se questo parametro non specifica alcun dato di post, Navigate genera una transazione HTTP GET. Questo parametro viene ignorato se URL non è un URL HTTP.

dwPostDataLen
Dati da inviare con la transazione HTTP POST. Ad esempio, la transazione POST viene usata per inviare i dati raccolti da un modulo HTML. Se questo parametro non specifica alcun dato di post, Navigate genera una transazione HTTP GET. Questo parametro viene ignorato se URL non è un URL HTTP.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::Navigate2

Chiamare questa funzione membro per passare alla risorsa identificata da un URL o al file identificato da un percorso completo.

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

Parametri

pIDL
Puntatore a una ITEMIDLIST struttura.

dwFlags
Flag di una variabile che specifica se aggiungere la risorsa all'elenco di cronologia, se leggere o scrivere dalla cache e se visualizzare la risorsa in una nuova finestra. La variabile può essere una combinazione dei valori definiti dall'enumerazione BrowserNavConstants .

lpszTargetFrameName
Puntatore a una stringa contenente il nome del frame in cui visualizzare la risorsa.

lpszURL
Puntatore a una stringa contenente l'URL.

lpvPostData
Dati da inviare con la transazione HTTP POST. Ad esempio, la transazione POST viene usata per inviare i dati raccolti da un modulo HTML. Se questo parametro non specifica alcun dato di post, Navigate2 genera una transazione HTTP GET. Questo parametro viene ignorato se URL non è un URL HTTP o HTTPS.

dwPostDataLen
Lunghezza in byte dei dati a cui punta il lpvPostData parametro .

lpszHeaders
Puntatore a un valore che specifica le intestazioni HTTP o HTTPS da inviare al server. Queste intestazioni vengono aggiunte alle intestazioni predefinite di Internet Explorer. Le intestazioni possono specificare elementi come l'azione richiesta del server, il tipo di dati passati al server o un codice di stato. Questo parametro viene ignorato se URL non è un URL HTTP o HTTPS.

baPostedData
Riferimento a un oggetto CByteArray.

Osservazioni:

Questa funzione membro estende la funzione membro supportando l'esplorazione Navigate in cartelle speciali, ad esempio Desktop e Computer personale, rappresentate dal parametro pIDL.

Si applica a WebBrowser e Internet Explorer.

Esempio

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

CHtmlView::OnBeforeNavigate2

Questa funzione membro viene chiamata dal framework per generare un evento prima che si verifichi un'operazione di spostamento nel Web browser.

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

Parametri

lpszURL
Puntatore a una stringa contenente l'URL a cui passare.

nFlags
Riservato a un uso futuro.

lpszTargetFrameName
Stringa che contiene il nome del frame in cui visualizzare la risorsa o NULL se non è stato assegnato alcun frame denominato per la risorsa.

baPostedData
Riferimento a un CByteArray oggetto contenente i dati da inviare al server se viene utilizzata la transazione HTTP POST.

lpszHeaders
Puntatore a una stringa contenente altre intestazioni HTTP da inviare al server (solo URL HTTP). Le intestazioni possono specificare elementi come l'azione richiesta del server, il tipo di dati passati al server o un codice di stato.

pbCancel
Puntatore a un flag di annullamento. Un'applicazione può impostare questo parametro su diverso da zero per annullare l'operazione di spostamento o su zero per consentirgli di continuare.

CHtmlView::OnCommandStateChange

Questa funzione membro viene chiamata dal framework per notificare a un'applicazione che lo stato abilitato di un comando del Web browser è stato modificato.

virtual void OnCommandStateChange(
    long nCommand,
    BOOL bEnable);

Parametri

nCommand
Identificatore del comando il cui stato abilitato è stato modificato.

bEnable
Stato abilitato. Questo parametro è diverso da zero se il comando è abilitato o zero se è disabilitato.

CHtmlView::OnDocumentComplete

Questa funzione membro viene chiamata dal framework per notificare a un'applicazione che un documento ha raggiunto lo READYSTATE_COMPLETE stato.

virtual void OnDocumentComplete(LPCTSTR lpszURL);

Parametri

lpszURL
Puntatore a una stringa che restituisce l'URL, il nome file UNC o un PIDL (un puntatore a un elenco di identificatori di elemento) a cui è stato eseguito lo spostamento.

Osservazioni:

Non tutti i fotogrammi generano questo evento, ma ogni fotogramma che genera un OnDownloadBegin evento genererà un evento corrispondente OnDocumentComplete .

L'URL indicato da lpszURL può essere diverso dall'URL a cui è stato indicato al browser di passare, perché questo URL è l'URL canonizzato e qualificato. Ad esempio, se un'applicazione specifica un URL di "www.microsoft.com" in una chiamata a Navigate o Navigate2, l'URL passato da OnNavigateComplete2 sarà "<https://www.microsoft.com/>". Inoltre, se il server ha reindirizzato il browser a un URL diverso, l'URL reindirizzato verrà riflesso qui.

CHtmlView::OnDocWindowActivate

Chiamato dall'implementazione di Internet Explorer o MSHTML di IOleInPlaceActiveObject::OnDocWindowActivate, che notifica all'oggetto sul posto attivo quando la finestra del documento del contenitore viene attivata o disattivata.

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

Parametri

fActivate
Indica lo stato della finestra del documento. Se questo valore è diverso da zero, la finestra verrà attivata. Se questo valore è zero, la finestra verrà disattivata.

Valore restituito

S_OK in caso di esito positivo o codice di errore definito da OLE in caso contrario.

Osservazioni:

Eseguire l'override OnDocWindowActivate OnDocWindowActivate per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::OnDocWindowActivate in Windows SDK.

CHtmlView::OnDownloadBegin

Questa funzione membro viene chiamata dal framework per iniziare a scaricare un documento.

virtual void OnDownloadBegin();

Osservazioni:

Questo evento viene generato poco dopo l'evento OnBeforeNavigate2 , a meno che la navigazione non venga annullata. Qualsiasi animazione o "occupato" indica che il contenitore deve essere connesso a questo evento.

CHtmlView::OnDownloadComplete

Questa funzione membro viene chiamata dal framework per indicare che un'operazione di spostamento è stata completata, è stata interrotta o non è riuscita.

virtual void OnDownloadComplete();

CHtmlView::OnEnableModeless

Chiamato quando Internet Explorer o MSHTML visualizza l'interfaccia utente modale.

virtual HRESULT OnEnableModeless(BOOL fEnable);

Parametri

fEnable
Indica se le finestre di dialogo modeless dell'host sono abilitate o disabilitate. Se questo valore è diverso da zero, le finestre di dialogo senza modalità sono abilitate. Se questo valore è zero, le finestre di dialogo senza modalità sono disabilitate.

Valore restituito

S_OK in caso di esito positivo o codice di errore definito da OLE in caso contrario.

Osservazioni:

Abilita o disabilita le finestre di dialogo senza modalità quando il contenitore crea o elimina definitivamente una finestra di dialogo modale. Eseguire l'override OnEnableModeless EnableModeless per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::EnableModeless in Windows SDK.

CHtmlView::OnFilterDataObject

Chiamata eseguita sull'host da Internet Explorer o MSHTML per consentire all'host di sostituire l'oggetto dati di Internet Explorer o MSHTML.

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

Parametri

pDataObject
Indirizzo dell'interfaccia IDataObject fornita da Internet Explorer o MSHTML.

ppDataObject
Indirizzo che riceve il puntatore all'interfaccia IDataObject fornito dall'host. Il contenuto di questo parametro deve essere sempre inizializzato in NULL, anche se il metodo non riesce.

Valore restituito

S_OK se l'oggetto dati viene sostituito, S_FALSE se l'oggetto dati non viene sostituito o un codice di errore definito da OLE se si verifica un errore.

Osservazioni:

Eseguire l'override OnFilterDataObject FilterDataObject per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::FilterDataObject in Windows SDK.

CHtmlView::OnFrameWindowActivate

Viene chiamato da IOleInPlaceActiveObject::OnFrameWindowActivate per notificare all'oggetto quando la finestra cornice di primo livello del contenitore viene attivata o disattivata.

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

Parametri

fActivate
Indica lo stato della finestra cornice di primo livello del contenitore. Se questo valore è diverso da zero, la finestra verrà attivata. Se questo valore è zero, la finestra verrà disattivata.

Valore restituito

S_OK in caso di esito positivo o codice di errore definito da OLE in caso contrario.

Osservazioni:

Eseguire l'override OnFrameWindowActivate OnFrameWindowActivate per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::OnFrameWindowActivate in Windows SDK.

CHtmlView::OnFullScreen

Questa funzione membro viene chiamata dal framework quando la FullScreen proprietà è stata modificata.

virtual void OnFullScreen(BOOL bFullScreen);

Parametri

bFullScreen
Diverso da zero se Internet Explorer è in modalità schermo intero; zero in caso contrario.

CHtmlView::OnGetDropTarget

Chiamato da Internet Explorer o MSHTML quando viene usato come destinazione di rilascio per consentire all'host di fornire un'alternativa IDropTarget.

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

Parametri

pDropTarget
IDropTarget Internet Explorer o MSHTML propone l'uso.

ppDropTarget
Indirizzo dell'oggetto IDropTarget che riceve il puntatore dell'interfaccia IDropTarget che l'host vuole fornire.

Valore restituito

Per un elenco dei codici restituiti, vedere IDocHostUIHandler::GetDropTarget in Windows SDK.

Osservazioni:

Eseguire l'override OnGetDropTarget GetDropTarget per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::GetDropTarget in Windows SDK.

CHtmlView::OnGetExternal

Chiamata eseguita da Internet Explorer o MSHTML per ottenere l'interfaccia dell'host IDispatch .

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

Parametri

lppDispatch
Puntatore all'indirizzo che riceve il IDispatch puntatore dell'interfaccia dell'applicazione host. Se l'host espone un'interfaccia di automazione, può fornire un riferimento a Internet Explorer o MSHTML tramite questo parametro. Il contenuto di questo parametro deve essere sempre inizializzato in NULL, anche se il metodo non riesce.

Valore restituito

S_OK in caso di esito positivo o codice di errore definito da OLE in caso contrario.

Osservazioni:

Eseguire l'override OnGetExternal GetExternal per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::GetExternal in Windows SDK.

CHtmlView::OnGetHostInfo

Recupera le funzionalità dell'interfaccia utente dell'host di Internet Explorer o MSHTML.

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

Parametri

pInfo
Indirizzo di una DOCHOSTUIINFO struttura che riceve le funzionalità dell'interfaccia utente dell'host.

Valore restituito

S_OK in caso di esito positivo o codice di errore definito da OLE in caso contrario.

Osservazioni:

Eseguire l'override OnGetHostInfo GetHostInfo per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::GetHostInfo in Windows SDK.

CHtmlView::OnGetOptionKeyPath

Chiamare questa funzione membro per ottenere la chiave del Registro di sistema in cui Internet Explorer o MSHTML archivia le preferenze utente.

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

Parametri

pchKey
Indirizzo di un oggetto LPOLESTR che riceve la stringa della sottochiave del Registro di sistema in cui l'host archivia le opzioni predefinite. Questa sottochiave sarà sotto la HKEY_CURRENT_USER chiave. Allocare questa memoria usando CoTaskMemAlloc. L'applicazione chiamante è responsabile della liberazione di questa memoria tramite CoTaskMemFree. Questo parametro deve essere sempre inizializzato in NULL, anche se il metodo ha esito negativo.

dwReserved
Riservato a un uso futuro. Non attualmente utilizzato.

Valore restituito

S_OK se ha esito positivo o S_FALSE in caso contrario. Se S_FALSE, Internet Explorer o MSHTML per impostazione predefinita avrà le proprie opzioni utente.

Osservazioni:

Eseguire l'override OnGetOptionKeyPath GetOptionKeyPath per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::GetOptionKeyPath in Windows SDK.

CHtmlView::OnHideUI

Questa funzione membro viene chiamata dal framework quando Internet Explorer o MSHTML rimuove i relativi menu e barre degli strumenti.

virtual HRESULT OnHideUI();

Valore restituito

S_OK in caso di esito positivo o codice di errore definito da OLE in caso contrario.

Osservazioni:

Eseguire l'override OnHideUI HideUI per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::HideUI in Windows SDK.

CHtmlView::OnMenuBar

Questa funzione membro viene chiamata dal framework quando la MenuBar proprietà è stata modificata.

virtual void OnMenuBar(BOOL bMenuBar);

Parametri

bMenuBar
Diverso da zero se la barra dei menu di Internet Explorer è visibile; zero in caso contrario.

CHtmlView::OnNavigateComplete2

Questa funzione membro viene chiamata dal framework dopo il completamento dello spostamento a un collegamento ipertestuale (in un elemento window o frameset).

virtual void OnNavigateComplete2(LPCTSTR strURL);

Parametri

strURL
Espressione stringa che restituisce l'URL, il nome file UNC o PIDL (un puntatore a un elenco di identificatori di elemento) a cui è stato eseguito lo spostamento.

Osservazioni:

Il parametro URL può essere un FILE PIDL se è presente un'entità spazio nome shell per la quale non è presente alcuna rappresentazione URL.

L'URL contenuto in strURL può essere diverso dall'URL a cui è stato indicato al browser di passare, perché questo URL è l'URL canonizzato e qualificato. Ad esempio, se un'applicazione specifica un URL di "www.microsoft.com" in una chiamata a Navigate o Navigate2, l'URL passato da OnNavigateComplete2 sarà "<https://www.microsoft.com/>". Inoltre, se il server ha reindirizzato il browser a un URL diverso, l'URL reindirizzato verrà riflesso qui.

CHtmlView::OnNavigateError

Chiamata eseguita dal framework in caso di errore di un collegamento ipertestuale.

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

Parametri

lpszURL
URL per il quale lo spostamento non è riuscito.

lpszFrame
Nome del frame in cui deve essere visualizzata la risorsa o NULL se non è stato assegnato alcun frame denominato per la risorsa.

dwError
Codice di stato dell'errore, se disponibile. Per un elenco dei codici di stato POSSIBILI HRESULT e HTTP, vedere NavigateError Codici di stato dell'evento.

pbCancel
Specifica se annullare la navigazione in una pagina di errore o in un'ulteriore ricerca automatica. Se TRUE (impostazione predefinita), continuare con lo spostamento a una pagina di errore o a una ricerca automatica; se FALSE, annullare la navigazione in una pagina di errore o ricerca automatica.

Osservazioni:

Eseguire l'override di questo metodo per fornire la gestione degli errori di spostamento personalizzata.

Per altre informazioni, vedere DWebBrowserEvents2::NavigateError.

CHtmlView::OnNewWindow2

Questa funzione membro viene chiamata dal framework quando deve essere creata una nuova finestra per la visualizzazione di una risorsa.

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

Parametri

ppDisp
Puntatore a un puntatore a un'interfaccia che, facoltativamente, riceve il puntatore dell'interfaccia IDispatch di un nuovo oggetto WebBrowser o Internet Explorer.

Cancel
Puntatore a un flag di annullamento. Un'applicazione può impostare questo parametro su diverso da zero per annullare l'operazione di spostamento o su zero per consentirgli di continuare.

Osservazioni:

Questo evento precede la creazione di una nuova finestra dall'interno di WebBrowser.

CHtmlView::OnProgressChange

Questa funzione membro viene chiamata dal framework per notificare a un'applicazione che lo stato di avanzamento di un'operazione di download è stato aggiornato.

virtual void OnProgressChange(
    long nProgress,
    long nProgressMax);

Parametri

nProgress
Quantità di avanzamento totale da visualizzare o -1 al termine dell'avanzamento.

nProgressMax
Valore di avanzamento massimo.

Osservazioni:

Il contenitore può usare le informazioni fornite da questo evento per visualizzare il numero di byte scaricati finora o per aggiornare un indicatore di stato.

CHtmlView::OnPropertyChange

Questa funzione membro viene chiamata dal framework per notificare a un'applicazione che PutProperty ha modificato il valore di una proprietà.

virtual void OnPropertyChange(LPCTSTR lpszProperty);

Parametri

lpszProperty
Puntatore a una stringa contenente il nome della proprietà.

CHtmlView::OnQuit

Questa funzione membro viene chiamata dal framework per notificare a un'applicazione che l'applicazione Internet Explorer è pronta per uscire.

virtual void OnQuit();

CHtmlView::OnResizeBorder

Chiamato dall'implementazione di Internet Explorer o MSHTML di IOleInPlaceActiveObject::ResizeBorder, che avvisa l'oggetto che deve ridimensionare lo spazio del bordo.

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

Parametri

prcBorder
Nuovo rettangolo esterno per lo spazio del bordo.

pUIWindow
Puntatore all'interfaccia per l'oggetto finestra cornice o documento il cui bordo è stato modificato.

fFrameWindow
TRUE se la finestra cornice chiama IOleInPlaceActiveObject::ResizeBorder, in caso contrario FALSE.

Valore restituito

S_OK in caso di esito positivo o codice di errore definito da OLE in caso contrario.

Osservazioni:

Eseguire l'override OnResizeBorder ResizeBorder per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::ResizeBorder in Windows SDK.

CHtmlView::OnShowContextMenu

Chiamato da Internet Explorer o MSHTML quando sta per visualizzare il relativo menu di scelta rapida.

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

Parametri

dwID
Identificatore del menu di scelta rapida da visualizzare. Per un elenco di valori, vedere IDocHostUIHandler::ShowContextMenu in Windows SDK.

ppt
Coordinate dello schermo per il menu.

pcmdtReserved
IOleCommandTarget interfaccia usata per eseguire query sullo stato dei comandi ed eseguire comandi su questo oggetto.

pdispReserved
IDispatch interfaccia dell'oggetto alle coordinate dello schermo. In questo modo un host può distinguere determinati oggetti per fornire un contesto più specifico.

Valore restituito

Per un elenco di valori, vedere IDocHostUIHandler::ShowContextMenu in Windows SDK.

Osservazioni:

Eseguire l'override OnShowContextMenu ShowContextMenu per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::ShowContextMenu in Windows SDK.

CHtmlView::OnShowUI

Chiamata eseguita prima che Internet Explorer o MSHTML visualizzi i menu e le barre degli strumenti.

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

Parametri

dwID
Riservato a un uso futuro.

pActiveObject
IOleInPlaceActiveObject interfaccia dell'oggetto attualmente attivo.

pCommandTarget
IOleCommandTarget interfaccia dell'oggetto .

pFrame
IOleInPlaceFrame interfaccia dell'oggetto . Questa operazione è necessaria per menu e barre degli strumenti.

pDoc
IOleInPlaceUIWindow interfaccia per l'oggetto . Questa operazione è necessaria per le barre degli strumenti.

Valore restituito

Per un elenco di valori, vedere IDocHostUIHandler::ShowUI in Windows SDK.

Osservazioni:

Eseguire l'override OnShowUI ShowUI per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::ShowUI in Windows SDK.

CHtmlView::OnStatusBar

Questa funzione membro viene chiamata dal framework quando la StatusBar proprietà è stata modificata.

virtual void OnStatusBar(BOOL bStatusBar);

Parametri

bStatusBar
Diverso da zero se la barra di stato di Internet Explorer è visibile o zero in caso contrario.

CHtmlView::OnStatusTextChange

Questa funzione membro viene chiamata dal framework per notificare a un'applicazione che il testo della barra di stato associato al controllo WebBrowser è stato modificato.

virtual void OnStatusTextChange(LPCTSTR lpszText);

Parametri

lpszText
Stringa contenente il nuovo testo della barra di stato.

CHtmlView::OnTheaterMode

Questa funzione membro viene chiamata dal framework quando la TheaterMode proprietà è stata modificata.

virtual void OnTheaterMode(BOOL bTheaterMode);

Parametri

bTheaterMode
Diverso da zero se Internet Explorer è in modalità teatro; zero in caso contrario.

CHtmlView::OnTitleChange

Questa funzione membro viene chiamata dal framework per notificare a un'applicazione se il titolo di un documento nel controllo WebBrowser diventa disponibile o cambia.

virtual void OnTitleChange(LPCTSTR lpszText);

Parametri

lpszText
Titolo del nuovo documento.

Osservazioni:

Per HTML, il titolo potrebbe cambiare; mentre il codice HTML è ancora in fase di download, l'URL del documento viene impostato come titolo. Dopo che il titolo reale (se presente) viene analizzato dal codice HTML, il titolo viene modificato in modo da riflettere il titolo effettivo.

CHtmlView::OnToolBar

Questa funzione membro viene chiamata dal framework quando la ToolBar proprietà è stata modificata.

virtual void OnToolBar(BOOL bToolBar);

Parametri

bToolBar
Diverso da zero se la barra degli strumenti di Internet Explorer è visibile o zero in caso contrario.

CHtmlView::OnTranslateAccelerator

Chiamato da Internet Explorer o MSHTML quando IOleInPlaceActiveObject::TranslateAccelerator o IOleControlSite::TranslateAccelerator viene chiamato per elaborare i messaggi di tasti di scelta rapida del menu dalla coda dei messaggi del contenitore.

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

Parametri

lpMsg
Punta al messaggio che potrebbe essere necessario tradurre.

pguidCmdGroup
Identificatore del gruppo di comandi.

nCmdID
Identificatore del comando.

Valore restituito

S_OK se ha esito positivo o S_FALSE in caso contrario.

Osservazioni:

Eseguire l'override OnTranslateAccelerator TranslateAccelerator per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::TranslateAccelerator in Windows SDK.

CHtmlView::OnTranslateUrl

Chiamata eseguita da Internet Explorer o MSHTML per consentire all'host la possibilità di modificare l'URL che deve essere caricato.

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

Parametri

dwTranslate
Riservato a un uso futuro.

pchURLIn
Indirizzo di una stringa fornita da Internet Explorer o MSHTML che rappresenta l'URL da tradurre.

ppchURLOut
Indirizzo di un puntatore stringa che riceve l'indirizzo dell'URL tradotto. L'host alloca il buffer usando l'allocatore di memoria dell'attività. Il contenuto di questo parametro deve essere sempre inizializzato in NULL, anche se l'URL non viene convertito o il metodo non riesce.

Valore restituito

S_OK se l'URL è stato convertito, S_FALSE se l'URL non è stato tradotto o un codice di errore definito da OLE se si è verificato un errore.

Osservazioni:

Eseguire l'override OnTranslateUrl TranslateUrl per reagire alla notifica dal controllo Microsoft Web Browser. Per altre informazioni, vedere IDocHostUIHandler::TranslateUrl in Windows SDK.

CHtmlView::OnUpdateUI

Notifica all'host che lo stato del comando è stato modificato.

virtual HRESULT OnUpdateUI();

Valore restituito

S_OK in caso di esito positivo o codice di errore definito da OLE in caso contrario.

Osservazioni:

L'host deve aggiornare lo stato dei pulsanti della barra degli strumenti. Questo metodo viene chiamato indipendentemente dal valore restituito da ShowUI. Eseguire l'override OnUpdateUI UpdateUI per reagire alla notifica dal controllo Microsoft Web Browser.

CHtmlView::OnVisible

Questa funzione membro viene chiamata dal framework quando la finestra per WebBrowser deve essere visualizzata o nascosta.

virtual void OnVisible(BOOL bVisible);

Parametri

bVisible
Diverso da zero se l'oggetto è visibile o zero in caso contrario.

Osservazioni:

In questo modo, la finestra host del controllo oggetto si comporta allo stesso modo in cui si comporta la finestra di Internet Explorer.

CHtmlView::PutProperty

Chiamare questa funzione membro per impostare la proprietà associata a un determinato oggetto.

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

Parametri

lpszProperty
Stringa contenente la proprietà da impostare.

vtValue
Nuovo valore della proprietà indicata da lpszProperty.

lpszPropertyName
Puntatore a una stringa contenente il nome della proprietà da impostare.

dValue
Nuovo valore della proprietà.

lValue
Nuovo valore della proprietà.

lpszValue
Puntatore a una stringa contenente il nuovo valore della proprietà.

nValue
Nuovo valore della proprietà.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::QueryFormsCommand

Query per lo stato di uno o più comandi generati dagli eventi dell'interfaccia utente.

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

Parametri

dwCommandID
Identificatore del comando sottoposto a query.

pbSupported
Puntatore a un oggetto BOOL che specifica se il comando (identificato da dwCommandID) è supportato. Se TRUE, il comando è supportato; in caso contrario FALSE, .

pbEnabled
Puntatore a un oggetto BOOL che specifica se il comando (identificato da dwCommandID) è abilitato. Se TRUE, il comando è supportato; in caso contrario FALSE, .

pbChecked
Puntatore a un oggetto BOOL che specifica se il comando (identificato da dwCommandID) è selezionato. Se TRUE, il comando è supportato; in caso contrario FALSE, .

Valore restituito

Un valore HRESULT standard. Per un elenco completo dei valori possibili, vedere IOleCommandTarget::QueryStatus in Windows SDK.

Osservazioni:

QueryFormsCommand implementa il comportamento del IOleCommandTarget::QueryStatus metodo .

CHtmlView::QueryStatusWB

Chiamare questa funzione membro per eseguire una query sullo stato di un comando.

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

Parametri

cmdID
Valore OLECMDID del comando per il quale il chiamante necessita di informazioni sullo stato.

Valore restituito

Indirizzo del OLECMDF valore che riceve lo stato del comando.

Osservazioni:

QueryStatusWB implementa il comportamento del IOleCommandTarget::QueryStatus metodo .

Si applica a WebBrowser e Internet Explorer.

CHtmlView::Refresh

Ricarica l'URL o il file attualmente visualizzato dal Web browser.

void Refresh();

Osservazioni:

Refresh non contiene parametri per l'impostazione del livello di aggiornamento.

Si applica a WebBrowser e Internet Explorer.

CHtmlView::Refresh2

Ricarica il file attualmente visualizzato da Internet Explorer.

void Refresh2(int nLevel);

Parametri

nLevel
Indirizzo della variabile che specifica il livello di aggiornamento. Le variabili possibili sono definite in RefreshConstants, in Windows SDK.

Osservazioni:

A differenza di Refresh, Refresh2 contiene un parametro che specifica il livello di aggiornamento.

Si applica a WebBrowser e Internet Explorer.

CHtmlView::SetAddressBar

Chiamare questa funzione membro per visualizzare o nascondere la barra degli indirizzi dell'oggetto Internet Explorer.

void SetAddressBar(BOOL bNewValue);

Parametri

bNewValue
Diverso da zero per mostrare la barra degli indirizzi; in caso contrario, zero.

Osservazioni:

Si applica a Internet Explorer. Se si utilizza questa chiamata con un controllo WebBrowser, non verrà restituito alcun errore, ma questa chiamata verrà ignorata.

CHtmlView::SetFullScreen

Chiamare questa funzione membro per impostare Internet Explorer sulla modalità finestra a schermo intero o normale.

void SetFullScreen(BOOL bNewValue);

Parametri

bNewValue
Diverso da zero per la modalità schermo intero; in caso contrario, zero.

Osservazioni:

In modalità schermo intero, la finestra principale di Internet Explorer è ingrandita e la barra di stato, la barra degli strumenti, la barra dei menu e la barra del titolo sono nascoste.

Si applica a Internet Explorer. Se si utilizza questa chiamata con un controllo WebBrowser, non verrà restituito alcun errore, ma questa chiamata verrà ignorata.

CHtmlView::SetHeight

Chiamare questa funzione membro per impostare l'altezza della finestra principale di Internet Explorer.

void SetHeight(long nNewValue);

Parametri

nNewValue
Altezza, in pixel, della finestra principale.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::SetLeft

Imposta la posizione orizzontale della finestra principale di Internet Explorer.

void SetLeft(long nNewValue);

Parametri

nNewValue
Coordinata dello schermo del bordo sinistro della finestra principale.

CHtmlView::SetMenuBar

Chiamare questa funzione membro per visualizzare o nascondere la barra dei menu di Internet Explorer.

void SetMenuBar(BOOL bNewValue);

Parametri

bNewValue
Diverso da zero per visualizzare la barra dei menu; in caso contrario, zero.

Osservazioni:

Si applica a Internet Explorer. Se si utilizza questa chiamata con un controllo WebBrowser, non verrà restituito alcun errore, ma questa chiamata verrà ignorata.

CHtmlView::SetOffline

Chiamare questa funzione membro per impostare un valore che indica se il controllo WebBrowser è attualmente operativo in modalità offline.

void SetOffline(BOOL bNewValue);

Parametri

bNewValue
Diverso da zero per leggere dalla cache locale; in caso contrario, zero.

Osservazioni:

In modalità offline, il browser legge le pagine HTML dalla cache locale anziché dal documento di origine.

Si applica a WebBrowser e Internet Explorer.

CHtmlView::SetRegisterAsBrowser

Chiamare questa funzione membro per impostare un valore che indica se il controllo WebBrowser è registrato come browser di primo livello per la risoluzione dei nomi di destinazione.

void SetRegisterAsBrowser(BOOL bNewValue);

Parametri

bNewValue
Determina se Internet Explorer è registrato come browser di primo livello. Se diverso da zero, il Web browser viene registrato come browser di primo livello; se zero, non è un browser di primo livello. Il valore predefinito è zero.

Osservazioni:

Un browser di primo livello è il browser impostato nel Registro di sistema come browser predefinito.

Si applica a WebBrowser e Internet Explorer.

CHtmlView::SetRegisterAsDropTarget

Chiamare questa funzione membro per impostare un valore che indica se il controllo WebBrowser è registrato come destinazione di rilascio per la navigazione.

void SetRegisterAsDropTarget(BOOL bNewValue);

Parametri

bNewValue
Determina se il controllo WebBrowser viene registrato come destinazione di rilascio per la navigazione. Se diverso da zero, l'oggetto viene registrato come destinazione di rilascio; se zero, non è una destinazione di rilascio.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::SetSilent

Chiamare questa funzione membro per impostare un valore che indica se è possibile visualizzare qualsiasi finestra di dialogo.

void SetSilent(BOOL bNewValue);

Parametri

bNewValue
Se diverso da zero, le finestre di dialogo non verranno visualizzate; se zero, verranno visualizzate le finestre di dialogo. Il valore predefinito è zero.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::SetStatusBar

Chiamare questa funzione membro per visualizzare la barra di stato.

void SetStatusBar(BOOL bNewValue);

Parametri

bNewValue
Diverso da zero se la barra di stato è visibile; in caso contrario, zero.

Osservazioni:

Si applica a Internet Explorer. Se si utilizza questa chiamata con un controllo WebBrowser, non verrà restituito alcun errore, ma questa chiamata verrà ignorata.

CHtmlView::SetTheaterMode

Chiamare questa funzione membro per impostare un valore che indica se il controllo WebBrowser è in modalità teatro.

void SetTheaterMode(BOOL bNewValue);

Parametri

bNewValue
Diverso da zero per impostare il controllo WebBrowser sulla modalità teatro; in caso contrario, zero. Il valore predefinito è zero.

Osservazioni:

Quando il Web browser è in modalità teatro, la finestra principale del browser riempie l'intera schermata, viene visualizzata una barra degli strumenti con un set minimo di strumenti di spostamento e la barra di stato viene visualizzata nell'angolo superiore destro dello schermo.

Si applica a WebBrowser e Internet Explorer.

CHtmlView::SetToolBar

Chiamare questa funzione membro per visualizzare o nascondere la barra degli strumenti di Internet Explorer.

void SetToolBar(int nNewValue);

Parametri

nNewValue
Indica se visualizzare la barra degli strumenti. Diverso da zero se la barra degli strumenti deve essere visualizzata; in caso contrario, zero.

Osservazioni:

Si applica a Internet Explorer. Se si utilizza questa chiamata con un controllo WebBrowser, non verrà restituito alcun errore, ma questa chiamata verrà ignorata.

CHtmlView::SetTop

Chiamare questa funzione membro per impostare la distanza tra il bordo superiore interno del controllo WebBrowser e il bordo superiore del contenitore

void SetTop(long nNewValue);

Parametri

nNewValue
Coordinata dello schermo del bordo superiore della finestra principale.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::SetVisible

Chiamare questa funzione membro per impostare lo stato di visibilità del controllo WebBrowser.

void SetVisible(BOOL bNewValue);

Parametri

bNewValue
Diverso da zero se il controllo è visibile; in caso contrario, zero.

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

CHtmlView::SetWidth

Imposta la larghezza della finestra principale di Internet Explorer.

void SetWidth(long nNewValue);

Parametri

nNewValue
Larghezza, in pixel, della finestra principale di Internet Explorer.

CHtmlView::Stop

Chiamare questa funzione membro per annullare qualsiasi operazione di spostamento o download in sospeso e arrestare qualsiasi elemento di pagina dinamico, ad esempio suoni di sfondo e animazioni.

void Stop();

Osservazioni:

Si applica a WebBrowser e Internet Explorer.

Vedi anche

Esempio MFC MFCIE
Classe CFormView
Grafico gerarchia
IWebBrowser2