Partilhar via

Classe CHtmlView

  • Artigo

Fornece a funcionalidade do controle WebBrowser dentro do contexto da arquitetura de documento/exibição do MFC.

Sintaxe

class CHtmlView : public CFormView

Membros

Métodos públicos

Nome Descrição
CHtmlView::Create Cria o controle WebBrowser.
CHtmlView::CreateControlSite Substituível, usado para criar uma instância do site de controle para hospedar um controle no formulário.
CHtmlView::ExecFormsCommand Executa o comando especificado usando o método IOleCommandTarget::Exec.
CHtmlView::ExecWB Executa um comando.
CHtmlView::GetAddressBar Determina se a barra de endereços do objeto Internet Explorer está visível. (O controle WebBrowser ignora; somente Internet Explorer.)
CHtmlView::GetApplication Recupera um objeto de aplicativo que representa o aplicativo que contém a instância atual do aplicativo Internet Explorer.
CHtmlView::GetBusy Recupera um valor que indica se um download ou outra atividade ainda está em andamento.
CHtmlView::GetContainer Recupera o contêiner do controle WebBrowser.
CHtmlView::GetFullName Recupera o nome completo, incluindo o caminho, do recurso exibido no navegador da Web. (O controle WebBrowser ignora; somente Internet Explorer.)
CHtmlView::GetFullScreen Indica se o controle WebBrowser está operando no modo de tela inteira ou no modo de janela normal.
CHtmlView::GetHeight Recupera a altura da janela principal do Internet Explorer.
CHtmlView::GetHtmlDocument Recupera o documento HTML ativo.
CHtmlView::GetLeft Recupera a coordenada de tela da borda esquerda da janela principal do Internet Explorer.
CHtmlView::GetLocationName Recupera o nome do recurso que o WebBrowser está exibindo no momento
CHtmlView::GetLocationURL Recupera a URL do recurso que o WebBrowser está exibindo no momento.
CHtmlView::GetMenuBar Recupera um valor que determina se a barra de menus está visível.
CHtmlView::GetOffline Recupera um valor que determina se o controle está offline.
CHtmlView::GetParentBrowser Um ponteiro para a interface IDispatch. Para obter mais informações, confira Como implementar a interface IDispatch.
CHtmlView::GetProperty Recupera o valor atual de uma propriedade associada ao objeto fornecido.
CHtmlView::GetReadyState Recupera o estado pronto do objeto do navegador da Web.
CHtmlView::GetRegisterAsBrowser Indica se o controle WebBrowser está registrado como um navegador de nível superior para resolução de nomes de destino.
CHtmlView::GetRegisterAsDropTarget Indica se o controle WebBrowser está registrado como um destino de soltar para navegação.
CHtmlView::GetSilent Indica se alguma caixa de diálogo pode ser mostrada.
CHtmlView::GetSource O código-fonte HTML da página da Web.
CHtmlView::GetStatusBar Indica se a barra de status do Internet Explorer está visível. (O controle WebBrowser ignora; somente Internet Explorer.)
CHtmlView::GetTheaterMode Indica se o controle WebBrowser está no modo de teatro.
CHtmlView::GetToolBar Recupera um valor que determina se a barra de ferramentas está visível.
CHtmlView::GetTop Recupera a coordenada de tela da borda superior da janela principal do Internet Explorer.
CHtmlView::GetTopLevelContainer Recupera um valor que indica se o objeto atual é o contêiner de nível superior do controle WebBrowser.
CHtmlView::GetType Recupera o nome do tipo do objeto do documento.
CHtmlView::GetVisible Recupera um valor que indica se o objeto está visível ou oculto.
CHtmlView::GetWidth Recupera a largura da janela principal do Internet Explorer.
CHtmlView::GoBack Navega para o item anterior na lista de históricos.
CHtmlView::GoForward Navega até o próximo item na lista de históricos.
CHtmlView::GoHome Navega até a página inicial ou inicial atual.
CHtmlView::GoSearch Navega até a página de pesquisa atual.
CHtmlView::LoadFromResource Carrega um recurso no controle WebBrowser.
CHtmlView::Navigate Navega até o recurso identificado por uma URL.
CHtmlView::Navigate2 Navega até o recurso identificado por uma URL ou para o arquivo identificado por um caminho completo.
CHtmlView::OnBeforeNavigate2 Chamado antes que uma operação de navegação ocorra no WebBrowser fornecido (em uma janela ou elemento de conjunto de quadros).
CHtmlView::OnCommandStateChange Chamado para notificar um aplicativo de que o estado habilitado de um comando do navegador da Web foi alterado.
CHtmlView::OnDocumentComplete Chamado para notificar um aplicativo de que um documento atingiu o estado READYSTATE_COMPLETE.
CHtmlView::OnDocWindowActivate Chamado da implementação do Internet Explorer ou MSHTML de IOleInPlaceActiveObject::OnDocWindowActivate, que notifica o objeto in-loco ativo quando a janela do documento do contêiner é ativada ou desativada.
CHtmlView::OnDownloadBegin Chamado para notificar um aplicativo de que uma operação de navegação está começando.
CHtmlView::OnDownloadComplete Chamado quando uma operação de navegação terminou, foi interrompida ou falhou.
CHtmlView::OnEnableModeless Chamado para habilitar ou desabilitar caixas de diálogo sem janela restrita quando o contêiner cria ou destrói uma caixa de diálogo modal.
CHtmlView::OnFilterDataObject Chamado no host pelo Internet Explorer ou MSHTML para permitir que o host substitua o Internet Explorer ou o objeto de dados do MSHTML.
CHtmlView::OnFrameWindowActivate Chamado de IOleInPlaceActiveObject::OnFrameWindowActivate para notificar o objeto quando a janela de quadro de nível superior do contêiner é ativada ou desativada.
CHtmlView::OnFullScreen Chamado quando a propriedade FullScreen é alterada.
CHtmlView::OnGetDropTarget Chamado pelo Internet Explorer ou MSHTML quando ele está sendo usado como um destino de soltar para permitir que o host forneça um IDropTarget alternativo.
CHtmlView::OnGetExternal Chamado pelo Internet Explorer ou MSHTML para obter a interface IDispatch do host.
CHtmlView::OnGetHostInfo Recupera os recursos de interface do usuário do host do Internet Explorer ou MSHTML.
CHtmlView::OnGetOptionKeyPath Retorna a chave do Registro na qual o Internet Explorer ou MSHTML armazena as preferências do usuário.
CHtmlView::OnHideUI Chamado quando o Internet Explorer ou MSHTML remove seus menus e barras de ferramentas.
CHtmlView::OnMenuBar Chamado quando a propriedade MenuBar é alterada.
CHtmlView::OnNavigateComplete2 Chamado após a navegação para um hiperlink concluído (em uma janela ou elemento de conjunto de quadros).
CHtmlView::OnNavigateError Chamado pela estrutura se a navegação para um hiperlink falhar.
CHtmlView::OnNewWindow2 Chamado quando uma nova janela deve ser criada para exibir um recurso.
CHtmlView::OnProgressChange Chamado para notificar um aplicativo de que o progresso de uma operação de download foi atualizado.
CHtmlView::OnPropertyChange Chamado para notificar um aplicativo de que o método PutProperty alterou o valor de uma propriedade.
CHtmlView::OnQuit Chamado para notificar um aplicativo de que o aplicativo Internet Explorer está pronto para ser encerrado. (Aplica-se somente ao Internet Explorer)
CHtmlView::OnResizeBorder Chamado da implementação do Internet Explorer ou do MSHTML de IOleInPlaceActiveObject::ResizeBorder, que alerta o objeto de que ele precisa para redimensionar seu espaço de borda.
CHtmlView::OnShowContextMenu Chamado do Internet Explorer ou MSHTML quando ele está prestes a mostrar seu menu de contexto.
CHtmlView::OnShowUI Chamado antes do Internet Explorer ou MSHTML exibir seus menus e barras de ferramentas.
CHtmlView::OnStatusBar Chamado quando a propriedade StatusBar é alterada.
CHtmlView::OnStatusTextChange Chamado para notificar um aplicativo de que o texto da barra de status associada ao controle WebBrowser foi alterado.
CHtmlView::OnTheaterMode Chamado quando a propriedade TheaterMode é alterada.
CHtmlView::OnTitleChange Chamado para notificar um aplicativo se o título de um documento no controle WebBrowser ficar disponível ou mudar.
CHtmlView::OnToolBar Chamado quando a propriedade ToolBar é alterada.
CHtmlView::OnTranslateAccelerator Chamado pelo Internet Explorer ou MSHTML quando IOleInPlaceActiveObject::TranslateAccelerator ou IOleControlSite::TranslateAccelerator é chamado para processar mensagens de tecla de acelerador de menu da fila de mensagens do contêiner.
CHtmlView::OnTranslateUrl Chamado pelo Internet Explorer ou MSHTML para permitir que o host tenha a oportunidade de modificar a URL a ser carregada.
CHtmlView::OnUpdateUI Notifica o host de que o estado do comando foi alterado.
CHtmlView::OnVisible Chamado quando a janela para o controle WebBrowser deve ser mostrada/ocultada.
CHtmlView::PutProperty Define o valor de uma propriedade associada ao objeto fornecido.
CHtmlView::QueryFormsCommand Consulta o status de um ou mais comandos gerados pelos eventos da interface do usuário.
CHtmlView::QueryStatusWB Consulta o status de um comando que está sendo processado pelo controle WebBrowser.
CHtmlView::Refresh Recarrega o arquivo atual.
CHtmlView::Refresh2 Recarrega o arquivo atual e, opcionalmente, impede que o cabeçalho pragma:nocache seja enviado.
CHtmlView::SetAddressBar Mostra ou oculta a barra de endereços do objeto Internet Explorer. (O controle WebBrowser ignora; somente Internet Explorer.)
CHtmlView::SetFullScreen Define um valor para determinar se o controle está operando no modo de tela inteira ou no modo de janela normal. (O controle WebBrowser ignora; somente Internet Explorer.)
CHtmlView::SetHeight Define a altura da janela principal do Internet Explorer.
CHtmlView::SetLeft Define a posição horizontal da janela principal do Internet Explorer.
CHtmlView::SetMenuBar Define um valor para determinar se a barra de menus do controle está visível. (O controle WebBrowser ignora; somente Internet Explorer.)
CHtmlView::SetOffline Define um valor para determinar se o controle está offline.
CHtmlView::SetRegisterAsBrowser Define um valor que indica se o controle WebBrowser está registrado como um navegador de nível superior para resolução de nomes de destino.
CHtmlView::SetRegisterAsDropTarget Define um valor que indica se o controle WebBrowser está registrado como um destino de soltar para navegação.
CHtmlView::SetSilent Define um valor para determinar se o controle exibirá caixas de diálogo.
CHtmlView::SetStatusBar Define um valor para determinar se a barra de status do Internet Explorer está visível. (O controle WebBrowser ignora; somente Internet Explorer.)
CHtmlView::SetTheaterMode Define um valor que indica se o controle WebBrowser está no modo de teatro.
CHtmlView::SetToolBar Define um valor para determinar se a barra de ferramentas do controle está visível. (O controle WebBrowser ignora; somente Internet Explorer.)
CHtmlView::SetTop Define a posição vertical da janela principal do Internet Explorer.
CHtmlView::SetVisible Define um valor que indica se o objeto está visível ou oculto.
CHtmlView::SetWidth Define a largura da janela principal do Internet Explorer.
CHtmlView::Stop Para de abrir um arquivo.

