Classe `CDHtmlDialog`

Artigo
07/05/2024

É usado para criar caixas de diálogo que usam HTML em vez de recursos de diálogo para implementar a interface do usuário.

Sintaxe

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Membros

Construtores públicos

Nome	Descrição
`CDHtmlDialog::CDHtmlDialog`	Constrói um objeto CDHtmlDialog.
`CDHtmlDialog::~CDHtmlDialog`	Destrói um objeto CDHtmlDialog.

Métodos públicos

Nome	Descrição
`CDHtmlDialog::CanAccessExternal`	Substituível que é chamado como uma verificação de acesso para ver se os objetos de script na página carregada podem acessar a expedição externa do site de controle. Verifica se a expedição é segura para scripts ou se a zona atual permite objetos que não são seguros para scripts.
`CDHtmlDialog::CreateControlSite`	Substituível usado para criar uma instância do site de controle para hospedar o controle WebBrowser na caixa de diálogo.
`CDHtmlDialog::DDX_DHtml_AxControl`	Troca dados entre uma variável membro e o valor da propriedade de um controle ActiveX em uma página HTML.
`CDHtmlDialog::DDX_DHtml_CheckBox`	Troca dados entre uma variável membro e uma caixa de seleção em uma página HTML.
`CDHtmlDialog::DDX_DHtml_ElementText`	Troca dados entre uma variável membro e qualquer propriedade de elemento HTML em uma página HTML.
`CDHtmlDialog::DDX_DHtml_Radio`	Troca dados entre uma variável membro e um botão de opção em uma página HTML.
`CDHtmlDialog::DDX_DHtml_SelectIndex`	Obtém ou define o índice de uma caixa de listagem em uma página HTML.
`CDHtmlDialog::DDX_DHtml_SelectString`	Obtém ou define o texto de exibição de uma entrada de caixa de listagem (com base no índice atual) em uma página HTML.
`CDHtmlDialog::DDX_DHtml_SelectValue`	Obtém ou define o valor de uma entrada de caixa de listagem (com base no índice atual) em uma página HTML.
`CDHtmlDialog::DestroyModeless`	Destrói uma caixa de diálogo sem janela restrita.
`CDHtmlDialog::EnableModeless`	Habilita caixas de diálogo sem janela restrita.
`CDHtmlDialog::FilterDataObject`	Permite que a caixa de diálogo filtre objetos de dados da área de transferência criados pelo navegador hospedado.
`CDHtmlDialog::GetControlDispatch`	Recupera a interface `IDispatch` em um controle ActiveX inserido no documento HTML.
`CDHtmlDialog::GetControlProperty`	Recupera a propriedade solicitada do controle ActiveX especificado.
`CDHtmlDialog::GetCurrentUrl`	Recupera a URL (Uniform Resource Locator) associada ao documento atual.
`CDHtmlDialog::GetDHtmlDocument`	Recupera a interface `IHTMLDocument2` no documento HTML atualmente carregado.
`CDHtmlDialog::GetDropTarget`	Chamado pelo controle WebBrowser contido quando ele está sendo usado como um destino suspenso para permitir que a caixa de diálogo forneça um `IDropTarget` alternativo.
`CDHtmlDialog::GetElement`	Obtém uma interface em um elemento HTML.
`CDHtmlDialog::GetElementHtml`	Recupera a propriedade `innerHTML` de um elemento HTML.
`CDHtmlDialog::GetElementInterface`	Recupera o ponteiro de interface solicitado de um elemento HTML.
`CDHtmlDialog::GetElementProperty`	Recupera o valor da propriedade de um elemento HTML.
`CDHtmlDialog::GetElementText`	Recupera a propriedade `innerText` de um elemento HTML.
`CDHtmlDialog::GetEvent`	Obtém o ponteiro `IHTMLEventObj` para o objeto de evento atual.
`CDHtmlDialog::GetExternal`	Obtém a interface `IDispatch` do host.
`CDHtmlDialog::GetHostInfo`	Recupera as funcionalidades da interface do usuário do host.
`CDHtmlDialog::GetOptionKeyPath`	Recupera a chave do Registro na qual as preferências do usuário são armazenadas.
`CDHtmlDialog::HideUI`	Oculta a interface do usuário do host.
`CDHtmlDialog::IsExternalDispatchSafe`	Indica se a interface `IDispatch` do host é segura para scripts.
`CDHtmlDialog::LoadFromResource`	Carrega o recurso especificado no controle WebBrowser.
`CDHtmlDialog::Navigate`	Navega para a URL especificada.
`CDHtmlDialog::OnBeforeNavigate`	Chamado pela estrutura antes de um evento de navegação ser acionado.
`CDHtmlDialog::OnDocumentComplete`	Chamado pela estrutura para notificar um aplicativo quando um documento chegar ao estado `READYSTATE_COMPLETE`.
`CDHtmlDialog::OnDocWindowActivate`	Chamado pela estrutura quando a janela do documento é ativada ou desativada.
`CDHtmlDialog::OnFrameWindowActivate`	Chamado pela estrutura quando a janela de quadro é ativada ou desativada.
`CDHtmlDialog::OnInitDialog`	Chamado em resposta à mensagem `WM_INITDIALOG`.
`CDHtmlDialog::OnNavigateComplete`	Chamado pela estrutura após a conclusão de um evento de navegação.
`CDHtmlDialog::ResizeBorder`	Alerta o objeto de que ele precisa redimensionar seu espaço de borda.
`CDHtmlDialog::SetControlProperty`	Define a propriedade de um controle ActiveX como um novo valor.
`CDHtmlDialog::SetElementHtml`	Define a propriedade `innerHTML` de um elemento HTML.
`CDHtmlDialog::SetElementProperty`	Define uma propriedade de um elemento HTML.
`CDHtmlDialog::SetElementText`	Define a propriedade `innerText` de um elemento HTML.
`CDHtmlDialog::SetExternalDispatch`	Define a interface `IDispatch` do host.
`CDHtmlDialog::SetHostFlags`	Define os sinalizadores de interface do usuário do host.
`CDHtmlDialog::ShowContextMenu`	Chamado quando um menu de contexto está prestes a ser exibido.
`CDHtmlDialog::ShowUI`	Mostra a interface do usuário do host.
`CDHtmlDialog::TranslateAccelerator`	Chamado para processar mensagens de tecla aceleradora de menu.
`CDHtmlDialog::TranslateUrl`	Chamado para modificar a URL a ser carregada.
`CDHtmlDialog::UpdateUI`	Chamado para notificar o host de que o estado do comando foi alterado.

