CDHtmlDialog Classe

É usado para criar caixas de diálogo que utilizam HTML em vez de recursos de diálogo para implementar a sua interface de utilizador.

Sintaxe

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados Públicos

Observações

CDHtmlDialog pode carregar o HTML para ser exibido a partir de um recurso HTML ou de uma URL.

CDHtmlDialog também pode fazer troca de dados com controlos HTML e gerir eventos a partir de controlos HTML, como cliques em botões.

Hierarquia de herança

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Requerimentos

Cabeçalho:afxdhtml.h

DDX_DHtml Macros Auxiliares

As DDX_DHtml macros auxiliares permitem fácil acesso às propriedades mais usadas dos controlos numa página HTML.

Macros de Intercâmbio de Dados

CDHtmlDialog::CanAccessExternal

Overridable que é chamado de verificação de acesso para ver se os objetos de scripting na página carregada conseguem aceder ao despacho externo do site de controlo. Verifica se o despacho é seguro para scripting ou se a zona atual permite objetos que não são seguros para scripting.

virtual BOOL CanAccessExternal();

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

CDHtmlDialog::CDHtmlDialog

Constrói uma caixa de diálogo dinâmica HTML baseada em recursos.

CDHtmlDialog();

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

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

Parâmetros

lpszTemplateName
A cadeia terminada por null que é o nome de um recurso modelo de caixa de diálogo.

szHtmlResID
A cadeia terminada nula que é o nome de um recurso HTML.

pParentWnd
Um ponteiro para o objeto janela pai ou proprietário (do tipo CWnd) ao qual pertence o objeto de diálogo. Se for NULL, a janela pai do objeto de diálogo está definida para a janela principal da aplicação.

nIDTemplate
Contém o número de ID de um recurso modelo de caixa de diálogo.

nHtmlResID
Contém o número ID de um recurso HTML.

Observações

A segunda forma do construtor fornece acesso ao recurso de diálogo através do nome do modelo. A terceira forma do construtor fornece acesso ao recurso de diálogo através do ID do template de recurso. Normalmente, o ID começa com o IDD_ prefixo.

CDHtmlDialog::~CDHtmlDialog

Destrói um CDHtmlDialog objeto.

virtual ~CDHtmlDialog();

Observações

A CWnd::DestroyWindow função membro deve ser usada para destruir caixas de diálogo sem modos criadas por CDialog::Create.

CDHtmlDialog::CreateControlSite

Sobrescrito usado para criar uma instância de controlo do site para hospedar o controlo do WebBrowser no diálogo.

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

Parâmetros

pContainer
Um indicador para o COleControlContainer objeto.

ppSite
Um apontador para um apontador para um COleControlSite.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

Pode sobrescrever esta função membro para devolver uma instância da sua própria classe de site de controlo.

CDHtmlDialog::DDX_DHtml_AxControl

Troca dados entre uma variável membro e o valor de propriedade de um controlo ActiveX numa página 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);

Parâmetros

pDX
Um ponteiro para um CDataExchange objeto.

szId
O valor do parâmetro ID da tag de objeto no código-fonte HTML para o controlo ActiveX.

dispId
O ID de despacho da propriedade com a qual pretende trocar dados.

szPropName
O nome da propriedade.

var
O membro de dados, do tipo VARIANT, COleVariant, ou CComVariant, que detém o valor trocado com a propriedade de controlo ActiveX.

Example

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

CDHtmlDialog::DDX_DHtml_CheckBox

Troca dados entre uma variável membro e uma caixa de seleção numa página HTML.

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

Parâmetros

pDX
Um ponteiro para um CDataExchange objeto.

szId
O valor que especificaste para o parâmetro ID do controlo HTML.

value
O valor que está a ser trocado.

Example

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

CDHtmlDialog::DDX_DHtml_ElementText

Troca dados entre uma variável membro e qualquer propriedade de elemento HTML numa página 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);

Parâmetros

