CHtmlView classe

Fornece a funcionalidade do controlo do Navegador Web no contexto da arquitetura de documentos/visualizações do MFC.

Sintaxe

class CHtmlView : public CFormView

Membros

Métodos Públicos

Observações

O controlo WebBrowser é uma janela em que o utilizador pode navegar por sites na World Wide Web, pastas no sistema de ficheiros local e numa rede. O controlo do WebBrowser suporta hiperligações, navegação pelo Uniform Resource Locator (URL) e mantém uma lista de histórico.

Utilização da CHtmlView Classe numa Aplicação MFC

Na aplicação padrão do framework MFC (seja baseada em SDI ou MDI), o objeto view é normalmente derivado de um conjunto especializado de classes. Estas classes, todas derivadas de CView, fornecem funcionalidades especializadas para além da proporcionada por CView.

Basear a classe view da aplicação fornece CHtmlView à vista o controlo do Navegador Web. Isto torna, na prática, a aplicação num navegador web. O método preferido para criar uma aplicação ao estilo navegador web é usar o MFC Application Wizard e especificar CHtmlView como a classe view. Para mais informações sobre a implementação e utilização do controlo do Navegador Web em aplicações MFC, consulte Criação de uma Aplicação Web Browser-Style.

CHtmlView é concebido para aplicações que acedem à Web (e/ou documentos HTML). As seguintes CHtmlView funções membros aplicam-se apenas à aplicação Internet Explorer. Estas funções terão sucesso no controlo do Navegador Web, mas não terão efeito visível.

• GetAddressBar
• GetFullName
• GetStatusBar
• SetAddressBar
• SetFullScreen
• SetMenuBar
• SetStatusBar
• SetToolBar

Hierarquia de herança

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

Requerimentos

Cabeçalho:afxhtml.h

CHtmlView::Create

Chame esta função membro para criar um controlo ou contentor do 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 por null que nomeia a classe Windows. O nome da classe pode ser qualquer nome registado na AfxRegisterWndClass função global ou na RegisterClass função Windows. Se NULL, usa os atributos predefinidos CFrameWnd por defeito.

lpszWindowName
Aponta para uma cadeia de caracteres com terminação nula que representa o nome da janela.

dwStyle
Especifica os atributos de estilo da janela. Por defeito, os WS_VISIBLE estilos e WS_CHILD Windows estão definidos.

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

pParentWnd
Um apontador para a janela mãe do controlo.

nID
O número de identificação da vista. Por padrão, defina como AFX_IDW_PANE_FIRST.

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

CHtmlView::CreateControlSite

Overridable usado para criar uma instância de site de controlo para hospedar um controlo no formulário.

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

Parâmetros

pContainer
Um apontador para um COleControlContainer objeto que contém o controlo.

ppSite
Um ponteiro para um ponteiro para um COleControlSite objeto, fornecendo o local para o controlo.

nID
O identificador do controlo a ser alojado.

clsid
O CLSID do controlo a ser alojado

Valor de retorno

Retornos TRUE do sucesso, FALSE do fracasso.

Observações

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

CHtmlView::ExecFormsCommand

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

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

Parâmetros

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

pVarIn
Apontador para uma VARIANT estrutura contendo argumentos de entrada. Pode ser NULL.

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

Valor de retorno

Um valor padrão HRESULT . Para uma lista completa dos valores possíveis, consulte IOleCommandTarget::Exec o SDK do Windows.

Observações

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

CHtmlView::ExecWB

Chame esta função membro para executar um comando no WebBrowser ou 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 comandos.

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

Observações

Veja IWebBrowser2::ExecWB no SDK do Windows.

CHtmlView::GetAddressBar

Ligue para esta função de membro para aceder à barra de endereços do Internet Explorer.

BOOL GetAddressBar() const;

Valor de retorno

Diferente de zero se a barra de endereços for visível; caso contrário, zero.

Observações

Aplica-se ao Internet Explorer. Se usar esta chamada com um controlo do WebBrowser, não devolverá erro, mas ignorará essa chamada.

CHtmlView::GetApplication

Chame esta função membro para recuperar o objeto de automação suportado pela aplicação que contém o controlo do Navegador Web.

LPDISPATCH GetApplication() const;

Valor de retorno

Um ponteiro para a IDispatch interface do objeto ativo do documento. Para mais informações, consulte Implementação da IDispatch Interface.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetBusy

Chame esta função membro para determinar se o controlo do Navegador Web está ativado numa operação de navegação ou download.

BOOL GetBusy() const;

Valor de retorno

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

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetContainer

Chame esta função membro para recuperar um objeto que avalie para o contentor do navegador web.

LPDISPATCH GetContainer() const;