Comentários

O controle WebBrowser é uma janela na qual o usuário pode procurar sites na World Wide Web e pastas no sistema de arquivos local e em uma rede. O controle WebBrowser dá suporte a hiperlink e navegação em URL (Uniform Resource Locator), além de manter uma lista de histórico.

Como usar a classe CHtmlView em um aplicativo MFC

No aplicativo de estrutura MFC padrão (baseado em SDI ou MDI), o objeto de exibição geralmente é derivado de um conjunto especializado de classes. Essas classes, todas derivadas de CView, fornecem funcionalidade especializada além daquela oferecida por CView.

Basear a classe de exibição do aplicativo em CHtmlView fornece a exibição com o controle WebBrowser. Isso efetivamente torna o aplicativo um navegador da Web. O método preferido de criar um aplicativo no estilo navegador da Web é usar o Assistente de Aplicativo MFC e especificar CHtmlView como a classe de exibição. Para mais informações sobre como implementar e usar o controle WebBrowser em aplicativos MFC, confira Como criar um aplicativo estilo navegador da Web.

Observação

O controle ActiveX do WebBrowser (e, portanto, CHtmlView) está disponível apenas para programas em execução em Windows NT versões 4.0 ou posteriores nas quais o Internet Explorer 4.0 ou posterior foi instalado.

CHtmlView foi projetado para aplicativos que acessam a Web (e/ou documentos HTML). As funções de membro CHtmlView a seguir se aplicam somente ao aplicativo Internet Explorer. Essas funções terão êxito no controle WebBrowser, mas não terão efeito visível.

Hierarquia de herança

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

Requisitos

Cabeçalho: afxhtml.h

CHtmlView::Create

Chame essa função de membro para criar um contêiner ou controle WebBrowser para o executável do Internet Explorer.

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

Parâmetros

lpszClassName
Aponta para uma cadeia de caracteres terminada em nulo que nomeia a classe do Windows. O nome de classe pode ser qualquer nome registrado com a função global AfxRegisterWndClass ou a função do Windows RegisterClass. Se NULL, usa os atributos CFrameWnd padrão predefinidos.

lpszWindowName
Aponta para uma cadeia de caracteres terminada em nulo que representa o nome da janela.

dwStyle
Especifica os atributos de estilo de janela. Por padrão, os estilos do Windows WS_VISIBLE e WS_CHILD são definidos.

rect
Uma referência a uma estrutura RECT que especifica o tamanho e a posição da janela. O valor rectDefault permite que o Windows especifique o tamanho e a posição da nova janela.

pParentWnd
Um ponteiro para a janela pai do controle.

nID
O número de ID da exibição. Por padrão, definido como AFX_IDW_PANE_FIRST.