Membros de Dados Públicos

Nome	Descrição
`CDHtmlDialog::m_bUseHtmlTitle`	Indica se o título do documento HTML deve ser usado como a legenda da caixa de diálogo.
`CDHtmlDialog::m_nHtmlResID`	ID de recurso referente ao recurso HTML a ser exibido.
`CDHtmlDialog::m_pBrowserApp`	Um ponteiro para um aplicativo do navegador da Web.
`CDHtmlDialog::m_spHtmlDoc`	Um ponteiro para um documento HTML.
`CDHtmlDialog::m_strCurrentUrl`	A URL atual.
`CDHtmlDialog::m_szHtmlResID`	Versão da cadeia de caracteres da ID do recurso HTML.

Comentários

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

CDHtmlDialog também pode fazer a troca de dados com controles HTML e manipular eventos de controles HTML, como cliques de botão.

Hierarquia de herança

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Requisitos

Cabeçalho: afxdhtml.h

`DDX_DHtml` Macros auxiliares

As macros auxiliares DDX_DHtml permitem acesso fácil às propriedades comumente usadas de controles em uma página HTML.

Macros de troca de dados

Nome	Descrição
`DDX_DHtml_ElementValue`	Define ou recupera a propriedade Value do controle selecionado.
`DDX_DHtml_ElementInnerText`	Define ou recupera o texto entre as marcas inicial e final do elemento atual.
`DDX_DHtml_ElementInnerHtml`	Define ou recupera o HTML entre as marcas inicial e final do elemento atual.
`DDX_DHtml_Anchor_Href`	Define ou recupera a URL de destino ou o ponto de ancoragem.
`DDX_DHtml_Anchor_Target`	Define ou recupera a janela ou o quadro de destino.
`DDX_DHtml_Img_Src`	Define ou recupera o nome de uma imagem ou um clipe de vídeo no documento.
`DDX_DHtml_Frame_Src`	Define ou recupera a URL do quadro associado.
`DDX_DHtml_IFrame_Src`	Define ou recupera a URL do quadro associado.