Valor de retorno

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

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetFullName

Chame esta função membro para recuperar o percurso completo do ficheiro que o Internet Explorer está atualmente a exibir.

CString GetFullName() const;

Valor de retorno

Um CString objeto contendo o caminho e o nome do ficheiro atualmente apresentado. Se não existirem caminho nem nome de ficheiro, GetFullName retorna um .CString

Observações

Aplica-se ao Internet Explorer. Se usar esta chamada com um controlo do WebBrowser, não devolverá erro, mas ignorará essa chamada.

CHtmlView::GetFullScreen

Chame esta função membro para determinar se o controlo do Navegador Web está a operar em modo de ecrã inteiro ou em modo janela normal.

BOOL GetFullScreen() const;

Valor de retorno

Diferente de zero se o Navegador estiver a operar em modo de ecrã inteiro; caso contrário, zero.

Observações

No modo de ecrã completo, a janela principal do Internet Explorer é maximizada e a barra de estado, barra de ferramentas, barra de menus e barra de título estão ocultas.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetHeight

Chame esta função membro para recuperar a altura, em pixels, da janela de frames do controlo do WebBrowser.

long GetHeight() const;

Valor de retorno

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

CHtmlView::GetHtmlDocument

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

LPDISPATCH GetHtmlDocument() const;

Valor de retorno

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

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetLeft

Chame esta função membro para recuperar a distância entre a borda esquerda interna do controlo do WebBrowser e a borda esquerda do seu contentor.

long GetLeft() const;

Valor de retorno

A distância da borda esquerda, em píxeis.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetLocationName

Chame esta função membro para obter o nome do recurso que está a ser apresentado no WebBrowser.

CString GetLocationName() const;

Valor de retorno

Um CString objeto contendo o nome do recurso atualmente exibido no Navegador Web.

Observações

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

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetLocationURL

Chame esta função membro para recuperar a URL do recurso que o controlo do Navegador Web está atualmente a exibir.

CString GetLocationURL() const;

Valor de retorno

Um CString objeto contendo a URL do recurso atualmente exibido no Navegador Web.

Observações

Se o recurso for uma pasta ou ficheiro na rede ou computador local, o nome é o UNC ou o caminho completo da pasta ou ficheiro.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetMenuBar

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

BOOL GetMenuBar() const;

Valor de retorno

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

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetOffline

Chame esta função membro para determinar se o navegador web está a funcionar offline.

BOOL GetOffline() const;

Valor de retorno

Diferente de zero se o navegador estiver atualmente offline; caso contrário, zero.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetParentBrowser

Chame esta função membro para recuperar um ponteiro para o objeto pai do controlo WebBrowser.

LPDISPATCH GetParentBrowser() const;

Valor de retorno

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

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetProperty

Chame esta função membro para obter o valor da propriedade atualmente associada ao controlo.

BOOL GetProperty(
    LPCTSTR lpszProperty,
    CString& strValue);

COleVariant GetProperty(LPCTSTR lpszProperty);

Parâmetros

lpszProperty
Um apontador para uma cadeia contendo a propriedade a recuperar.

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

Valor de retorno

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

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetReadyState

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

READYSTATE GetReadyState() const;

Valor de retorno

Um READYSTATE valor, conforme descrito no SDK do Windows.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetRegisterAsBrowser

Chame esta função membro para determinar se o objeto WebBrowser está registado como navegador de topo para resolução do nome alvo.

BOOL GetRegisterAsBrowser() const;

Valor de retorno

Diferente de zero se o navegador estiver registado como navegador de topo; caso contrário, zero.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetRegisterAsDropTarget

Chame esta função membro para determinar se o controlo do WebBrowser está registado como drop target para navegação.

BOOL GetRegisterAsDropTarget() const;

Valor de retorno

Diferente de zero se o navegador estiver registado como drop target; caso contrário, zero.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetSilent

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

BOOL GetSilent() const;

Valor de retorno

Diferente de zero se as caixas de diálogo não puderem ser exibidas pelo controlo do Navegador Web; caso contrário, zero.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetSource

Chame esta função membro para recuperar o código-fonte HTML da página web.

BOOL GetSource(CString& strRef);

Valor de retorno

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

Parâmetros

refString
A CString que irá guardar o código-fonte.

Observações

Esta função é equivalente ao comando "View Source" no Internet Explorer, exceto que o código-fonte é devolvido num CString.

CHtmlView::GetStatusBar

Chame esta função membro para determinar se o controlo do Navegador Web apresenta uma barra de estado.

BOOL GetStatusBar() const;

Valor de retorno

Não nula se a barra de estado puder ser exibida; caso contrário, zero.

Observações