pContext
Um ponteiro para um CCreateContext. NULL por padrão.

CHtmlView::CreateControlSite

Substituível, usado para criar uma instância do site de controle para hospedar um controle no formulário.

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

Parâmetros

pContainer
Um ponteiro para um objeto COleControlContainer que contém o controle.

ppSite
Um ponteiro para um ponteiro para um objeto COleControlSite, fornecendo o site para o controle.

nID
O identificador do controle a ser hospedado.

clsid
O CLSID do controle a ser hospedado

Valor de retorno

Retornará TRUE se for bem-sucedido, FALSE em caso de falha.

Comentários

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

CHtmlView::ExecFormsCommand

Executa o comando especificado usando o método IOleCommandTarget::Exec.

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

Parâmetros

dwCommandID
O comando a ser executado. Esse comando deve pertencer ao grupo CMDSETID3_Forms3.

pVarIn
Ponteiro para uma estrutura VARIANT que contém argumentos de entrada. Pode ser NULL.

pVarOut
Ponteiro para uma estrutura VARIANT para receber a saída do comando. Pode ser NULL.

Valor de retorno

Um valor HRESULT padrão. Para uma listagem completa de valores possíveis, confira IOleCommandTarget::Exec no SDK do Windows.

Comentários

ExecFormsCommand implementa o comportamento do método IOleCommandTarget::Exec.

CHtmlView::ExecWB

Chame essa função de membro para executar um comando no WebBrowser ou no Internet Explorer.

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

Parâmetros

cmdID
O comando a ser executado.

cmdexecopt
As opções definidas para executar o comando.

pvaIn
Uma variante usada para especificar argumentos de entrada de comando.

pvaOut
Uma variante usada para especificar argumentos de saída de comando.

Comentários

Consulte IWebBrowser2::ExecWB no SDK do Windows.

CHtmlView::GetAddressBar

Chame essa função de membro para recuperar a barra de endereços do Internet Explorer.

BOOL GetAddressBar() const;

Valor de retorno

Não zero se a barra de endereços estiver visível; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer. Se você usar essa chamada com um controle WebBrowser, nenhum erro será retornado, mas a chamada será ignorará.

CHtmlView::GetApplication

Chame essa função de membro para recuperar o objeto de automação compatível com o aplicativo que contém o controle WebBrowser.

LPDISPATCH GetApplication() const;

Valor de retorno

Um ponteiro para a interface IDispatch do objeto de documento ativo. Para obter mais informações, confira Como implementar a interface IDispatch.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetBusy

Chame essa função de membro para determinar se o controle WebBrowser está envolvido em uma operação de navegação ou de download.

BOOL GetBusy() const;

Valor de retorno

Diferente de zero se o navegador da Web estiver ocupado; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetContainer

Chame essa função de membro para recuperar um objeto avaliado para o contêiner do navegador da Web.

LPDISPATCH GetContainer() const;

Valor de retorno

Um ponteiro para a interface IDispatch do objeto de documento ativo.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetFullName

Chame essa função de membro para recuperar o caminho completo do arquivo que o Internet Explorer está exibindo no momento.

CString GetFullName() const;

Valor de retorno

Um objeto CString que contém o caminho e o nome do arquivo exibido no momento. Se nenhum caminho e nome de arquivo existirem, GetFullName retornará um CString vazio.

Comentários

Aplica-se ao Internet Explorer. Se você usar essa chamada com um controle WebBrowser, nenhum erro será retornado, mas a chamada será ignorará.

CHtmlView::GetFullScreen

Chame essa função de membro para determinar se o controle WebBrowser está operando no modo de tela inteira ou no modo de janela normal.

BOOL GetFullScreen() const;

Valor de retorno

Diferente de zero se o WebBrowser estiver operando no modo de tela inteira; caso contrário, zero.

Comentários

No modo de tela inteira, a janela principal do Internet Explorer é maximizada e a barra de status, a barra de ferramentas, a barra de menus e a barra de título são ocultadas.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetHeight

Chame essa função de membro para recuperar a altura, em pixels, da janela de quadro do controle WebBrowser.

long GetHeight() const;

Valor de retorno

A altura da janela do quadro do controle, em pixels.

CHtmlView::GetHtmlDocument

Chame essa função de membro para recuperar o documento HTML do documento ativo.

LPDISPATCH GetHtmlDocument() const;

Valor de retorno

Um ponteiro para a interface IDispatch do objeto de documento ativo.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetLeft

Chame essa função de membro para recuperar a distância entre a borda esquerda interna do controle WebBrowser e a borda esquerda de seu contêiner.

long GetLeft() const;

Valor de retorno

A distância da borda esquerda, em pixels.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetLocationName

Chame essa função de membro para obter o nome do recurso que está sendo exibido no WebBrowser.

CString GetLocationName() const;

Valor de retorno

Um objeto CString que contém o nome do recurso exibido atualmente no WebBrowser.

Comentários

Se o recurso for uma página HTML na World Wide Web, o nome será o título dessa página. Se o recurso for uma pasta ou arquivo na rede ou no computador local, o nome será UNC ou o caminho completo da pasta ou do arquivo.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetLocationURL

Chame essa função de membro para recuperar a URL do recurso que o controle WebBrowser está exibindo no momento.

CString GetLocationURL() const;

Valor de retorno

Um objeto CString que contém a URL do recurso exibido atualmente no WebBrowser.

Comentários

Se o recurso for uma pasta ou arquivo na rede ou no computador local, o nome será UNC ou o caminho completo da pasta ou do arquivo.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetMenuBar

Chame essa função de membro para determinar se a barra de menus está visível.

BOOL GetMenuBar() const;

Valor de retorno

Diferente de zero se a barra de menus estiver visível; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetOffline

Chame essa função de membro para determinar se o navegador da Web está operando offline.

BOOL GetOffline() const;

Valor de retorno

Diferente de zero se o navegador da Web estiver offline no momento; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetParentBrowser

Chame essa função de membro para recuperar um ponteiro para o objeto pai do controle WebBrowser.

LPDISPATCH GetParentBrowser() const;

Valor de retorno

Um ponteiro para a interface IDispatch do objeto que é o pai do controle WebBrowser.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetProperty

Chame essa função de membro para obter o valor da propriedade atualmente associada ao controle.

BOOL GetProperty(
    LPCTSTR lpszProperty,
    CString& strValue);

COleVariant GetProperty(LPCTSTR lpszProperty);

Parâmetros

lpszProperty
Um ponteiro para uma cadeia de caracteres que contém a propriedade a ser recuperada.

strValue
Uma referência a um objeto CString que recebe o valor atual da propriedade.

Valor de retorno

Na primeira versão, não zero se concluído com sucesso; caso contrário, zero. Na segunda versão, um objeto COleVariant.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetReadyState

Chame essa função de membro para recuperar o estado pronto do objeto WebBrowser.

READYSTATE GetReadyState() const;

Valor de retorno

Um valor READYSTATE, conforme descrito no SDK do Windows.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetRegisterAsBrowser

Chame essa função de membro para determinar se o objeto WebBrowser está registrado como um navegador de nível superior para resolução de nomes de destino.