`CDHtmlDialog::CanAccessExternal`

Substituível que é chamado como uma verificação de acesso para ver se os objetos de script na página carregada podem acessar a expedição externa do site de controle. Verifica se a expedição é segura para scripts ou se a zona atual permite objetos que não são seguros para scripts.

virtual BOOL CanAccessExternal();

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

`CDHtmlDialog::CDHtmlDialog`

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

CDHtmlDialog();

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

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

Parâmetros

lpszTemplateName
A cadeia de caracteres terminada em nulo que é o nome de um recurso de modelo de caixa de diálogo.

szHtmlResID
A cadeia de caracteres terminada em nulo que é o nome de um recurso HTML.

pParentWnd
Um ponteiro para o objeto de janela pai ou proprietário (do tipo CWnd) ao qual o objeto de caixa de diálogo pertence. Se for NULL, a janela pai do objeto de caixa de diálogo será definida como a janela principal do aplicativo.

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

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

Comentários

A segunda forma do construtor dá acesso ao recurso de caixa de diálogo por meio do nome do modelo. A terceira forma do construtor dá acesso ao recurso de caixa de diálogo por meio da ID do modelo de recurso. Normalmente, a ID começa com o prefixo IDD_.

`CDHtmlDialog::~CDHtmlDialog`

Destrói um objeto CDHtmlDialog.

virtual ~CDHtmlDialog();

Comentários

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

`CDHtmlDialog::CreateControlSite`

Substituível usado para criar uma instância do site de controle para hospedar o controle WebBrowser na caixa de diálogo.

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

Parâmetros

pContainer
Um ponteiro para o COleControlContainer objeto.

ppSite
Um ponteiro para um ponteiro para um COleControlSite.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

Você pode substituir essa função de membro para retornar uma instância de sua classe de site de controle.

`CDHtmlDialog::DDX_DHtml_AxControl`

Troca dados entre uma variável membro e o valor da propriedade de um controle ActiveX em uma 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 objeto CDataExchange.

szId
O valor do parâmetro de ID da marca de objeto na fonte HTML para o controle ActiveX.

dispId
A ID de expedição da propriedade com a qual você deseja trocar dados.

szPropName
O nome da propriedade.

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

Exemplo

// 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 em uma página HTML.

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

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange.

szId
O valor especificado para o parâmetro de ID do controle HTML.

value
O valor que está sendo trocado.

Exemplo

// 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 em uma 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 objeto CDataExchange.

szId
O valor especificado para o parâmetro de ID do controle HTML.

dispId
A ID de expedição do elemento HTML com o qual você deseja trocar dados.

value
O valor que está sendo trocado.

`CDHtmlDialog::DDX_DHtml_Radio`

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

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

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange.

szId
O valor especificado para o parâmetro de ID do controle HTML.

value
O valor que está sendo trocado.

`CDHtmlDialog::DDX_DHtml_SelectIndex`

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

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

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange.

szId
O valor especificado para o parâmetro id do controle HTML.

value
O valor que está sendo trocado.

`CDHtmlDialog::DDX_DHtml_SelectString`

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

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

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange.

szId
O valor especificado para o parâmetro de ID do controle HTML.

value
O valor que está sendo trocado.

`CDHtmlDialog::DDX_DHtml_SelectValue`

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

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

Parâmetros

pDX
Um ponteiro para um objeto CDataExchange.

szId
O valor especificado para o parâmetro de ID do controle HTML.

value
O valor que está sendo trocado.

Exemplo

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

`CDHtmlDialog::DestroyModeless`

Desanexa uma caixa de diálogo sem janela restrita do objeto CDHtmlDialog e destrói o objeto.

void DestroyModeless();

`CDHtmlDialog::EnableModeless`

Habilita caixas de diálogo sem janela restrita.

STDMETHOD(EnableModeless)(BOOL fEnable);

Parâmetros

fEnable
Consulte fEnable em IDocHostUIHandler::EnableModeless no SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