Aplica-se ao Internet Explorer. Se usar esta chamada com um controlo do WebBrowser, não devolverá erro, mas ignorará essa chamada.

CHtmlView::GetTheaterMode

Chame esta função membro para determinar se o navegador web está em modo teatro.

BOOL GetTheaterMode() const;

Valor de retorno

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

Observações

Quando o navegador está em modo teatro, a janela principal do navegador preenche todo o ecrã, aparece uma barra de ferramentas com um conjunto mínimo de ferramentas de navegação e a barra de estado aparece no canto superior direito do ecrã.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetToolBar

Chame esta 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 é visível. Diferente de zero se a barra de ferramentas estiver visível; caso contrário, zero.

CHtmlView::GetTop

Chame esta função membro para recuperar a coordenada do ecrã da borda superior da janela principal do controlo do WebBrowser.

long GetTop() const;

Valor de retorno

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

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetTopLevelContainer

Chame esta função membro para determinar se o Internet Explorer é o contentor de topo do controlo do WebBrowser.

BOOL GetTopLevelContainer() const;

Valor de retorno

Diferente de zero, o contentor é o contentor de nível superior; caso contrário, zero.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetType

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

CString GetType() const;

Valor de retorno

Um CString objeto contendo o nome do tipo do documento ativo contido.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GetVisible

Chame esta função membro para determinar se o objeto contido é visível.

BOOL GetVisible() const;

Valor de retorno

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

Observações

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 píxeis.

CHtmlView::GoBack

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

void GoBack();

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GoForward

Avança um item na lista de histórico.

void GoForward();

CHtmlView::GoHome

Navega até à página inicial ou inicial atual especificada na caixa de diálogo Opções de Internet do Internet Explorer ou na caixa de diálogo Propriedades da Internet, acedida a partir do Painel de Controlo.

void GoHome();

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::GoSearch

Navega até à 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, acedida a partir do Painel de Controlo.

void GoSearch();

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::LoadFromResource

Chame esta função membro para carregar o recurso especificado no controlo do WebBrowser.

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

Parâmetros

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

nRes
O ID do buffer que contém o nome do recurso a carregar.

Valor de retorno

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

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::Navigate

Chame esta função membro para navegar até ao 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 atribuída pelo chamador que contém o URL para navegar, ou o caminho completo do ficheiro a mostrar.

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

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

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

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

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

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::Navigate2

Chame esta função membro para navegar até ao recurso identificado por uma URL, ou para o ficheiro 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 apontador para uma ITEMIDLIST estrutura.

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

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

lpszURL
Um ponteiro para uma string contendo a URL.

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

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

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

baPostedData
Uma referência a um objeto CByteArray.

Observações

Esta função membro estende a Navigate função membro ao suportar a navegação em pastas especiais, como Desktop e My Computer, que são representadas pelo parâmetro pIDL.

Aplica-se ao Internet Explorer e ao WebBrowser.

Example

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

CHtmlView::OnBeforeNavigate2

Esta função membro é chamada pelo framework para causar o disparo de um evento antes de ocorrer uma operação de navegação no navegador web.

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

Parâmetros

lpszURL
Apontador para uma string contendo o URL para navegar.

nFlags
Reservado para uso futuro.

lpszTargetFrameName
Uma cadeia que contém o nome do quadro onde mostrar o recurso, ou NULL se nenhum quadro nomeado for direcionado para o recurso.

baPostedData
Uma referência a um CByteArray objeto que contém os dados a enviar para o servidor se a transação HTTP POST estiver a ser utilizada.

lpszHeaders
Um apontador para uma string contendo outros cabeçalhos HTTP para enviar ao servidor (apenas URLs HTTP). Os cabeçalhos podem especificar coisas como a ação exigida ao servidor, o tipo de dados a ser passado para o servidor ou um código de estado.

pbCancel
Um indicador para uma bandeira de cancelamento. Uma aplicação pode definir este parâmetro como diferente de zero para cancelar a operação de navegação, ou para zero para permitir que continue.

CHtmlView::OnCommandStateChange

Esta função membro é chamada pelo framework para notificar uma aplicação de que o estado ativado de um comando do navegador web mudou.

virtual void OnCommandStateChange(
    long nCommand,
    BOOL bEnable);

Parâmetros

nCommand
Identificador do comando cujo estado ativado mudou.

bEnable
Estado ativado. Este parâmetro é diferente de zero se o comando estiver ativado, ou zero se estiver desativado.

CHtmlView::OnDocumentComplete

Esta função membro é chamada pelo framework para notificar uma aplicação de que um documento chegou ao READYSTATE_COMPLETE estado.

virtual void OnDocumentComplete(LPCTSTR lpszURL);