BOOL GetRegisterAsBrowser() const;

Valor de retorno

Diferente de zero se o navegador estiver registrado como um navegador de nível superior; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetRegisterAsDropTarget

Chame essa função de membro para determinar se o controle WebBrowser está registrado como um destino de soltar para navegação.

BOOL GetRegisterAsDropTarget() const;

Valor de retorno

Diferente de zero se o navegador estiver registrado como um destino de soltar; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetSilent

Chame essa função de membro para determinar se alguma caixa de diálogo pode ser mostrada no controle WebBrowser.

BOOL GetSilent() const;

Valor de retorno

Diferente de zero se as caixas de diálogo não puderem ser exibidas no controle WebBrowser; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetSource

Chame essa função de membro para recuperar o código-fonte HTML para a página da Web.

BOOL GetSource(CString& strRef);

Valor de retorno

Diferente de zero se bem-sucedido; caso contrário, zero.

Parâmetros

refString
Um CString que conterá o código-fonte.

Comentários

Essa função é equivalente ao comando "View Source" no Internet Explorer, exceto que o código-fonte é retornado em um CString.

CHtmlView::GetStatusBar

Chame essa função de membro para determinar se o controle WebBrowser exibe uma barra de status.

BOOL GetStatusBar() const;

Valor de retorno

Diferente de zero se a barra de status puder ser exibida; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer. Se você usar essa chamada com um controle WebBrowser, nenhum erro será retornado, mas a chamada será ignorará.

CHtmlView::GetTheaterMode

Chame essa função de membro para determinar se o navegador da Web está no modo de teatro.

BOOL GetTheaterMode() const;

Valor de retorno

Diferente de zero se o navegador da Web estiver no modo de teatro; caso contrário, zero.

Comentários

Quando o navegador da Web está no modo de teatro, a janela principal do navegador preenche toda a tela, uma barra de ferramentas com um conjunto mínimo de ferramentas de navegação é exibida e a barra de status aparece no canto superior direito da tela.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetToolBar

Chame essa função de membro para determinar se a barra de ferramentas está visível.

int GetToolBar() const;

Valor de retorno

Um valor que indica se a barra de ferramentas está visível. Não zero se a barra de ferramentas estiver visível; caso contrário, zero.

CHtmlView::GetTop

Chame essa função de membro para recuperar a coordenada de tela da borda superior da janela principal do controle WebBrowser.

long GetTop() const;

Valor de retorno

Endereço de uma variável que recebe a coordenada de tela da borda superior da janela principal.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetTopLevelContainer

Chame essa função de membro para determinar se o Internet Explorer é o contêiner de nível superior do controle WebBrowser.

BOOL GetTopLevelContainer() const;

Valor de retorno

Não zero se o contêiner for o contêiner de nível superior; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetType

Chame essa função de membro para recuperar o nome do tipo do documento ativo contido.

CString GetType() const;

Valor de retorno

Um objeto CString que contém o nome do tipo do documento ativo contido.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetVisible

Chame essa função de membro para determinar se o objeto contido está visível.

BOOL GetVisible() const;

Valor de retorno

Não zero se o objeto está visível; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetWidth

Recupera a largura da janela principal do Internet Explorer.

long GetWidth() const;

Valor de retorno

A largura atual da janela em pixels.

CHtmlView::GoBack

Navega para trás um item na lista de histórico.

void GoBack();

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GoForward

Navega para frente um item na lista de histórico.

void GoForward();

CHtmlView::GoHome

Navega até a página inicial atual ou a página de início especificada na caixa de diálogo Opções de Internet do Internet Explorer ou na caixa de diálogo Propriedades da Internet, acessada no Painel de Controle.

void GoHome();

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GoSearch

Navega até a página de pesquisa atual, conforme especificado na caixa de diálogo Opções de Internet do Internet Explorer ou na caixa de diálogo Propriedades da Internet, acessada no Painel de Controle.

void GoSearch();

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::LoadFromResource

Chame essa função de membro para carregar o recurso especificado no controle WebBrowser.

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
A ID do buffer que contém o nome do recurso a ser carregado.

Valor de retorno

Diferente de zero se bem-sucedido; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

Chame essa função de membro para navegar até o recurso identificado por uma URL.

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

Parâmetros

URL
Uma cadeia de caracteres alocada por chamador que contém a URL para a qual navegar ou o caminho completo do arquivo a ser exibido.

dwFlags
Os sinalizadores de uma variável que especifica se o recurso deve ser adicionado à lista de histórico, se deve ser lido ou gravado do cache e se 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 coisas 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 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 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 URL não for uma URL HTTP.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

Chame essa função de membro para navegar até o recurso identificado por uma URL ou para o arquivo identificado por um caminho completo.

void Navigate2(
    LPITEMIDLIST pIDL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL);

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

void Navigate2(
    LPCTSTR lpszURL,
    DWORD dwFlags,
    CByteArray& baPostedData,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeader = NULL);

Parâmetros

pIDL
Um ponteiro para uma estrutura ITEMIDLIST.

dwFlags
Os sinalizadores de uma variável que especifica se o recurso deve ser adicionado à lista de histórico, se deve ser lido ou gravado do cache e se 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.

lpszURL
Um ponteiro para uma cadeia de caracteres que contém a URL.

lpvPostData
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, Navigate2 emitirá uma transação HTTP GET. Esse parâmetro será ignorado se URL não for uma URL HTTP ou HTTPS.

dwPostDataLen
Comprimento em bytes dos dados apontados pelo parâmetro lpvPostData.

lpszHeaders
Um ponteiro para um valor que especifica os cabeçalhos HTTP ou HTTPS 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 coisas 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 URL não for uma URL HTTP ou HTTPS.

baPostedData
Uma referência a um objeto CByteArray.

Comentários

Essa função membro estende a função Navigate membro dando suporte à navegação em pastas especiais, como Desktop e Meu Computador, que são representadas pelo parâmetro pIDL.

Aplica-se ao Internet Explorer e ao WebBrowser.

Exemplo

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

CHtmlView::OnBeforeNavigate2

Essa função membro é chamada pela estrutura para fazer com que um evento seja acionado antes que uma operação de navegação ocorra no navegador da Web.

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

Parâmetros

lpszURL
Ponteiro para uma cadeia de caracteres que contém a URL para a qual navegar.

nFlags
Reservado para uso futuro.

lpszTargetFrameName
Uma cadeia de caracteres que contém o nome do quadro no qual exibir o recurso ou NULL se nenhum quadro nomeado for direcionado para o recurso.

baPostedData
Uma referência a um objeto CByteArray que contém os dados a serem enviados ao servidor se a transação HTTP POST estiver sendo usada.

lpszHeaders
Um ponteiro para uma cadeia de caracteres que contém outros cabeçalhos HTTP a serem enviados para o servidor (somente URLs HTTP). Os cabeçalhos podem especificar coisas 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.

pbCancel
Um ponteiro para um sinalizador de cancelamento. Um aplicativo pode definir esse parâmetro como não zero para cancelar a operação de navegação ou zero para permitir que ela continue.

CHtmlView::OnCommandStateChange