pDX
Um ponteiro para um CDataExchange objeto.

szId
O valor que especificaste para o parâmetro ID do controlo HTML.

dispId
O ID de despacho do elemento HTML com o qual pretende trocar dados.

value
O valor que está a ser trocado.

CDHtmlDialog::DDX_DHtml_Radio

Troca dados entre uma variável membro e um botão de opção numa página HTML.

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

Parâmetros

pDX
Um ponteiro para um CDataExchange objeto.

szId
O valor que especificaste para o parâmetro ID do controlo HTML.

value
O valor que está a ser trocado.

CDHtmlDialog::DDX_DHtml_SelectIndex

Obtém ou define o índice de uma caixa de lista numa página HTML.

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

Parâmetros

pDX
Um ponteiro para um CDataExchange objeto.

szId
O valor que especificaste para o parâmetro do id controlo HTML.

value
O valor que está a ser trocado.

CDHtmlDialog::DDX_DHtml_SelectString

Obtém ou define o texto de exibição de uma entrada de uma caixa de lista (com base no índice atual) numa página HTML.

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

Parâmetros

pDX
Um ponteiro para um CDataExchange objeto.

szId
O valor que especificaste para o parâmetro ID do controlo HTML.

value
O valor que está a ser trocado.

CDHtmlDialog::DDX_DHtml_SelectValue

Obtém ou define o valor de uma entrada de caixa de lista (com base no índice atual) numa página HTML.

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

Parâmetros

pDX
Um ponteiro para um CDataExchange objeto.

szId
O valor que especificaste para o parâmetro ID do controlo HTML.

value
O valor que está a ser trocado.

Example

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

CDHtmlDialog::DestroyModeless

Desliga uma caixa de diálogo sem modo do CDHtmlDialog objeto e destrói o objeto.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Ativa as caixas de diálogo sem modo.

STDMETHOD(EnableModeless)(BOOL fEnable);

Parâmetros

fEnable
Veja fEnable no IDocHostUIHandler::EnableModeless SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::EnableModeless, conforme descrito no SDK do Windows.

CDHtmlDialog::FilterDataObject

Permite que o diálogo filtre os objetos de dados da área criados pelo navegador alojado.

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

Parâmetros

pDO
Veja pDO no IDocHostUIHandler::FilterDataObject SDK do Windows.

ppDORet
Veja ppDORet no IDocHostUIHandler::FilterDataObject SDK do Windows.

Valor de retorno

Retorna S_FALSE.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::FilterDataObject, conforme descrito no SDK do Windows.

CDHtmlDialog::GetControlDispatch

Recupera a IDispatch interface num controlo ActiveX embutido no documento HTML devolvido por GetDHtmlDocument.

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

Parâmetros

szId
O ID HTML de um controlo ActiveX.

ppdisp
A IDispatch interface do controlo pode ser encontrada na página Web.

Valor de retorno

Um valor padrão HRESULT .

CDHtmlDialog::GetControlProperty

Recupera a propriedade solicitada do controlo ActiveX especificado.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Parâmetros

szId
O ID HTML de um controlo ActiveX.

szPropName
O nome de uma propriedade na localização padrão do utilizador atual.

pdispControl
O IDispatch ponteiro de um controlo ActiveX.

dispId
O ID de despacho de uma propriedade.

Valor de retorno

Uma variante contendo a propriedade solicitada ou uma variante vazia caso o controlo ou propriedade não fosse encontrado.

Observações

As sobrecargas estão listadas de menos eficientes no topo para mais eficientes na base.

CDHtmlDialog::GetCurrentUrl

Recupera o Localizador Uniforme de Recursos (URL) associado ao documento atual.

void GetCurrentUrl(CString& szUrl);

Parâmetros

szUrl
Um CString objeto contendo o URL a recuperar.

CDHtmlDialog::GetDHtmlDocument

Recupera a IHTMLDocument2 interface do documento HTML atualmente carregado.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Parâmetros

