Clase CDHtmlDialog

  • Artículo

Se utiliza para crear cuadros de diálogo que utilizan HTML en lugar de recursos de cuadro de diálogo para implementar la interfaz de usuario.

Sintaxis

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

Miembros

Constructores públicos

Nombre Descripción
CDHtmlDialog::CDHtmlDialog Construye un objeto CDHtmlDialog.
CDHtmlDialog::~CDHtmlDialog Destruye un objeto CDHtmlDialog.

Métodos públicos

Nombre Descripción
CDHtmlDialog::CanAccessExternal Se puede invalidar que se llama como una comprobación de acceso para ver si los objetos de scripting en la página cargada pueden acceder al envío externo del sitio de control. Comprueba que el envío sea seguro para el scripting o la zona actual permite objetos que no son seguros para el scripting.
CDHtmlDialog::CreateControlSite El marco dibuja este invalidable utilizado para crear una instancia de sitio de control para alojar el control WebBrowser en la categoría de diálogo.
CDHtmlDialog::DDX_DHtml_AxControl Intercambia datos entre una variable miembro y el valor de propiedad de un control ActiveX en una página HTML.
CDHtmlDialog::DDX_DHtml_CheckBox Intercambia datos entre una variable miembro y una casilla en una página HTML.
CDHtmlDialog::DDX_DHtml_ElementText Intercambia datos entre una variable miembro y cualquier propiedad de elemento HTML en una página HTML.
CDHtmlDialog::DDX_DHtml_Radio Intercambia datos entre una variable miembro y un botón de radio en una página HTML.
CDHtmlDialog::DDX_DHtml_SelectIndex Obtiene o establece el índice de un cuadro de lista en una página HTML.
CDHtmlDialog::DDX_DHtml_SelectString Obtiene o establece el texto para mostrar de una entrada de cuadro de lista (basado en el índice actual) en una página HTML.
CDHtmlDialog::DDX_DHtml_SelectValue Obtiene o establece el valor de una entrada de cuadro de lista (basada en el índice actual) en una página HTML.
CDHtmlDialog::DestroyModeless Destruye un cuadro de diálogo no modal.
CDHtmlDialog::EnableModeless Habilita cuadros de diálogo no modales.
CDHtmlDialog::FilterDataObject Permite que el cuadro de diálogo filtre los objetos de datos del Portapapeles creados por el explorador hospedado.
CDHtmlDialog::GetControlDispatch Recupera la interfaz IDispatch en un control ActiveX incrustado en el documento HTML.
CDHtmlDialog::GetControlProperty Recupera la propiedad solicitada del control ActiveX especificado.
CDHtmlDialog::GetCurrentUrl Recupera el localizador uniforme de recursos (URL) asociado al documento actual.
CDHtmlDialog::GetDHtmlDocument Recupera la interfaz IHTMLDocument2 en el documento HTML cargado actualmente.
CDHtmlDialog::GetDropTarget Llamado por el control WebBrowser contenido cuando se usa como destino de colocación para permitir que el cuadro de diálogo proporcione una alternativa IDropTarget.
CDHtmlDialog::GetElement Obtiene una interfaz en un elemento HTML.
CDHtmlDialog::GetElementHtml Recupera la propiedad innerHTML de un elemento HTML.
CDHtmlDialog::GetElementInterface Recupera el puntero de interfaz solicitado de un elemento HTML.
CDHtmlDialog::GetElementProperty Recupera el valor de la propiedad de un elemento HTML.
CDHtmlDialog::GetElementText Recupera la propiedad innerText de un elemento HTML.
CDHtmlDialog::GetEvent Obtiene el puntero IHTMLEventObj al objeto de evento actual.
CDHtmlDialog::GetExternal Obtiene la interfaz del host IDispatch.
CDHtmlDialog::GetHostInfo Recupera las funcionalidades de la interfaz de usuario del host.
CDHtmlDialog::GetOptionKeyPath Recupera la clave del Registro en la que se almacenan las preferencias del usuario.
CDHtmlDialog::HideUI Oculta la interfaz de usuario del host.
CDHtmlDialog::IsExternalDispatchSafe Indica si la interfaz del host IDispatch es segura para el scripting.
CDHtmlDialog::LoadFromResource Carga el recurso especificado en el control WebBrowser.
CDHtmlDialog::Navigate Navega a la URL especificada.
CDHtmlDialog::OnBeforeNavigate Lo llama el marco antes de que se desencadene un evento de navegación.
CDHtmlDialog::OnDocumentComplete Llamado por el framework para notificar a una aplicación cuando un documento ha alcanzado el estado READYSTATE_COMPLETE.
CDHtmlDialog::OnDocWindowActivate Llamado por el framework cuando se activa o desactiva la ventana del documento.
CDHtmlDialog::OnFrameWindowActivate El marco la llama cuando la ventana del marco está activado o desactivado.
CDHtmlDialog::OnInitDialog Se llama en respuesta al mensaje WM_INITDIALOG.
CDHtmlDialog::OnNavigateComplete Lo llama el marco una vez completado un evento de navegación.
CDHtmlDialog::ResizeBorder Alerta al objeto que necesita para cambiar el tamaño de su espacio de borde.
CDHtmlDialog::SetControlProperty Establece la propiedad de un control ActiveX en un nuevo valor.
CDHtmlDialog::SetElementHtml Establece la propiedad innerHTML de un elemento HTML.
CDHtmlDialog::SetElementProperty Establece una propiedad de un elemento HTML.
CDHtmlDialog::SetElementText Establece la propiedad innerText de un elemento HTML.
CDHtmlDialog::SetExternalDispatch Establece la interfaz del host IDispatch.
CDHtmlDialog::SetHostFlags Establece las marcas de interfaz de usuario del host.
CDHtmlDialog::ShowContextMenu Se llama cuando se va a mostrar un menú contextual.
CDHtmlDialog::ShowUI Muestra la interfaz de usuario del host.
CDHtmlDialog::TranslateAccelerator Se llama a para procesar los mensajes de tecla de aceleración del menú.
CDHtmlDialog::TranslateUrl Se llama para modificar la dirección URL que se va a cargar.
CDHtmlDialog::UpdateUI Se llama para notificar al host que cambió el estado del comando.

