Partilhar via

Classe CDHtmlDialog

  • Artigo

É 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çalhoafxdhtml.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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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 Devolução

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