Essa função de membro é chamada pela estrutura para notificar um aplicativo de que o estado habilitado de um comando do navegador da Web foi alterado.

virtual void OnCommandStateChange(
    long nCommand,
    BOOL bEnable);

Parâmetros

nCommand
Identificador do comando cujo estado habilitado foi alterado.

bEnable
Estado habilitado. Esse parâmetro será diferente de zero se o comando estiver habilitado; caso contrário, será zero.

CHtmlView::OnDocumentComplete

Essa função de membro é chamada pela estrutura para notificar um aplicativo de que um documento atingiu o estado READYSTATE_COMPLETE.

virtual void OnDocumentComplete(LPCTSTR lpszURL);

Parâmetros

lpszURL
Um ponteiro para uma cadeia de caracteres avaliada para a URL, o nome do arquivo UNC ou um PIDL (um ponteiro para uma lista de identificadores de item) para o qual se navegou.

Comentários

Nem todos os quadros dispararão esse evento, mas cada quadro que disparar um evento OnDownloadBegin disparará um evento OnDocumentComplete correspondente.

A URL indicada por lpszURL pode ser diferente da URL para a qual o navegador foi orientado a navegar, pois essa URL é a canônica e qualificada. Por exemplo, se um aplicativo especificar uma URL de "www.microsoft.com" em uma chamada para Navigate ou Navigate2, a URL passada por OnNavigateComplete2 será "<https://www.microsoft.com/>". Além disso, se o servidor tiver redirecionado o navegador para uma URL diferente, a URL redirecionada será refletida aqui.

CHtmlView::OnDocWindowActivate

Chamado da implementação do Internet Explorer ou MSHTML de IOleInPlaceActiveObject::OnDocWindowActivate, que notifica o objeto in-loco ativo quando a janela do documento do contêiner é ativada ou desativada.

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

Parâmetros

fActivate
Indica o estado da janela do documento. Se esse valor não for zero, a janela será ativada. Se esse valor for zero, a janela estará sendo desativada.

Valor de retorno

S_OK se bem-sucedido; caso contrário, um código de erro definido por OLE.

Comentários

Substitua OnDocWindowActivate para reagir à notificação OnDocWindowActivate do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::OnDocWindowActivate no SDK do Windows para mais informações.

CHtmlView::OnDownloadBegin

Essa função de membro é chamada pela estrutura para começar a baixar um documento.

virtual void OnDownloadBegin();

Comentários

Esse evento é acionado logo após o evento OnBeforeNavigate2, a menos que a navegação seja cancelada. Qualquer animação ou indicação de "ocupado" que o contêiner precisa exibir deve ser conectada a esse evento.

CHtmlView::OnDownloadComplete

Essa função de membro é chamada pela estrutura para indicar que uma operação de navegação foi concluída, foi interrompida ou falhou.

virtual void OnDownloadComplete();

CHtmlView::OnEnableModeless

Chamado quando o Internet Explorer ou MSHTML exibe a interface do usuário modal.

virtual HRESULT OnEnableModeless(BOOL fEnable);

Parâmetros

fEnable
Indica se as caixas de diálogo sem janela restrita do host estão habilitadas ou desabilitadas. Se esse valor não for zero, as caixas de diálogo sem janela restrita serão habilitadas. Se esse valor for zero, as caixas de diálogo sem janela restrita serão desabilitadas.

Valor de retorno

S_OK se bem-sucedido; caso contrário, um código de erro definido por OLE.

Comentários

Habilita ou desabilita caixas de diálogo sem janela restrita quando o contêiner cria ou destrói uma caixa de diálogo modal. Substitua OnEnableModeless para reagir à notificação EnableModeless do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::EnableModeless no SDK do Windows para mais informações.

CHtmlView::OnFilterDataObject

Chamado no host pelo Internet Explorer ou MSHTML para permitir que o host substitua o Internet Explorer ou o objeto de dados do MSHTML.

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

Parâmetros

pDataObject
Endereço da interface IDataObject fornecida pelo Internet Explorer ou MSHTML.

ppDataObject
Endereço que recebe o ponteiro da interface IDataObject fornecido pelo host. O conteúdo desse parâmetro sempre deve ser inicializado para NULL, mesmo que o método falhe.

Valor de retorno

S_OK se o objeto de dados for substituído; S_FALSE se o objeto de dados não for substituído; ou um código de erro definido por OLE, se ocorrer um erro.

Comentários

Substitua OnFilterDataObject para reagir à notificação FilterDataObject do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::FilterDataObject no SDK do Windows para mais informações.

CHtmlView::OnFrameWindowActivate

Chamado de IOleInPlaceActiveObject::OnFrameWindowActivate para notificar o objeto quando a janela de quadro de nível superior do contêiner é ativada ou desativada.

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

Parâmetros

fActivate
Indica o estado da janela de quadros de nível superior do contêiner. Se esse valor não for zero, a janela será ativada. Se esse valor for zero, a janela estará sendo desativada.

Valor de retorno

S_OK se bem-sucedido; caso contrário, um código de erro definido por OLE.

Comentários

Substitua OnFrameWindowActivate para reagir à notificação OnFrameWindowActivate do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::OnFrameWindowActivate no SDK do Windows para mais informações.

CHtmlView::OnFullScreen

Essa função de membro é chamada pela estrutura quando a propriedade FullScreen é alterada.

virtual void OnFullScreen(BOOL bFullScreen);

Parâmetros

bFullScreen
Não zero se o Internet Explorer estiver no modo de tela inteira; caso contrário, zero.

CHtmlView::OnGetDropTarget

Chamado pelo Internet Explorer ou MSHTML quando ele está sendo usado como um destino de soltar para permitir que o host forneça um IDropTarget alternativo.

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

Parâmetros

pDropTarget
IDropTarget que o Internet Explorer ou MSHTML propõe usar.

ppDropTarget
Endereço do IDropTarget que recebe o ponteiro de interface IDropTarget que o host deseja fornecer.

Valor de retorno

Confira IDocHostUIHandler::GetDropTarget no SDK do Windows uma lista de códigos de retorno.

Comentários

Substitua OnGetDropTarget para reagir à notificação GetDropTarget do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::GetDropTarget no SDK do Windows para mais informações.

CHtmlView::OnGetExternal

Chamado pelo Internet Explorer ou MSHTML para obter a interface IDispatch do host.

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

Parâmetros

lppDispatch
Um ponteiro para o endereço que recebe o ponteiro de interface IDispatch do aplicativo host. Se o host expor uma interface de Automação, ele poderá fornecer uma referência ao Internet Explorer ou MSHTML por meio desse parâmetro. O conteúdo desse parâmetro sempre deve ser inicializado para NULL, mesmo que o método falhe.

Valor de retorno

S_OK se bem-sucedido; caso contrário, um código de erro definido por OLE.

Comentários

Substitua OnGetExternal para reagir à notificação GetExternal do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::GetExternal no SDK do Windows para mais informações.

CHtmlView::OnGetHostInfo

Recupera os recursos de interface do usuário do host do Internet Explorer ou MSHTML.

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

Parâmetros