Miembros de datos públicos

Nombre Descripción
CDHtmlDialog::m_bUseHtmlTitle Indica si se debe usar el subtítulo del documento HTML como título del cuadro de diálogo.
CDHtmlDialog::m_nHtmlResID Identificador de recurso del recurso HTML que se va a mostrar.
CDHtmlDialog::m_pBrowserApp Un puntero a una aplicación de explorador web.
CDHtmlDialog::m_spHtmlDoc Un puntero a un documento HTML.
CDHtmlDialog::m_strCurrentUrl La URL actual.
CDHtmlDialog::m_szHtmlResID Versión de cadena del identificador de recurso HTML.

Comentarios

CDHtmlDialog puede cargar el código HTML que se va a mostrar desde un recurso HTML o una dirección URL.

CDHtmlDialog también puede realizar el intercambio de datos con controles HTML y controlar eventos de controles HTML, como clics de botón.

Jerarquía de herencia

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

Requisitos

Encabezadoafxdhtml.h:

DDX_DHtmlMacros de asistente

Las macros auxiliares de DDX_DHtml permiten un acceso sencillo a las propiedades de controles que se usan habitualmente en una página HTML.

Macros de intercambio de datos

Nombre Descripción
DDX_DHtml_ElementValue Establece o recupera la propiedad Value del control seleccionado.
DDX_DHtml_ElementInnerText Establece o recupera el texto entre las etiquetas inicial y final del elemento actual.
DDX_DHtml_ElementInnerHtml Establece o recupera el CÓDIGO HTML entre las etiquetas inicial y final del elemento actual.
DDX_DHtml_Anchor_Href Establece o recupera la dirección URL de destino o el punto de anclaje.
DDX_DHtml_Anchor_Target Establece o recupera la ventana o marco de destino.
DDX_DHtml_Img_Src Establece o recupera el nombre de una imagen o un clip de vídeo en el documento.
DDX_DHtml_Frame_Src Establece o recupera la dirección URL del marco asociado.
DDX_DHtml_IFrame_Src Establece o recupera la dirección URL del marco asociado.