Comentários

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

`CDHtmlDialog::FilterDataObject`

Permite que a caixa de diálogo filtre objetos de dados da área de transferência criados pelo navegador hospedado.

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

Parâmetros

pDO
Consulte pDO em IDocHostUIHandler::FilterDataObject no SDK do Windows.

ppDORet
Consulte ppDORet em IDocHostUIHandler::FilterDataObject no SDK do Windows.

Valor de retorno

Retorna S_FALSE.

Comentários

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

`CDHtmlDialog::GetControlDispatch`

Recupera a interface IDispatch em um controle ActiveX inserido no documento HTML retornado por GetDHtmlDocument.

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

Parâmetros

szId
A ID HTML de um controle ActiveX.

ppdisp
A interface IDispatch do controle, se encontrada na página da Web.

Valor de retorno

Um valor HRESULT padrão.

`CDHtmlDialog::GetControlProperty`

Recupera a propriedade solicitada do controle ActiveX especificado.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Parâmetros

szId
A ID HTML de um controle ActiveX.

szPropName
O nome de uma propriedade na localidade padrão do usuário atual.

pdispControl
O ponteiro IDispatch de um controle ActiveX.

dispId
A ID de expedição de uma propriedade.

Valor de retorno

Uma variante que contém a propriedade solicitada ou uma variante vazia se o controle ou a propriedade não puder ser encontrado.

Comentários

As sobrecargas são listadas das menos eficientes na parte superior para as mais eficientes na parte inferior.

`CDHtmlDialog::GetCurrentUrl`

Recupera a URL (Uniform Resource Locator) associada ao documento atual.

void GetCurrentUrl(CString& szUrl);

Parâmetros

szUrl
Um objeto CString que contém a URL a ser recuperada.

`CDHtmlDialog::GetDHtmlDocument`

Recupera a interface IHTMLDocument2 no documento HTML atualmente carregado.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Parâmetros

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

Valor de retorno

Um HRESULT padrão. Retorna S_OK se houver êxito.

`CDHtmlDialog::GetDropTarget`

Chamado pelo controle WebBrowser contido quando ele está sendo usado como um destino suspenso para permitir que a caixa de diálogo forneça um IDropTarget alternativo.

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

Parâmetros

pDropTarget
Consulte pDropTarget em IDocHostUIHandler::GetDropTarget no SDK do Windows.

ppDropTarget
Consulte ppDropTarget em IDocHostUIHandler::GetDropTarget no SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

Comentários

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

`CDHtmlDialog::GetElement`

Retorna 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
A ID de um elemento HTML.

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

pbCollection
Um BOOL que indica se o objeto representado por ppdisp é um só elemento ou uma coleção de elementos.

pphtmlElement
Um ponteiro IHTMLElement para o elemento solicitado.

Valor de retorno

Um valor HRESULT padrão.

Comentários

Use a primeira sobrecarga se precisar lidar com condições nas quais pode haver mais de um elemento com a ID especificada. Você pode usar o último parâmetro para descobrir se o ponteiro de interface retornado é para uma coleção ou um só item. Se o ponteiro da interface estiver em uma coleção, você poderá consultar IHTMLElementCollection e usar sua propriedade item para se referir aos elementos por posição ordinal.

A segunda sobrecarga falhará se houver mais de um elemento com a mesma ID na página.

`CDHtmlDialog::GetElementHtml`

Recupera a propriedade innerHTML do elemento HTML identificado por szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

Parâmetros

szElementId
A ID de um elemento HTML.

Valor de retorno

A propriedade innerHTML do elemento HTML identificado por szElementId ou NULL se o elemento não pôde ser encontrado.

`CDHtmlDialog::GetElementInterface`

Recupera o ponteiro de interface solicitado 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
A 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 IID (identificador de interface) da interface solicitada.

Valor de retorno

Um valor HRESULT padrão.

Exemplo

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 do elemento HTML identificado por szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Parâmetros

szElementId
A ID de um elemento HTML.

dispId
A ID de expedição de uma propriedade.

Valor de retorno

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

`CDHtmlDialog::GetElementText`

Recupera a propriedade innerText do elemento HTML identificado por szElementId.

BSTR GetElementText(LPCTSTR szElementId);