Parâmetros

lpszURL
Um apontador para uma cadeia que avalia para o URL, nome de ficheiro UNC ou um PIDL (um ponteiro para uma lista de identificadores de item) para onde foi navegado.

Observações

Nem todos os frames vão disparar este evento, mas cada frame que lança um OnDownloadBegin evento irá disparar um evento correspondente OnDocumentComplete .

A URL indicada por lpszURL pode ser diferente da URL para a qual o navegador foi instruído a navegar, porque esta URL é a URL canonizada e qualificada. Por exemplo, se uma aplicação especificar uma URL de "www.microsoft.com" numa chamada para Navigate ou Navigate2, a URL passada por OnNavigateComplete2 ele será "<https://www.microsoft.com/>". Além disso, se o servidor redirecionou o navegador para uma URL diferente, a URL redirecionada será refletida aqui.

CHtmlView::OnDocWindowActivate

Chamado a partir da implementação do Internet Explorer ou MSHTML de IOleInPlaceActiveObject::OnDocWindowActivate, que notifica o objeto ativo no local quando a janela do documento do contentor é ativada ou desativada.

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

Parâmetros

fActivate
Indica o estado da janela do documento. Se este valor for diferente de zero, a janela está a ser ativada. Se este valor for zero, a janela está a ser desativada.

Valor de retorno

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

Observações

Override OnDocWindowActivate para reagir à OnDocWindowActivate notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::OnDocWindowActivate no SDK do Windows para obter mais informações.

CHtmlView::OnDownloadBegin

Esta função de membro é chamada pelo framework para começar a descarregar um documento.

virtual void OnDownloadBegin();

Observações

Este evento é ativado pouco depois do OnBeforeNavigate2 evento, a menos que a navegação seja cancelada. Qualquer animação ou indicação de "ocupado" que o contentor precise de mostrar deve estar ligada a este evento.

CHtmlView::OnDownloadComplete

Esta função membro é chamada pelo framework para indicar que uma operação de navegação terminou, foi interrompida ou falhou.

virtual void OnDownloadComplete();

CHtmlView::OnEnableModeless

Chamado quando o Internet Explorer ou MSHTML apresenta interface modal.

virtual HRESULT OnEnableModeless(BOOL fEnable);

Parâmetros

fEnable
Indica se as caixas de diálogo sem modo do anfitrião estão ativadas ou desativadas. Se este valor for diferente de zero, as caixas de diálogo sem modos estão ativadas. Se este valor for zero, as caixas de diálogo sem modos são desativadas.

Valor de retorno

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

Observações

Ativa ou desativa caixas de diálogo sem modos quando o contentor cria ou destrói uma caixa de diálogo modal. Override OnEnableModeless para reagir à EnableModeless notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::EnableModeless no SDK do Windows para obter mais informações.

CHtmlView::OnFilterDataObject

Chamado ao anfitrião pelo Internet Explorer ou MSHTML para permitir que o anfitrião substitua o objeto de dados do Internet Explorer ou MSHTML.

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

Parâmetros

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

ppDataObject
Endereço que recebe o IDataObject ponteiro de interface fornecido pelo anfitrião. O conteúdo deste parâmetro deve sempre ser inicializado em 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.

Observações

Override OnFilterDataObject para reagir à FilterDataObject notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::FilterDataObject no SDK do Windows para obter mais informações.

CHtmlView::OnFrameWindowActivate

Chamado para IOleInPlaceActiveObject::OnFrameWindowActivate notificar o objeto quando a janela de estrutura superior do contentor for ativada ou desativada.

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

Parâmetros

fActivate
Indica o estado da janela de moldura do nível superior do contentor. Se este valor for diferente de zero, a janela está a ser ativada. Se este valor for zero, a janela está a ser desativada.

Valor de retorno

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

Observações

Override OnFrameWindowActivate para reagir à OnFrameWindowActivate notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::OnFrameWindowActivate no SDK do Windows para obter mais informações.

CHtmlView::OnFullScreen

Esta função membro é chamada pelo framework quando a FullScreen propriedade mudou.

virtual void OnFullScreen(BOOL bFullScreen);

Parâmetros

bFullScreen
Diferente de zero se o Internet Explorer estiver em modo de ecrã completo; Zero caso contrário.

CHtmlView::OnGetDropTarget

Chamado pelo Internet Explorer ou MSHTML quando está a ser usado como drop target para permitir que o host forneça uma alternativa IDropTarget.

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

Parâmetros

pDropTarget
IDropTarget O Internet Explorer ou MSHTML propõe ser utilizado.

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

Valor de retorno

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

Observações