CDHtmlDialog::CanAccessExternal

Se puede invalidar que se llama como una comprobación de acceso para ver si los objetos de scripting en la página cargada pueden acceder al envío externo del sitio de control. Comprueba que el envío sea seguro para el scripting o la zona actual permite objetos que no son seguros para el scripting.

virtual BOOL CanAccessExternal();

Valor devuelto

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.

CDHtmlDialog::CDHtmlDialog

Construye un cuadro de diálogo HTML dinámico basado en recursos.

CDHtmlDialog();

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

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

Parámetros

lpszTemplateName
Cadena terminada en null que es el nombre de un recurso de plantilla de cuadro de diálogo.

szHtmlResID
Cadena terminada en null que es el nombre de un recurso HTML.

pParentWnd
Puntero al objeto de ventana primaria o propietaria (de tipo CWnd) al que pertenece el objeto de diálogo. Si es NULL, la ventana primaria del objeto de cuadro de diálogo se establece en la ventana principal de la aplicación.

nIDTemplate
Contiene el número de identificador de un recurso de plantilla de cuadro de diálogo.

nHtmlResID
Contiene el número de identificador de un recurso HTML.

Comentarios

La segunda forma del constructor proporciona acceso al recurso de diálogo a través del nombre de la plantilla. La tercera forma del constructor proporciona acceso al recurso de diálogo mediante el identificador de la plantilla de recursos. Normalmente, el identificador comienza con el prefijo IDD_.

CDHtmlDialog::~CDHtmlDialog

Destruye un objeto CDHtmlDialog .

virtual ~CDHtmlDialog();

Comentarios

La CWnd::DestroyWindow función miembro debe usarse para destruir cuadros de diálogo sin modelo creados por CDialog::Create.

CDHtmlDialog::CreateControlSite

El marco dibuja este invalidable utilizado para crear una instancia de sitio de control para alojar el control WebBrowser en la categoría de diálogo.

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

Parámetros

pContainer
Un puntero al objeto COleControlContainer.

ppSite
Un puntero a un puntero a la fila COleControlSite.

Valor devuelto

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.

Comentarios

Puede invalidar esta función miembro de manera que se devuelva una instancia de la clase de sitio de control que proporcione.

CDHtmlDialog::DDX_DHtml_AxControl

Intercambia datos entre una variable miembro y el valor de propiedad de un control ActiveX en una página HTML.

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    VARIANT& var);

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    LPCTSTR szPropName,
    VARIANT& var);

Parámetros

pDX
Puntero a un objeto CDataExchange .

szId
Valor del parámetro ID de la etiqueta de objeto en el origen HTML del control ActiveX.

dispId
Identificador de envío de la propiedad con la que desea intercambiar datos.

szPropName
El nombre de la propiedad.

var
Miembro de datos, de tipo VARIANT, COleVarianto CComVariant, que contiene el valor intercambiado con la propiedad de control ActiveX.

Ejemplo

// COleVariant m_varSliderValue;
DDX_DHtml_AxControl(pDX, _T("slider1"), 0x0b /* Value */, m_varSliderValue);

CDHtmlDialog::DDX_DHtml_CheckBox

Intercambia datos entre una variable miembro y una casilla en una página HTML.

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

Parámetros

pDX
Puntero a un objeto CDataExchange .

szId
Valor que especificó para el parámetro ID del control HTML.

value
Valor que se va a intercambiar.

Ejemplo

// int m_nItalic;
DDX_DHtml_CheckBox(pDX, L"italic", m_nItalic);

CDHtmlDialog::DDX_DHtml_ElementText