Parâmetros

szElementId
A ID de um elemento HTML.

Valor de retorno

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

`CDHtmlDialog::GetEvent`

Retorna o ponteiro IHTMLEventObj para o objeto de evento atual.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Parâmetros

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

Valor de retorno

Um valor HRESULT padrão.

Comentários

Essa função só deve ser chamada de dentro de um manipulador de eventos DHTML.

`CDHtmlDialog::GetExternal`

Obtém a interface IDispatch do host.

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Parâmetros

ppDispatch
Consulte ppDispatch em IDocHostUIHandler::GetExternal no SDK do Windows.

Valor de retorno

Retornará S_OK se houver êxito ou E_NOTIMPL se houver falha.

Comentários

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

`CDHtmlDialog::GetHostInfo`

Recupera as funcionalidades da interface do usuário do host.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Parâmetros

pInfo
Consulte pInfo em IDocHostUIHandler::GetHostInfo no SDK do Windows.

Valor de retorno

Retorna S_OK.

Comentários

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

`CDHtmlDialog::GetOptionKeyPath`

Recupera a chave do Registro na qual as preferências do usuário são armazenadas.

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

Parâmetros

pchKey
Consulte pchKey em IDocHostUIHandler::GetOptionKeyPath no SDK do Windows.

dw
Consulte dw em IDocHostUIHandler::GetOptionKeyPath no SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

Comentários

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

`CDHtmlDialog::HideUI`

Oculta a interface do usuário do host.

STDMETHOD(HideUI)(void);

Valor de retorno

Retorna E_NOTIMPL.

Comentários

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

`CDHtmlDialog::IsExternalDispatchSafe`

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

virtual BOOL IsExternalDispatchSafe();

Valor de retorno

Retorna FALSE.

`CDHtmlDialog::LoadFromResource`

Carrega o recurso especificado no controle WebBrowser na caixa de diálogo DHTML.

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

Parâmetros

lpszResource
Um ponteiro para uma cadeia de caracteres contendo o nome do recurso a ser carregado.

nRes
ID do pool de recursos a carregar.

Valor de retorno

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

`CDHtmlDialog::m_bUseHtmlTitle`

Indica se o título do documento HTML deve ser usado como a legenda da caixa de diálogo.

BOOL m_bUseHtmlTitle;

Comentários

Se m_bUseHtmlTitle for TRUE, a legenda da caixa de diálogo será definida como o título do documento HTML; caso contrário, a legenda no recurso de caixa de diálogo será usada.

`CDHtmlDialog::m_nHtmlResID`

ID de recurso referente ao recurso HTML a ser exibido.

UINT m_nHtmlResID;

Exemplo

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

`CDHtmlDialog::m_pBrowserApp`

Um ponteiro para um aplicativo do navegador da 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 da cadeia de caracteres da ID do recurso HTML.

LPTSTR m_szHtmlResID;

Exemplo

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

`CDHtmlDialog::Navigate`

Navega até o 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 cadeia de caracteres que contém a URL a ser direcionada.

dwFlags
Os sinalizadores de uma variável que especifica se o recurso deve ser adicionado à lista de histórico, se deve ser lido no cache ou gravado do cache e se o usuário deseja exibir o recurso em uma nova janela. A variável pode ser uma combinação dos valores definidos pela enumeração BrowserNavConstants.

lpszTargetFrameName
Um ponteiro para uma cadeia de caracteres que contém o nome do quadro no qual exibir o recurso.

lpszHeaders
Um ponteiro para um valor que especifica os cabeçalhos HTTP a serem enviados para o servidor. Esses cabeçalhos são adicionados aos cabeçalhos padrão do Internet Explorer. Os cabeçalhos podem especificar informações como a ação necessária do servidor, o tipo de dados que está sendo passado para o servidor ou um código de status. Esse parâmetro será ignorado se a URL não for uma URL HTTP.

lpvPostData
Um ponteiro para os dados a serem enviados com a transação HTTP POST. Por exemplo, a transação POST é usada para enviar dados coletados por um formulário HTML. Se esse parâmetro não especificar nenhum pós-dado, Navigate emitirá uma transação HTTP GET. Esse parâmetro será ignorado se a URL não for uma URL HTTP.