**pphtmlDoc Um ponteiro para um ponteiro para um documento HTML.

Valor de retorno

Um padrão HRESULT. Retorna S_OK se for bem-sucedido.

CDHtmlDialog::GetDropTarget

Chamado pelo controlo do WebBrowser contido quando está a ser usado como drop target para permitir que o diálogo forneça uma alternativa IDropTarget.

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

Parâmetros

pDropTarget
Veja pDropTarget no IDocHostUIHandler::GetDropTarget SDK do Windows.

ppDropTarget
Veja ppDropTarget no IDocHostUIHandler::GetDropTarget SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::GetDropTarget, conforme descrito no SDK do Windows.

CDHtmlDialog::GetElement

Devolve uma interface no elemento HTML especificado por szElementId.

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

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

Parâmetros

szElementId
O ID de um elemento HTML.

ppdisp
Um IDispatch apontador para o elemento solicitado ou coleção de elementos.

pbCollection
A BOOL indica se o objeto representado por ppdisp é um único elemento ou uma coleção de elementos.

pphtmlElement
Um IHTMLElement apontador para o elemento solicitado.

Valor de retorno

Um valor padrão HRESULT .

Observações

Use a primeira sobrecarga se precisar de lidar com condições em que possam existir mais do que um elemento com o ID especificado. Pode usar o último parâmetro para descobrir se o ponteiro de interface devolvido é para uma coleção ou para um único item. Se o ponteiro de interface estiver numa coleção, pode consultar o IHTMLElementCollection e usar a sua item propriedade para se referir aos elementos pela posição ordinal.

A segunda sobrecarga falha se houver mais do que um elemento com o mesmo ID na página.

CDHtmlDialog::GetElementHtml

Recupera a innerHTML propriedade do elemento HTML identificada por szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

Parâmetros

szElementId
O ID de um elemento HTML.

Valor de retorno

A innerHTML propriedade do elemento HTML identificada por szElementId ou NULL se o elemento não pudesse ser encontrado.

CDHtmlDialog::GetElementInterface

Recupera o ponteiro de interface solicitado a partir do elemento HTML identificado por szElementId.

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

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

Parâmetros

szElementId
O ID de um elemento HTML.

ppvObj
Endereço de um ponteiro que será preenchido com o ponteiro de interface solicitado se o elemento for encontrado e a consulta for bem-sucedida.

refiid
O ID da interface (IID) da interface solicitada.

Valor de retorno

Um valor padrão HRESULT .

Example

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 o valor da propriedade identificada por dispId a partir do elemento HTML identificado por szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Parâmetros

szElementId
O ID de um elemento HTML.

dispId
O ID de despacho de uma propriedade.

Valor de retorno

O valor da propriedade ou uma variante vazia se a propriedade ou elemento não pudesse ser encontrado.

CDHtmlDialog::GetElementText

Recupera a innerText propriedade do elemento HTML identificada por szElementId.

BSTR GetElementText(LPCTSTR szElementId);

Parâmetros

szElementId
O ID de um elemento HTML.

Valor de retorno

A innerText propriedade do elemento HTML identificada por szElementId ou NULL se a propriedade ou elemento não pudesse ser encontrada.

CDHtmlDialog::GetEvent

Devolve o IHTMLEventObj ponteiro ao objeto de evento atual.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Parâmetros

ppEventObj
Endereço de um ponteiro que será preenchido com o IHTMLEventObj ponteiro da interface.

Valor de retorno

Um valor padrão HRESULT .

Observações

Esta função só deve ser chamada a partir de um gestor de eventos DHTML.

CDHtmlDialog::GetExternal

Recebe a interface do IDispatch anfitrião.

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Parâmetros

ppDispatch
Veja ppDispatch no IDocHostUIHandler::GetExternal SDK do Windows.

Valor de retorno

Retornos S_OK do sucesso ou E_NOTIMPL do fracasso.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::GetExternal, conforme descrito no SDK do Windows.