Intercambia datos entre una variable miembro y cualquier propiedad de elemento HTML en una página HTML.

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    CString& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    short& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    int& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    long& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    DWORD& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    float& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    double& value);

Parámetros

pDX
Puntero a un objeto CDataExchange .

szId
Valor que especificó para el parámetro ID del control HTML.

dispId
El ID de envío del elemento HTML con el que se desea intercambiar datos.

value
Valor que se va a intercambiar.

CDHtmlDialog::DDX_DHtml_Radio

Intercambia datos entre una variable miembro y un botón de radio en una página HTML.

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

Parámetros

pDX
Puntero a un objeto CDataExchange .

szId
Valor que especificó para el parámetro ID del control HTML.

value
Valor que se va a intercambiar.

CDHtmlDialog::DDX_DHtml_SelectIndex

Obtiene o establece el índice de un cuadro de lista en una página HTML.

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

Parámetros

pDX
Puntero a un objeto CDataExchange .

szId
El valor especificado para el parámetro del control HTML id.

value
Valor que se va a intercambiar.

CDHtmlDialog::DDX_DHtml_SelectString

Obtiene o establece el texto para mostrar de una entrada de cuadro de lista (basado en el índice actual) en una página HTML.

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

Parámetros

pDX
Puntero a un objeto CDataExchange .

szId
Valor que especificó para el parámetro ID del control HTML.

value
Valor que se va a intercambiar.

CDHtmlDialog::DDX_DHtml_SelectValue

Obtiene o establece el valor de una entrada de cuadro de lista (basada en el índice actual) en una página HTML.

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

Parámetros

pDX
Puntero a un objeto CDataExchange .

szId
Valor que especificó para el parámetro ID del control HTML.

value
Valor que se va a intercambiar.

Ejemplo

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

CDHtmlDialog::DestroyModeless

Desasocia un cuadro de diálogo modela del CDHtmlDialog objeto y destruye el objeto.

void DestroyModeless();

CDHtmlDialog::EnableModeless

Habilita cuadros de diálogo no modales.

STDMETHOD(EnableModeless)(BOOL fEnable);

Parámetros

fEnable
Consulte fEnable en IDocHostUIHandler::EnableModeless de Windows SDK.

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::EnableModeless, como se describe en Windows SDK.

CDHtmlDialog::FilterDataObject

Permite que el cuadro de diálogo filtre los objetos de datos del Portapapeles creados por el explorador hospedado.

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

Parámetros

pDO
Consulte pDO en IDocHostUIHandler::FilterDataObject de Windows SDK.

ppDORet
Consulte ppDORet en IDocHostUIHandler::FilterDataObject de Windows SDK.

Valor devuelto

Devuelve S_FALSE.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::FilterDataObject, como se describe en Windows SDK.

CDHtmlDialog::GetControlDispatch

Recupera la interfaz IDispatch en un control ActiveX incrustado en el documento HTML devuelto por GetDHtmlDocument.

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

Parámetros

szId
Identificador HTML de un control ActiveX.

ppdisp
Interfaz IDispatch del control si se encuentra en la página web.

Valor devuelto

Un valor HRESULT estándar.

CDHtmlDialog::GetControlProperty

Recupera la propiedad solicitada del control ActiveX especificado.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

Parámetros

szId
Identificador HTML de un control ActiveX.

szPropName
Nombre de una propiedad en la configuración regional predeterminada del usuario actual.

pdispControl
Un puntero IDispatch de un control ActiveX.

dispId
Identificador de envío de una propiedad.

Valor devuelto

Variante que contiene la propiedad solicitada o una variante vacía si no se encontró el control o la propiedad.

Comentarios

Las sobrecargas se muestran de menos eficiente en la parte superior a la más eficaz en la parte inferior.

CDHtmlDialog::GetCurrentUrl

Recupera el localizador uniforme de recursos (URL) asociado al documento actual.

void GetCurrentUrl(CString& szUrl);