dwPostDataLen
Dados a serem enviados com a transação HTTP POST. Por exemplo, a transação POST é usada para enviar dados coletados por um formulário HTML. Se esse parâmetro não especificar nenhum pós-dado, Navigate emitirá uma transação HTTP GET. Esse parâmetro será ignorado se a URL não for uma URL HTTP.

`CDHtmlDialog::OnBeforeNavigate`

Chamado pela estrutura para fazer com que um evento seja acionado antes que ocorra uma navegação.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parâmetros

pDisp
Um ponteiro para um objeto IDispatch.

szUrl
Um ponteiro para uma cadeia de caracteres que contém a URL para a qual navegar.

`CDHtmlDialog::OnDocumentComplete`

Chamado pela estrutura para notificar um aplicativo quando um documento atingir o estado READYSTATE_COMPLETE.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parâmetros

pDisp
Um ponteiro para um objeto IDispatch.

szUrl
Um ponteiro para uma cadeia de caracteres que contém a URL para a qual o usuário navegou.

`CDHtmlDialog::OnDocWindowActivate`

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

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Parâmetros

fActivate
Consulte fActivate em IDocHostUIHandler::OnDocWindowActivate no SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

Comentários

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

`CDHtmlDialog::OnFrameWindowActivate`

Chamado pela estrutura quando a janela de quadro é ativada ou desativada.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Parâmetros

fActivate
Consulte fActivate em IDocHostUIHandler::OnFrameWindowActivate no SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

Comentários

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

`CDHtmlDialog::OnInitDialog`

Chamado em resposta à mensagem WM_INITDIALOG.

virtual BOOL OnInitDialog();

Valor de retorno

A implementação padrão retorna TRUE.

Comentários

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

Substitua essa função de membro se você precisar executar o processamento especial quando a caixa de diálogo for inicializada. Na versão substituída, primeiro chame a classe base OnInitDialog, mas desconsidere o valor retornado. Normalmente, você retornará TRUE de sua função de membro substituída.

O Windows chama a função OnInitDialog por meio do procedimento de caixa de diálogo global padrão comum a todas as caixas de diálogo da biblioteca Microsoft Foundation Class, em vez de por meio do mapa de mensagens, para que você não precise de uma entrada de mapa de mensagens para essa função de membro.

`CDHtmlDialog::OnNavigateComplete`

Chamado pela estrutura após a navegação para a URL especificada ser concluída.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parâmetros

pDisp
Um ponteiro para um objeto IDispatch.

szUrl
Um ponteiro para uma cadeia de caracteres que contém a URL para a qual o usuário navegou.

`CDHtmlDialog::ResizeBorder`

Alerta o objeto de que ele precisa redimensionar seu espaço de borda.

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

Parâmetros

prcBorder
Consulte prcBorder em IDocHostUIHandler::ResizeBorder no SDK do Windows.

pUIWindow
Consulte pUIWindow em IDocHostUIHandler::ResizeBorder no SDK do Windows.

fFrameWindow
Consulte fFrameWindow em IDocHostUIHandler::ResizeBorder no SDK do Windows.

Valor de retorno

Retorna E_NOTIMPL.

`CDHtmlDialog::SetControlProperty`

Define a propriedade de um controle ActiveX como 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
A ID HTML de um controle ActiveX.

dispId
A ID de expedição da propriedade a ser definida.

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

pdispControl
Ponteiro para a interface de IDispatch um controle ActiveX.

szPropName
Cadeia de caracteres contendo o nome da propriedade a ser definida.

`CDHtmlDialog::SetElementHtml`

Define a propriedade innerHTML de um elemento HTML.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Parâmetros

szElementId
A ID de um elemento HTML.

bstrText
O novo valor da propriedade innerHTML.

punkElem
O ponteiro IUnknown de um elemento HTML.

`CDHtmlDialog::SetElementProperty`

Define uma propriedade de um elemento HTML.

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

Parâmetros

szElementId
A ID de um elemento HTML.

dispId
A ID de expedição da propriedade a ser definida.

pVar
O novo valor da propriedade.

`CDHtmlDialog::SetElementText`

Define a propriedade innerText de um elemento HTML.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Parâmetros