CDHtmlDialog::GetHostInfo

Recupera as capacidades da interface do anfitrião.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Parâmetros

pInfo
Veja pInfo no IDocHostUIHandler::GetHostInfo SDK do Windows.

Valor de retorno

Retorna S_OK.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::GetHostInfo, conforme descrito no SDK do Windows.

CDHtmlDialog::GetOptionKeyPath

Recupera a chave do registo sob a qual as preferências do utilizador são armazenadas.

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

Parâmetros

pchKey
Veja pchKey no IDocHostUIHandler::GetOptionKeyPath SDK do Windows.

dw
Veja dw no IDocHostUIHandler::GetOptionKeyPath SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::GetOptionKeyPath, conforme descrito no SDK do Windows.

CDHtmlDialog::HideUI

Esconde a interface do anfitrião.

STDMETHOD(HideUI)(void);

Valor de retorno

Retorna E_NOTIMPL.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::HideUI, conforme descrito no SDK do Windows.

CDHtmlDialog::IsExternalDispatchSafe

Indica se a interface do IDispatch host é segura para scripting.

virtual BOOL IsExternalDispatchSafe();

Valor de retorno

Retorna FALSE.

CDHtmlDialog::LoadFromResource

Carrega o recurso especificado no controlo do Navegador Web no diálogo DHTML.

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

Parâmetros

lpszResource
Um ponteiro para uma string contendo o nome do recurso a carregar.

nRes
O ID do recurso a carregar.

Valor de retorno

TRUE se for bem-sucedida; caso contrário, FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Indica se deve usar o título do documento HTML como legenda de diálogo.

BOOL m_bUseHtmlTitle;

Observações

Se m_bUseHtmlTitle for TRUE, a legenda do diálogo é definida igual ao título do documento HTML; caso contrário, a legenda no recurso de diálogo é utilizada.

CDHtmlDialog::m_nHtmlResID

ID do recurso HTML a ser exibido.

UINT m_nHtmlResID;

Example

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

CDHtmlDialog::m_pBrowserApp

Um apontador para uma aplicação de navegador Web.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Um ponteiro para um documento HTML.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

A URL atual.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

Versão em cadeia do ID de recurso HTML.

LPTSTR m_szHtmlResID;

Example

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

CDHtmlDialog::Navigate

Navega até ao recurso identificado pela URL especificada por lpszURL.

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

Parâmetros

lpszURL
Um ponteiro para uma string contendo a URL a ser direcionada.

dwFlags
Os flags de uma variável que especificam se deve adicionar o recurso à lista de histórico, se deve ler para a cache ou escrever a partir da cache, e se deve mostrar o recurso numa nova janela. A variável pode ser uma combinação dos valores definidos pela BrowserNavConstants enumeração.

lpszTargetFrameName
Um apontador para uma string que contém o nome do quadro onde se deve apresentar o recurso.

lpszHeaders
Um apontador para um valor que especifica os cabeçalhos HTTP a enviar para o servidor. Estes cabeçalhos são adicionados aos cabeçalhos predefinidos do Internet Explorer. Os cabeçalhos podem especificar informações como a ação exigida ao servidor, o tipo de dados a ser passado ao servidor ou um código de estado. Este parâmetro é ignorado se o URL não for um URL HTTP.

lpvPostData
Um ponteiro para os dados a enviar com a transação HTTP POST. Por exemplo, a transação POST é usada para enviar dados recolhidos por um formulário HTML. Se este parâmetro não especificar nenhum dado de publicação, emite Navigate uma transação HTTP GET. Este parâmetro é ignorado se o URL não for um URL HTTP.

dwPostDataLen
Dados a enviar com a transação HTTP POST. Por exemplo, a transação POST é usada para enviar dados recolhidos por um formulário HTML. Se este parâmetro não especificar nenhum dado de publicação, emite Navigate uma transação HTTP GET. Este parâmetro é ignorado se o URL não for um URL HTTP.