Parámetros

szUrl
Un objeto CString que contiene la dirección URL que se va a recuperar.

CDHtmlDialog::GetDHtmlDocument

Recupera la interfaz IHTMLDocument2 en el documento HTML cargado actualmente.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

Parámetros

**pphtmlDoc Un puntero a un puntero a un documento HTML.

Valor devuelto

Un HRESULT estándar. Si la operación se realiza correctamente, devuelve S_OK.

CDHtmlDialog::GetDropTarget

Llamado por el control WebBrowser contenido cuando se usa como destino de colocación para permitir que el cuadro de diálogo proporcione una alternativa IDropTarget.

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

Parámetros

pDropTarget
Consulte pDropTarget en IDocHostUIHandler::GetDropTarget de Windows SDK.

ppDropTarget
Consulte ppDropTarget en IDocHostUIHandler::GetDropTarget de Windows SDK.

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::GetDropTarget, como se describe en Windows SDK.

CDHtmlDialog::GetElement

Devuelve una interfaz en el elemento HTML especificado por szElementId.

HRESULT GetElement(
    LPCTSTR szElementId,
    IDispatch** ppdisp,
    BOOL* pbCollection = NULL);

HRESULT GetElement(
    LPCTSTR szElementId,
    IHTMLElement** pphtmlElement);

Parámetros

szElementId
El identificador del elemento HTML.

ppdisp
Un puntero IDispatch al elemento o colección solicitados de elementos.

pbCollection
Un BOOL indica si el objeto representado por ppdisp es un único elemento o una colección de elementos.

pphtmlElement
Un puntero IHTMLElement al elemento solicitado.

Valor devuelto

Un valor HRESULT estándar.

Comentarios

Usa la primera sobrecarga si necesitas controlar las condiciones en las que puede haber más de un elemento con el identificador especificado. Puedes usar el último parámetro para averiguar si el puntero de interfaz devuelto es a una colección o a un solo elemento. Si el puntero de interfaz está en una colección, puede consultar IHTMLElementCollection y usar su propiedad item para hacer referencia a los elementos por posición ordinal.

Se producirá un error en la segunda sobrecarga si hay más de un elemento con el mismo identificador en la página.

CDHtmlDialog::GetElementHtml

Recupera la propiedad innerHTML del elemento HTML identificado por szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

Parámetros

szElementId
El identificador del elemento HTML.

Valor devuelto

La propiedad innerHTML del elemento HTML identificado por szElementId o NULL si no se pudo encontrar el elemento.

CDHtmlDialog::GetElementInterface

Recupera el puntero de interfaz solicitado del elemento HTML identificado por szElementId.

template <class Q> HRESULT GetElementInterface(
    LPCTSTR szElementId,
    Q** ppvObj);

HRESULT GetElementInterface(
    LPCTSTR szElementId,
    REFIID refiid,
    void** ppvObj);

Parámetros

szElementId
El identificador del elemento HTML.

ppvObj
Dirección de un puntero que se rellenará con el puntero de interfaz solicitado si se encuentra el elemento y la consulta se realiza correctamente.

refiid
Identificador de interfaz (IID) de la interfaz solicitada.

Valor devuelto

Un valor HRESULT estándar.

Ejemplo

CComPtr<IHTMLInputButtonElement> spBtn1;
CComPtr<IHTMLInputButtonElement> spBtn2;
HRESULT hr = S_OK;

// Use the template overload
hr = GetElementInterface(L"Button1", &spBtn1);

// Use the nontemplate overload
hr = GetElementInterface(L"Button1", IID_IHTMLInputButtonElement,
                         reinterpret_cast<void **>(&spBtn2));

CDHtmlDialog::GetElementProperty

Recupera el valor de la propiedad identificada por dispId del elemento HTML identificado por szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

Parámetros

szElementId
El identificador del elemento HTML.

dispId
Identificador de envío de una propiedad.

Valor devuelto

Valor de la propiedad o una variante vacía si no se encontró la propiedad o el elemento.