szElementId
A ID de um elemento HTML.

bstrText
O novo valor da propriedade innerText.

punkElem
O ponteiro IUnknown de um elemento HTML.

`CDHtmlDialog::SetExternalDispatch`

Define a interface IDispatch do host.

void SetExternalDispatch(IDispatch* pdispExternal);

Parâmetros

pdispExternal
A nova interface IDispatch.

`CDHtmlDialog::SetHostFlags`

Define os sinalizadores da interface do usuário do host.

void SetHostFlags(DWORD dwFlags);

Parâmetros

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

`CDHtmlDialog::ShowContextMenu`

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

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

Parâmetros

dwID
Consulte dwID em IDocHostUIHandler::ShowContextMenu no SDK do Windows.

ppt
Consulte ppt em IDocHostUIHandler::ShowContextMenu no SDK do Windows.

pcmdtReserved
Consulte pcmdtReserved em IDocHostUIHandler::ShowContextMenu no SDK do Windows.

pdispReserved
Consulte pdispReserved em IDocHostUIHandler::ShowContextMenu no SDK do Windows.

Valor de retorno

Retorna S_FALSE.

Comentários

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

`CDHtmlDialog::ShowUI`

Mostra a interface do usuário do host.

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

Parâmetros

dwID
Consulte dwID em IDocHostUIHandler::ShowUI no SDK do Windows.

pActiveObject
Consulte pActiveObject em IDocHostUIHandler::ShowUI no SDK do Windows.

pCommandTarget
Consulte pCommandTarget em IDocHostUIHandler::ShowUI no SDK do Windows.

pFrame
Consulte pFrame em IDocHostUIHandler::ShowUI no SDK do Windows.

pDoc
Consulte pDoc em IDocHostUIHandler::ShowUI no SDK do Windows.

Valor de retorno

Retorna S_FALSE.

Comentários

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

`CDHtmlDialog::TranslateAccelerator`

Chamado para processar mensagens de tecla aceleradora de menu.

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

Parâmetros

lpMsg
Consulte lpMsg em IDocHostUIHandler::TranslateAccelerator no SDK do Windows.

pguidCmdGroup
Consulte pguidCmdGroup em IDocHostUIHandler::TranslateAccelerator no SDK do Windows.

nCmdID
Consulte nCmdID em IDocHostUIHandler::TranslateAccelerator no SDK do Windows.

Valor de retorno

Retorna S_FALSE.

Comentários

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

`CDHtmlDialog::TranslateUrl`

Chamado para modificar a URL a ser carregada.

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

Parâmetros

dwTranslate
Consulte dwTranslate em IDocHostUIHandler::TranslateUrl no SDK do Windows.

pchURLIn
Consulte pchURLIn em IDocHostUIHandler::TranslateUrl no SDK do Windows.

ppchURLOut
Consulte ppchURLOut em IDocHostUIHandler::TranslateUrl no SDK do Windows.

Valor de retorno

Retorna S_FALSE.

Comentários

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

`CDHtmlDialog::UpdateUI`

Chamado para notificar o host de que o estado do comando foi alterado.

STDMETHOD(UpdateUI)(void);

Valor de retorno

Retorna E_NOTIMPL.

Comentários

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

Confira também

Exemplo de MFC DHtmlExplore
DDX_DHtml Macros auxiliares
Gráfico da hierarquia

Compartilhar via

Classe CDHtmlDialog

Sintaxe

Membros

Construtores públicos

Métodos públicos

Membros de Dados Públicos

Comentários

Hierarquia de herança

Requisitos

DDX_DHtml Macros auxiliares

Macros de troca de dados

CDHtmlDialog::CanAccessExternal

Valor de retorno

CDHtmlDialog::CDHtmlDialog

Parâmetros

Comentários

CDHtmlDialog::~CDHtmlDialog

Comentários

CDHtmlDialog::CreateControlSite

Parâmetros

Valor de retorno

Comentários

CDHtmlDialog::DDX_DHtml_AxControl

Parâmetros

Exemplo

CDHtmlDialog::DDX_DHtml_CheckBox

Parâmetros

Exemplo

CDHtmlDialog::DDX_DHtml_ElementText

Parâmetros

CDHtmlDialog::DDX_DHtml_Radio

