Classe CDHtmlDialog

Viene usato per creare finestre di dialogo che usano HTML anziché risorse di dialogo per implementare l'interfaccia utente.

Sintassi

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Membri

Costruttori pubblici

Nome	Descrizione
CDHtmlDialog::CDHtmlDialog	Costruisce un oggetto CDHtmlDialog.
CDHtmlDialog::~CDHtmlDialog	Elimina definitivamente un oggetto CDHtmlDialog.

Metodi pubblici

Nome	Descrizione
CDHtmlDialog::CanAccessExternal	Sostituibile che viene chiamato come controllo di accesso per verificare se gli oggetti di scripting nella pagina caricata possono accedere all'invio esterno del sito di controllo. Verifica che l'invio sia sicuro per lo scripting o che la zona corrente consenta gli oggetti che non sono sicuri per lo scripting.
CDHtmlDialog::CreateControlSite	Sostituibile usato per creare un'istanza del sito di controllo per ospitare il controllo WebBrowser nella finestra di dialogo.
CDHtmlDialog::DDX_DHtml_AxControl	Scambia dati tra una variabile membro e il valore della proprietà di un controllo ActiveX in una pagina HTML.
CDHtmlDialog::DDX_DHtml_CheckBox	Scambia dati tra una variabile membro e una casella di controllo in una pagina HTML.
CDHtmlDialog::DDX_DHtml_ElementText	Scambia dati tra una variabile membro e qualsiasi proprietà dell'elemento HTML in una pagina HTML.
CDHtmlDialog::DDX_DHtml_Radio	Scambia dati tra una variabile membro e un pulsante di opzione in una pagina HTML.
CDHtmlDialog::DDX_DHtml_SelectIndex	Ottiene o imposta l'indice di una casella di riepilogo in una pagina HTML.
CDHtmlDialog::DDX_DHtml_SelectString	Ottiene o imposta il testo visualizzato di una voce di casella di riepilogo (in base all'indice corrente) in una pagina HTML.
CDHtmlDialog::DDX_DHtml_SelectValue	Ottiene o imposta il valore di una voce di casella di riepilogo (in base all'indice corrente) in una pagina HTML.
CDHtmlDialog::DestroyModeless	Elimina definitivamente una finestra di dialogo senza modalità.
CDHtmlDialog::EnableModeless	Abilita finestre di dialogo senza modalità.
CDHtmlDialog::FilterDataObject	Consente alla finestra di dialogo di filtrare gli oggetti dati degli Appunti creati dal browser ospitato.
CDHtmlDialog::GetControlDispatch	Recupera l'interfaccia IDispatch in un controllo ActiveX incorporato nel documento HTML.
CDHtmlDialog::GetControlProperty	Recupera la proprietà richiesta del controllo ActiveX specificato.
CDHtmlDialog::GetCurrentUrl	Recupera l'URL (Uniform Resource Locator) associato al documento corrente.
CDHtmlDialog::GetDHtmlDocument	Recupera l'interfaccia IHTMLDocument2 nel documento HTML attualmente caricato.
CDHtmlDialog::GetDropTarget	Chiamato dal controllo WebBrowser contenuto quando viene usato come destinazione di rilascio per consentire al dialogo di fornire un'alternativa IDropTarget.
CDHtmlDialog::GetElement	Ottiene un'interfaccia su un elemento HTML.
CDHtmlDialog::GetElementHtml	Recupera la innerHTML proprietà di un elemento HTML.
CDHtmlDialog::GetElementInterface	Recupera il puntatore dell'interfaccia richiesto da un elemento HTML.
CDHtmlDialog::GetElementProperty	Recupera il valore della proprietà di un elemento HTML.
CDHtmlDialog::GetElementText	Recupera la innerText proprietà di un elemento HTML.
CDHtmlDialog::GetEvent	Ottiene il IHTMLEventObj puntatore all'oggetto evento corrente.
CDHtmlDialog::GetExternal	Ottiene l'interfaccia dell'host IDispatch .
CDHtmlDialog::GetHostInfo	Recupera le funzionalità dell'interfaccia utente dell'host.
CDHtmlDialog::GetOptionKeyPath	Recupera la chiave del Registro di sistema in cui vengono archiviate le preferenze utente.
CDHtmlDialog::HideUI	Nasconde l'interfaccia utente dell'host.
CDHtmlDialog::IsExternalDispatchSafe	Indica se l'interfaccia dell'host IDispatch è sicura per lo scripting.
CDHtmlDialog::LoadFromResource	Carica la risorsa specificata nel controllo WebBrowser.
CDHtmlDialog::Navigate	Passa all'URL specificato.
CDHtmlDialog::OnBeforeNavigate	Chiamato dal framework prima che venga generato un evento di navigazione.
CDHtmlDialog::OnDocumentComplete	Chiamato dal framework per notificare a un'applicazione quando un documento ha raggiunto lo READYSTATE_COMPLETE stato.
CDHtmlDialog::OnDocWindowActivate	Chiamato dal framework quando la finestra del documento viene attivata o disattivata.
CDHtmlDialog::OnFrameWindowActivate	Chiamato dal framework quando la finestra cornice viene attivata o disattivata.
CDHtmlDialog::OnInitDialog	Chiamato in risposta al WM_INITDIALOG messaggio.
CDHtmlDialog::OnNavigateComplete	Chiamato dal framework dopo il completamento di un evento di navigazione.
CDHtmlDialog::ResizeBorder	Avvisa l'oggetto che deve ridimensionare lo spazio del bordo.
CDHtmlDialog::SetControlProperty	Imposta la proprietà di un controllo ActiveX su un nuovo valore.
CDHtmlDialog::SetElementHtml	Imposta la innerHTML proprietà di un elemento HTML.
CDHtmlDialog::SetElementProperty	Imposta una proprietà di un elemento HTML.
CDHtmlDialog::SetElementText	Imposta la innerText proprietà di un elemento HTML.
CDHtmlDialog::SetExternalDispatch	Imposta l'interfaccia dell'host IDispatch .
CDHtmlDialog::SetHostFlags	Imposta i flag dell'interfaccia utente dell'host.
CDHtmlDialog::ShowContextMenu	Chiamato quando un menu di scelta rapida sta per essere visualizzato.
CDHtmlDialog::ShowUI	Mostra l'interfaccia utente dell'host.
CDHtmlDialog::TranslateAccelerator	Chiamato per elaborare i messaggi di tasti di scelta rapida del menu.
CDHtmlDialog::TranslateUrl	Chiamato per modificare l'URL da caricare.
CDHtmlDialog::UpdateUI	Chiamato per notificare all'host che lo stato del comando è stato modificato.

Membri dati pubblici

Nome	Descrizione
CDHtmlDialog::m_bUseHtmlTitle	Indica se utilizzare il titolo del documento HTML come didascalia della finestra di dialogo.
CDHtmlDialog::m_nHtmlResID	ID risorsa della risorsa HTML da visualizzare.
CDHtmlDialog::m_pBrowserApp	Puntatore a un'applicazione Web browser.
CDHtmlDialog::m_spHtmlDoc	Puntatore a un documento HTML.
CDHtmlDialog::m_strCurrentUrl	URL corrente.
CDHtmlDialog::m_szHtmlResID	Versione stringa dell'ID risorsa HTML.

Osservazioni:

CDHtmlDialog può caricare il codice HTML da visualizzare da una risorsa HTML o da un URL.

CDHtmlDialog può anche eseguire lo scambio di dati con controlli HTML e gestire eventi da controlli HTML, ad esempio clic sui pulsanti.

Gerarchia di ereditarietà

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Requisiti

Intestazione: afxdhtml.h

DDX_DHtml Macro helper

Le DDX_DHtml macro helper consentono di accedere facilmente alle proprietà di uso comune dei controlli in una pagina HTML.

Macro di Scambio di dati

Nome	Descrizione
DDX_DHtml_ElementValue	Imposta o recupera la proprietà Value dal controllo selezionato.
DDX_DHtml_ElementInnerText	Imposta o recupera il testo tra i tag iniziale e finale dell'elemento corrente.
DDX_DHtml_ElementInnerHtml	Imposta o recupera il codice HTML tra i tag iniziale e finale dell'elemento corrente.
DDX_DHtml_Anchor_Href	Imposta o recupera l'URL di destinazione o il punto di ancoraggio.
DDX_DHtml_Anchor_Target	Imposta o recupera la finestra o il frame di destinazione.
DDX_DHtml_Img_Src	Imposta o recupera il nome di un'immagine o di un clip video nel documento.
DDX_DHtml_Frame_Src	Imposta o recupera l'URL del frame associato.
DDX_DHtml_IFrame_Src	Imposta o recupera l'URL del frame associato.

CDHtmlDialog::CanAccessExternal

Sostituibile che viene chiamato come controllo di accesso per verificare se gli oggetti di scripting nella pagina caricata possono accedere all'invio esterno del sito di controllo. Verifica che l'invio sia sicuro per lo scripting o che la zona corrente consenta gli oggetti che non sono sicuri per lo scripting.

virtual BOOL CanAccessExternal();

Valore restituito

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

CDHtmlDialog::CDHtmlDialog

Costruisce una finestra di dialogo HTML dinamica basata su risorse.

CDHtmlDialog();

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

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

Parametri

lpszTemplateName
Stringa con terminazione Null che corrisponde al nome di una risorsa modello di finestra di dialogo.

szHtmlResID
Stringa con terminazione Null che corrisponde al nome di una risorsa HTML.

pParentWnd
Puntatore all'oggetto finestra padre o proprietario (di tipo CWnd) a cui appartiene l'oggetto dialog. Se è NULL, la finestra padre dell'oggetto finestra di dialogo viene impostata sulla finestra principale dell'applicazione.

nIDTemplate
Contiene il numero ID di una risorsa modello di finestra di dialogo.

nHtmlResID
Contiene il numero ID di una risorsa HTML.

Osservazioni:

La seconda forma del costruttore fornisce l'accesso alla risorsa della finestra di dialogo tramite il nome del modello. La terza forma del costruttore fornisce l'accesso alla risorsa della finestra di dialogo tramite l'ID del modello di risorsa. In genere, l'ID inizia con il IDD_ prefisso .

CDHtmlDialog::~CDHtmlDialog

Elimina un oggetto CDHtmlDialog .

virtual ~CDHtmlDialog();

Osservazioni:

La CWnd::DestroyWindow funzione membro deve essere utilizzata per eliminare definitivamente le finestre di dialogo senza modalità create da CDialog::Create.

CDHtmlDialog::CreateControlSite

Sostituibile usato per creare un'istanza del sito di controllo per ospitare il controllo WebBrowser nella finestra di dialogo.

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

Parametri

pContainer
Puntatore all'oggetto COleControlContainer.

ppSite
Puntatore a un puntatore a un oggetto COleControlSite.

Valore restituito

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

Osservazioni:

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

CDHtmlDialog::DDX_DHtml_AxControl

Scambia dati tra una variabile membro e il valore della proprietà di un controllo ActiveX in una pagina HTML.

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

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

Parametri

pDX
Puntatore a un oggetto CDataExchange.

szId
Valore del parametro ID del tag oggetto nell'origine HTML per il controllo ActiveX.

dispId
ID dispatch della proprietà con cui si desidera scambiare dati.

szPropName
Nome della proprietà.

var
Membro dati di tipo VARIANT, COleVarianto CComVariant, che contiene il valore scambiato con la proprietà del controllo ActiveX.

Esempio

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

CDHtmlDialog::DDX_DHtml_CheckBox

Scambia dati tra una variabile membro e una casella di controllo in una pagina HTML.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange.

szId
Valore specificato per il parametro ID del controllo HTML.

value
Valore scambiato.

Esempio

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

CDHtmlDialog::DDX_DHtml_ElementText

Scambia dati tra una variabile membro e qualsiasi proprietà dell'elemento HTML in una pagina HTML.

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

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

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

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

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

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

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

Parametri

pDX
Puntatore a un oggetto CDataExchange.

szId
Valore specificato per il parametro ID del controllo HTML.

dispId
ID dispatch dell'elemento HTML con cui si desidera scambiare dati.

value
Valore scambiato.

CDHtmlDialog::DDX_DHtml_Radio

Scambia dati tra una variabile membro e un pulsante di opzione in una pagina HTML.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange.

szId
Valore specificato per il parametro ID del controllo HTML.

value
Valore scambiato.

CDHtmlDialog::DDX_DHtml_SelectIndex

Ottiene o imposta l'indice di una casella di riepilogo in una pagina HTML.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange.

szId
Valore specificato per il parametro del id controllo HTML.

value
Valore scambiato.

CDHtmlDialog::DDX_DHtml_SelectString

Ottiene o imposta il testo visualizzato di una voce di casella di riepilogo (in base all'indice corrente) in una pagina HTML.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange.

szId
Valore specificato per il parametro ID del controllo HTML.

value
Valore scambiato.

CDHtmlDialog::DDX_DHtml_SelectValue

Ottiene o imposta il valore di una voce di casella di riepilogo (in base all'indice corrente) in una pagina HTML.

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

Parametri

pDX
Puntatore a un oggetto CDataExchange.

szId
Valore specificato per il parametro ID del controllo HTML.

value
Valore scambiato.

Esempio

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

CDHtmlDialog::DestroyModeless

Scollega una finestra di dialogo senza modalità dall'oggetto CDHtmlDialog e elimina definitivamente l'oggetto.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Abilita finestre di dialogo senza modalità.

STDMETHOD(EnableModeless)(BOOL fEnable);

Parametri

fEnable
Vedere fEnable in IDocHostUIHandler::EnableModeless Windows SDK.

Valore restituito

Restituisce E_NOTIMPL.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::EnableModeless, come descritto in Windows SDK.

CDHtmlDialog::FilterDataObject

Consente alla finestra di dialogo di filtrare gli oggetti dati degli Appunti creati dal browser ospitato.

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

Parametri

pDO
Vedere pDO in IDocHostUIHandler::FilterDataObject Windows SDK.

ppDORet
Vedere ppDORet in IDocHostUIHandler::FilterDataObject Windows SDK.

Valore restituito

Restituisce S_FALSE.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::FilterDataObject, come descritto in Windows SDK.

CDHtmlDialog::GetControlDispatch

Recupera l'interfaccia IDispatch in un controllo ActiveX incorporato nel documento HTML restituito da GetDHtmlDocument.

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

Parametri

szId
ID HTML di un controllo ActiveX.

ppdisp
Interfaccia IDispatch del controllo se presente nella pagina Web.

Valore restituito

Un valore HRESULT standard.

CDHtmlDialog::GetControlProperty

Recupera la proprietà richiesta del controllo ActiveX specificato.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Parametri

szId
ID HTML di un controllo ActiveX.

szPropName
Nome di una proprietà nelle impostazioni locali predefinite dell'utente corrente.

pdispControl
Puntatore IDispatch di un controllo ActiveX.

dispId
ID dispatch di una proprietà.

Valore restituito

Variante contenente la proprietà richiesta o una variante vuota se non è stato possibile trovare il controllo o la proprietà.

Osservazioni:

Gli overload sono elencati dalla parte superiore meno efficiente alla più efficiente nella parte inferiore.

CDHtmlDialog::GetCurrentUrl

Recupera l'URL (Uniform Resource Locator) associato al documento corrente.

void GetCurrentUrl(CString& szUrl);

Parametri

szUrl
Oggetto CString contenente l'URL da recuperare.

CDHtmlDialog::GetDHtmlDocument

Recupera l'interfaccia IHTMLDocument2 nel documento HTML attualmente caricato.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Parametri

**pphtmlDoc Puntatore a un puntatore a un documento HTML.

Valore restituito

Oggetto standard HRESULT. Se l'esito è positivo, restituisce S_OK.

CDHtmlDialog::GetDropTarget

Chiamato dal controllo WebBrowser contenuto quando viene usato come destinazione di rilascio per consentire al dialogo di fornire un'alternativa IDropTarget.

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

Parametri

pDropTarget
Vedere pDropTarget in IDocHostUIHandler::GetDropTarget Windows SDK.

ppDropTarget
Vedere ppDropTarget in IDocHostUIHandler::GetDropTarget Windows SDK.

Valore restituito

Restituisce E_NOTIMPL.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::GetDropTarget, come descritto in Windows SDK.

CDHtmlDialog::GetElement

Restituisce un'interfaccia sull'elemento HTML specificato da szElementId.

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

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

Parametri

szElementId
ID di un elemento HTML.

ppdisp
Puntatore IDispatch all'elemento o alla raccolta di elementi richiesti.

pbCollection
Oggetto BOOL che indica se l'oggetto rappresentato da ppdisp è un singolo elemento o una raccolta di elementi.

pphtmlElement
Puntatore IHTMLElement all'elemento richiesto.

Valore restituito

Un valore HRESULT standard.

Osservazioni:

Usare il primo overload se è necessario gestire le condizioni in cui potrebbero essere presenti più elementi con l'ID specificato. È possibile usare l'ultimo parametro per determinare se il puntatore dell'interfaccia restituito è a una raccolta o a un singolo elemento. Se il puntatore dell'interfaccia si trova in una raccolta, è possibile eseguire una query per e IHTMLElementCollection utilizzare la relativa item proprietà per fare riferimento agli elementi in base alla posizione ordinale.

Il secondo overload avrà esito negativo se nella pagina sono presenti più elementi con lo stesso ID.

CDHtmlDialog::GetElementHtml

Recupera la innerHTML proprietà dell'elemento HTML identificato da szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

Parametri

szElementId
ID di un elemento HTML.

Valore restituito

Proprietà innerHTML dell'elemento HTML identificato da szElementId o NULL se l'elemento non è stato trovato.

CDHtmlDialog::GetElementInterface

Recupera il puntatore dell'interfaccia richiesto dall'elemento HTML identificato da szElementId.

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

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

Parametri

szElementId
ID di un elemento HTML.

ppvObj
Indirizzo di un puntatore che verrà riempito con il puntatore di interfaccia richiesto se l'elemento viene trovato e la query ha esito positivo.

refiid
ID di interfaccia (IID) dell'interfaccia richiesta.

Valore restituito

Un valore HRESULT standard.

Esempio

CComPtr<IHTMLInputButtonElement> spBtn1;
CComPtr<IHTMLInputButtonElement> spBtn2;
HRESULT hr = S_OK;

// Use the template overload
hr = GetElementInterface(L"Button1", &spBtn1);

// Use the nontemplate overload
hr = GetElementInterface(L"Button1", IID_IHTMLInputButtonElement,
                         reinterpret_cast<void **>(&spBtn2));

CDHtmlDialog::GetElementProperty

Recupera il valore della proprietà identificata dall'elemento dispId HTML identificato da szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Parametri

szElementId
ID di un elemento HTML.

dispId
ID dispatch di una proprietà.

Valore restituito

Valore della proprietà o di una variante vuota se non è stato possibile trovare la proprietà o l'elemento.

CDHtmlDialog::GetElementText

Recupera la innerText proprietà dell'elemento HTML identificato da szElementId.

BSTR GetElementText(LPCTSTR szElementId);

Parametri

szElementId
ID di un elemento HTML.

Valore restituito

Proprietà innerText dell'elemento HTML identificato da szElementId o NULL se non è stato possibile trovare la proprietà o l'elemento.

CDHtmlDialog::GetEvent

Restituisce il IHTMLEventObj puntatore all'oggetto evento corrente.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Parametri

ppEventObj
Indirizzo di un puntatore che verrà riempito con il puntatore dell'interfaccia IHTMLEventObj .

Valore restituito

Un valore HRESULT standard.

Osservazioni:

Questa funzione deve essere chiamata solo dall'interno di un gestore eventi DHTML.

CDHtmlDialog::GetExternal

Ottiene l'interfaccia dell'host IDispatch .

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Parametri

ppDispatch
Vedere ppDispatch in IDocHostUIHandler::GetExternal Windows SDK.

Valore restituito

Restituisce S_OK in caso di esito positivo o E_NOTIMPL negativo.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::GetExternal, come descritto in Windows SDK.

CDHtmlDialog::GetHostInfo

Recupera le funzionalità dell'interfaccia utente dell'host.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Parametri

pInfo
Vedere pInfo in IDocHostUIHandler::GetHostInfo Windows SDK.

Valore restituito

Restituisce S_OK.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::GetHostInfo, come descritto in Windows SDK.

CDHtmlDialog::GetOptionKeyPath

Recupera la chiave del Registro di sistema in cui vengono archiviate le preferenze utente.

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

Parametri

pchKey
Vedere pchKey in IDocHostUIHandler::GetOptionKeyPath Windows SDK.

dw
Vedere dw in IDocHostUIHandler::GetOptionKeyPath Windows SDK.

Valore restituito

Restituisce E_NOTIMPL.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::GetOptionKeyPath, come descritto in Windows SDK.

CDHtmlDialog::HideUI

Nasconde l'interfaccia utente dell'host.

STDMETHOD(HideUI)(void);

Valore restituito

Restituisce E_NOTIMPL.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::HideUI, come descritto in Windows SDK.

CDHtmlDialog::IsExternalDispatchSafe

Indica se l'interfaccia dell'host IDispatch è sicura per lo scripting.

virtual BOOL IsExternalDispatchSafe();

Valore restituito

Restituisce FALSE.

CDHtmlDialog::LoadFromResource

Carica la risorsa specificata nel controllo WebBrowser nella finestra di dialogo DHTML.

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

Parametri

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

nRes
ID della risorsa da caricare.

Valore restituito

TRUE se l'esito è positivo; in caso contrario, FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Indica se utilizzare il titolo del documento HTML come didascalia della finestra di dialogo.

BOOL m_bUseHtmlTitle;

Osservazioni:

Se è , la didascalia della finestra di TRUEdialogo è impostata su uguale al titolo del documento HTML. In m_bUseHtmlTitle caso contrario, viene utilizzata la didascalia nella risorsa della finestra di dialogo.

CDHtmlDialog::m_nHtmlResID

ID risorsa della risorsa HTML da visualizzare.

UINT m_nHtmlResID;

Esempio

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

CDHtmlDialog::m_pBrowserApp

Puntatore a un'applicazione Web browser.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Puntatore a un documento HTML.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

URL corrente.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

Versione stringa dell'ID risorsa HTML.

LPTSTR m_szHtmlResID;

Esempio

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

CDHtmlDialog::Navigate

Passa alla risorsa identificata dall'URL specificato da lpszURL.

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

Parametri

lpszURL
Puntatore a una stringa contenente l'URL di destinazione.

dwFlags
Flag di una variabile che specifica se aggiungere la risorsa all'elenco di cronologia, se leggere nella cache 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 informazioni quali l'azione richiesta del server, il tipo di dati passati al server o un codice di stato. Questo parametro viene ignorato se l'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 l'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 l'URL non è un URL HTTP.

CDHtmlDialog::OnBeforeNavigate

Chiamato dal framework per generare un evento prima che si verifichi una navigazione.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametri

pDisp
Puntatore a un oggetto IDispatch.

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

CDHtmlDialog::OnDocumentComplete

Chiamato dal framework per notificare a un'applicazione quando un documento ha raggiunto lo READYSTATE_COMPLETE stato.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametri

pDisp
Puntatore a un oggetto IDispatch.

szUrl
Puntatore a una stringa contenente l'URL a cui è stato eseguito lo spostamento.

CDHtmlDialog::OnDocWindowActivate

Chiamato dal framework quando la finestra del documento viene attivata o disattivata.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Parametri

fActivate
Vedere fActivate in IDocHostUIHandler::OnDocWindowActivate Windows SDK.

Valore restituito

Restituisce E_NOTIMPL.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::OnDocWindowActivate, come descritto in Windows SDK.

CDHtmlDialog::OnFrameWindowActivate

Chiamato dal framework quando la finestra cornice viene attivata o disattivata.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Parametri

fActivate
Vedere fActivate in IDocHostUIHandler::OnFrameWindowActivate Windows SDK.

Valore restituito

Restituisce E_NOTIMPL.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::OnFrameWindowActivate, come descritto in Windows SDK.

CDHtmlDialog::OnInitDialog

Chiamato in risposta al WM_INITDIALOG messaggio.

virtual BOOL OnInitDialog();

Valore restituito

L'implementazione predefinita restituisce TRUE.

Osservazioni:

Questo messaggio viene inviato alla finestra di dialogo durante le Createchiamate , CreateIndirecto DoModal che si verificano immediatamente prima della visualizzazione della finestra di dialogo.

Eseguire l'override di questa funzione membro se è necessario eseguire un'elaborazione speciale quando viene inizializzata la finestra di dialogo. Nella versione sottoposta a override chiamare prima la classe OnInitDialog di base ma ignorarne il valore restituito. In genere si tornerà TRUE dalla funzione membro sottoposta a override.

Windows chiama la OnInitDialog funzione tramite la routine standard della finestra di dialogo globale comune a tutte le finestre di dialogo della libreria di classi di Microsoft Foundation, anziché tramite la mappa dei messaggi, pertanto non è necessaria una voce della mappa messaggi per questa funzione membro.

CDHtmlDialog::OnNavigateComplete

Chiamato dal framework dopo il completamento dello spostamento all'URL specificato.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parametri

pDisp
Puntatore a un oggetto IDispatch.

szUrl
Puntatore a una stringa contenente l'URL a cui è stato eseguito lo spostamento.

CDHtmlDialog::ResizeBorder

Avvisa l'oggetto che deve ridimensionare lo spazio del bordo.

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

Parametri

prcBorder
Vedere prcBorder in IDocHostUIHandler::ResizeBorder Windows SDK.

pUIWindow
Vedere pUIWindow in IDocHostUIHandler::ResizeBorder Windows SDK.

fFrameWindow
Vedere fFrameWindow in IDocHostUIHandler::ResizeBorder Windows SDK.

Valore restituito

Restituisce E_NOTIMPL.

CDHtmlDialog::SetControlProperty

Imposta la proprietà di un controllo ActiveX su un nuovo valore.

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

void SetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    LPCTSTR szElementId,
    LPCTSTR szPropName,
    VARIANT* pVar);

Parametri

szElementId
ID HTML di un controllo ActiveX.

dispId
ID dispatch della proprietà da impostare.

pVar
Puntatore a un oggetto VARIANT contenente il nuovo valore della proprietà.

pdispControl
Puntatore all'interfaccia di IDispatch un controllo ActiveX.

szPropName
Stringa contenente il nome della proprietà da impostare.

CDHtmlDialog::SetElementHtml

Imposta la innerHTML proprietà di un elemento HTML.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Parametri

szElementId
ID di un elemento HTML.

bstrText
Nuovo valore della proprietà innerHTML.

punkElem
Puntatore IUnknown di un elemento HTML.

CDHtmlDialog::SetElementProperty

Imposta una proprietà di un elemento HTML.

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

Parametri

szElementId
ID di un elemento HTML.

dispId
ID dispatch della proprietà da impostare.

pVar
Nuovo valore della proprietà.

CDHtmlDialog::SetElementText

Imposta la innerText proprietà di un elemento HTML.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Parametri

szElementId
ID di un elemento HTML.

bstrText
Nuovo valore della proprietà innerText.

punkElem
Puntatore IUnknown di un elemento HTML.

CDHtmlDialog::SetExternalDispatch

Imposta l'interfaccia dell'host IDispatch .

void SetExternalDispatch(IDispatch* pdispExternal);

Parametri

pdispExternal
IDispatch Nuova interfaccia.

CDHtmlDialog::SetHostFlags

Imposta i flag dell'interfaccia utente host.

void SetHostFlags(DWORD dwFlags);

Parametri

dwFlags
Per i valori possibili, vedere DOCHOSTUIFLAG in Windows SDK.

CDHtmlDialog::ShowContextMenu

Chiamato quando un menu di scelta rapida sta per essere visualizzato.

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

Parametri

dwID
Vedere dwID in IDocHostUIHandler::ShowContextMenu Windows SDK.

ppt
Vedere ppt in IDocHostUIHandler::ShowContextMenu Windows SDK.

pcmdtReserved
Vedere pcmdtReserved in IDocHostUIHandler::ShowContextMenu Windows SDK.

pdispReserved
Vedere pdispReserved in IDocHostUIHandler::ShowContextMenu Windows SDK.

Valore restituito

Restituisce S_FALSE.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::ShowContextMenu, come descritto in Windows SDK.

CDHtmlDialog::ShowUI

Mostra l'interfaccia utente dell'host.

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

Parametri

dwID
Vedere dwID in IDocHostUIHandler::ShowUI Windows SDK.

pActiveObject
Vedere pActiveObject in IDocHostUIHandler::ShowUI Windows SDK.

pCommandTarget
Vedere pCommandTarget in IDocHostUIHandler::ShowUI Windows SDK.

pFrame
Vedere pFrame in IDocHostUIHandler::ShowUI Windows SDK.

pDoc
Vedere pDoc in IDocHostUIHandler::ShowUI Windows SDK.

Valore restituito

Restituisce S_FALSE.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::ShowUI, come descritto in Windows SDK.

CDHtmlDialog::TranslateAccelerator

Chiamato per elaborare i messaggi di tasti di scelta rapida del menu.

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

Parametri

lpMsg
Vedere lpMsg in IDocHostUIHandler::TranslateAccelerator Windows SDK.

pguidCmdGroup
Vedere pguidCmdGroup in IDocHostUIHandler::TranslateAccelerator Windows SDK.

nCmdID
Vedere nCmdID in IDocHostUIHandler::TranslateAccelerator Windows SDK.

Valore restituito

Restituisce S_FALSE.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::TranslateAccelerator, come descritto in Windows SDK.

CDHtmlDialog::TranslateUrl

Chiamato per modificare l'URL da caricare.

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

Parametri

dwTranslate
Vedere dwTranslate in IDocHostUIHandler::TranslateUrl Windows SDK.

pchURLIn
Vedere pchURLIn in IDocHostUIHandler::TranslateUrl Windows SDK.

ppchURLOut
Vedere ppchURLOut in IDocHostUIHandler::TranslateUrl Windows SDK.

Valore restituito

Restituisce S_FALSE.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::TranslateUrl, come descritto in Windows SDK.

CDHtmlDialog::UpdateUI

Chiamato per notificare all'host che lo stato del comando è stato modificato.

STDMETHOD(UpdateUI)(void);

Valore restituito

Restituisce E_NOTIMPL.

Osservazioni:

Questa funzione membro è l'implementazione CDHtmlDialog di IDocHostUIHandler::UpdateUI, come descritto in Windows SDK.

Vedi anche

Esempio MFC DHtmlExplore
DDX_DHtml Macro helper
Grafico della gerarchia