CDHtmlDialog::OnBeforeNavigate

Chamado pela estrutura para causar um disparo de um evento antes de ocorrer uma navegação.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parâmetros

pDisp
Um apontador para um IDispatch objeto.

szUrl
Um ponteiro para uma string contendo o URL para navegar.

CDHtmlDialog::OnDocumentComplete

Chamado pelo framework para notificar uma candidatura quando um documento atingiu o READYSTATE_COMPLETE estado.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parâmetros

pDisp
Um apontador para um IDispatch objeto.

szUrl
Um ponteiro para uma string contendo o URL para onde foi navegado.

CDHtmlDialog::OnDocWindowActivate

Chamado pela estrutura quando a janela do documento é ativada ou desativada.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Parâmetros

fActivate
Veja fActivate no IDocHostUIHandler::OnDocWindowActivate SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::OnDocWindowActivate, conforme descrito no SDK do Windows.

CDHtmlDialog::OnFrameWindowActivate

Chamada pela estrutura quando a janela da moldura é ativada ou desativada.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Parâmetros

fActivate
Veja fActivate no IDocHostUIHandler::OnFrameWindowActivate SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::OnFrameWindowActivate, conforme descrito no SDK do Windows.

CDHtmlDialog::OnInitDialog

Liguei em resposta à WM_INITDIALOG mensagem.

virtual BOOL OnInitDialog();

Valor de retorno

A implementação padrão devolve TRUE.

Observações

Esta mensagem é enviada para a caixa de diálogo durante as Createchamadas , CreateIndirect, ou DoModal que ocorrem imediatamente antes da exibição da caixa de diálogo.

Substitua esta função de membro se precisar de realizar um processamento especial quando a caixa de diálogo for inicializada. Na versão sobreposta, primeiro chama a classe OnInitDialog base mas ignora o seu valor de retorno. Normalmente regressarás TRUE da função de membro sobreposto.

O Windows chama a OnInitDialog função através do procedimento padrão global de caixa de diálogo comum a todas as caixas de diálogo da Microsoft Foundation Class Library, em vez de através do seu mapa de mensagens, por isso não precisa de uma entrada de mapa de mensagens para esta função membro.

CDHtmlDialog::OnNavigateComplete

Chamado pela framework após a navegação até ao URL especificado ser concluída.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parâmetros

pDisp
Um apontador para um IDispatch objeto.

szUrl
Um ponteiro para uma string contendo o URL para onde foi navegado.

CDHtmlDialog::ResizeBorder

Alerta o objeto de que precisa de redimensionar o espaço da fronteira.

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

Parâmetros

prcBorder
Veja prcBorder no IDocHostUIHandler::ResizeBorder SDK do Windows.

pUIWindow
Veja pUIWindow no IDocHostUIHandler::ResizeBorder SDK do Windows.

fFrameWindow
Veja fFrameWindow no IDocHostUIHandler::ResizeBorder SDK do Windows.

Valor de retorno

Devolve E_NOTIMPL.

CDHtmlDialog::SetControlProperty

Define a propriedade de um controlo ActiveX para um novo valor.

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

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

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

Parâmetros

szElementId
O ID HTML de um controlo ActiveX.

dispId
O ID de despacho da propriedade a definir.

pVar
Apontador para um VARIANT que contém o novo valor da propriedade.

pdispControl
Apontar para a interface de IDispatch um controlo ActiveX.

szPropName
String contendo o nome da propriedade a definir.

CDHtmlDialog::SetElementHtml

Define a innerHTML propriedade de um elemento HTML.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Parâmetros

szElementId
O ID de um elemento HTML.

bstrText
O novo valor da innerHTML propriedade.

punkElem
O IUnknown ponteiro de um elemento HTML.

CDHtmlDialog::SetElementProperty

Define uma propriedade de um elemento HTML.

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

Parâmetros