pInfo
Endereço de uma estrutura DOCHOSTUIINFO que recebe os recursos de interface do usuário do host.

Valor de retorno

S_OK se bem-sucedido; caso contrário, um código de erro definido por OLE.

Comentários

Substitua OnGetHostInfo para reagir à notificação GetHostInfo do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::GetHostInfo no SDK do Windows para mais informações.

CHtmlView::OnGetOptionKeyPath

Chame essa função de membro para obter a chave do Registro na qual o Internet Explorer ou o MSHTML armazena as preferências do usuário.

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

Parâmetros

pchKey
Endereço de um LPOLESTR que recebe a cadeia de caracteres de subchave do Registro em que o host armazena suas opções padrão. Essa subchave estará sob a chave HKEY_CURRENT_USER. Alocar essa memória usando CoTaskMemAlloc. O aplicativo de chamada é responsável por liberar essa memória usando CoTaskMemFree. Esse parâmetro sempre deve ser inicializado para NULL, mesmo que o método falhe.

dwReserved
Reservado para uso futuro. Não usado no momento.

Valor de retorno

S_OK se for bem-sucedido, caso contrário, S_FALSE. Se S_FALSE, Internet Explorer ou MSHTML usará como padrão as próprias opções de usuário.

Comentários

Substitua OnGetOptionKeyPath para reagir à notificação GetOptionKeyPath do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::GetOptionKeyPath no SDK do Windows para mais informações.

CHtmlView::OnHideUI

Essa função de membro é chamada pela estrutura quando o Internet Explorer ou o MSHTML remove seus menus e barras de ferramentas.

virtual HRESULT OnHideUI();

Valor de retorno

S_OK se bem-sucedido; caso contrário, um código de erro definido por OLE.

Comentários

Substitua OnHideUI para reagir à notificação HideUI do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::HideUI no SDK do Windows para mais informações.

CHtmlView::OnMenuBar

Essa função de membro é chamada pela estrutura quando a propriedade MenuBar é alterada.

virtual void OnMenuBar(BOOL bMenuBar);

Parâmetros

bMenuBar
Diferente de zero se a barra de menus do Internet Explorer estiver visível; caso contrário, zero.

CHtmlView::OnNavigateComplete2

Essa função membro é chamada pela estrutura após a navegação para um hiperlink ser concluída (em uma janela ou elemento de conjunto de quadros).

virtual void OnNavigateComplete2(LPCTSTR strURL);

Parâmetros

strURL
Uma expressão de cadeia de caracteres que é avaliada para a URL, o nome do arquivo UNC ou PIDL (um ponteiro para uma lista de identificadores de item) para o qual se navegou.

Comentários

O parâmetro de URL poderá ser um PIDL se houver uma entidade de espaço de nome de shell para a qual não haja declaração de URL.

A URL contida em strURL pode ser diferente da URL para a qual o navegador foi orientado a navegar, pois essa URL é a URL canônica e qualificada. Por exemplo, se um aplicativo especificar uma URL de "www.microsoft.com" em uma chamada para Navigate ou Navigate2, a URL passada por OnNavigateComplete2 será "<https://www.microsoft.com/>". Além disso, se o servidor tiver redirecionado o navegador para uma URL diferente, a URL redirecionada será refletida aqui.

CHtmlView::OnNavigateError

Chamado pela estrutura se a navegação para um hiperlink falhar.

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

Parâmetros

lpszURL
A URL para a qual a navegação falhou.

lpszFrame
O nome do quadro no qual o recurso deve ser exibido ou NULL se nenhum quadro nomeado foi direcionado para o recurso.

dwError
Um código de status de erro, se disponível. Para uma lista dos possíveis códigos de status HTTP e HRESULT, confira Códigos de Status de EventoNavigateError..

pbCancel
Especifica se deseja é preciso cancelar a navegação para uma página de erro ou qualquer outra pesquisa automática. Se TRUE (o padrão), continue com a navegação para uma página de erro ou pesquisa automática; se FALSE, cancelar a navegação para uma página de erro ou pesquisa automática.

Comentários

Substitua este método para fornecer tratamento de erro de navegação personalizado.

Para obter mais informações, veja DWebBrowserEvents2::NavigateError

CHtmlView::OnNewWindow2

Essa função de membro é chamada pela estrutura quando uma nova janela deve ser criada para exibir um recurso.

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

Parâmetros

ppDisp
Um ponteiro para um ponteiro de interface que, opcionalmente, recebe o ponteiro de interface IDispatch de um novo objeto WebBrowser ou Internet Explorer.

Cancel
Um ponteiro para um sinalizador de cancelamento. Um aplicativo pode definir esse parâmetro como não zero para cancelar a operação de navegação ou zero para permitir que ela continue.

Comentários

Esse evento precede a criação de uma nova janela de dentro do WebBrowser.

CHtmlView::OnProgressChange

Essa função de membro é chamada pela estrutura para notificar um aplicativo de que o andamento de uma operação de download foi atualizado.

virtual void OnProgressChange(
    long nProgress,
    long nProgressMax);

Parâmetros

nProgress
Quantidade de progresso total a ser mostrado ou -1 quando o progresso estiver concluído.

nProgressMax
Valor máximo do progresso.

Comentários

O contêiner pode usar as informações fornecidas por esse evento para exibir o número de bytes baixados até agora ou atualizar um indicador de progresso.

CHtmlView::OnPropertyChange

Essa função de membro é chamada pela estrutura para notificar um aplicativo de que PutProperty alterou o valor de uma propriedade.

virtual void OnPropertyChange(LPCTSTR lpszProperty);

Parâmetros

lpszProperty
Um ponteiro para uma cadeia de caracteres contendo o nome da propriedade.

CHtmlView::OnQuit

Essa função de membro é chamada pela estrutura para notificar um aplicativo de que o aplicativo Internet Explorer está pronto para ser encerrado.

virtual void OnQuit();

CHtmlView::OnResizeBorder

Chamado da implementação do Internet Explorer ou do MSHTML de IOleInPlaceActiveObject::ResizeBorder, que alerta o objeto de que ele precisa para redimensionar seu espaço de borda.

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

Parâmetros

prcBorder
Novo retângulo externo para espaço na borda.

pUIWindow
Um ponteiro para a interface do quadro ou objeto da janela do documento cuja borda foi alterada.

fFrameWindow
TRUE se a janela de quadro estiver chamando IOleInPlaceActiveObject::ResizeBorder, caso contrário FALSE.

Valor de retorno

S_OK se bem-sucedido; caso contrário, um código de erro definido por OLE.

Comentários

Substitua OnResizeBorder para reagir à notificação ResizeBorder do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::ResizeBorder no SDK do Windows para mais informações.

CHtmlView::OnShowContextMenu

Chamado do Internet Explorer ou MSHTML quando ele está prestes a mostrar seu menu de contexto.

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

Parâmetros

dwID
Identificador do menu de contexto a ser exibido. Confira IDocHostUIHandler::ShowContextMenu no SDK do Windows uma lista de valores.

ppt
Coordenadas de tela para o menu.

pcmdtReserved
Interface IOleCommandTarget usada para consultar o status do comando e executar comandos neste objeto.