Parâmetros

CDHtmlDialog::DDX_DHtml_SelectIndex

Parâmetros

CDHtmlDialog::DDX_DHtml_SelectString

Parâmetros

CDHtmlDialog::DDX_DHtml_SelectValue

Parâmetros

Exemplo

CDHtmlDialog::DestroyModeless

CDHtmlDialog::EnableModeless

Parâmetros

Valor de retorno

Comentários

CDHtmlDialog::FilterDataObject

Parâmetros

Valor de retorno

Comentários

CDHtmlDialog::GetControlDispatch

Parâmetros

Valor de retorno

CDHtmlDialog::GetControlProperty

Parâmetros

Valor de retorno

Comentários

CDHtmlDialog::GetCurrentUrl

Parâmetros

CDHtmlDialog::GetDHtmlDocument

Parâmetros

Valor de retorno

CDHtmlDialog::GetDropTarget

Parâmetros

Valor de retorno

Comentários

CDHtmlDialog::GetElement

Parâmetros

Valor de retorno

Comentários

CDHtmlDialog::GetElementHtml

Parâmetros

Valor de retorno

CDHtmlDialog::GetElementInterface

Parâmetros

Valor de retorno

Exemplo

CDHtmlDialog::GetElementProperty

Parâmetros

Valor de retorno

CDHtmlDialog::GetElementText

Classe `CDHtmlDialog`

`DDX_DHtml` Macros auxiliares

`CDHtmlDialog::CanAccessExternal`

`CDHtmlDialog::CDHtmlDialog`

`CDHtmlDialog::~CDHtmlDialog`

`CDHtmlDialog::CreateControlSite`

`CDHtmlDialog::DDX_DHtml_AxControl`

`CDHtmlDialog::DDX_DHtml_CheckBox`

`CDHtmlDialog::DDX_DHtml_ElementText`

`CDHtmlDialog::DDX_DHtml_Radio`

`CDHtmlDialog::DDX_DHtml_SelectIndex`

`CDHtmlDialog::DDX_DHtml_SelectString`

`CDHtmlDialog::DDX_DHtml_SelectValue`

`CDHtmlDialog::DestroyModeless`

`CDHtmlDialog::EnableModeless`

`CDHtmlDialog::FilterDataObject`

`CDHtmlDialog::GetControlDispatch`

`CDHtmlDialog::GetControlProperty`

`CDHtmlDialog::GetCurrentUrl`

`CDHtmlDialog::GetDHtmlDocument`

`CDHtmlDialog::GetDropTarget`

`CDHtmlDialog::GetElement`

`CDHtmlDialog::GetElementHtml`

`CDHtmlDialog::GetElementInterface`

`CDHtmlDialog::GetElementProperty`

`CDHtmlDialog::GetElementText`

`CDHtmlDialog::GetEvent`

`CDHtmlDialog::GetExternal`

`CDHtmlDialog::GetHostInfo`

`CDHtmlDialog::GetOptionKeyPath`

`CDHtmlDialog::HideUI`

`CDHtmlDialog::IsExternalDispatchSafe`

`CDHtmlDialog::LoadFromResource`

`CDHtmlDialog::m_bUseHtmlTitle`

`CDHtmlDialog::m_nHtmlResID`

`CDHtmlDialog::m_pBrowserApp`

`CDHtmlDialog::m_spHtmlDoc`

`CDHtmlDialog::m_strCurrentUrl`

`CDHtmlDialog::m_szHtmlResID`

`CDHtmlDialog::Navigate`

`CDHtmlDialog::OnBeforeNavigate`

`CDHtmlDialog::OnDocumentComplete`

`CDHtmlDialog::OnDocWindowActivate`

`CDHtmlDialog::OnFrameWindowActivate`

`CDHtmlDialog::OnInitDialog`

`CDHtmlDialog::OnNavigateComplete`

`CDHtmlDialog::ResizeBorder`

`CDHtmlDialog::SetControlProperty`

`CDHtmlDialog::SetElementHtml`

`CDHtmlDialog::SetElementProperty`

`CDHtmlDialog::SetElementText`

`CDHtmlDialog::SetExternalDispatch`

`CDHtmlDialog::SetHostFlags`