Override OnGetDropTarget para reagir à GetDropTarget notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::GetDropTarget no SDK do Windows para obter mais informações.

CHtmlView::OnGetExternal

Chamada pelo Internet Explorer ou MSHTML para obter a interface do IDispatch anfitrião.

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

Parâmetros

lppDispatch
Um ponteiro para o endereço que recebe o IDispatch ponteiro de interface da aplicação anfitriã. Se o host expor uma interface de Automação, pode fornecer uma referência ao Internet Explorer ou MSHTML através deste parâmetro. O conteúdo deste parâmetro deve sempre ser inicializado em NULL, mesmo que o método falhe.

Valor de retorno

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

Observações

Override OnGetExternal para reagir à GetExternal notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::GetExternal no SDK do Windows para obter mais informações.

CHtmlView::OnGetHostInfo

Recupera as capacidades de interface do Internet Explorer ou do host MSHTML.

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

Parâmetros

pInfo
Endereço de uma DOCHOSTUIINFO estrutura que recebe as capacidades de interface do anfitrião.

Valor de retorno

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

Observações

Override OnGetHostInfo para reagir à GetHostInfo notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::GetHostInfo no SDK do Windows para obter mais informações.

CHtmlView::OnGetOptionKeyPath

Chame esta função membro para obter a chave do registo sob a qual o Internet Explorer ou MSHTML armazena as preferências dos utilizadores.

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

Parâmetros

pchKey
Endereço de um LPOLESTR que recebe a cadeia de subchave do registo onde o host armazena as suas opções padrão. Esta subchave estará por baixo da HKEY_CURRENT_USER chave. Aloque esta memória usando CoTaskMemAlloc. A aplicação que chama é responsável por libertar esta memória usando CoTaskMemFree. Este parâmetro deve sempre ser inicializado para NULL, mesmo que o método falhe.

dwReserved
Reservado para uso futuro. Não está a ser usado atualmente.

Valor de retorno

S_OK Se for bem-sucedido, ou S_FALSE não. Se S_FALSE, o Internet Explorer ou MSHTML irá usar por defeito as suas próprias opções de utilizador.

Observações

Override OnGetOptionKeyPath para reagir à GetOptionKeyPath notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::GetOptionKeyPath no SDK do Windows para obter mais informações.

CHtmlView::OnHideUI

Esta função membro é chamada pelo framework quando o Internet Explorer ou MSHTML remove os seus menus e barras de ferramentas.

virtual HRESULT OnHideUI();

Valor de retorno

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

Observações

Override OnHideUI para reagir à HideUI notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::HideUI no SDK do Windows para obter mais informações.

CHtmlView::OnMenuBar

Esta função membro é chamada pelo framework quando a MenuBar propriedade mudou.

virtual void OnMenuBar(BOOL bMenuBar);

Parâmetros

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

CHtmlView::OnNavigateComplete2

Esta função membro é chamada pelo framework após a navegação para um hiperlink concluída (seja num elemento de janela ou frameset).

virtual void OnNavigateComplete2(LPCTSTR strURL);

Parâmetros

strURL
Uma expressão de cadeia que avalia para o URL, nome de ficheiro UNC ou PIDL (um apontador para uma lista de identificadores de item) para onde foi navegado.

Observações

O parâmetro URL pode ser um PIDL se existir uma entidade de espaço de nomes shell para a qual não existe representação de URL.

O URL contido strURL em pode ser diferente do URL para onde o navegador foi instruído a navegar, porque este URL é o URL canonizado e qualificado. Por exemplo, se uma aplicação especificar uma URL de "www.microsoft.com" numa chamada para Navigate ou Navigate2, a URL passada por OnNavigateComplete2 ele será "<https://www.microsoft.com/>". Além disso, se o servidor redirecionou o navegador para uma URL diferente, a URL redirecionada será refletida aqui.

CHtmlView::OnNavigateError

É chamado pelo framework se a navegação para um hyperlink falhar.

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

Parâmetros

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

lpszFrame
O nome do quadro em que o recurso deve ser exibido, ou NULL se nenhum frame nomeado foi direcionado para o recurso.

dwError
Um código de estado de erro, se disponível. Para uma lista dos códigos de estado possíveis HRESULT e HTTP, veja NavigateError Códigos de Estado de Eventos..

pbCancel
Especifica se deve cancelar a navegação para uma página de erro ou qualquer pesquisa automática adicional. Se TRUE (o predefinido), continue com a navegação até uma página de erro ou pesquisa automática; se FALSE, cancele a navegação para uma página de erro ou a pesquisa automática.

Observações

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

Para mais informações, consulte DWebBrowserEvents2::NavigateError

CHtmlView::OnNewWindow2