pdispReserved
Interface IDispatch do objeto nas coordenadas da tela. Isso permite que um host diferencie objetos específicos para fornecer um contexto mais específico.

Valor de retorno

Confira IDocHostUIHandler::ShowContextMenu no SDK do Windows uma lista de valores.

Comentários

Substitua OnShowContextMenu para reagir à notificação ShowContextMenu do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::ShowContextMenu no SDK do Windows para mais informações.

CHtmlView::OnShowUI

Chamado antes do Internet Explorer ou MSHTML exibir seus menus e barras de ferramentas.

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

Parâmetros

dwID
Reservado para uso futuro.

pActiveObject
Interface IOleInPlaceActiveObject do objeto ativo no momento.

pCommandTarget
Interface IOleCommandTarget do objeto.

pFrame
Interface IOleInPlaceFrame do objeto. Isso é necessário para menus e barras de ferramentas.

pDoc
interface IOleInPlaceUIWindow para o objeto. Isso é necessário para barras de ferramentas.

Valor de retorno

Confira IDocHostUIHandler::ShowUI no SDK do Windows uma lista de valores.

Comentários

Substitua OnShowUI para reagir à notificação ShowUI do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::ShowUI no SDK do Windows para mais informações.

CHtmlView::OnStatusBar

Essa função de membro é chamada pela estrutura quando a propriedade StatusBar é alterada.

virtual void OnStatusBar(BOOL bStatusBar);

Parâmetros

bStatusBar
Diferente de zero se a barra de status do Internet Explorer estiver visível; caso contrário, zero.

CHtmlView::OnStatusTextChange

Essa função de membro é chamada pela estrutura para notificar um aplicativo de que o texto da barra de status associada ao controle WebBrowser foi alterado.

virtual void OnStatusTextChange(LPCTSTR lpszText);

Parâmetros

lpszText
Uma cadeia de caracteres que contém o novo texto da barra de status.

CHtmlView::OnTheaterMode

Essa função de membro é chamada pela estrutura quando a propriedade TheaterMode é alterada.

virtual void OnTheaterMode(BOOL bTheaterMode);

Parâmetros

bTheaterMode
Não zero se o Internet Explorer está no modo de teatro; caso contrário, zero.

CHtmlView::OnTitleChange

Essa função de membro será chamada pela estrutura para notificar um aplicativo se o título de um documento no controle WebBrowser ficar disponível ou mudar.

virtual void OnTitleChange(LPCTSTR lpszText);

Parâmetros

lpszText
O novo título do documento.

Comentários

Para HTML, o título pode mudar; enquanto o HTML ainda está baixando, a URL do documento é definida como o título. Depois que o título real (se houver um) for analisado do HTML, o título será alterado para refletir o título real.

CHtmlView::OnToolBar

Essa função de membro é chamada pela estrutura quando a propriedade ToolBar é alterada.

virtual void OnToolBar(BOOL bToolBar);

Parâmetros

bToolBar
Diferente de zero se a barra de ferramentas do Internet Explorer estiver visível; caso contrário, zero.

CHtmlView::OnTranslateAccelerator

Chamado pelo Internet Explorer ou MSHTML quando IOleInPlaceActiveObject::TranslateAccelerator ou IOleControlSite::TranslateAccelerator é chamado para processar mensagens de tecla de acelerador de menu da fila de mensagens do contêiner.

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

Parâmetros

lpMsg
Aponta para a mensagem que pode precisar ser traduzida.

pguidCmdGroup
Identificador de grupo de comandos.

nCmdID
Identificador de comando.

Valor de retorno

S_OK se for bem-sucedido, caso contrário, S_FALSE.

Comentários

Substitua OnTranslateAccelerator para reagir à notificação TranslateAccelerator do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::TranslateAccelerator no SDK do Windows para mais informações.

CHtmlView::OnTranslateUrl

Chamado pelo Internet Explorer ou MSHTML para permitir que o host tenha a oportunidade de modificar a URL a ser carregada.

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

Parâmetros

dwTranslate
Reservado para uso futuro.

pchURLIn
Endereço de uma cadeia de caracteres fornecida pelo Internet Explorer ou MSHTML que representa a URL a ser traduzida.

ppchURLOut
Endereço de um ponteiro de cadeia de caracteres que recebe o endereço da URL traduzida. O host aloca o buffer usando o alocador de memória da tarefa. O conteúdo desse parâmetro sempre deve ser inicializado para NULL, mesmo que a URL não seja traduzida ou o método falhe.

Valor de retorno

S_OK se a URL foi traduzida, S_FALSE se a URL não foi traduzida ou um código de erro definido por OLE se ocorreu um erro.

Comentários

Substitua OnTranslateUrl para reagir à notificação TranslateUrl do controle do Navegador da Web da Microsoft. Confira IDocHostUIHandler::TranslateUrl no SDK do Windows para mais informações.

CHtmlView::OnUpdateUI

Notifica o host de que o estado do comando foi alterado.

virtual HRESULT OnUpdateUI();

Valor de retorno

S_OK se bem-sucedido; caso contrário, um código de erro definido por OLE.

Comentários

O host deve atualizar o estado dos botões da barra de ferramentas. Esse método é chamado independentemente do valor retornado de ShowUI. Substitua OnUpdateUI para reagir à notificação UpdateUI do controle do Navegador da Web da Microsoft.

CHtmlView::OnVisible

Essa função de membro é chamada pela estrutura quando a janela do WebBrowser deve ser mostrada ou ocultada.

virtual void OnVisible(BOOL bVisible);

Parâmetros

bVisible
Não zero se o objeto estiver visível; caso contrário, zero.

Comentários

Isso permite que a janela do host de controle de objeto se comporte da mesma maneira que a janela do Internet Explorer se comportaria.

CHtmlView::PutProperty

Chame essa função de membro para definir a propriedade associada a um determinado objeto.

void PutProperty(
    LPCTSTR lpszProperty,
    const VARIANT& vtValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    double dValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    long lValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    LPCTSTR lpszValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    short nValue);

Parâmetros

lpszProperty
Uma cadeia de caracteres que contém a propriedade a ser definida.

vtValue
O novo valor da propriedade indicado por lpszProperty.

lpszPropertyName
Um ponteiro para uma cadeia de caracteres que contém o nome da propriedade a ser definida.

dValue
O novo valor da propriedade.

lValue
O novo valor da propriedade.

lpszValue
Um ponteiro para uma cadeia de caracteres que contém o novo valor da propriedade.

nValue
O novo valor da propriedade.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::QueryFormsCommand

Consulta o status de um ou mais comandos gerados pelos eventos da interface do usuário.

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

Parâmetros

dwCommandID
O identificador do comando que está sendo consultado.

pbSupported
Há suporte para um ponteiro para especificar BOOL se o comando (identificado por dwCommandID) tem suporte. Se TRUE, há suporte para o comando; caso contrário, FALSE.

pbEnabled
Um ponteiro para uma especificação BOOL se o comando (identificado por dwCommandID) está habilitado. Se TRUE, há suporte para o comando; caso contrário, FALSE.

