Clase CHtmlView
Proporciona la funcionalidad del control WebBrowser en el contexto de la arquitectura de vista/documento de MFC.
Sintaxis
class CHtmlView : public CFormView
Miembros
Métodos públicos
Nombre | Descripción |
---|---|
CHtmlView::Create |
Crea el control WebBrowser. |
CHtmlView::CreateControlSite |
Reemplazable usado para crear una instancia del sitio de control para hospedar un control en el formulario. |
CHtmlView::ExecFormsCommand |
Ejecuta el comando especificado mediante el método IOleCommandTarget::Exec . |
CHtmlView::ExecWB |
Ejecuta un comando. |
CHtmlView::GetAddressBar |
Determina si la barra de direcciones del objeto de Internet Explorer está visible. (El control WebBrowser se omite; solo Internet Explorer). |
CHtmlView::GetApplication |
Recupera un objeto de aplicación que representa la aplicación que contiene la instancia actual de la aplicación Internet Explorer. |
CHtmlView::GetBusy |
Recupera un valor que indica si una descarga u otra actividad sigue en curso. |
CHtmlView::GetContainer |
Recupera el contenedor del control WebBrowser. |
CHtmlView::GetFullName |
Recupera el nombre completo, incluida la ruta de acceso, del recurso que se muestra en el explorador web. (El control WebBrowser se omite; solo Internet Explorer). |
CHtmlView::GetFullScreen |
Indica si el control WebBrowser está funcionando en modo de pantalla completa o en modo de ventana normal. |
CHtmlView::GetHeight |
Recupera el alto de la ventana principal de Internet Explorer. |
CHtmlView::GetHtmlDocument |
Recupera el documento HTML activo. |
CHtmlView::GetLeft |
Recupera la coordenada de pantalla del borde izquierdo de la ventana principal de Internet Explorer. |
CHtmlView::GetLocationName |
Recupera el nombre del recurso que WebBrowser muestra actualmente. |
CHtmlView::GetLocationURL |
Recupera la dirección URL del recurso que WebBrowser muestra actualmente. |
CHtmlView::GetMenuBar |
Recupera un valor que determina si la barra de menús está visible. |
CHtmlView::GetOffline |
Recupera un valor que determina si el control está sin conexión. |
CHtmlView::GetParentBrowser |
Recupera un puntero a la interfaz IDispatch . Para obtener más información, consulte Proceso para la implementación de la interfaz IDispatch . |
CHtmlView::GetProperty |
Recupera el valor actual de una propiedad asociada con el objeto especificado. |
CHtmlView::GetReadyState |
Recupera el estado listo del objeto de explorador web. |
CHtmlView::GetRegisterAsBrowser |
Indica si el control WebBrowser está registrado como un explorador de nivel superior para la resolución de nombres de destino. |
CHtmlView::GetRegisterAsDropTarget |
Indica si el control WebBrowser está registrado como un destino para colocar para la navegación. |
CHtmlView::GetSilent |
Indica si se pueden mostrar los cuadros de diálogo. |
CHtmlView::GetSource |
Código fuente HTML de la página web. |
CHtmlView::GetStatusBar |
Indica si la barra de estado de Internet Explorer está visible. (El control WebBrowser se omite; solo Internet Explorer). |
CHtmlView::GetTheaterMode |
Indica si el control WebBrowser está en modo de pantalla completa. |
CHtmlView::GetToolBar |
Recupera un valor que determina si la barra de herramientas está visible. |
CHtmlView::GetTop |
Recupera la coordenada de pantalla del borde superior de la ventana principal de Internet Explorer. |
CHtmlView::GetTopLevelContainer |
Recupera un valor que indica si el objeto actual es el contenedor de nivel superior del control WebBrowser. |
CHtmlView::GetType |
Recupera el nombre de tipo del objeto de documento. |
CHtmlView::GetVisible |
Recupera un valor que indica si el objeto está visible u oculto. |
CHtmlView::GetWidth |
Recupera el ancho de la ventana principal de Internet Explorer. |
CHtmlView::GoBack |
Navega al elemento anterior de la lista de historial. |
CHtmlView::GoForward |
Navega al elemento siguiente de la lista de historial. |
CHtmlView::GoHome |
Navega a la página de inicio o principal actual. |
CHtmlView::GoSearch |
Navega a la página de búsqueda actual. |
CHtmlView::LoadFromResource |
Carga un recurso en el control WebBrowser. |
CHtmlView::Navigate |
Navega al recurso identificado con una dirección URL. |
CHtmlView::Navigate2 |
Navega al recurso identificado con una dirección URL o al archivo identificado mediante una ruta de acceso completa. |
CHtmlView::OnBeforeNavigate2 |
Se llama a esta función miembro antes de que ocurra una operación de navegación en el control WebBrowser en cuestión (en un elemento de ventana o de conjunto de marcos). |
CHtmlView::OnCommandStateChange |
Se llama para notificar a una aplicación que el estado habilitado de un comando de explorador web ha cambiado. |
CHtmlView::OnDocumentComplete |
Se llama para notificar a una aplicación que un documento alcanzó el estado READYSTATE_COMPLETE . |
CHtmlView::OnDocWindowActivate |
Se llama a esta función miembro desde la implementación de Internet Explorer o MSHTML del método IOleInPlaceActiveObject::OnDocWindowActivate , desde donde se notifica al objeto en contexto activo sobre si la ventana de documento del contenedor se activa o desactiva. |
CHtmlView::OnDownloadBegin |
Se llama para notificar a una aplicación que se está iniciando una operación de navegación. |
CHtmlView::OnDownloadComplete |
Se llama cuando una operación de navegación termina, se detiene o no se puede realizar. |
CHtmlView::OnEnableModeless |
Se llama para habilitar o deshabilitar los cuadros de diálogo no modales cuando el contenedor crea o destruye un cuadro de diálogo modal. |
CHtmlView::OnFilterDataObject |
Internet Explorer o MSHTML lo llaman en el host para permitir que el host reemplace el objeto de datos de Internet Explorer o MSHTML. |
CHtmlView::OnFrameWindowActivate |
Se llama a esta función miembro desde el método IOleInPlaceActiveObject::OnFrameWindowActivate para notificar al objeto sobre si la ventana de marco de nivel superior del contenedor se activa o desactiva. |
CHtmlView::OnFullScreen |
Se llama cuando la FullScreen propiedad ha cambiado. |
CHtmlView::OnGetDropTarget |
Se llama a esta función miembro desde Internet Explorer o MSHTML para usarse como destino para colocar, de manera que pueda proporcionarse una instancia alternativa de la interfaz IDropTarget desde el host. |
CHtmlView::OnGetExternal |
Internet Explorer o MSHTML lo llaman para obtener la interfaz IDispatch del host. |
CHtmlView::OnGetHostInfo |
Recupera las capacidades de la interfaz de usuario del host de Internet Explorer o MSHTML. |
CHtmlView::OnGetOptionKeyPath |
Devuelve la clave del registro bajo la que Internet Explorer o MSHTML almacenan las preferencias del usuario. |
CHtmlView::OnHideUI |
Se llama cuando Internet Explorer o MSHTML quita sus menús y barras de herramientas. |
CHtmlView::OnMenuBar |
Se llama cuando la MenuBar propiedad ha cambiado. |
CHtmlView::OnNavigateComplete2 |
Se llama a esta función miembro una vez que se completa el proceso de navegación hasta un hipervínculo (en un elemento de ventana o conjunto de marcos). |
CHtmlView::OnNavigateError |
El marco de trabajo lo llama si la navegación a un hipervínculo no se realiza correctamente. |
CHtmlView::OnNewWindow2 |
Se llama cuando se va a crear una nueva ventana para mostrar un recurso. |
CHtmlView::OnProgressChange |
Se llama para notificar a una aplicación que se actualizó el progreso de una operación de descarga. |
CHtmlView::OnPropertyChange |
Se llama a esta función miembro para notificar a una aplicación de que el valor de una propiedad de objeto se ha cambiado desde el método PutProperty . |
CHtmlView::OnQuit |
Se llama para notificar a una aplicación que la aplicación Internet Explorer está preparada para cerrarse. (Se aplica a Internet Explorer solamente) |
CHtmlView::OnResizeBorder |
Se llama a esta función miembro desde la implementación de Internet Explorer o MSHTML del método IOleInPlaceActiveObject::ResizeBorder , desde donde se alerta al objeto de que debe cambiarse el tamaño de su espacio del borde. |
CHtmlView::OnShowContextMenu |
Se llama a esta función miembro desde Internet Explorer o MSHTML cuando está a punto de mostrarse su menú contextual. |
CHtmlView::OnShowUI |
Se llama antes de que Internet Explorer o MSHTML muestren sus menús y barras de herramientas. |
CHtmlView::OnStatusBar |
Se llama cuando la StatusBar propiedad ha cambiado. |
CHtmlView::OnStatusTextChange |
Se llama para notificar a una aplicación que el texto de la barra de estado asociada con el control WebBrowser ha cambiado. |
CHtmlView::OnTheaterMode |
Se llama cuando la TheaterMode propiedad ha cambiado. |
CHtmlView::OnTitleChange |
Se llama para notificar a una aplicación si el título de un documento del control WebBrowser está disponible o cambia. |
CHtmlView::OnToolBar |
Se llama cuando la ToolBar propiedad ha cambiado. |
CHtmlView::OnTranslateAccelerator |
Se llama a esta función miembro desde Internet Explorer o MSHTML cuando se llama a los métodos IOleInPlaceActiveObject::TranslateAccelerator o IOleControlSite::TranslateAccelerator para procesar los mensajes de tecla de aceleración de menús que se ubiquen en la cola de mensajes del contenedor. |
CHtmlView::OnTranslateUrl |
Internet Explorer o MSHTML lo llaman para ofrecer al host la oportunidad de modificar la dirección URL que se va a cargar. |
CHtmlView::OnUpdateUI |
Notifica al host que cambió el estado del comando. |
CHtmlView::OnVisible |
Se llama cuando la ventana del control WebBrowser debería estar visible u oculta. |
CHtmlView::PutProperty |
Recupera el valor actual de una propiedad asociada con el objeto especificado. |
CHtmlView::QueryFormsCommand |
Consulta el estado de uno o más comandos generados por eventos de interfaz de usuario. |
CHtmlView::QueryStatusWB |
Consulta el estado de un comando procesado por el control WebBrowser. |
CHtmlView::Refresh |
Vuelve a cargar la página actual. |
CHtmlView::Refresh2 |
Vuelve a cargar el archivo actual y, opcionalmente, impide que se envíe el encabezado pragma:nocache . |
CHtmlView::SetAddressBar |
Muestra u oculta la barra de direcciones del objeto de Internet Explorer. (El control WebBrowser se omite; solo Internet Explorer). |
CHtmlView::SetFullScreen |
Establece un valor para determinar si el control está funcionando en modo de pantalla completa o en modo de ventana normal. (El control WebBrowser se omite; solo Internet Explorer). |
CHtmlView::SetHeight |
Establece el alto de la ventana principal de Internet Explorer. |
CHtmlView::SetLeft |
Establece la posición horizontal de la ventana principal de Internet Explorer. |
CHtmlView::SetMenuBar |
Establece un valor para determinar si la barra de menús del control está visible. (El control WebBrowser se omite; solo Internet Explorer). |
CHtmlView::SetOffline |
Establece un valor para determinar si el control está sin conexión. |
CHtmlView::SetRegisterAsBrowser |
Establece un valor que indica si el control WebBrowser está registrado como un explorador de nivel superior para la resolución de nombres de destino. |
CHtmlView::SetRegisterAsDropTarget |
Establece un valor que indica si el control WebBrowser está registrado como un destino para colocar para la navegación. |
CHtmlView::SetSilent |
Establece un valor para determinar si el control mostrará cuadros de diálogo. |
CHtmlView::SetStatusBar |
Establece un valor para determinar si la barra de estado de Internet Explorer está visible. (El control WebBrowser se omite; solo Internet Explorer). |
CHtmlView::SetTheaterMode |
Establece un valor que indica si el control WebBrowser está en modo de pantalla completa. |
CHtmlView::SetToolBar |
Establece un valor para determinar si la barra de herramientas del control está visible. (El control WebBrowser se omite; solo Internet Explorer). |
CHtmlView::SetTop |
Establece la posición vertical de la ventana principal de Internet Explorer. |
CHtmlView::SetVisible |
Establece un valor que indica si el objeto está visible u oculto. |
CHtmlView::SetWidth |
Establece el ancho de la ventana principal de Internet Explorer. |
CHtmlView::Stop |
Detiene la apertura de un archivo. |
Comentarios
El control WebBrowser es una ventana donde el usuario puede examinar sitios de World Wide Web, así como carpetas del sistema de archivos local y de una red. El control WebBrowser admite hipervínculos, navegación de localizador uniforme de recursos (URL) y mantiene una lista de historial.
Uso de la clase CHtmlView
en una aplicación MFC
En la aplicación de marco de trabajo MFC estándar (basada en SDI o MDI), el objeto de vista se deriva normalmente de un conjunto de clases especializado. Estas clases, todas ellas derivadas de CView
, proporcionan funciones especializadas más allá de las que proporciona CView
.
Al basar la clase de vista de la aplicación en CHtmlView
se proporciona la vista con el control WebBrowser. De este modo, la aplicación se convierte de manera eficaz en un explorador web. El método preferido para crear una aplicación de estilo de explorador web es usar el Asistente para aplicaciones MFC y especificar CHtmlView
como la clase de vista. Para obtener más información sobre la implementación y el uso del control WebBrowser en aplicaciones MFC, vea Creating a Web Browser-Style Application(Crear una aplicación de estilo de navegador web).
Nota:
El control ActiveX WebBrowser (y por tanto CHtmlView
) solo está disponible para programas que se ejecutan en Windows NT 4.0 o versiones posteriores, con Internet Explorer 4.0 o posterior instalado.
CHtmlView
está diseñado para aplicaciones que acceden a la Web (y/o a documentos HTML). La siguientes funciones miembro CHtmlView
se aplican solo a la aplicación Internet Explorer. Aunque estas funciones se ejecutarán correctamente en el control WebBrowser, no tendrán ningún efecto visible.
GetAddressBar
GetFullName
GetStatusBar
SetAddressBar
SetFullScreen
SetMenuBar
SetStatusBar
SetToolBar
Jerarquía de herencia
CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView
CHtmlView
Requisitos
Encabezado: afxhtml.h
CHtmlView::Create
Llame a esta función miembro para crear un control o contenedor de WebBrowser para el ejecutable de Internet Explorer.
virtual BOOL Create(
LPCTSTR lpszClassName,
LPCTSTR lpszWindowName,
DWORD dwStyle,
const RECT& rect,
CWnd* pParentWnd,
UINT nID,
CCreateContext* pContext = NULL);
Parámetros
lpszClassName
Se usa para apuntar a una cadena de caracteres que finaliza en null y que, a su vez, se usa para asignar el nombre de la clase Windows. El nombre de clase puede ser cualquier nombre que se haya registrado con la función global AfxRegisterWndClass
o la función de Windows RegisterClass
. Si el valor es NULL
, se usarán los atributos predeterminados predefinidos de la clase CFrameWnd
.
lpszWindowName
El valor de este parámetro se usa para apuntar a una cadena de caracteres que finaliza en null y que, a su vez, se usa para representar el nombre de la ventana.
dwStyle
[in] El valor de este parámetro se usa para especificar los atributos de estilo de la ventana. De forma predeterminada, se establecen los estilos WS_VISIBLE
y WS_CHILD
de Windows.
rect
El valor de este parámetro se corresponde con una referencia a una estructura RECT
, que se usa para especificar el tamaño y la posición de la ventana. El valor rectDefault
se usa para permitir que el tamaño y la posición de la nueva ventana pueda determinarse desde Windows.
pParentWnd
El valor de este parámetro se corresponde con un puntero que apunta a la ventana primaria del control.
nID
El valor de este parámetro se corresponde con el número de id. de la vista. De manera predeterminada, se establece en AFX_IDW_PANE_FIRST
.
pContext
Puntero a un objeto CCreateContext
. NULL
es el valor predeterminado.
CHtmlView::CreateControlSite
Reemplazable usado para crear una instancia del sitio de control para hospedar un control en el formulario.
virtual BOOL CreateControlSite(
COleControlContainer* pContainer,
COleControlSite** ppSite,
UINT nID,
REFCLSID clsid);
Parámetros
pContainer
El valor de este parámetro se corresponde con un puntero que apunta a un objeto COleControlContainer
, donde se almacena el control.
ppSite
El valor de este parámetro se corresponde con puntero que apunta a un puntero que, a su vez, apunta a un objeto COleControlSite
, donde se proporciona el sitio del control.
nID
El valor de este parámetro se corresponde con el identificador del control que se va a hospedar.
clsid
El valor de este parámetro se corresponde con el CLSID del control que se va a hospedar.
Valor devuelto
Devuelve TRUE
si la operación se realiza correctamente; de lo contrario, devuelve FALSE
.
Comentarios
Puede invalidar esta función miembro de manera que se devuelva una instancia de la clase de sitio de control que proporcione.
CHtmlView::ExecFormsCommand
Ejecuta el comando especificado mediante el método IOleCommandTarget::Exec
.
HRESULT ExecFormsCommand(
DWORD dwCommandID,
VARIANT* pVarIn,
VARIANT* pVarOut);
Parámetros
dwCommandID
Comando que se va a ejecutar. Este comando debe pertenecer al grupo que se especifica en el grupo CMDSETID3_Forms3
.
pVarIn
Puntero a una VARIANT
estructura que contiene argumentos de entrada. Puede ser NULL
.
pVarOut
El valor de este parámetro se corresponde con un puntero que apunta a una estructura VARIANT
, donde se recibirá la salida del comando. Puede ser NULL
.
Valor devuelto
Un valor HRESULT
estándar. Para obtener una lista completa de los valores posibles para este método, consulte el método IOleCommandTarget::Exec
de Windows SDK.
Comentarios
En el método ExecFormsCommand
, se implementa el comportamiento del método IOleCommandTarget::Exec
.
CHtmlView::ExecWB
Llame a esta función miembro para ejecutar un comando en el elemento WebBrowser o en Internet Explorer.
void ExecWB(
OLECMDID cmdID,
OLECMDEXECOPT cmdexecopt,
VARIANT* pvaIn,
VARIANT* pvaOut);
Parámetros
cmdID
El comando que se debe ejecutar.
cmdexecopt
El valor de este parámetro se corresponde con las opciones que se establecen para ejecutar el comando.
pvaIn
El valor de este parámetro se corresponde con una variante que se usa para especificar los argumentos de entrada de comandos.
pvaOut
El valor de este parámetro se corresponde con una variante que se usa para especificar los argumentos de salida de comandos.
Comentarios
Consulte el método IWebBrowser2::ExecWB
de Windows SDK.
CHtmlView::GetAddressBar
Llame a esta función miembro para recuperar la barra de direcciones de Internet Explorer.
BOOL GetAddressBar() const;
Valor devuelto
El valor devuelto será distinto de cero si la barra de direcciones es visible; de lo contrario, será cero.
Comentarios
Este elemento se aplica a Internet Explorer. Si usa esta llamada con un control WebBrowser, no se devolverá ningún error, sino que esta se omitirá.
CHtmlView::GetApplication
Llame a esta función miembro para recuperar el objeto de automatización que se admite en la aplicación y donde se almacena el control WebBrowser.
LPDISPATCH GetApplication() const;
Valor devuelto
El valor devuelto se corresponde con un puntero que apunta a la interfaz IDispatch
del objeto de documento activo. Para obtener más información, consulte Proceso para la implementación de la interfaz IDispatch
.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetBusy
Llame a esta función miembro para determinar si el control WebBrowser está implicado en una operación de navegación o descarga.
BOOL GetBusy() const;
Valor devuelto
El valor que se devuelva será distinto de cero si el explorador web está ocupado; de lo contrario, será cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetContainer
Llame a esta función miembro para recuperar un objeto cuyo valor se evalúa como el contenedor del explorador web.
LPDISPATCH GetContainer() const;
Valor devuelto
El valor devuelto se corresponde con un puntero que apunta a la interfaz IDispatch
del objeto de documento activo.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetFullName
Llame a esta función miembro para recuperar la ruta de acceso completa del archivo que se está mostrando en Internet Explorer actualmente.
CString GetFullName() const;
Valor devuelto
El valor devuelto se corresponde con un objeto CString
, donde se incluye tanto la ruta de acceso como el nombre del archivo que se muestra actualmente. Al usar la función GetFullName
, si no existe ninguna ruta de acceso ni nombre de archivo, se devolverá un objeto CString
vacío.
Comentarios
Este elemento se aplica a Internet Explorer. Si usa esta llamada con un control WebBrowser, no se devolverá ningún error, sino que esta se omitirá.
CHtmlView::GetFullScreen
Llame a esta función miembro para determinar si el control WebBrowser funciona en modo de pantalla completa o en modo de ventana normal.
BOOL GetFullScreen() const;
Valor devuelto
El valor devuelto será distinto de cero si el elemento WebBrowser funciona en modo de pantalla completa; de lo contrario, será cero.
Comentarios
En el modo de pantalla completa, la ventana principal de Internet Explorer se maximiza. A su vez, tanto la barra de estado como la barra de herramientas, la barra de menús y la barra de título se ocultan.
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetHeight
Llame a esta función miembro para recuperar la altura, en píxeles, de la ventana de marco del control WebBrowser.
long GetHeight() const;
Valor devuelto
El valor devuelto se corresponde con el alto, en píxeles, de la ventana de marco del control.
CHtmlView::GetHtmlDocument
Llame a esta función miembro para recuperar el documento HTML que se corresponde con el documento activo.
LPDISPATCH GetHtmlDocument() const;
Valor devuelto
El valor devuelto se corresponde con un puntero que apunta a la interfaz IDispatch
del objeto de documento activo.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetLeft
Llame a esta función miembro para recuperar la distancia entre el borde izquierdo interno del control WebBrowser y el borde izquierdo de su contenedor.
long GetLeft() const;
Valor devuelto
El valor devuelto se corresponde con la distancia, en píxeles, del borde izquierdo.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetLocationName
Llame a esta función miembro para obtener el nombre del recurso que se muestra en el elemento WebBrowser.
CString GetLocationName() const;
Valor devuelto
El valor devuelto se corresponde con un objeto CString
, donde se incluye el nombre del recurso que se muestra actualmente en el elemento WebBrowser.
Comentarios
Si el recurso es una página HTML en World Wide Web, el nombre se corresponderá con el título de esta. Si el recurso es una carpeta o un archivo en la red o equipo local, el nombre se corresponderá con la ruta de acceso completa o UNC de la carpeta o el archivo en cuestión.
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetLocationURL
Llame a esta función miembro para recuperar la URL del recurso que esté se mostrando actualmente en el control WebBrowser.
CString GetLocationURL() const;
Valor devuelto
El valor devuelto se corresponde con un objeto CString
, donde se incluye la URL del recurso que se muestra actualmente en el elemento WebBrowser.
Comentarios
Si el recurso es una carpeta o un archivo en la red o equipo local, el nombre se corresponderá con la ruta de acceso completa o UNC de la carpeta o el archivo en cuestión.
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetMenuBar
Llame a esta función miembro para determinar si la barra de menús es visible.
BOOL GetMenuBar() const;
Valor devuelto
El valor devuelto será distinto de cero si la barra de menús es visible; de lo contrario, será cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetOffline
Llame a esta función miembro para determinar si el explorador web funciona sin conexión actualmente.
BOOL GetOffline() const;
Valor devuelto
El valor devuelto será distinto de cero si el explorador web está sin conexión actualmente; de lo contrario, será cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetParentBrowser
Llame a esta función miembro para recuperar un puntero que apunte al objeto primario del control WebBrowser.
LPDISPATCH GetParentBrowser() const;
Valor devuelto
El valor devuelto se corresponde con un puntero que apunta a la interfaz IDispatch
del objeto primario del control WebBrowser.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetProperty
Llame a esta función miembro para obtener el valor de la propiedad que esté actualmente asociada con el control.
BOOL GetProperty(
LPCTSTR lpszProperty,
CString& strValue);
COleVariant GetProperty(LPCTSTR lpszProperty);
Parámetros
lpszProperty
El valor de este parámetro se corresponde con un puntero que apunta a una cadena donde se almacena la propiedad que se va a recuperar.
strValue
El valor de este parámetro se corresponde con una referencia a un objeto CString
donde se recibe el valor actual de la propiedad en cuestión.
Valor devuelto
En la primera versión, el valor devuelto será distinto de cero si la función se completa correctamente; de lo contrario, será cero. En la segunda versión, el valor devuelto será un objeto COleVariant
.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetReadyState
Llame a esta función miembro para recuperar el estado listo del objeto WebBrowser.
READYSTATE GetReadyState() const;
Valor devuelto
El valor devuelto se corresponde con uno de los valores de la enumeración READYSTATE
, tal y como se describe en Windows SDK.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetRegisterAsBrowser
Llame a esta función miembro para determinar si el objeto WebBrowser se registró como explorador de nivel superior en relación con los procesos de resolución de nombres de destino.
BOOL GetRegisterAsBrowser() const;
Valor devuelto
El valor devuelto será distinto de cero si el explorador se registró como explorador de nivel superior; de lo contrario, será cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetRegisterAsDropTarget
Llame a esta función miembro para determinar si el control WebBrowser se registró como destino de colocación para la navegación.
BOOL GetRegisterAsDropTarget() const;
Valor devuelto
El valor devuelto será distinto de cero si el explorador se registró como destino de colocación; de lo contrario, será cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetSilent
Llame a esta función miembro para determinar si se pueden mostrar cuadros de diálogo en el control WebBrowser.
BOOL GetSilent() const;
Valor devuelto
Distinto de cero si los cuadros de diálogo no se pueden mostrar desde el control WebBrowser; de lo contrario, cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetSource
Llame a esta función miembro para recuperar el código fuente HTML de la página web.
BOOL GetSource(CString& strRef);
Valor devuelto
Es distinto de cero si es correcto. En caso contrario, es cero.
Parámetros
refString
El valor de este parámetro se corresponde con un objeto CString
que se va a usar para almacenar el código fuente.
Comentarios
El uso de esta función equivale al uso del comando "Ver origen" en Internet Explorer, con la diferencia de que el código fuente se devolverá en un objeto CString
.
CHtmlView::GetStatusBar
Llame a esta función miembro para determinar si se muestra una barra de estado en el control WebBrowser.
BOOL GetStatusBar() const;
Valor devuelto
El valor devuelto será distinto de cero si se puede mostrar la barra de estado; de lo contrario, será cero.
Comentarios
Este elemento se aplica a Internet Explorer. Si usa esta llamada con un control WebBrowser, no se devolverá ningún error, sino que esta se omitirá.
CHtmlView::GetTheaterMode
Llame a esta función miembro para determinar si el explorador web funciona en modo de pantalla completa actualmente.
BOOL GetTheaterMode() const;
Valor devuelto
El valor devuelto será distinto de cero si el explorador web está en modo de pantalla completa; de lo contrario, será cero.
Comentarios
Si el explorador web está en modo de pantalla completa, la ventana principal del explorador rellenará toda la pantalla, aparecerá una barra de herramientas con un conjunto mínimo de herramientas de navegación y, por último, aparecerá la barra de estado en la esquina superior derecha de la pantalla.
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetToolBar
Llame a esta función miembro para determinar si la barra de herramientas es visible.
int GetToolBar() const;
Valor devuelto
El valor devuelto se usa para indicar si la barra de herramientas es visible. Este será distinto de cero si la barra de herramientas es visible; de lo contrario, será cero.
CHtmlView::GetTop
Llame a esta función miembro para recuperar la coordenada de pantalla del borde superior de la ventana principal del control WebBrowser.
long GetTop() const;
Valor devuelto
El valor devuelto se corresponde con la dirección de una variable donde se recibe la coordenada de pantalla del borde superior de la ventana principal.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetTopLevelContainer
Llame a esta función miembro para determinar si Internet Explorer es el contenedor de nivel superior del control WebBrowser.
BOOL GetTopLevelContainer() const;
Valor devuelto
El valor devuelto será distinto de cero si el contenedor es el contenedor de nivel superior; de lo contrario, será cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetType
Llame a esta función miembro para recuperar el nombre de tipo del documento activo contenido.
CString GetType() const;
Valor devuelto
El valor devuelto se corresponde con un objeto CString
, donde se almacena el nombre de tipo del documento activo contenido.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetVisible
Llame a esta función miembro para determinar si el objeto contenido es visible.
BOOL GetVisible() const;
Valor devuelto
El valor devuelto será distinto de cero si el objeto es visible; de lo contrario, será cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GetWidth
Recupera el ancho de la ventana principal de Internet Explorer.
long GetWidth() const;
Valor devuelto
El valor devuelto se corresponde con la anchura actual de la ventana, que se mide en píxeles.
CHtmlView::GoBack
Llame a esta función miembro para navegar hasta el elemento anterior de la lista de historial.
void GoBack();
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GoForward
Llame a esta función miembro para navegar hasta el elemento posterior de la lista de historial.
void GoForward();
CHtmlView::GoHome
Navega a la página principal o de inicio actual especificada en el cuadro de diálogo Opciones de Internet de Internet Explorer o en el cuadro de diálogo Propiedades de Internet, al que se accede desde el Panel de control.
void GoHome();
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::GoSearch
Llame a esta función miembro para navegar a la página de búsqueda actual, que se especifica en el cuadro de diálogo Opciones de Internet de Internet Explorer o en el cuadro de diálogo Propiedades de Internet, a los que se accede desde el Panel de control.
void GoSearch();
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::LoadFromResource
Llame a esta función miembro para cargar el recurso que se especifique en el control WebBrowser.
BOOL LoadFromResource(LPCTSTR lpszResource);
BOOL LoadFromResource(UINT nRes);
Parámetros
lpszResource
El valor de este parámetro se corresponde con un puntero que apunta a una cadena donde se almacena el nombre del recurso que se va a cargar.
nRes
El valor de este parámetro se corresponde con el id. del búfer donde se almacena el nombre del recurso que se va a cargar.
Valor devuelto
Es distinto de cero si es correcto. En caso contrario, es cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::Navigate
Llame a esta función miembro para ir a un recurso que se identifica mediante una URL.
void Navigate(
LPCTSTR URL,
DWORD dwFlags = 0,
LPCTSTR lpszTargetFrameName = NULL,
LPCTSTR lpszHeaders = NULL,
LPVOID lpvPostData = NULL,
DWORD dwPostDataLen = 0);
Parámetros
URL
El valor de este parámetro se corresponde con una cadena que se asigna desde el llamador y donde se almacena la dirección URL hasta la que debe navegarse o, alternativamente, la ruta de acceso completa del archivo que se va a mostrar.
dwFlags
El valor de este parámetro se corresponde con las marcas de una variable que se usa para especificar si el recurso se va a agregar a la lista del historial, si se va a leer o escribir desde la memoria caché y, por último, si el recurso se va a mostrar en una nueva ventana. Esta variable puede ser una combinación de los valores que se definen en la enumeración BrowserNavConstants
.
lpszTargetFrameName
El valor de este parámetro se corresponde con un puntero que apunta a una cadena donde se almacena el nombre del marco en el que se va a mostrar el recurso.
lpszHeaders
El valor de este parámetro se corresponde con un puntero que apunta a un valor que se usa para especificar los encabezados HTTP que se van a enviar al servidor. Estos encabezados se agregan a los encabezados predeterminados de Internet Explorer. Los encabezados pueden usarse para especificar elementos como la acción que debe realizarse en el servidor, el tipo de datos que deben pasarse al servidor o un código de estado. Este parámetro se omite si el elemento URL
no es una URL HTTP.
lpvPostData
El valor de este parámetro se corresponde con un puntero que apunta a los datos que se van a enviar en la transacción HTTP POST. Por ejemplo, si la transacción POST se usa para enviar los datos que se recopilaron con un formulario HTML. Si no se especifica ningún dato POST en este parámetro, se emitirá una transacción HTTP GET desde Navigate
. Este parámetro se omite si el elemento URL
no es una URL HTTP.
dwPostDataLen
El valor de este parámetro se corresponde con los datos que se van a enviar en la transacción HTTP POST. Por ejemplo, si la transacción POST se usa para enviar los datos que se recopilaron con un formulario HTML. Si no se especifica ningún dato POST en este parámetro, se emitirá una transacción HTTP GET desde Navigate
. Este parámetro se omite si el elemento URL
no es una URL HTTP.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::Navigate2
Llame a esta función miembro para ir a un recurso que se identifica mediante una URL o a un archivo que se identifica mediante una ruta de acceso completa.
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
El valor de este parámetro se corresponde con un puntero que apunta a una estructura ITEMIDLIST
.
dwFlags
El valor de este parámetro se corresponde con las marcas de una variable que se usa para especificar si el recurso se va a agregar a la lista del historial, si se va a leer o escribir desde la memoria caché y, por último, si el recurso se va a mostrar en una nueva ventana. Esta variable puede ser una combinación de los valores que se definen en la enumeración BrowserNavConstants
.
lpszTargetFrameName
El valor de este parámetro se corresponde con un puntero que apunta a una cadena donde se almacena el nombre del marco en el que se va a mostrar el recurso.
lpszURL
Puntero a una cadena que contiene la dirección URL.
lpvPostData
El valor de este parámetro se corresponde con los datos que se van a enviar en la transacción HTTP POST. Por ejemplo, si la transacción POST se usa para enviar los datos que se recopilaron con un formulario HTML. Si no se especifica ningún dato POST en este parámetro, se emitirá una transacción HTTP GET desde Navigate2
. Este parámetro se omite si el elemento URL
no es una URL HTTP o HTTPS.
dwPostDataLen
El valor de este parámetro se corresponde con la longitud, en bytes, de los datos a los que se apunta mediante el parámetro lpvPostData
.
lpszHeaders
El valor de este parámetro se corresponde con un puntero que apunta a un valor que se usa para especificar los encabezados HTTP o HTTPS que se van a enviar al servidor. Estos encabezados se agregan a los encabezados predeterminados de Internet Explorer. Los encabezados pueden usarse para especificar elementos como la acción que debe realizarse en el servidor, el tipo de datos que deben pasarse al servidor o un código de estado. Este parámetro se omite si el elemento URL
no es una URL HTTP o HTTPS.
baPostedData
Referencia a un objeto CByteArray
.
Comentarios
Esta función miembro constituye una extensión de la función miembro Navigate
donde se admiten los procesos de exploración en carpetas especiales, como Escritorio y Mi equipo, que se representan mediante el parámetro pIDL
.
Se aplica a Internet Explorer y WebBrowser.
Ejemplo
void CMyHtmlView::OnGoToMicrosoft()
{
Navigate2(_T("http://home.microsoft.com"));
}
CHtmlView::OnBeforeNavigate2
Se llama a esta función miembro desde el marco para que se desencadene un evento antes de que se produzca una operación de navegación en el explorador web.
virtual void OnBeforeNavigate2(
LPCTSTR lpszURL,
DWORD nFlags,
LPCTSTR lpszTargetFrameName,
CByteArray& baPostedData,
LPCTSTR lpszHeaders,
BOOL* pbCancel);
Parámetros
lpszURL
El valor de este parámetro se corresponde con un puntero que apunta a una cadena donde se almacena la URL hasta la que debe navegarse.
nFlags
Reservado para uso futuro.
lpszTargetFrameName
El valor de este parámetro se corresponde con una cadena que se usa para almacenar el nombre del marco donde se va a mostrar el recurso o, alternativamente, con un valor NULL
si no hay un marco con nombre que se vaya a usar en relación con el recurso.
baPostedData
El valor de este parámetro se corresponde con una referencia a un objeto CByteArray
donde se almacenan los datos que se enviarán al servidor si se usa la transacción HTTP POST.
lpszHeaders
El valor de este parámetro se corresponde con un puntero que apunta a una cadena donde se almacenan otros encabezados HTTP que se van a enviar al servidor (solo URL HTTP). Los encabezados pueden usarse para especificar elementos como la acción que debe realizarse en el servidor, el tipo de datos que deben pasarse al servidor o un código de estado.
pbCancel
El valor de este parámetro se corresponde con un puntero que apunta a una marca de cancelación. Mediante una aplicación, este parámetro puede establecerse en un valor distinto de cero para cancelar la operación de navegación o, alternativamente, en cero para permitir que esta continúe.
CHtmlView::OnCommandStateChange
Se llama a esta función miembro desde el marco para que se notifique a una aplicación de que el estado habilitado de un comando del explorador web ha cambiado.
virtual void OnCommandStateChange(
long nCommand,
BOOL bEnable);
Parámetros
nCommand
El valor de este parámetro se corresponde con el identificador del comando cuyo estado habilitado ha cambiado.
bEnable
Este valor se usa para indicar el estado habilitado del comando. El valor de este parámetro será distinto de cero si el comando está habilitado o cero si está deshabilitado.
CHtmlView::OnDocumentComplete
Se llama a esta función miembro desde el marco para notificar a una aplicación de que un documento ha alcanzado el estado READYSTATE_COMPLETE
.
virtual void OnDocumentComplete(LPCTSTR lpszURL);
Parámetros
lpszURL
El valor de este parámetro se corresponde con un puntero que apunta a una cadena cuyo valor se evalúa como la URL, el nombre de archivo UNC o un PIDL (un puntero a una lista de identificadores de elementos) a la que se ha navegado.
Comentarios
Este evento no se desencadenará en todos los marcos. No obstante, para cada marco donde se active un evento OnDownloadBegin
, se desencadenará un evento OnDocumentComplete
correspondiente.
La URL que se indique en el parámetro lpszURL
podrá ser diferente de la URL hasta la que se haya indicado que deba ir el explorador, ya que esta URL será la URL en formato canónico y calificada. Por ejemplo, si se especifica la URL "www.microsoft.com"
en una llamada a un objeto Navigate
o Navigate2
, la URL que se pase por la función OnNavigateComplete2
será "<https://www.microsoft.com/>"
. Además, si se ha redirigido al explorador a una URL diferente desde el servidor, la URL que se redirige se reflejará aquí.
CHtmlView::OnDocWindowActivate
Se llama a esta función miembro desde la implementación de Internet Explorer o MSHTML del método IOleInPlaceActiveObject::OnDocWindowActivate
, desde donde se notifica al objeto en contexto activo sobre si la ventana de documento del contenedor se activa o desactiva.
virtual HRESULT OnDocWindowActivate(BOOL fActivate);
Parámetros
fActivate
El valor de este parámetro se usa para averiguar el estado de la ventana de documento. Si este valor es distinto de cero, la ventana se activará. Si este valor es cero, la ventana se desactivará.
Valor devuelto
El valor devuelto será S_OK
si la función se ejecuta correctamente; en el caso contrario, será un código de error definido mediante OLE.
Comentarios
Invalide el elemento OnDocWindowActivate
para reaccionar a una notificación OnDocWindowActivate
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::OnDocWindowActivate
en Windows SDK.
CHtmlView::OnDownloadBegin
Se llama a esta función miembro desde el marco para comenzar el proceso de descarga de un documento.
virtual void OnDownloadBegin();
Comentarios
Este evento se desencadena poco después del evento OnBeforeNavigate2
, a menos que se cancele la navegación. Cualquier animación o indicación de un estado "ocupado" que deba mostrarse desde el contenedor deberá conectarse con este evento.
CHtmlView::OnDownloadComplete
Se llama a esta función miembro desde el marco para indicar que una operación de navegación se ha finalizado, se ha detenido o tiene errores.
virtual void OnDownloadComplete();
CHtmlView::OnEnableModeless
Se llama a esta función miembro cuando se muestra una UI modal desde Internet Explorer o MSHTML.
virtual HRESULT OnEnableModeless(BOOL fEnable);
Parámetros
fEnable
El valor de este parámetro se usa para averiguar si los cuadros de diálogo no modales del host están habilitados o deshabilitados. Si este valor es distinto de cero, se habilitarán los cuadros de diálogo no modales. Si este valor es cero, se deshabilitarán los cuadros de diálogo no modales.
Valor devuelto
El valor devuelto será S_OK
si la función se ejecuta correctamente; en el caso contrario, será un código de error definido mediante OLE.
Comentarios
Esta función se usa para habilitar o deshabilitar los cuadros de diálogo no modales cuando se cree o se destruya un cuadro de diálogo modal desde el contenedor. Invalide el elemento OnEnableModeless
para reaccionar a una notificación EnableModeless
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::EnableModeless
en Windows SDK.
CHtmlView::OnFilterDataObject
Internet Explorer o MSHTML lo llaman en el host para permitir que el host reemplace el objeto de datos de Internet Explorer o MSHTML.
virtual HRESULT OnFilterDataObject(
LPDATAOBJECT pDataObject,
LPDATAOBJECT* ppDataObject);
Parámetros
pDataObject
El valor de este parámetro se corresponde con la dirección de la interfaz IDataObject
que se proporciona desde Internet Explorer o MSHTML.
ppDataObject
El valor de este parámetro se corresponde con la dirección donde se recibe el puntero de interfaz IDataObject
que se proporciona desde el host. El contenido de este parámetro siempre debe inicializarse con un valor NULL
; incluso si se produce un error en el método.
Valor devuelto
El valor que se devuelve será S_OK
si se reemplaza el objeto de datos. Asimismo, el valor será S_FALSE
si este no se reemplaza o será o un código de error definido mediante OLE si se produce un error.
Comentarios
Invalide el elemento OnFilterDataObject
para reaccionar a una notificación FilterDataObject
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::FilterDataObject
en Windows SDK.
CHtmlView::OnFrameWindowActivate
Se llama a esta función miembro desde el método IOleInPlaceActiveObject::OnFrameWindowActivate
para notificar al objeto sobre si la ventana de marco de nivel superior del contenedor se activa o desactiva.
virtual HRESULT OnFrameWindowActivate(BOOL fActivate);
Parámetros
fActivate
El valor de este parámetro se usa para averiguar el estado de la ventana de marco de nivel superior del contenedor. Si este valor es distinto de cero, la ventana se activará. Si este valor es cero, la ventana se desactivará.
Valor devuelto
El valor devuelto será S_OK
si la función se ejecuta correctamente; en el caso contrario, será un código de error definido mediante OLE.
Comentarios
Invalide el elemento OnFrameWindowActivate
para reaccionar a una notificación OnFrameWindowActivate
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::OnFrameWindowActivate
en Windows SDK.
CHtmlView::OnFullScreen
Se llama a esta función miembro desde el marco cuando cambia el valor de la propiedad FullScreen
.
virtual void OnFullScreen(BOOL bFullScreen);
Parámetros
bFullScreen
El valor de este parámetro será distinto de cero si Internet Explorer está en modo de pantalla completa; de lo contrario, será cero.
CHtmlView::OnGetDropTarget
Se llama a esta función miembro desde Internet Explorer o MSHTML para usarse como destino para colocar, de manera que pueda proporcionarse una instancia alternativa de la interfaz IDropTarget
desde el host.
virtual HRESULT OnGetDropTarget(
LPDROPTARGET pDropTarget,
LPDROPTARGET* ppDropTarget);
Parámetros
pDropTarget
El valor de este parámetro se corresponde con la instancia de IDropTarget
cuyo uso se propone desde Internet Explorer o MSHTML.
ppDropTarget
El valor de este parámetro se corresponde con la dirección del objeto IDropTarget
donde se recibe el puntero de interfaz IDropTarget
que quiere proporcionarse desde el host.
Valor devuelto
Para obtener una lista de códigos de retorno, consulte el método IDocHostUIHandler::GetDropTarget
en Windows SDK.
Comentarios
Invalide el elemento OnGetDropTarget
para reaccionar a una notificación GetDropTarget
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::GetDropTarget
en Windows SDK.
CHtmlView::OnGetExternal
Internet Explorer o MSHTML lo llaman para obtener la interfaz IDispatch
del host.
virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);
Parámetros
lppDispatch
El valor de este parámetro se corresponde con un puntero que apunta a la dirección donde se recibe el puntero de interfaz IDispatch
de la aplicación host. Si se expone una interfaz de Automation en el host, será posible obtener una referencia a Internet Explorer o MSHTML mediante este parámetro. El contenido de este parámetro siempre debe inicializarse con un valor NULL
; incluso si se produce un error en el método.
Valor devuelto
El valor devuelto será S_OK
si la función se ejecuta correctamente; en el caso contrario, será un código de error definido mediante OLE.
Comentarios
Invalide el elemento OnGetExternal
para reaccionar a una notificación GetExternal
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::GetExternal
en Windows SDK.
CHtmlView::OnGetHostInfo
Recupera las capacidades de la interfaz de usuario del host de Internet Explorer o MSHTML.
virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);
Parámetros
pInfo
Dirección de una estructura DOCHOSTUIINFO
donde se reciben las funcionalidades de la UI del host.
Valor devuelto
El valor devuelto será S_OK
si la función se ejecuta correctamente; en el caso contrario, será un código de error definido mediante OLE.
Comentarios
Invalide el elemento OnGetHostInfo
para reaccionar a una notificación GetHostInfo
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::GetHostInfo
en Windows SDK.
CHtmlView::OnGetOptionKeyPath
Llame a esta función miembro para obtener la clave del Registro donde se almacenan las preferencias del usuario de Internet Explorer o MSHTML.
virtual HRESULT OnGetOptionKeyPath(
LPOLESTR* pchKey,
DWORD dwReserved);
Parámetros
pchKey
El valor de este parámetro se corresponde con la dirección de un objeto LPOLESTR
donde se recibe la cadena de subclave del Registro donde, a su vez, se almacenan las opciones predeterminadas del host. Esta subclave se almacenará bajo la clave HKEY_CURRENT_USER
. Use la función CoTaskMemAlloc
para asignar esta memoria. Esta memoria deberá liberarse desde la aplicación que se use para realizar la llamada, mediante una llamada a la función CoTaskMemFree
. Este parámetro siempre debe inicializarse con un valor NULL
; incluso si se produce un error en el método.
dwReserved
Reservado para uso futuro. No se usa actualmente.
Valor devuelto
El valor devuelto será S_OK
si la función se completa correctamente; de lo contrario, será S_FALSE
. Si es S_FALSE
, se usarán las opciones de usuario de Internet Explorer o MSHTML como valores predeterminados.
Comentarios
Invalide el elemento OnGetOptionKeyPath
para reaccionar a una notificación GetOptionKeyPath
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::GetOptionKeyPath
en Windows SDK.
CHtmlView::OnHideUI
Se llama a esta función miembro desde el marco cuando se quitan menús y barras de herramientas de Internet Explorer o MSHTML.
virtual HRESULT OnHideUI();
Valor devuelto
El valor devuelto será S_OK
si la función se ejecuta correctamente; en el caso contrario, será un código de error definido mediante OLE.
Comentarios
Invalide el elemento OnHideUI
para reaccionar a una notificación HideUI
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::HideUI
en Windows SDK.
CHtmlView::OnMenuBar
Se llama a esta función miembro desde el marco cuando cambia el valor de la propiedad MenuBar
.
virtual void OnMenuBar(BOOL bMenuBar);
Parámetros
bMenuBar
El valor de este parámetro será distinto de cero si la barra de menús de Internet Explorer es visible; de lo contrario, será cero.
CHtmlView::OnNavigateComplete2
Se llama a esta función miembro desde el marco una vez que se completa el proceso de navegación hasta un hipervínculo (en un elemento de ventana o conjunto de marcos).
virtual void OnNavigateComplete2(LPCTSTR strURL);
Parámetros
strURL
El valor de este parámetro se corresponde con una expresión de cadena cuyo valor se evalúa como la URL, el nombre de archivo UNC o un PIDL (un puntero a una lista de identificadores de elementos) a la que se ha navegado.
Comentarios
El parámetro URL podrá ser un PIDL siempre que haya una entidad de espacio de nombres de shell que no tenga una representación mediante URL.
La URL que se incluya en el parámetro strURL
podrá ser diferente de la URL hasta la que se haya indicado que deba ir el explorador, ya que esta URL será la URL en formato canónico y calificada. Por ejemplo, si se especifica la URL "www.microsoft.com"
en una llamada a un objeto Navigate
o Navigate2
, la URL que se pase por la función OnNavigateComplete2
será "<https://www.microsoft.com/>"
. Además, si se ha redirigido al explorador a una URL diferente desde el servidor, la URL que se redirige se reflejará aquí.
CHtmlView::OnNavigateError
El marco de trabajo lo llama si la navegación a un hipervínculo no se realiza correctamente.
virtual void OnNavigateError(
LPCTSTR lpszURL,
LPCTSTR lpszFrame,
DWORD dwError,
BOOL* pbCancel);
Parámetros
lpszURL
El valor de este parámetro se corresponde con la URL para la que se produjo un error de navegación.
lpszFrame
El valor de este parámetro se corresponde con el nombre del marco donde se va a mostrar el recurso o, alternativamente, con un valor NULL
si no hay un marco con nombre que se vaya a usar en relación con el recurso.
dwError
El valor de este parámetro se corresponde con código de estado de error, siempre que haya uno disponible. Para obtener una lista de los códigos de estado HRESULT
y HTTP posibles, consulte Códigos de estado del evento NavigateError
.
pbCancel
El valor de este parámetro se usa para especificar si debe cancelarse la navegación hasta una página de error o hasta un proceso de búsqueda automática posterior. Si el valor es TRUE
(el valor predeterminado), se continuará la navegación hasta una página de error o hasta un proceso de búsqueda automática; de lo contrario, si es FALSE
, se cancelará la navegación hasta estos elementos.
Comentarios
Reemplace este método para proporcionar procesos de control de errores de navegación personalizados.
Para obtener más información, consulte: DWebBrowserEvents2::NavigateError
CHtmlView::OnNewWindow2
Se llama a esta función miembro desde el marco cuando se va a crear una nueva ventana donde mostrar un recurso.
virtual void OnNewWindow2(
LPDISPATCH* ppDisp,
BOOL* Cancel);
Parámetros
ppDisp
El valor de este parámetro se corresponde con un puntero que apunta a un puntero de interfaz donde, opcionalmente, se recibe el puntero de interfaz IDispatch
de un nuevo objeto de WebBrowser o Internet Explorer.
Cancel
El valor de este parámetro se corresponde con un puntero que apunta a una marca de cancelación. Mediante una aplicación, este parámetro puede establecerse en un valor distinto de cero para cancelar la operación de navegación o, alternativamente, en cero para permitir que esta continúe.
Comentarios
Este evento precede al proceso de creación de una nueva ventana desde el elemento WebBrowser.
CHtmlView::OnProgressChange
Se llama a esta función miembro desde el marco para notificar a una aplicación de que se ha actualizado el progreso de una operación de descarga.
virtual void OnProgressChange(
long nProgress,
long nProgressMax);
Parámetros
nProgress
El valor de este parámetro se corresponde con la cantidad del progreso total que se va a mostrar o, alternativamente, -1 si se completa el progreso.
nProgressMax
El valor de este parámetro se corresponde con el valor máximo del progreso.
Comentarios
La información que se proporciona en este evento puede usarse en el contenedor para mostrar el número de bytes que se han descargado hasta ahora o para actualizar un indicador de progreso.
CHtmlView::OnPropertyChange
Se llama a esta función miembro desde el marco para notificar a una aplicación de que se ha cambiado el valor de una propiedad mediante el uso de la función PutProperty
.
virtual void OnPropertyChange(LPCTSTR lpszProperty);
Parámetros
lpszProperty
El valor de este parámetro se corresponde con un puntero que apunta a una cadena donde se almacena el nombre de la propiedad.
CHtmlView::OnQuit
Se llama a esta función miembro desde el marco para notificar a una aplicación de que Internet Explorer está preparado para salir.
virtual void OnQuit();
CHtmlView::OnResizeBorder
Se llama a esta función miembro desde la implementación de Internet Explorer o MSHTML del método IOleInPlaceActiveObject::ResizeBorder
, desde donde se alerta al objeto de que debe cambiarse el tamaño de su espacio del borde.
virtual HRESULT OnResizeBorder(
LPCRECT prcBorder,
LPOLEINPLACEUIWINDOW pUIWindow,
BOOL fFrameWindow);
Parámetros
prcBorder
El valor de este parámetro se corresponde con el nuevo rectángulo exterior para el espacio de borde.
pUIWindow
El valor de este parámetro se corresponde con un puntero que apunta a la interfaz del objeto de ventana de marco o documento cuyo borde ha cambiado.
fFrameWindow
El valor de este parámetro deberá ser TRUE
si va a llamarse al método IOleInPlaceActiveObject::ResizeBorder
desde la ventana del marco; de lo contrario, deberá ser FALSE
.
Valor devuelto
El valor devuelto será S_OK
si la función se ejecuta correctamente; en el caso contrario, será un código de error definido mediante OLE.
Comentarios
Invalide el elemento OnResizeBorder
para reaccionar a una notificación ResizeBorder
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::ResizeBorder
en Windows SDK.
CHtmlView::OnShowContextMenu
Se llama a esta función miembro desde Internet Explorer o MSHTML cuando está a punto de mostrarse su menú contextual.
virtual HRESULT OnShowContextMenu(
DWORD dwID,
LPPOINT ppt,
LPUNKNOWN pcmdtReserved,
LPDISPATCH pdispReserved);
Parámetros
dwID
El valor de este parámetro se corresponde con el identificador del menú contextual que se va a mostrar. Para una lista de valores, consulte IDocHostUIHandler::ShowContextMenu
en Windows SDK.
ppt
El valor de este parámetro se corresponde con las coordenadas de pantalla del menú.
pcmdtReserved
El valor de este parámetro se corresponde con la instancia de la interfaz IOleCommandTarget
que se usa para consultar el estado del comando y ejecutar comandos sobre este objeto.
pdispReserved
El valor de este parámetro se corresponde con la instancia de la interfaz IDispatch
del objeto que se ubica en las coordenadas de la pantalla que se especifican. Este parámetro se usa para permitir que se diferencien determinados objetos en el host y, por tanto, que se proporcione un contexto más específico.
Valor devuelto
Para una lista de valores, consulte IDocHostUIHandler::ShowContextMenu
en Windows SDK.
Comentarios
Invalide el elemento OnShowContextMenu
para reaccionar a una notificación ShowContextMenu
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::ShowContextMenu
en Windows SDK.
CHtmlView::OnShowUI
Se llama antes de que Internet Explorer o MSHTML muestren sus menús y barras de herramientas.
virtual HRESULT OnShowUI(
DWORD dwID,
LPOLEINPLACEACTIVEOBJECT pActiveObject,
LPOLECOMMANDTARGET pCommandTarget,
LPOLEINPLACEFRAME pFrame,
LPOLEINPLACEUIWINDOW pDoc);
Parámetros
dwID
Reservado para uso futuro.
pActiveObject
El valor de este parámetro se corresponde con la instancia de la interfaz IOleInPlaceActiveObject
del objeto que está activo actualmente.
pCommandTarget
El valor de este parámetro se corresponde con la instancia de la interfaz IOleCommandTarget
del objeto.
pFrame
El valor de este parámetro se corresponde con la instancia de la interfaz IOleInPlaceFrame
del objeto. Esto es necesario en el caso de los menús y las barras de herramientas.
pDoc
El valor de este parámetro se corresponde con la instancia de la interfaz IOleInPlaceUIWindow
del objeto. Esto es necesario en el caso de las barras de herramientas.
Valor devuelto
Para una lista de valores, consulte IDocHostUIHandler::ShowUI
en Windows SDK.
Comentarios
Invalide el elemento OnShowUI
para reaccionar a una notificación ShowUI
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::ShowUI
en Windows SDK.
CHtmlView::OnStatusBar
Se llama a esta función miembro desde el marco cuando cambia el valor de la propiedad StatusBar
.
virtual void OnStatusBar(BOOL bStatusBar);
Parámetros
bStatusBar
El valor de este parámetro será distinto de cero si la barra de estado de Internet Explorer es visible; de lo contrario, será cero.
CHtmlView::OnStatusTextChange
Esta función se llama desde el marco para notificar a una aplicación de que el texto de la barra de estado que está asociada con el control WebBrowser ha cambiado.
virtual void OnStatusTextChange(LPCTSTR lpszText);
Parámetros
lpszText
El valor de este parámetro se corresponde con una cadena donde se almacena el nuevo texto de la barra de estado.
CHtmlView::OnTheaterMode
Se llama a esta función miembro desde el marco cuando cambia el valor de la propiedad TheaterMode
.
virtual void OnTheaterMode(BOOL bTheaterMode);
Parámetros
bTheaterMode
El valor de este parámetro será distinto de cero si Internet Explorer está en modo de pantalla completa; de lo contrario, será cero.
CHtmlView::OnTitleChange
Se llama a esta función miembro desde el marco para notificar a una aplicación sobre si el título de un documento del control WebBrowser pasa a estar disponible o cambia.
virtual void OnTitleChange(LPCTSTR lpszText);
Parámetros
lpszText
El valor de este parámetro se corresponde con el nuevo título del documento.
Comentarios
En el caso de HTML, el título podría cambiar; la URL del documento se establecerá como título mientras que el elemento HTML todavía se está descargando. Después de que el título real (si existe) se analice a partir del elemento HTML, el título se cambiará para reflejar el título real.
CHtmlView::OnToolBar
Se llama a esta función miembro desde el marco cuando cambia el valor de la propiedad ToolBar
.
virtual void OnToolBar(BOOL bToolBar);
Parámetros
bToolBar
El valor de este parámetro será distinto de cero si la barra de herramientas de Internet Explorer es visible; de lo contrario, será cero.
CHtmlView::OnTranslateAccelerator
Se llama a esta función miembro desde Internet Explorer o MSHTML cuando se llama a los métodos IOleInPlaceActiveObject::TranslateAccelerator
o IOleControlSite::TranslateAccelerator
para procesar los mensajes de tecla de aceleración de menús que se ubiquen en la cola de mensajes del contenedor.
virtual HRESULT OnTranslateAccelerator(
LPMSG lpMsg,
const GUID* pguidCmdGroup,
DWORD nCmdID);
Parámetros
lpMsg
El valor de este parámetro se usa para apuntar al mensaje que podría necesitar traducirse.
pguidCmdGroup
El valor de este parámetro se corresponde con el identificador del grupo de comandos.
nCmdID
Identificador de comando.
Valor devuelto
El valor devuelto será S_OK
si la función se completa correctamente; de lo contrario, será S_FALSE
.
Comentarios
Invalide el elemento OnTranslateAccelerator
para reaccionar a una notificación TranslateAccelerator
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::TranslateAccelerator
en Windows SDK.
CHtmlView::OnTranslateUrl
Internet Explorer o MSHTML lo llaman para ofrecer al host la oportunidad de modificar la dirección URL que se va a cargar.
virtual HRESULT OnTranslateUrl(
DWORD dwTranslate,
OLECHAR* pchURLIn,
OLECHAR** ppchURLOut);
Parámetros
dwTranslate
Reservado para uso futuro.
pchURLIn
El valor de este parámetro se corresponde con la dirección de una cadena, que se proporciona desde Internet Explorer o MSHTML, donde se representa la URL que se va a traducir.
ppchURLOut
El valor de este parámetro se corresponde con la dirección de un puntero de cadena donde se recibirá la dirección de la URL que se traduzca. El búfer se asigna desde el host, mediante el asignador de memoria de tareas. El contenido de este parámetro siempre debe inicializarse con un valor NULL
; incluso si la URL no se traduce o se produce un error en el método.
Valor devuelto
El valor devuelto será S_OK
si la URL se traduce. Asimismo, será S_FALSE
si la URL no se traduce o un código de error definido mediante OLE si se produce un error.
Comentarios
Invalide el elemento OnTranslateUrl
para reaccionar a una notificación TranslateUrl
del control Microsoft Web Browser. Para obtener más información, consulte el método IDocHostUIHandler::TranslateUrl
en Windows SDK.
CHtmlView::OnUpdateUI
Notifica al host que cambió el estado del comando.
virtual HRESULT OnUpdateUI();
Valor devuelto
El valor devuelto será S_OK
si la función se ejecuta correctamente; en el caso contrario, será un código de error definido mediante OLE.
Comentarios
El estado de los botones de la barra de herramientas debe actualizarse desde el host. Se llama a este método independientemente del valor devuelto del elemento ShowUI
. Invalide el elemento OnUpdateUI
para reaccionar a una notificación UpdateUI
del control Microsoft Web Browser.
CHtmlView::OnVisible
Se llama a esta función miembro desde el marco cuando se debe mostrar u ocultar la ventana del elemento WebBrowser.
virtual void OnVisible(BOOL bVisible);
Parámetros
bVisible
El valor devuelto será distinto de cero si el objeto es visible; de lo contrario, será cero.
Comentarios
Esto permite que la ventana de host del control de objetos se comporte de la misma manera que la ventana de Internet Explorer.
CHtmlView::PutProperty
Llame a esta función miembro para establecer la propiedad que se asocie con un objeto determinado.
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
El valor de este parámetro se corresponde con una cadena donde se almacena el valor de propiedad que va a establecerse.
vtValue
El valor de este parámetro se corresponde con el nuevo valor de la propiedad que se indica mediante el parámetro lpszProperty
.
lpszPropertyName
El valor de este parámetro se corresponde con un puntero que apunta a una cadena donde se almacena el nombre de la propiedad que se va a establecer.
dValue
Valor nuevo de la propiedad.
lValue
Valor nuevo de la propiedad.
lpszValue
El valor de este parámetro se corresponde con un puntero que apunta a una cadena donde se almacena el nuevo valor de la propiedad.
nValue
Valor nuevo de la propiedad.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::QueryFormsCommand
Consulta el estado de uno o más comandos generados por eventos de interfaz de usuario.
HRESULT QueryFormsCommand(
DWORD dwCommandID,
BOOL* pbSupported,
BOOL* pbEnabled,
BOOL* pbChecked);
Parámetros
dwCommandID
El valor de este parámetro se corresponde con el identificador del comando sobre el que se va a realizar la consulta.
pbSupported
El valor de este parámetro se corresponde con un puntero que apunta a un objeto BOOL
, que se usa para especificar si se admite el comando (que se identifica en el parámetro dwCommandID
). Si se admite el comando, el valor deberá ser TRUE
; de lo contrario, deberá ser FALSE
.
pbEnabled
El valor de este parámetro se corresponde con un puntero que apunta a un objeto BOOL
, que se usa para especificar si el comando (que se identifica en el parámetro dwCommandID
) está habilitado. Si se admite el comando, el valor deberá ser TRUE
; de lo contrario, deberá ser FALSE
.
pbChecked
El valor de este parámetro se corresponde con un puntero que apunta a un objeto BOOL
, que se usa para especificar si el comando (que se identifica en el parámetro dwCommandID
) está comprobado. Si se admite el comando, el valor deberá ser TRUE
; de lo contrario, deberá ser FALSE
.
Valor devuelto
Un valor HRESULT
estándar. Para obtener una lista completa de los valores posibles para este método, consulte el método IOleCommandTarget::QueryStatus
de Windows SDK.
Comentarios
En el método QueryFormsCommand
, se implementa el comportamiento del método IOleCommandTarget::QueryStatus
.
CHtmlView::QueryStatusWB
Llame a esta función miembro para consultar un estado de comando.
OLECMDF QueryStatusWB(OLECMDID cmdID) const;
Parámetros
cmdID
El valor de este parámetro se corresponde con el valor OLECMDID
del comando para cuyo llamador se requiere información.
Valor devuelto
El valor devuelto se corresponderá con la dirección del valor OLECMDF
donde se recibe el estado del comando.
Comentarios
En el método QueryStatusWB
, se implementa el comportamiento del método IOleCommandTarget::QueryStatus
.
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::Refresh
Llame a esta función para volver a cargar la URL o el archivo que se está mostrando actualmente en el explorador web.
void Refresh();
Comentarios
En la función Refresh
no se incluyen parámetros que puedan usarse para establecer el nivel de actualización.
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::Refresh2
Llame a esta función para volver a cargar el archivo que se está mostrando actualmente en Internet Explorer.
void Refresh2(int nLevel);
Parámetros
nLevel
El valor de este parámetro se corresponde con la dirección de la variable que se usa para especificar el nivel de actualización. Las variables posibles se definen en el tipo enumerado RefreshConstants
, en Windows SDK.
Comentarios
A diferencia de la función Refresh
, en la función Refresh2
se incluye un parámetro que se usa para especificar el nivel de actualización.
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::SetAddressBar
Llame a esta función miembro para hacer que se muestre u oculte la barra de direcciones del objeto de Internet Explorer.
void SetAddressBar(BOOL bNewValue);
Parámetros
bNewValue
El valor de este parámetro deberá ser distinto de cero para que se muestre la barra de direcciones; de lo contrario, deberá ser cero.
Comentarios
Este elemento se aplica a Internet Explorer. Si usa esta llamada con un control WebBrowser, no se devolverá ningún error, sino que esta se omitirá.
CHtmlView::SetFullScreen
Llame a esta función miembro para establecer Internet Explorer en modo de ventana completa o en modo de ventana normal.
void SetFullScreen(BOOL bNewValue);
Parámetros
bNewValue
El valor de este parámetro deberá ser distinto de cero para que se establezca el modo de pantalla completa; de lo contrario, deberá ser cero.
Comentarios
En el modo de pantalla completa, la ventana principal de Internet Explorer se maximiza. A su vez, tanto la barra de estado como la barra de herramientas, la barra de menús y la barra de título se ocultan.
Este elemento se aplica a Internet Explorer. Si usa esta llamada con un control WebBrowser, no se devolverá ningún error, sino que esta se omitirá.
CHtmlView::SetHeight
Llame a esta función miembro para establecer la altura de la ventana principal de Internet Explorer.
void SetHeight(long nNewValue);
Parámetros
nNewValue
El valor de este parámetro se corresponde con la altura, en píxeles, de la ventana principal.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::SetLeft
Establece la posición horizontal de la ventana principal de Internet Explorer.
void SetLeft(long nNewValue);
Parámetros
nNewValue
El valor de este método se corresponde con la coordenada de pantalla del borde izquierdo de la ventana principal.
CHtmlView::SetMenuBar
Llame a esta función miembro para hacer que se muestre u oculte la barra de menús de Internet Explorer.
void SetMenuBar(BOOL bNewValue);
Parámetros
bNewValue
El valor de este parámetro deberá ser distinto de cero para que se muestre la barra de menús; de lo contrario, deberá ser cero.
Comentarios
Este elemento se aplica a Internet Explorer. Si usa esta llamada con un control WebBrowser, no se devolverá ningún error, sino que esta se omitirá.
CHtmlView::SetOffline
Llame a esta función miembro para establecer un valor que se usa para indicar si el control WebBrowser está funcionando actualmente en modo sin conexión.
void SetOffline(BOOL bNewValue);
Parámetros
bNewValue
El valor de este parámetro deberá ser distinto de cero para que se lea desde la memoria caché local; de lo contrario, deberá ser cero.
Comentarios
Cuando se esté en modo sin conexión, en el explorador se leerán las páginas HTML desde la memoria caché local en lugar de desde el documento de origen.
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::SetRegisterAsBrowser
Llame a esta función miembro para establecer un valor que se usa para indicar si el control WebBrowser se registró como explorador de nivel superior en relación con los procesos de resolución de nombres de destino.
void SetRegisterAsBrowser(BOOL bNewValue);
Parámetros
bNewValue
El valor de este parámetro se usa para determinar si Internet Explorer se registró como un explorador de nivel superior. Si el valor no es cero, significará que el explorador web se registró como un explorador de nivel superior; de lo contrario, si este es cero, significará que no es un explorador de nivel superior. El valor predeterminado es cero.
Comentarios
El explorador de nivel superior es el que se establece en el Registro como explorador predeterminado.
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::SetRegisterAsDropTarget
Llame a esta función miembro para establecer un valor que se usa para indicar si el control WebBrowser se registró como destino para colocar en relación con el proceso de navegación.
void SetRegisterAsDropTarget(BOOL bNewValue);
Parámetros
bNewValue
El valor de este parámetro se usa para determinar si el control WebBrowser está registrado como destino de colocación para la navegación. Si el valor no es cero, significará que el objeto se registró como un destino de colocación; de lo contrario, si este es cero, significará que no es un destino de colocación.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::SetSilent
Llame a esta función miembro para establecer un valor que se usa para indicar si se pueden mostrar cuadros de diálogo.
void SetSilent(BOOL bNewValue);
Parámetros
bNewValue
Si el valor no es cero, significará que no se pueden mostrar cuadros de diálogo; de lo contrario, si este es cero, significará que estos sí pueden mostrarse. El valor predeterminado es cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::SetStatusBar
Llame a esta función miembro para hacer que se muestre la barra de estado.
void SetStatusBar(BOOL bNewValue);
Parámetros
bNewValue
El valor devuelto será distinto de cero si la barra de estado es visible; de lo contrario, será cero.
Comentarios
Este elemento se aplica a Internet Explorer. Si usa esta llamada con un control WebBrowser, no se devolverá ningún error, sino que esta se omitirá.
CHtmlView::SetTheaterMode
Llame a esta función miembro para establecer un valor que se usa para indicar si el control WebBrowser está en modo de pantalla completa.
void SetTheaterMode(BOOL bNewValue);
Parámetros
bNewValue
El valor de este parámetro deberá ser distinto de cero para hacer que el control WebBrowser se establezca en modo de pantalla completa; de lo contrario, deberá ser cero. El valor predeterminado es cero.
Comentarios
Si el explorador web está en modo de pantalla completa, la ventana principal del explorador rellenará toda la pantalla, aparecerá una barra de herramientas con un conjunto mínimo de herramientas de navegación y, por último, aparecerá la barra de estado en la esquina superior derecha de la pantalla.
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::SetToolBar
Llame a esta función miembro para hacer que se muestre u oculte la barra de herramientas de Internet Explorer.
void SetToolBar(int nNewValue);
Parámetros
nNewValue
El valor de este parámetro se usa para indicar si debe mostrarse la barra de herramientas. El valor de este parámetro deberá ser distinto de cero para hacer que se muestre la barra de herramientas; de lo contrario, deberá ser cero.
Comentarios
Este elemento se aplica a Internet Explorer. Si usa esta llamada con un control WebBrowser, no se devolverá ningún error, sino que esta se omitirá.
CHtmlView::SetTop
Llame a esta función miembro para establecer la distancia entre el borde superior interno del control WebBrowser y el borde superior de su contenedor.
void SetTop(long nNewValue);
Parámetros
nNewValue
El valor de este método se corresponde con la coordenada de pantalla del borde superior de la ventana principal.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::SetVisible
Llame a esta función miembro para establecer el estado de visibilidad del control WebBrowser.
void SetVisible(BOOL bNewValue);
Parámetros
bNewValue
El valor devuelto será distinto de cero si el control es visible; de lo contrario, será cero.
Comentarios
Se aplica a Internet Explorer y WebBrowser.
CHtmlView::SetWidth
Establece el ancho de la ventana principal de Internet Explorer.
void SetWidth(long nNewValue);
Parámetros
nNewValue
El valor de este parámetro se corresponde con el ancho, en píxeles, de la ventana principal de Internet Explorer.
CHtmlView::Stop
Llame a esta función miembro para hacer que se cancele cualquiera de las operaciones de navegación o descarga que estén pendientes y que se detengan los elementos de página dinámicos, como sonidos de fondo y animaciones.
void Stop();
Comentarios
Se aplica a Internet Explorer y WebBrowser.
Consulte también
Ejemplo de MFCMFCIE
Clase CFormView
Gráfico de jerarquías
IWebBrowser2