Esta função membro é chamada pelo framework quando se pretende criar uma nova janela 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 IDispatch ponteiro de interface de um novo objeto do WebBrowser ou Internet Explorer.

Cancel
Um indicador para uma bandeira de cancelamento. Uma aplicação pode definir este parâmetro como diferente de zero para cancelar a operação de navegação, ou para zero para permitir que continue.

Observações

Este evento precede a criação de uma nova janela dentro do Navegador Web.

CHtmlView::OnProgressChange

Esta função membro é chamada pelo framework para notificar uma aplicação de que o progresso de uma operação de download foi atualizado.

virtual void OnProgressChange(
    long nProgress,
    long nProgressMax);

Parâmetros

nProgress
Quantidade de progresso total a mostrar, ou -1 quando o progresso estiver completo.

nProgressMax
Valor máximo de progresso.

Observações

O contentor pode usar a informação fornecida por este evento para mostrar o número de bytes descarregados até agora ou para atualizar um indicador de progresso.

CHtmlView::OnPropertyChange

Esta função membro é chamada pelo framework para notificar uma aplicação que PutProperty alterou o valor de uma propriedade.

virtual void OnPropertyChange(LPCTSTR lpszProperty);

Parâmetros

lpszProperty
Um apontador para uma cadeia que contém o nome da propriedade.

CHtmlView::OnQuit

Esta função membro é chamada pelo framework para notificar uma aplicação de que a aplicação do Internet Explorer está pronta para encerrar.

virtual void OnQuit();

CHtmlView::OnResizeBorder

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

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

Parâmetros

prcBorder
Novo retângulo exterior para o espaço das fronteiras.

pUIWindow
Um ponteiro para a interface do objeto frame ou janela do documento cuja borda mudou.

fFrameWindow
TRUE se a janela de moldura chamar IOleInPlaceActiveObject::ResizeBorder, caso contrário FALSE.

Valor de retorno

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

Observações

Override OnResizeBorder para reagir à ResizeBorder notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::ResizeBorder no SDK do Windows para obter mais informações.

CHtmlView::OnShowContextMenu

Chamado pelo Internet Explorer ou MSHTML quando está prestes a mostrar o 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. Consulte IDocHostUIHandler::ShowContextMenu no SDK do Windows para obter uma lista de valores.

ppt
Coordenadas do ecrã para o menu.

pcmdtReserved
IOleCommandTarget Interface usada para consultar o estado dos comandos e executar comandos neste objeto.

pdispReserved
IDispatch interface do objeto nas coordenadas do ecrã. Isto permite que um hospedeiro diferencie objetos específicos para fornecer um contexto mais específico.

Valor de retorno

Consulte IDocHostUIHandler::ShowContextMenu no SDK do Windows para obter uma lista de valores.

Observações

Override OnShowContextMenu para reagir à ShowContextMenu notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::ShowContextMenu no SDK do Windows para obter mais informações.

CHtmlView::OnShowUI

Chamado antes do Internet Explorer ou MSHTML mostra os 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
IOleInPlaceActiveObject interface do objeto atualmente ativo.

pCommandTarget
IOleCommandTarget interface do objeto.

pFrame
IOleInPlaceFrame interface do objeto. Isto é necessário para menus e barras de ferramentas.

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

Valor de retorno

Consulte IDocHostUIHandler::ShowUI no SDK do Windows para obter uma lista de valores.

Observações

Override OnShowUI para reagir à ShowUI notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::ShowUI no SDK do Windows para obter mais informações.

CHtmlView::OnStatusBar

Esta função membro é chamada pelo framework quando a StatusBar propriedade mudou.

virtual void OnStatusBar(BOOL bStatusBar);

Parâmetros

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

CHtmlView::OnStatusTextChange

Esta função membro é chamada pelo framework para notificar uma aplicação de que o texto da barra de estado associada ao controlo do Navegador Web mudou.

virtual void OnStatusTextChange(LPCTSTR lpszText);

Parâmetros

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

CHtmlView::OnTheaterMode

Esta função membro é chamada pelo framework quando a TheaterMode propriedade mudou.

virtual void OnTheaterMode(BOOL bTheaterMode);

Parâmetros

bTheaterMode
Diferente de zero se o Internet Explorer estiver em modo teatro; Zero caso contrário.

CHtmlView::OnTitleChange

Esta função membro é chamada pelo framework para notificar uma aplicação se o título de um documento no controlo do WebBrowser ficar disponível ou mudar.

virtual void OnTitleChange(LPCTSTR lpszText);

Parâmetros

lpszText
O novo título do documento.

Observações

Para HTML, o título pode mudar; enquanto o HTML ainda está a ser descarregado, a URL do documento está definida como título. Depois de o título real (se existir) ser extraído do HTML, o título é alterado para refletir o título real.