pbChecked
Um ponteiro para uma especificação BOOL se o comando (identificado por dwCommandID) está marcado. Se TRUE, há suporte para o comando; caso contrário, FALSE.

Valor de retorno

Um valor HRESULT padrão. Para uma listagem completa de valores possíveis, confira IOleCommandTarget::QueryStatus no SDK do Windows.

Comentários

QueryFormsCommand implementa o comportamento do método IOleCommandTarget::QueryStatus.

CHtmlView::QueryStatusWB

Chame essa função de membro para consultar um status de comando.

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

Parâmetros

cmdID
O valor OLECMDID do comando para o qual o chamador precisa das informações de status.

Valor de retorno

O endereço do valor OLECMDF que recebe o status do comando.

Comentários

QueryStatusWB implementa o comportamento do método IOleCommandTarget::QueryStatus.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::Refresh

Recarrega a URL ou o arquivo que o navegador da Web está exibindo no momento.

void Refresh();

Comentários

Refresh não contém parâmetros para definir o nível de atualização.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::Refresh2

Recarrega o arquivo que o Internet Explorer está exibindo no momento.

void Refresh2(int nLevel);

Parâmetros

nLevel
O endereço da variável que especifica o nível de atualização. As variáveis possíveis são definidas no RefreshConstantsSDK do Windows.

Comentários

Ao contrário de Refresh, Refresh2 contém um parâmetro que especifica o nível de atualização.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetAddressBar

Chame essa função de membro para mostrar ou ocultar a barra de endereços do objeto Internet Explorer.

void SetAddressBar(BOOL bNewValue);

Parâmetros

bNewValue
Não zero para mostrar a barra de endereços; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer. Se você usar essa chamada com um controle WebBrowser, nenhum erro será retornado, mas a chamada será ignorará.

CHtmlView::SetFullScreen

Chame essa função de membro para definir o Internet Explorer para o modo de janela normal ou de tela inteira.

void SetFullScreen(BOOL bNewValue);

Parâmetros

bNewValue
Não zero para o modo de tela inteira; caso contrário, zero.

Comentários

No modo de tela inteira, a janela principal do Internet Explorer é maximizada e a barra de status, a barra de ferramentas, a barra de menus e a barra de título são ocultadas.

Aplica-se ao Internet Explorer. Se você usar essa chamada com um controle WebBrowser, nenhum erro será retornado, mas a chamada será ignorará.

CHtmlView::SetHeight

Chame essa função de membro para definir a altura da janela principal do Internet Explorer.

void SetHeight(long nNewValue);

Parâmetros

nNewValue
A altura, em pixels, da janela principal.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetLeft

Define a posição horizontal da janela principal do Internet Explorer.

void SetLeft(long nNewValue);

Parâmetros

nNewValue
A coordenada da tela da borda esquerda da janela principal.

CHtmlView::SetMenuBar

Chame essa função de membro para mostrar ou ocultar a barra de menus do Internet Explorer.

void SetMenuBar(BOOL bNewValue);

Parâmetros

bNewValue
Não zero para mostrar a barra de menus; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer. Se você usar essa chamada com um controle WebBrowser, nenhum erro será retornado, mas a chamada será ignorará.

CHtmlView::SetOffline

Chame essa função de membro para definir um valor que indica se o controle WebBrowser está operando no modo offline no momento.

void SetOffline(BOOL bNewValue);

Parâmetros

bNewValue
Não zero para ler do cache local; caso contrário, zero.

Comentários

No modo offline, o navegador lê páginas HTML do cache local em vez do documento de origem.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetRegisterAsBrowser

Chame essa função de membro para definir um valor que indica se o controle WebBrowser está registrado como um navegador de nível superior para resolução de nomes de destino.

void SetRegisterAsBrowser(BOOL bNewValue);

Parâmetros

bNewValue
Determina se o Internet Explorer está registrado como um navegador de nível superior. Se não for zero, o navegador da Web será registrado como um navegador de nível superior; se for zero, não será um navegador de nível superior. O valor padrão é zero.

Comentários

Um navegador de nível superior é o navegador definido no Registro como o navegador padrão.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetRegisterAsDropTarget

Chame essa função de membro para definir um valor que indica se o controle WebBrowser está registrado como um destino de soltar para navegação.

void SetRegisterAsDropTarget(BOOL bNewValue);

Parâmetros

bNewValue
Determina se o controle WebBrowser está registrado como um destino de soltar para navegação. Se não for zero, o objeto será registrado como um destino de soltar; se for zero, não será um destino de soltar.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetSilent

Chame essa função de membro para definir um valor que indica se alguma caixa de diálogo pode ser mostrada.

void SetSilent(BOOL bNewValue);

Parâmetros

bNewValue
Se não for zero, as caixas de diálogo não serão exibidas; se zero, as caixas de diálogo serão exibidas. O valor padrão é zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetStatusBar

Chame essa função de membro para exibir a barra de status.

void SetStatusBar(BOOL bNewValue);

Parâmetros

bNewValue
Não zero se a barra de status estiver visível; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer. Se você usar essa chamada com um controle WebBrowser, nenhum erro será retornado, mas a chamada será ignorará.

CHtmlView::SetTheaterMode

Chame essa função de membro para definir um valor que indica se o controle WebBrowser está no modo de teatro.

void SetTheaterMode(BOOL bNewValue);

Parâmetros

bNewValue
Não zero para definir o controle WebBrowser para o modo de teatro; caso contrário, zero. O valor padrão é zero.

Comentários

Quando o navegador da Web está no modo de teatro, a janela principal do navegador preenche toda a tela, uma barra de ferramentas com um conjunto mínimo de ferramentas de navegação é exibida e a barra de status aparece no canto superior direito da tela.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetToolBar

Chame essa função de membro para mostrar ou ocultar a barra de ferramentas do Internet Explorer.

void SetToolBar(int nNewValue);

Parâmetros

nNewValue
Indica se deve você deseja exibir a barra de ferramentas. Não zero se a barra de ferramentas deve ser exibida; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer. Se você usar essa chamada com um controle WebBrowser, nenhum erro será retornado, mas a chamada será ignorará.

CHtmlView::SetTop

Chame essa função de membro para definir a distância entre a borda superior interna do controle WebBrowser e a borda superior de seu contêiner

void SetTop(long nNewValue);

Parâmetros

nNewValue
A coordenada da tela da borda superior da janela principal.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetVisible

Chame essa função de membro para definir o estado de visibilidade do controle WebBrowser.

void SetVisible(BOOL bNewValue);

Parâmetros

bNewValue
Não zero se o controle está visível; caso contrário, zero.

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetWidth

Define a largura da janela principal do Internet Explorer.

void SetWidth(long nNewValue);

Parâmetros

nNewValue
A largura, em pixels, da janela principal do Internet Explorer.

CHtmlView::Stop

Chame essa função de membro para cancelar qualquer operação de navegação ou download pendente e interromper qualquer elemento de página dinâmica, como sons em segundo plano e animações.

void Stop();

Comentários

Aplica-se ao Internet Explorer e ao WebBrowser.

Confira também

Exemplo de MFC MFCIE
CFormView classe
Gráfico de hierarquia
IWebBrowser2