CDHtmlDialog::GetElementText

Recupera la propiedad innerText del elemento HTML identificado por szElementId.

BSTR GetElementText(LPCTSTR szElementId);

Parámetros

szElementId
El identificador del elemento HTML.

Valor devuelto

La propiedad innerText del elemento HTML identificado por szElementId o NULL si la propiedad o elemento no se han podido encontrar.

CDHtmlDialog::GetEvent

Devuelve el puntero IHTMLEventObj al objeto de evento actual.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

Parámetros

ppEventObj
Dirección de un puntero que se rellenará con el puntero de interfaz IHTMLEventObj.

Valor devuelto

Un valor HRESULT estándar.

Comentarios

Solo se debe llamar a esta función desde dentro de un controlador de eventos DHTML.

CDHtmlDialog::GetExternal

Obtiene la interfaz del host IDispatch.

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

Parámetros

ppDispatch
Consulte ppDispatch en IDocHostUIHandler::GetExternal de Windows SDK.

Valor devuelto

Devuelve S_OK si la operación se realiza correctamente; de lo contrario, devuelve E_NOTIMPL.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::GetExternal, como se describe en Windows SDK.

CDHtmlDialog::GetHostInfo

Recupera las funcionalidades de la interfaz de usuario del host.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

Parámetros

pInfo
Consulte pInfo en IDocHostUIHandler::GetHostInfo de Windows SDK.

Valor devuelto

Devuelve S_OK.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::GetHostInfo, como se describe en Windows SDK.

CDHtmlDialog::GetOptionKeyPath

Recupera la clave del Registro en la que se almacenan las preferencias del usuario.

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

Parámetros

pchKey
Consulte pchKey en IDocHostUIHandler::GetOptionKeyPath de Windows SDK.

dw
Consulte dw en IDocHostUIHandler::GetOptionKeyPath de Windows SDK.

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::GetOptionKeyPath, como se describe en Windows SDK.

CDHtmlDialog::HideUI

Oculta la interfaz de usuario del host.

STDMETHOD(HideUI)(void);

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::HideUI, como se describe en Windows SDK.

CDHtmlDialog::IsExternalDispatchSafe

Indica si la interfaz del host IDispatch es segura para el scripting.

virtual BOOL IsExternalDispatchSafe();

Valor devuelto

Devuelve FALSE.

CDHtmlDialog::LoadFromResource

Carga el recurso especificado en el control WebBrowser en el diálogo DHTML.

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
Id. del recurso que se va a cargar.

Valor devuelto

TRUE si es correcto; de lo contrario, FALSE.

CDHtmlDialog::m_bUseHtmlTitle

Indica si se debe usar el subtítulo del documento HTML como título del cuadro de diálogo.

BOOL m_bUseHtmlTitle;

Comentarios

Si m_bUseHtmlTitle es TRUE, el subtítulo del cuadro de diálogo se establece igual al título del documento HTML; de lo contrario, se usa el subtítulo del recurso de diálogo.

CDHtmlDialog::m_nHtmlResID

Identificador de recurso del recurso HTML que se va a mostrar.

UINT m_nHtmlResID;

Ejemplo

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

CDHtmlDialog::m_pBrowserApp

Un puntero a una aplicación de explorador web.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

Un puntero a un documento HTML.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

La URL actual.

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

Versión de cadena del identificador de recurso HTML.

LPTSTR m_szHtmlResID;

Ejemplo

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

Navega hasta el recurso identificado por la dirección URL especificada por lpszURL.

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

Parámetros

lpszURL
Un puntero a una cadena que contiene la URL a la que se apunta.

dwFlags
Las marcas de una variable que especifica si se añade el recurso a la lista del historial, si se lee a la caché o se escribe desde la caché, y si se muestra el recurso 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 información 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 ignora si la 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 ignora si la 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 URL no es una URL HTTP.

CDHtmlDialog::OnBeforeNavigate

Lo llama el marco para hacer que se active un evento antes de que se produzca una navegación.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parámetros