CHtmlView::OnToolBar

Esta função membro é chamada pelo framework quando a ToolBar propriedade mudou.

virtual void OnToolBar(BOOL bToolBar);

Parâmetros

bToolBar
Não zero se a barra de ferramentas do Internet Explorer estiver visível ou zero caso contrário.

CHtmlView::OnTranslateAccelerator

Chamado pelo Internet Explorer ou MSHTML quando IOleInPlaceActiveObject::TranslateAccelerator ou IOleControlSite::TranslateAccelerator é chamado para processar mensagens aceleradoras de menu da fila de mensagens do contentor.

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

Parâmetros

lpMsg
Aponta para a mensagem que talvez precise de ser traduzida.

pguidCmdGroup
Identificador do grupo de comando.

nCmdID
Identificador de comando.

Valor de retorno

S_OK Se for bem-sucedido, ou S_FALSE não.

Observações

Override OnTranslateAccelerator para reagir à TranslateAccelerator notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::TranslateAccelerator no SDK do Windows para obter mais informações.

CHtmlView::OnTranslateUrl

Chamado pelo Internet Explorer ou MSHTML para permitir ao host 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 string fornecida pelo Internet Explorer ou MSHTML que representa a URL a ser traduzida.

ppchURLOut
Endereço de um ponteiro de string que recebe o endereço da URL traduzida. O host aloca o buffer usando o alocador de memória da tarefa. O conteúdo deste parâmetro deve sempre 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.

Observações

Override OnTranslateUrl para reagir à TranslateUrl notificação do controlo do Microsoft Web Browser. Consulte IDocHostUIHandler::TranslateUrl no SDK do Windows para obter mais informações.

CHtmlView::OnUpdateUI

Notifica o anfitrião que o estado de comando mudou.

virtual HRESULT OnUpdateUI();

Valor de retorno

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

Observações

O anfitrião deve atualizar o estado dos botões da barra de ferramentas. Este método é chamado independentemente do valor de retorno de ShowUI. Override OnUpdateUI para reagir à UpdateUI notificação do controlo do Microsoft Web Browser.

CHtmlView::OnVisible

Esta função membro é chamada pelo framework quando a janela do Navegador Web deve ser mostrada ou oculta.

virtual void OnVisible(BOOL bVisible);

Parâmetros

bVisible
Diferente de zero se o objeto for visível ou de zero caso contrário.

Observações

Isto permite que a janela anfitriã de controlo do objeto se comporte da mesma forma que a janela do Internet Explorer.

CHtmlView::PutProperty

Chame esta função membro para definir a propriedade associada a um dado 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 contendo a propriedade para definir.

vtValue
O novo valor da propriedade indicado por lpszProperty.

lpszPropertyName
Um apontador para uma cadeia contendo o nome da propriedade a definir.

dValue
O novo valor do imóvel.

lValue
O novo valor do imóvel.

lpszValue
Um apontador para uma cadeia que contém o novo valor da propriedade.

nValue
O novo valor do imóvel.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::QueryFormsCommand

Consultas para o estado de um ou mais comandos gerados por eventos da interface do utilizador.

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

Parâmetros

dwCommandID
O identificador do comando que está a ser consultado.

pbSupported
Um apontador para um BOOL que especifica se o comando (identificado por dwCommandID) é suportado. Se TRUE, o comando for suportado; caso contrário FALSE.

pbEnabled
Um ponteiro para um BOOL que especifica se o comando (identificado por dwCommandID) está ativado. Se TRUE, o comando for suportado; caso contrário FALSE.

pbChecked
Um apontador para um BOOL que especifica se o comando (identificado por dwCommandID) está verificado. Se TRUE, o comando for suportado; caso contrário FALSE.

Valor de retorno

Um valor padrão HRESULT . Para uma lista completa dos valores possíveis, consulte IOleCommandTarget::QueryStatus o SDK do Windows.

Observações

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

CHtmlView::QueryStatusWB

Chame esta função membro para consultar o estado de um comando.

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

Parâmetros

cmdID
O OLECMDID valor do comando para o qual o chamador precisa de informação de estado.

Valor de retorno

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

Observações

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

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::Refresh

Recarrega a URL ou ficheiro que o navegador web está a exibir no momento.

void Refresh();

Observações

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 ficheiro que o Internet Explorer está atualmente a mostrar.

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 estão definidas em RefreshConstants, no SDK do Windows.

Observações

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 esta função membro para mostrar ou ocultar a barra de endereços do objeto do Internet Explorer.

void SetAddressBar(BOOL bNewValue);

Parâmetros

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

Observações