szElementId
O ID de um elemento HTML.

dispId
O ID de despacho da propriedade a definir.

pVar
O novo valor do imóvel.

CDHtmlDialog::SetElementText

Define a innerText propriedade de um elemento HTML.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Parâmetros

szElementId
O ID de um elemento HTML.

bstrText
O novo valor da innerText propriedade.

punkElem
O IUnknown ponteiro de um elemento HTML.

CDHtmlDialog::SetExternalDispatch

Define a interface do IDispatch anfitrião.

void SetExternalDispatch(IDispatch* pdispExternal);

Parâmetros

pdispExternal
A nova IDispatch interface.

CDHtmlDialog::SetHostFlags

Define os flags da interface do anfitrião.

void SetHostFlags(DWORD dwFlags);

Parâmetros

dwFlags
Para valores possíveis, veja DOCHOSTUIFLAG no SDK do Windows.

CDHtmlDialog::ShowContextMenu

Chamada quando um menu de contexto está prestes a ser exibido.

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

Parâmetros

dwID
Veja dwID no IDocHostUIHandler::ShowContextMenu SDK do Windows.

ppt
Veja ppt no IDocHostUIHandler::ShowContextMenu SDK do Windows.

pcmdtReserved
Veja pcmdtReserved no IDocHostUIHandler::ShowContextMenu SDK do Windows.

pdispReserved
Veja pdispReserved no IDocHostUIHandler::ShowContextMenu SDK do Windows.

Valor de retorno

Retorna S_FALSE.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::ShowContextMenu, conforme descrito no SDK do Windows.

CDHtmlDialog::ShowUI

Mostra a interface do anfitrião.

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

Parâmetros

dwID
Veja dwID no IDocHostUIHandler::ShowUI SDK do Windows.

pActiveObject
Veja pActiveObject no IDocHostUIHandler::ShowUI SDK do Windows.

pCommandTarget
Veja pCommandTarget no IDocHostUIHandler::ShowUI SDK do Windows.

pFrame
Veja pFrame no IDocHostUIHandler::ShowUI SDK do Windows.

pDoc
Veja pDoc no IDocHostUIHandler::ShowUI SDK do Windows.

Valor de retorno

Retorna S_FALSE.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::ShowUI, conforme descrito no SDK do Windows.

CDHtmlDialog::TranslateAccelerator

Chamado para processar mensagens de acelerador de menu.

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

Parâmetros

lpMsg
Veja lpMsg no IDocHostUIHandler::TranslateAccelerator SDK do Windows.

pguidCmdGroup
Veja pguidCmdGroup no IDocHostUIHandler::TranslateAccelerator SDK do Windows.

nCmdID
Veja nCmdID no IDocHostUIHandler::TranslateAccelerator SDK do Windows.

Valor de retorno

Retorna S_FALSE.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::TranslateAccelerator, conforme descrito no SDK do Windows.

CDHtmlDialog::TranslateUrl

Chamado para modificar o URL a ser carregado.

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

Parâmetros

dwTranslate
Veja dwTranslate no IDocHostUIHandler::TranslateUrl SDK do Windows.

pchURLIn
Veja pchURLIn no IDocHostUIHandler::TranslateUrl SDK do Windows.

ppchURLOut
Veja ppchURLOut no IDocHostUIHandler::TranslateUrl SDK do Windows.

Valor de retorno

Retorna S_FALSE.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::TranslateUrl, conforme descrito no SDK do Windows.

CDHtmlDialog::UpdateUI

Liguei para notificar o anfitrião que o estado do comando mudou.

STDMETHOD(UpdateUI)(void);

Valor de retorno

Retorna E_NOTIMPL.

Observações

Esta função membro é a CDHtmlDialog implementação de IDocHostUIHandler::UpdateUI, conforme descrito no SDK do Windows.

Consulte também

Exemplo MFC DHtmlExplore
DDX_DHtml Macros Auxiliares
Gráfico de Hierarquia