pDisp
Puntero a un objeto IDispatch .

szUrl
Un puntero que apunta a una cadena donde se almacena la URL hasta la que debe navegarse.

CDHtmlDialog::OnDocumentComplete

Llamado por el marco para notificar a una aplicación cuando un documento ha alcanzado el estado READYSTATE_COMPLETE.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parámetros

pDisp
Puntero a un objeto IDispatch .

szUrl
Un puntero a una cadena que contiene la dirección URL a la que se ha navegado.

CDHtmlDialog::OnDocWindowActivate

Llamado por el framework cuando se activa o desactiva la ventana del documento.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

Parámetros

fActivate
Consulte fActivate en IDocHostUIHandler::OnDocWindowActivate de Windows SDK.

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::OnDocWindowActivate, como se describe en Windows SDK.

CDHtmlDialog::OnFrameWindowActivate

El marco la llama cuando la ventana del marco está activado o desactivado.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

Parámetros

fActivate
Consulte fActivate en IDocHostUIHandler::OnFrameWindowActivate de Windows SDK.

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::OnFrameWindowActivate, como se describe en Windows SDK.

CDHtmlDialog::OnInitDialog

Se llama en respuesta al mensaje WM_INITDIALOG.

virtual BOOL OnInitDialog();

Valor devuelto

La implementación predeterminada devuelve TRUE.

Comentarios

Este mensaje se envía al cuadro de diálogo durante las llamadas a Create, CreateIndirecto DoModal, que se producen inmediatamente antes de que se muestre el cuadro de diálogo.

Invalide esta función miembro si necesita realizar un procesamiento especial cuando se inicializa el cuadro de diálogo. En la versión invalidada, primero llama a la clase base OnInitDialog, pero ignora su valor devuelto. Normalmente, devolverá TRUE de la función miembro reemplazada.

Windows llama a la OnInitDialog función a través del procedimiento de cuadro de diálogo global estándar común a todos los cuadros de diálogo de la Biblioteca de clases de Microsoft Foundation, en lugar de a través del mapa de mensajes, por lo que no necesitas una entrada de mapa de mensajes para esta función miembro.

CDHtmlDialog::OnNavigateComplete

Lo llama el marco una vez completada la navegación a la dirección URL especificada.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

Parámetros

pDisp
Puntero a un objeto IDispatch .

szUrl
Un puntero a una cadena que contiene la dirección URL a la que se ha navegado.

CDHtmlDialog::ResizeBorder

Alerta al objeto que necesita para cambiar el tamaño de su espacio de borde.

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

Parámetros

prcBorder
Consulte prcBorder en IDocHostUIHandler::ResizeBorder de Windows SDK.

pUIWindow
Consulte pUIWindow en IDocHostUIHandler::ResizeBorder de Windows SDK.

fFrameWindow
Consulte fFrameWindow en IDocHostUIHandler::ResizeBorder de Windows SDK.

Valor devuelto

Devuelve E_NOTIMPL.

CDHtmlDialog::SetControlProperty

Establece la propiedad de un control ActiveX en un nuevo valor.

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

void SetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    LPCTSTR szElementId,
    LPCTSTR szPropName,
    VARIANT* pVar);

Parámetros

szElementId
Identificador HTML de un control ActiveX.

dispId
[in] El identificador de envío de la propiedad a establecer.

pVar
Puntero en un tipo VARIANT que contiene el nuevo valor de propiedad.

pdispControl
Puntero a la interfaz de IDispatch un control ActiveX.

szPropName
Cadena que contiene el nombre de la propiedad que se va a establecer.

CDHtmlDialog::SetElementHtml

Establece la propiedad innerHTML de un elemento HTML.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

Parámetros

szElementId
El identificador del elemento HTML.

bstrText
Nuevo valor de la propiedad innerHTML.

punkElem
El puntero IUnknown de un elemento HTML.

CDHtmlDialog::SetElementProperty

Establece una propiedad de un elemento HTML.

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