Aplica-se ao Internet Explorer. Se usar esta chamada com um controlo do WebBrowser, não devolverá erro, mas ignorará essa chamada.

CHtmlView::SetFullScreen

Chame esta função membro para definir o Internet Explorer para ecrã inteiro ou modo janela normal.

void SetFullScreen(BOOL bNewValue);

Parâmetros

bNewValue
Não zero para o modo de ecrã inteiro; caso contrário, zero.

Observações

No modo de ecrã completo, a janela principal do Internet Explorer é maximizada e a barra de estado, barra de ferramentas, barra de menus e barra de título estão ocultas.

Aplica-se ao Internet Explorer. Se usar esta chamada com um controlo do WebBrowser, não devolverá erro, mas ignorará essa chamada.

CHtmlView::SetHeight

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

void SetHeight(long nNewValue);

Parâmetros

nNewValue
A altura, em píxeis, da janela principal.

Observações

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 do ecrã da extremidade esquerda da janela principal.

CHtmlView::SetMenuBar

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

void SetMenuBar(BOOL bNewValue);

Parâmetros

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

Observações

Aplica-se ao Internet Explorer. Se usar esta chamada com um controlo do WebBrowser, não devolverá erro, mas ignorará essa chamada.

CHtmlView::SetOffline

Chame esta função membro para definir um valor que indique se o controlo do Navegador Web está atualmente a operar em modo offline.

void SetOffline(BOOL bNewValue);

Parâmetros

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

Observações

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

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetRegisterAsBrowser

Chame esta função membro para definir um valor que indique se o controlo do Navegador Web está registado como navegador de topo para resolução do nome alvo.

void SetRegisterAsBrowser(BOOL bNewValue);

Parâmetros

bNewValue
Determina se o Internet Explorer está registado como navegador de topo. Se não zero, o navegador web está registado como navegador de topo; Se for zero, não é um navegador de topo. O valor padrão é zero.

Observações

Um navegador de topo é o navegador definido no registo como navegador predefinido.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetRegisterAsDropTarget

Chame esta função membro para definir um valor que indique se o controlo do WebBrowser está registado como drop target para navegação.

void SetRegisterAsDropTarget(BOOL bNewValue);

Parâmetros

bNewValue
Determina se o controlo do WebBrowser está registado como drop target para navegação. Se não ser zero, o objeto é registado como alvo de queda; Se for zero, não é um alvo de queda.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetSilent

Chame esta função membro para definir um valor que indique se é possível mostrar alguma caixa de diálogo.

void SetSilent(BOOL bNewValue);

Parâmetros

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

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetStatusBar

Chame esta função de membro para mostrar a barra de estado.

void SetStatusBar(BOOL bNewValue);

Parâmetros

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

Observações

Aplica-se ao Internet Explorer. Se usar esta chamada com um controlo do WebBrowser, não devolverá erro, mas ignorará essa chamada.

CHtmlView::SetTheaterMode

Chame esta função membro para definir um valor que indique se o controlo do Navegador Web está em modo teatro.

void SetTheaterMode(BOOL bNewValue);

Parâmetros

bNewValue
Nonzero para definir o controlo do WebBrowser para modo teatro; caso contrário, zero. O valor padrão é zero.

Observações

Quando o navegador está em modo teatro, a janela principal do navegador preenche todo o ecrã, aparece uma barra de ferramentas com um conjunto mínimo de ferramentas de navegação e a barra de estado aparece no canto superior direito do ecrã.

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetToolBar

Chame esta 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 mostrar a barra de ferramentas. Diferente de zero se a barra de ferramentas for para ser exibida; caso contrário, zero.

Observações

Aplica-se ao Internet Explorer. Se usar esta chamada com um controlo do WebBrowser, não devolverá erro, mas ignorará essa chamada.

CHtmlView::SetTop

Chame esta função membro para definir a distância entre a borda superior interna do controlo do WebBrowser e a borda superior do seu contentor

void SetTop(long nNewValue);

Parâmetros

nNewValue
A coordenada do ecrã da borda superior da janela principal.

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

CHtmlView::SetVisible

Chame esta função membro para definir o estado de visibilidade do controlo do Navegador Web.

void SetVisible(BOOL bNewValue);

Parâmetros

bNewValue
Não nulo se o controlo for visível; caso contrário, zero.

Observações

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 esta função membro para cancelar qualquer operação pendente de navegação ou download e parar quaisquer elementos dinâmicos da página, como sons de fundo e animações.

void Stop();

Observações

Aplica-se ao Internet Explorer e ao WebBrowser.

Consulte também

Exemplo MFC MFCIE
CFormView Classe
Gráfico hierárquico
IWebBrowser2