Parámetros

szElementId
El identificador del elemento HTML.

dispId
[in] El identificador de envío de la propiedad a establecer.

pVar
Valor nuevo de la propiedad.

CDHtmlDialog::SetElementText

Establece la propiedad innerText de un elemento HTML.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

Parámetros

szElementId
El identificador del elemento HTML.

bstrText
Nuevo valor de la propiedad innerText.

punkElem
El puntero IUnknown de un elemento HTML.

CDHtmlDialog::SetExternalDispatch

Establece la interfaz del host IDispatch.

void SetExternalDispatch(IDispatch* pdispExternal);

Parámetros

pdispExternal
La nueva interfaz IDispatch.

CDHtmlDialog::SetHostFlags

Establece las marcas de interfaz de usuario del host.

void SetHostFlags(DWORD dwFlags);

Parámetros

dwFlags
Para conocer los valores posibles, consulta DOCHOSTUIFLAG en Windows SDK.

CDHtmlDialog::ShowContextMenu

Se llama cuando se va a mostrar un menú contextual.

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

Parámetros

dwID
Consulte dwID en IDocHostUIHandler::ShowContextMenu de Windows SDK.

ppt
Consulte ppt en IDocHostUIHandler::ShowContextMenu de Windows SDK.

pcmdtReserved
Consulte pcmdtReserved en IDocHostUIHandler::ShowContextMenu de Windows SDK.

pdispReserved
Consulte pdispReserved en IDocHostUIHandler::ShowContextMenu de Windows SDK.

Valor devuelto

Devuelve S_FALSE.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::ShowContextMenu, como se describe en Windows SDK.

CDHtmlDialog::ShowUI

Muestra la interfaz de usuario del host.

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

Parámetros

dwID
Consulte dwID en IDocHostUIHandler::ShowUI de Windows SDK.

pActiveObject
Consulte pActiveObject en IDocHostUIHandler::ShowUI de Windows SDK.

pCommandTarget
Consulte pCommandTarget en IDocHostUIHandler::ShowUI de Windows SDK.

pFrame
Consulte pFrame en IDocHostUIHandler::ShowUI de Windows SDK.

pDoc
Consulte pDoc en IDocHostUIHandler::ShowUI de Windows SDK.

Valor devuelto

Devuelve S_FALSE.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::ShowUI, como se describe en Windows SDK.

CDHtmlDialog::TranslateAccelerator

Se llama a para procesar los mensajes de tecla de aceleración del menú.

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

Parámetros

lpMsg
Consulte lpMsg en IDocHostUIHandler::TranslateAccelerator de Windows SDK.

pguidCmdGroup
Consulte pguidCmdGroup en IDocHostUIHandler::TranslateAccelerator de Windows SDK.

nCmdID
Consulte nCmdID en IDocHostUIHandler::TranslateAccelerator de Windows SDK.

Valor devuelto

Devuelve S_FALSE.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::TranslateAccelerator, como se describe en Windows SDK.

CDHtmlDialog::TranslateUrl

Se llama para modificar la dirección URL que se va a cargar.

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

Parámetros

dwTranslate
Consulte dwTranslate en IDocHostUIHandler::TranslateUrl de Windows SDK.

pchURLIn
Consulte pchURLIn en IDocHostUIHandler::TranslateUrl de Windows SDK.

ppchURLOut
Consulte ppchURLOut en IDocHostUIHandler::TranslateUrl de Windows SDK.

Valor devuelto

Devuelve S_FALSE.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::TranslateUrl, como se describe en Windows SDK.

CDHtmlDialog::UpdateUI

Se llama para notificar al host que cambió el estado del comando.

STDMETHOD(UpdateUI)(void);

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Esta función miembro es la CDHtmlDialog implementación de IDocHostUIHandler::UpdateUI, como se describe en Windows SDK.

Consulte también

Ejemplo de MFCDHtmlExplore
DDX_DHtmlMacros de asistente
Gráfico de jerarquías