CDHtmlDialog (clase)CDHtmlDialog Class

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.Is used to create dialog boxes that use HTML rather than dialog resources to implement their user interface.

SintaxisSyntax

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

MiembrosMembers

Constructores públicosPublic Constructors

NOMBREName DescripciónDescription
CDHtmlDialog:: CDHtmlDialogCDHtmlDialog::CDHtmlDialog Construye un objeto CDHtmlDialog.Constructs a CDHtmlDialog object.
CDHtmlDialog:: ~ CDHtmlDialogCDHtmlDialog::~CDHtmlDialog Destruye un objeto CDHtmlDialog.Destroys a CDHtmlDialog object.

Métodos públicosPublic Methods

NOMBREName DescripciónDescription
CDHtmlDialog:: CanAccessExternalCDHtmlDialog::CanAccessExternal Reemplazable al que se llama como una comprobación de acceso para ver si los objetos de scripting de la página cargada pueden tener acceso al envío externo del sitio de control.Overridable that is called as an access check to see whether scripting objects on the loaded page can access the external dispatch of the control site. Comprueba que el envío sea seguro para el scripting o que la zona actual permita objetos que no son seguros para el scripting.Checks to make sure the dispatch is either safe for scripting or the current zone allows for objects that are not safe for scripting.
CDHtmlDialog:: CreateControlSiteCDHtmlDialog::CreateControlSite Reemplazable usado para crear una instancia del sitio de control para hospedar el control WebBrowser en el cuadro de diálogo.Overridable used to create a control site instance to host the WebBrowser control on the dialog.
CDHtmlDialog::D DX_DHtml_AxControlCDHtmlDialog::DDX_DHtml_AxControl Intercambia datos entre una variable miembro y el valor de propiedad de un control ActiveX en una página HTML.Exchanges data between a member variable and the property value of an ActiveX control on an HTML page.
CDHtmlDialog::D DX_DHtml_CheckBoxCDHtmlDialog::DDX_DHtml_CheckBox Intercambia datos entre una variable miembro y una casilla en una página HTML.Exchanges data between a member variable and a check box on an HTML page.
CDHtmlDialog::D DX_DHtml_ElementTextCDHtmlDialog::DDX_DHtml_ElementText Intercambia datos entre una variable miembro y cualquier propiedad de elemento HTML en una página HTML.Exchanges data between a member variable and any HTML element property on an HTML page.
CDHtmlDialog::D DX_DHtml_RadioCDHtmlDialog::DDX_DHtml_Radio Intercambia datos entre una variable miembro y un botón de radio de una página HTML.Exchanges data between a member variable and a radio button on an HTML page.
CDHtmlDialog::D DX_DHtml_SelectIndexCDHtmlDialog::DDX_DHtml_SelectIndex Obtiene o establece el índice de un cuadro de lista en una página HTML.Gets or sets the index of a list box on an HTML page.
CDHtmlDialog::D DX_DHtml_SelectStringCDHtmlDialog::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.Gets or sets the display text of a list box entry (based on the current index) on an HTML page.
CDHtmlDialog::D DX_DHtml_SelectValueCDHtmlDialog::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.Gets or sets the value of a list box entry (based on the current index) on an HTML page.
CDHtmlDialog::D estroyModelessCDHtmlDialog::DestroyModeless Destruye un cuadro de diálogo no modal.Destroys a modeless dialog box.
CDHtmlDialog:: EnableModelessCDHtmlDialog::EnableModeless Habilita los cuadros de diálogo no modales.Enables modeless dialog boxes.
CDHtmlDialog:: FilterDataObjectCDHtmlDialog::FilterDataObject Permite que el cuadro de diálogo filtre los objetos de datos del portapapeles creados por el explorador hospedado.Allows the dialog to filter clipboard data objects created by the hosted browser.
CDHtmlDialog:: GetControlDispatchCDHtmlDialog::GetControlDispatch Recupera la IDispatch interfaz en un control ActiveX incrustado en el documento HTML.Retrieves the IDispatch interface on an ActiveX control embedded in the HTML document.
CDHtmlDialog:: GetControlPropertyCDHtmlDialog::GetControlProperty Recupera la propiedad solicitada del control ActiveX especificado.Retrieves the requested property of the specified ActiveX control.
CDHtmlDialog:: GetCurrentUrlCDHtmlDialog::GetCurrentUrl Recupera el localizador uniforme de recursos (URL) asociado al documento actual.Retrieves the Uniform Resource Locator (URL) associated with the current document.
CDHtmlDialog:: GetDHtmlDocumentCDHtmlDialog::GetDHtmlDocument Recupera la interfaz IHTMLDocument2 en el documento HTML cargado actualmente.Retrieves the IHTMLDocument2 interface on the currently loaded HTML document.
CDHtmlDialog:: GetDropTargetCDHtmlDialog::GetDropTarget Lo llama el control WebBrowser incluido cuando se usa como destino de colocación para permitir que el cuadro de diálogo proporcione un IDropTargetalternativo.Called by the contained WebBrowser control when it is being used as a drop target to allow the dialog to supply an alternative IDropTarget.
CDHtmlDialog:: GetElementCDHtmlDialog::GetElement Obtiene una interfaz en un elemento HTML.Gets an interface on an HTML element.
CDHtmlDialog:: GetElementHtmlCDHtmlDialog::GetElementHtml Recupera la innerHTML propiedad de un elemento HTML.Retrieves the innerHTML property of an HTML element.
CDHtmlDialog:: GetElementInterfaceCDHtmlDialog::GetElementInterface Recupera el puntero de interfaz solicitado de un elemento HTML.Retrieves the requested interface pointer from an HTML element.
CDHtmlDialog:: GetElementPropertyCDHtmlDialog::GetElementProperty Recupera el valor de la propiedad de un elemento HTML.Retrieves the value of an HTML element's property.
CDHtmlDialog:: GetElementTextCDHtmlDialog::GetElementText Recupera la innerText propiedad de un elemento HTML.Retrieves the innerText property of an HTML element.
CDHtmlDialog:: GetEventCDHtmlDialog::GetEvent Obtiene el IHTMLEventObj puntero al objeto de evento actual.Gets the IHTMLEventObj pointer to the current event object.
CDHtmlDialog:: GetExternalCDHtmlDialog::GetExternal Obtiene la interfaz del host IDispatch .Gets the host's IDispatch interface.
CDHtmlDialog:: GetHostInfoCDHtmlDialog::GetHostInfo Recupera las capacidades de la interfaz de usuario del host.Retrieves the host's UI capabilities.
CDHtmlDialog:: GetOptionKeyPathCDHtmlDialog::GetOptionKeyPath Recupera la clave del registro en la que se almacenan las preferencias del usuario.Retrieves the registry key under which user preferences are stored.
CDHtmlDialog:: HideUICDHtmlDialog::HideUI Oculta la interfaz de usuario del host.Hides the host's UI.
CDHtmlDialog:: IsExternalDispatchSafeCDHtmlDialog::IsExternalDispatchSafe Indica si la interfaz del host IDispatch es segura para el scripting.Indicates whether the host's IDispatch interface is safe for scripting.
CDHtmlDialog:: LoadFromResourceCDHtmlDialog::LoadFromResource Carga el recurso especificado en el control WebBrowser.Loads the specified resource into the WebBrowser control.
CDHtmlDialog:: NavigateCDHtmlDialog::Navigate Navega hasta la dirección URL especificada.Navigates to the specified URL.
CDHtmlDialog:: OnBeforeNavigateCDHtmlDialog::OnBeforeNavigate Lo llama el marco de trabajo antes de que se desencadene un evento de navegación.Called by the framework before a navigation event is fired.
CDHtmlDialog:: OnDocumentCompleteCDHtmlDialog::OnDocumentComplete Lo llama el marco de trabajo para notificar a una aplicación cuando un documento ha alcanzado el estado READYSTATE_COMPLETE.Called by the framework to notify an application when a document has reached the READYSTATE_COMPLETE state.
CDHtmlDialog:: OnDocWindowActivateCDHtmlDialog::OnDocWindowActivate Lo llama el marco de trabajo cuando la ventana de documento está activada o desactivada.Called by the framework when the document window is activated or deactivated.
CDHtmlDialog:: OnFrameWindowActivateCDHtmlDialog::OnFrameWindowActivate Lo llama el marco de trabajo cuando la ventana de marco está activada o desactivada.Called by the framework when the frame window is activated or deactivated.
CDHtmlDialog:: OnInitDialogCDHtmlDialog::OnInitDialog Se llama en respuesta al mensaje de WM_INITDIALOG.Called in response to the WM_INITDIALOG message.
CDHtmlDialog:: OnNavigateCompleteCDHtmlDialog::OnNavigateComplete Lo llama el marco de trabajo una vez completado un evento de navegación.Called by the framework after a navigation event is completed.
CDHtmlDialog:: ResizeBorderCDHtmlDialog::ResizeBorder Alerta al objeto que necesita para cambiar el tamaño del espacio del borde.Alerts the object that it needs to resize its border space.
CDHtmlDialog:: SetControlPropertyCDHtmlDialog::SetControlProperty Establece la propiedad de un control ActiveX en un nuevo valor.Sets the property of an ActiveX control to a new value.
CDHtmlDialog:: SetElementHtmlCDHtmlDialog::SetElementHtml Establece la innerHTML propiedad de un elemento HTML.Sets the innerHTML property of an HTML element.
CDHtmlDialog:: SetElementPropertyCDHtmlDialog::SetElementProperty Establece una propiedad de un elemento HTML.Sets a property of an HTML element.
CDHtmlDialog:: SetElementTextCDHtmlDialog::SetElementText Establece la innerText propiedad de un elemento HTML.Sets the innerText property of an HTML element.
CDHtmlDialog:: SetExternalDispatchCDHtmlDialog::SetExternalDispatch Establece la interfaz del host IDispatch .Sets the host's IDispatch interface.
CDHtmlDialog:: SetHostFlagsCDHtmlDialog::SetHostFlags Establece las marcas de la interfaz de usuario del host.Sets the host's UI flags.
CDHtmlDialog:: ShowContextMenuCDHtmlDialog::ShowContextMenu Se le llama cuando un menú contextual está a punto de mostrarse.Called when a context menu is about to be displayed.
CDHtmlDialog:: ShowUICDHtmlDialog::ShowUI Muestra la interfaz de usuario del host.Shows the host's UI.
CDHtmlDialog:: TranslateAcceleratorCDHtmlDialog::TranslateAccelerator Se llama para procesar los mensajes de tecla de aceleración del menú.Called to process menu accelerator-key messages.
CDHtmlDialog:: TranslateUrlCDHtmlDialog::TranslateUrl Se llama para modificar la dirección URL que se va a cargar.Called to modify the URL to be loaded.
CDHtmlDialog:: UpdateUICDHtmlDialog::UpdateUI Se llama para notificar al host que el estado del comando ha cambiado.Called to notify the host that the command state has changed.

Miembros de datos públicosPublic Data Members

NombreName DescripciónDescription
CDHtmlDialog:: m_bUseHtmlTitleCDHtmlDialog::m_bUseHtmlTitle Indica si se va a usar el título del documento HTML como título del cuadro de diálogo.Indicates whether to use the HTML document's title as the dialog caption.
CDHtmlDialog:: m_nHtmlResIDCDHtmlDialog::m_nHtmlResID IDENTIFICADOR de recurso del recurso HTML que se va a mostrar.Resource ID of HTML resource to be displayed.
CDHtmlDialog:: m_pBrowserAppCDHtmlDialog::m_pBrowserApp Puntero a una aplicación de explorador Web.A pointer to a Web browser application.
CDHtmlDialog:: m_spHtmlDocCDHtmlDialog::m_spHtmlDoc Un puntero a un documento HTML.A pointer to an HTML document.
CDHtmlDialog:: m_strCurrentUrlCDHtmlDialog::m_strCurrentUrl La dirección URL actual.The current URL.
CDHtmlDialog:: m_szHtmlResIDCDHtmlDialog::m_szHtmlResID Versión de cadena del identificador de recurso HTML.String version of the HTML resource ID.

ObservacionesRemarks

CDHtmlDialog puede cargar el código HTML que se va a mostrar desde un recurso HTML o una dirección URL.CDHtmlDialog can load the HTML to be displayed from either an HTML resource or a URL.

CDHtmlDialog también puede realizar el intercambio de datos con controles HTML y controlar eventos de controles HTML, como clics en botones.CDHtmlDialog can also do data exchange with HTML controls and handle events from HTML controls, such as button clicks.

Jerarquía de herenciaInheritance Hierarchy

CObjectCObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTargetCCmdTarget

CDHtmlSinkHandler

CWndCWnd

CDHtmlEventSink

CDialogCDialog

CDHtmlDialog

RequisitosRequirements

Encabezado: afxdhtml. hHeader: afxdhtml.h

Macros auxiliares de DDX_DHtmlDDX_DHtml Helper Macros

Las macros auxiliares de DDX_DHtml permiten el acceso sencillo a las propiedades de los controles que se usan habitualmente en una página HTML.The DDX_DHtml helper macros allow easy access to the commonly used properties of controls on an HTML page.

Macros de intercambio de datosData Exchange Macros

NombreName DescripciónDescription
DDX_DHtml_ElementValueDDX_DHtml_ElementValue Establece o recupera la propiedad Value del control seleccionado.Sets or retrieves the Value property from the selected control.
DDX_DHtml_ElementInnerTextDDX_DHtml_ElementInnerText Establece o recupera el texto entre las etiquetas inicial y final del elemento actual.Sets or retrieves the text between the start and end tags of the current element.
DDX_DHtml_ElementInnerHtmlDDX_DHtml_ElementInnerHtml Establece o recupera el código HTML entre las etiquetas inicial y final del elemento actual.Sets or retrieves the HTML between the start and end tags of the current element.
DDX_DHtml_Anchor_HrefDDX_DHtml_Anchor_Href Establece o recupera la dirección URL de destino o el punto de anclaje.Sets or retrieves the destination URL or anchor point.
DDX_DHtml_Anchor_TargetDDX_DHtml_Anchor_Target Establece o recupera la ventana o el marco de destino.Sets or retrieves the target window or frame.
DDX_DHtml_Img_SrcDDX_DHtml_Img_Src Establece o recupera el nombre de una imagen o de un clip de vídeo en el documento.Sets or retrieves the name of an image or a video clip in the document.
DDX_DHtml_Frame_SrcDDX_DHtml_Frame_Src Establece o recupera la dirección URL del marco asociado.Sets or retrieves the URL of the associated frame.
DDX_DHtml_IFrame_SrcDDX_DHtml_IFrame_Src Establece o recupera la dirección URL del marco asociado.Sets or retrieves the URL of the associated frame.

CDHtmlDialog:: CanAccessExternalCDHtmlDialog::CanAccessExternal

Reemplazable al que se llama como una comprobación de acceso para ver si los objetos de scripting de la página cargada pueden tener acceso al envío externo del sitio de control.Overridable that is called as an access check to see whether scripting objects on the loaded page can access the external dispatch of the control site. Comprueba que el envío sea seguro para el scripting o que la zona actual permita objetos que no son seguros para el scripting.Checks to make sure the dispatch is either safe for scripting or the current zone allows for objects that are not safe for scripting.

virtual BOOL CanAccessExternal();

Valor devueltoReturn Value

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.Nonzero if successful; otherwise 0.

CDHtmlDialog:: CDHtmlDialogCDHtmlDialog::CDHtmlDialog

Crea un cuadro de diálogo HTML dinámico basado en recursos.Constructs a resource-based dynamic HTML dialog box.

CDHtmlDialog();

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

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

ParámetrosParameters

lpszTemplateNamelpszTemplateName
Cadena terminada en null que es el nombre de un recurso de plantilla de cuadro de diálogo.The null-terminated string that is the name of a dialog-box template resource.

szHtmlResIDszHtmlResID
Cadena terminada en null que es el nombre de un recurso HTML.The null-terminated string that is the name of an HTML resource.

pParentWndpParentWnd
Puntero al objeto de ventana primario o propietario (de tipo CWnd) al que pertenece el objeto de cuadro de diálogo.A pointer to the parent or owner window object (of type CWnd) to which the dialog object belongs. Si es NULL, la ventana primaria del objeto de cuadro de diálogo se establece en la ventana principal de la aplicación.If it is NULL, the dialog object's parent window is set to the main application window.

nIDTemplatenIDTemplate
Contiene el número de identificación de un recurso de plantilla de cuadro de diálogo.Contains the ID number of a dialog-box template resource.

nHtmlResIDnHtmlResID
Contiene el número de identificador de un recurso HTML.Contains the ID number of an HTML resource.

ObservacionesRemarks

La segunda forma del constructor proporciona acceso al recurso de cuadro de diálogo a través del nombre de la plantilla.The second form of the constructor provides access to the dialog resource through the template name. La tercera forma del constructor proporciona acceso al recurso de cuadro de diálogo a través del identificador de la plantilla de recursos.The third form of the constructor provides access to the dialog resource through the ID of the resource template. Normalmente, el identificador comienza con el prefijo IDD_ .Usually, the ID begins with the IDD_ prefix.

CDHtmlDialog:: ~ CDHtmlDialogCDHtmlDialog::~CDHtmlDialog

Destruye un objeto CDHtmlDialog.Destroys a CDHtmlDialog object.

virtual ~CDHtmlDialog();

ObservacionesRemarks

La función miembro CWnd::D estroywindow se debe usar para destruir los cuadros de diálogo no modales creados por CDialog:: Create.The CWnd::DestroyWindow member function must be used to destroy modeless dialog boxes that are created by CDialog::Create.

CDHtmlDialog:: CreateControlSiteCDHtmlDialog::CreateControlSite

Reemplazable usado para crear una instancia del sitio de control para hospedar el control WebBrowser en el cuadro de diálogo.Overridable used to create a control site instance to host the WebBrowser control on the dialog.

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

ParámetrosParameters

pContainerpContainer
Un puntero al objeto COleControlContainerA pointer to the COleControlContainer object

ppSiteppSite
Un puntero a un puntero a un COleControlSite.A pointer to a pointer to a COleControlSite.

Valor devueltoReturn Value

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.Nonzero if successful; otherwise 0.

ObservacionesRemarks

Puede invalidar esta función miembro para que devuelva una instancia de su propia clase de sitio de control.You can override this member function to return an instance of your own control site class.

CDHtmlDialog::D DX_DHtml_AxControlCDHtmlDialog::DDX_DHtml_AxControl

Intercambia datos entre una variable miembro y el valor de propiedad de un control ActiveX en una página HTML.Exchanges data between a member variable and the property value of an ActiveX control on an HTML page.

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ámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object.

szIdszId
Valor del parámetro de identificador de la etiqueta de objeto en el origen HTML del control ActiveX.The value of the object tag's ID parameter in the HTML source for the ActiveX control.

dispIddispId
El identificador de envío de la propiedad con la que desea intercambiar los datos.The dispatch ID of the property with which you want to exchange data.

szPropNameszPropName
Nombre de la propiedad.The name of the property.

varvar
El miembro de datos, de tipo VARIANT, COleVarianto CComVariant, que contiene el valor intercambiado con la propiedad de control ActiveX.The data member, of type VARIANT, COleVariant, or CComVariant, that holds the value exchanged with the ActiveX control property.

EjemploExample

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

CDHtmlDialog::D DX_DHtml_CheckBoxCDHtmlDialog::DDX_DHtml_CheckBox

Intercambia datos entre una variable miembro y una casilla en una página HTML.Exchanges data between a member variable and a check box on an HTML page.

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

ParámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object.

szIdszId
Valor especificado para el parámetro de identificador del control HTML.The value that you specified for the HTML control's ID parameter.

valuevalue
Valor que se va a intercambiar.The value being exchanged.

EjemploExample

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

CDHtmlDialog::D DX_DHtml_ElementTextCDHtmlDialog::DDX_DHtml_ElementText

Intercambia datos entre una variable miembro y cualquier propiedad de elemento HTML en una página HTML.Exchanges data between a member variable and any HTML element property on an HTML page.

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ámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object.

szIdszId
Valor especificado para el parámetro de identificador del control HTML.The value that you specified for the HTML control's ID parameter.

dispIddispId
El identificador de envío del elemento HTML con el que desea intercambiar datos.The dispatch ID of the HTML element with which you want to exchange data.

valuevalue
Valor que se va a intercambiar.The value being exchanged.

CDHtmlDialog::D DX_DHtml_RadioCDHtmlDialog::DDX_DHtml_Radio

Intercambia datos entre una variable miembro y un botón de radio de una página HTML.Exchanges data between a member variable and a radio button on an HTML page.

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

ParámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object.

szIdszId
Valor especificado para el parámetro de identificador del control HTML.The value that you specified for the HTML control's ID parameter.

valuevalue
Valor que se va a intercambiar.The value being exchanged.

CDHtmlDialog::D DX_DHtml_SelectIndexCDHtmlDialog::DDX_DHtml_SelectIndex

Obtiene o establece el índice de un cuadro de lista en una página HTML.Gets or sets the index of a list box on an HTML page.

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

ParámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object.

szIdszId
Valor especificado para el parámetro del control HTML id .The value that you specified for the HTML control's id parameter.

valuevalue
Valor que se va a intercambiar.The value being exchanged.

CDHtmlDialog::D DX_DHtml_SelectStringCDHtmlDialog::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.Gets or sets the display text of a list box entry (based on the current index) on an HTML page.

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

ParámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object.

szIdszId
Valor especificado para el parámetro de identificador del control HTML.The value that you specified for the HTML control's ID parameter.

valuevalue
Valor que se va a intercambiar.The value being exchanged.

CDHtmlDialog::D DX_DHtml_SelectValueCDHtmlDialog::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.Gets or sets the value of a list box entry (based on the current index) on an HTML page.

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

ParámetrosParameters

pDXpDX
Un puntero a un objeto CDataExchange ( .A pointer to a CDataExchange object.

szIdszId
Valor especificado para el parámetro de identificador del control HTML.The value that you specified for the HTML control's ID parameter.

valuevalue
Valor que se va a intercambiar.The value being exchanged.

EjemploExample

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

CDHtmlDialog::D estroyModelessCDHtmlDialog::DestroyModeless

Desasocia un cuadro de diálogo no modal del CDHtmlDialog objeto y destruye el objeto.Detaches a modeless dialog box from the CDHtmlDialog object and destroys the object.

void DestroyModeless();

CDHtmlDialog:: EnableModelessCDHtmlDialog::EnableModeless

Habilita los cuadros de diálogo no modales.Enables modeless dialog boxes.

STDMETHOD(EnableModeless)(BOOL fEnable);

ParámetrosParameters

fEnablefEnable
Vea fEnable en IDocHostUIHandler:: EnableModeless en el Windows SDK.See fEnable in IDocHostUIHandler::EnableModeless in the Windows SDK.

Valor devueltoReturn Value

Devuelve E_NOTIMPL.Returns E_NOTIMPL.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: EnableModeless, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::EnableModeless, as described in the Windows SDK.

CDHtmlDialog:: FilterDataObjectCDHtmlDialog::FilterDataObject

Permite que el cuadro de diálogo filtre los objetos de datos del portapapeles creados por el explorador hospedado.Allows the dialog to filter clipboard data objects created by the hosted browser.

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

ParámetrosParameters

ppDO
Consulte pDO in IDocHostUIHandler:: FilterDataObject en el Windows SDK.See pDO in IDocHostUIHandler::FilterDataObject in the Windows SDK.

ppDORetppDORet
Vea ppDORet en IDocHostUIHandler::FilterDataObject en el Windows SDK.See ppDORet in IDocHostUIHandler::FilterDataObject in the Windows SDK.

Valor devueltoReturn Value

Devuelve S_FALSE.Returns S_FALSE.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: FilterDataObject, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::FilterDataObject, as described in the Windows SDK.

CDHtmlDialog:: GetControlDispatchCDHtmlDialog::GetControlDispatch

Recupera la IDispatch interfaz en un control ActiveX incrustado en el documento HTML devuelto por GetDHtmlDocument.Retrieves the IDispatch interface on an ActiveX control embedded in the HTML document returned by GetDHtmlDocument.

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

ParámetrosParameters

szIdszId
IDENTIFICADOR HTML de un control ActiveX.The HTML ID of an ActiveX control.

ppdispppdisp
La IDispatch interfaz del control, si se encuentra en la Página Web.The IDispatch interface of the control if found in the Web page.

Valor devueltoReturn Value

Valor HRESULT estándar.A standard HRESULT value.

CDHtmlDialog:: GetControlPropertyCDHtmlDialog::GetControlProperty

Recupera la propiedad solicitada del control ActiveX especificado.Retrieves the requested property of the specified ActiveX control.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

ParámetrosParameters

szIdszId
IDENTIFICADOR HTML de un control ActiveX.The HTML ID of an ActiveX control.

szPropNameszPropName
Nombre de una propiedad de la configuración regional predeterminada del usuario actual.The name of a property in the default locale of the current user.

pdispControlpdispControl
IDispatchPuntero de un control ActiveX.The IDispatch pointer of an ActiveX control.

dispIddispId
El identificador de envío de una propiedad.The dispatch ID of a property.

Valor devueltoReturn Value

Variante que contiene la propiedad solicitada o una variante vacía si no se pudo encontrar el control o la propiedad.A variant containing the requested property or an empty variant if the control or property could not be found.

ObservacionesRemarks

Las sobrecargas se muestran desde la menos eficaz en la parte superior a la más eficaz en la parte inferior.The overloads are listed from least efficient at the top to most efficient at the bottom.

CDHtmlDialog:: GetCurrentUrlCDHtmlDialog::GetCurrentUrl

Recupera el localizador uniforme de recursos (URL) asociado al documento actual.Retrieves the Uniform Resource Locator (URL) associated with the current document.

void GetCurrentUrl(CString& szUrl);

ParámetrosParameters

szUrlszUrl
Objeto CString que contiene la dirección URL que se va a recuperar.A CString object containing the URL to retrieve.

CDHtmlDialog:: GetDHtmlDocumentCDHtmlDialog::GetDHtmlDocument

Recupera la interfaz IHTMLDocument2 en el documento HTML cargado actualmente.Retrieves the IHTMLDocument2 interface on the currently loaded HTML document.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

ParámetrosParameters

* * * pphtmlDoc* puntero a un puntero a un documento HTML.**pphtmlDoc A pointer to a pointer to an HTML document.

Valor devueltoReturn Value

HRESULT estándar.A standard HRESULT. Devuelve S_OK si se realiza correctamente.Returns S_OK if successful.

CDHtmlDialog:: GetDropTargetCDHtmlDialog::GetDropTarget

Lo llama el control WebBrowser incluido cuando se usa como destino de colocación para permitir que el cuadro de diálogo proporcione un IDropTargetalternativo.Called by the contained WebBrowser control when it is being used as a drop target to allow the dialog to supply an alternative IDropTarget.

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

ParámetrosParameters

pDropTargetpDropTarget
Vea pDropTarget en IDocHostUIHandler:: GetDropTarget en el Windows SDK.See pDropTarget in IDocHostUIHandler::GetDropTarget in the Windows SDK.

ppDropTargetppDropTarget
Vea ppDropTarget en IDocHostUIHandler::GetDropTarget en el Windows SDK.See ppDropTarget in IDocHostUIHandler::GetDropTarget in the Windows SDK.

Valor devueltoReturn Value

Devuelve E_NOTIMPL.Returns E_NOTIMPL.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: GetDropTarget, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::GetDropTarget, as described in the Windows SDK.

CDHtmlDialog:: GetElementCDHtmlDialog::GetElement

Devuelve una interfaz en el elemento HTML especificado por szElementId.Returns an interface on the HTML element specified by szElementId.

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

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

ParámetrosParameters

szElementIdszElementId
IDENTIFICADOR de un elemento HTML.The ID of an HTML element.

ppdispppdisp
IDispatchPuntero al elemento o colección de elementos solicitados.An IDispatch pointer to the requested element or collection of elements.

pbCollectionpbCollection
Un valor BOOLEANO que indica si el objeto representado por ppdisp es un elemento único o una colección de elementos.A BOOL indicating whether the object represented by ppdisp is a single element or a collection of elements.

pphtmlElementpphtmlElement
IHTMLElementPuntero al elemento solicitado.An IHTMLElement pointer to the requested element.

Valor devueltoReturn Value

Valor HRESULT estándar.A standard HRESULT value.

ObservacionesRemarks

Use la primera sobrecarga si necesita controlar las condiciones en las que puede haber más de un elemento con el identificador especificado.Use the first overload if you need to handle conditions in which there may be more than one element with the specified ID. Puede usar el último parámetro para averiguar si el puntero de interfaz devuelto es a una colección o un elemento único.You can use the last parameter to find out whether the returned interface pointer is to a collection or a single item. Si el puntero de interfaz se encuentra en una colección, puede consultar IHTMLElementCollection y usar su item propiedad para hacer referencia a los elementos por posición ordinal.If the interface pointer is on a collection, you can query for the IHTMLElementCollection and use its item property to refer to the elements by ordinal position.

La segunda sobrecarga producirá un error si hay más de un elemento con el mismo identificador en la página.The second overload will fail if there is more than one element with the same ID in the page.

CDHtmlDialog:: GetElementHtmlCDHtmlDialog::GetElementHtml

Recupera la innerHTML propiedad del elemento HTML identificado por szElementId.Retrieves the innerHTML property of the HTML element identified by szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

ParámetrosParameters

szElementIdszElementId
IDENTIFICADOR de un elemento HTML.The ID of an HTML element.

Valor devueltoReturn Value

La innerHTML propiedad del elemento HTML identificado por SZELEMENTID o null si no se encuentra el elemento.The innerHTML property of the HTML element identified by szElementId or NULL if the element could not be found.

CDHtmlDialog:: GetElementInterfaceCDHtmlDialog::GetElementInterface

Recupera el puntero de interfaz solicitado del elemento HTML identificado por szElementId.Retrieves the requested interface pointer from the HTML element identified by szElementId.

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

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

ParámetrosParameters

szElementIdszElementId
IDENTIFICADOR de un elemento HTML.The ID of an HTML element.

ppvObjppvObj
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.Address of a pointer that will be filled with the requested interface pointer if the element is found and the query succeeds.

REFIIDrefiid
IDENTIFICADOR de interfaz (IID) de la interfaz solicitada.The interface ID (IID) of the requested interface.

Valor devueltoReturn Value

Valor HRESULT estándar.A standard HRESULT value.

EjemploExample

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:: GetElementPropertyCDHtmlDialog::GetElementProperty

Recupera el valor de la propiedad identificada por DISPID del elemento HTML identificado por szElementId.Retrieves the value of the property identified by dispId from the HTML element identified by szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

ParámetrosParameters

szElementIdszElementId
IDENTIFICADOR de un elemento HTML.The ID of an HTML element.

dispIddispId
El identificador de envío de una propiedad.The dispatch ID of a property.

Valor devueltoReturn Value

El valor de la propiedad o una variante vacía si no se encontró la propiedad o el elemento.The value of the property or an empty variant if the property or element could not be found.

CDHtmlDialog:: GetElementTextCDHtmlDialog::GetElementText

Recupera la innerText propiedad del elemento HTML identificado por szElementId.Retrieves the innerText property of the HTML element identified by szElementId.

BSTR GetElementText(LPCTSTR szElementId);

ParámetrosParameters

szElementIdszElementId
IDENTIFICADOR de un elemento HTML.The ID of an HTML element.

Valor devueltoReturn Value

La innerText propiedad del elemento HTML identificado por SZELEMENTID o null si no se encontró la propiedad o el elemento.The innerText property of the HTML element identified by szElementId or NULL if the property or element could not be found.

CDHtmlDialog:: GetEventCDHtmlDialog::GetEvent

Devuelve el IHTMLEventObj puntero al objeto de evento actual.Returns the IHTMLEventObj pointer to the current event object.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

ParámetrosParameters

ppEventObjppEventObj
Dirección de un puntero que se rellenará con el IHTMLEventObj puntero de interfaz.Address of a pointer that will be filled with the IHTMLEventObj interface pointer.

Valor devueltoReturn Value

Valor HRESULT estándar.A standard HRESULT value.

ObservacionesRemarks

Solo se debe llamar a esta función desde dentro de un controlador de eventos DHTML.This function should only be called from within a DHTML event handler.

CDHtmlDialog:: GetExternalCDHtmlDialog::GetExternal

Obtiene la interfaz del host IDispatch .Gets the host's IDispatch interface.

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

ParámetrosParameters

ppDispatchppDispatch
Vea ppDispatch en IDocHostUIHandler:: GetExternal en el Windows SDK.See ppDispatch in IDocHostUIHandler::GetExternal in the Windows SDK.

Valor devueltoReturn Value

Devuelve S_OK si se ejecuta correctamente o E_NOTIMPL en caso de error.Returns S_OK on success or E_NOTIMPL on failure.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: GetExternal, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::GetExternal, as described in the Windows SDK.

CDHtmlDialog:: GetHostInfoCDHtmlDialog::GetHostInfo

Recupera las capacidades de la interfaz de usuario del host.Retrieves the host's UI capabilities.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

ParámetrosParameters

pInfopInfo
Vea Pinfo en IDocHostUIHandler:: GetHostInfo en el Windows SDK.See pInfo in IDocHostUIHandler::GetHostInfo in the Windows SDK.

Valor devueltoReturn Value

Devuelve S_OK.Returns S_OK.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: GetHostInfo, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::GetHostInfo, as described in the Windows SDK.

CDHtmlDialog:: GetOptionKeyPathCDHtmlDialog::GetOptionKeyPath

Recupera la clave del registro en la que se almacenan las preferencias del usuario.Retrieves the registry key under which user preferences are stored.

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

ParámetrosParameters

pchKeypchKey
Vea pchKey en IDocHostUIHandler:: GetOptionKeyPath en el Windows SDK.See pchKey in IDocHostUIHandler::GetOptionKeyPath in the Windows SDK.

dwdw
Vea DW en IDocHostUIHandler::GetOptionKeyPath en el Windows SDK.See dw in IDocHostUIHandler::GetOptionKeyPath in the Windows SDK.

Valor devueltoReturn Value

Devuelve E_NOTIMPL.Returns E_NOTIMPL.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: GetOptionKeyPath, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::GetOptionKeyPath, as described in the Windows SDK.

CDHtmlDialog:: HideUICDHtmlDialog::HideUI

Oculta la interfaz de usuario del host.Hides the host's UI.

STDMETHOD(HideUI)(void);

Valor devueltoReturn Value

Devuelve E_NOTIMPL.Returns E_NOTIMPL.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: HideUI, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::HideUI, as described in the Windows SDK.

CDHtmlDialog:: IsExternalDispatchSafeCDHtmlDialog::IsExternalDispatchSafe

Indica si la interfaz del host IDispatch es segura para el scripting.Indicates whether the host's IDispatch interface is safe for scripting.

virtual BOOL IsExternalDispatchSafe();

Valor devueltoReturn Value

Devuelve FALSE.Returns FALSE.

CDHtmlDialog:: LoadFromResourceCDHtmlDialog::LoadFromResource

Carga el recurso especificado en el control WebBrowser en el cuadro de diálogo DHTML.Loads the specified resource into the WebBrowser control in the DHTML dialog.

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

ParámetrosParameters

lpszResourcelpszResource
Puntero a una cadena que contiene el nombre del recurso que se va a cargar.A pointer to a string containing the name of the resource to load.

nResnRes
Id. del recurso que se va a cargar.The ID of the resource to load.

Valor devueltoReturn Value

TRUE si es correcto; en caso contrario, FALSE.TRUE if successful; otherwise FALSE.

CDHtmlDialog:: m_bUseHtmlTitleCDHtmlDialog::m_bUseHtmlTitle

Indica si se va a usar el título del documento HTML como título del cuadro de diálogo.Indicates whether to use the HTML document's title as the dialog caption.

BOOL m_bUseHtmlTitle;

ObservacionesRemarks

Si m_ bUseHtmlTitle es true, el título del cuadro de diálogo se establece igual al título del documento HTML; de lo contrario, se usa el título del recurso de diálogo.If m_ bUseHtmlTitle is TRUE, the dialog caption is set equal to the title of the HTML document; otherwise, the caption in the dialog resource is used.

CDHtmlDialog:: m_nHtmlResIDCDHtmlDialog::m_nHtmlResID

IDENTIFICADOR de recurso del recurso HTML que se va a mostrar.Resource ID of HTML resource to be displayed.

UINT m_nHtmlResID;

EjemploExample

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

CDHtmlDialog:: m_pBrowserAppCDHtmlDialog::m_pBrowserApp

Puntero a una aplicación de explorador Web.A pointer to a Web browser application.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog:: m_spHtmlDocCDHtmlDialog::m_spHtmlDoc

Un puntero a un documento HTML.A pointer to an HTML document.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog:: m_strCurrentUrlCDHtmlDialog::m_strCurrentUrl

La dirección URL actual.The current URL.

CString m_strCurrentUrl;

CDHtmlDialog:: m_szHtmlResIDCDHtmlDialog::m_szHtmlResID

Versión de cadena del identificador de recurso HTML.String version of the HTML resource ID.

LPTSTR m_szHtmlResID;

EjemploExample

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

CDHtmlDialog:: NavigateCDHtmlDialog::Navigate

Navega al recurso identificado por la dirección URL especificada por lpszURL.Navigates to the resource identified by the URL that is specified by lpszURL.

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

ParámetrosParameters

lpszURLlpszURL
Un puntero a una cadena que contiene la dirección URL que se va a usar como destino.A pointer to a string containing the URL to be targeted.

dwFlagsdwFlags
Marcas de una variable que especifica si se debe agregar el recurso a la lista de historial, si se va a leer o escribir en la memoria caché, y si se va a mostrar el recurso en una nueva ventana.The flags of a variable that specifies whether to add the resource to the history list, whether to read to the cache or write from the cache, and whether to display the resource in a new window. La variable puede ser una combinación de los valores definidos por la enumeración BrowserNavConstants .The variable can be a combination of the values defined by the BrowserNavConstants enumeration.

lpszTargetFrameNamelpszTargetFrameName
Puntero a una cadena que contiene el nombre del marco en el que se va a mostrar el recurso.A pointer to a string that contains the name of the frame in which to display the resource.

lpszHeaderslpszHeaders
Un puntero a un valor que especifica los encabezados HTTP que se van a enviar al servidor.A pointer to a value that specifies the HTTP headers to send to the server. Estos encabezados se agregan a los encabezados predeterminados de Internet Explorer.These headers are added to the default Internet Explorer headers. Los encabezados pueden especificar tal información como la acción requerida del servidor, el tipo de datos que se pasan al servidor o un código de estado.The headers can specify such information as the action required of the server, the type of data being passed to the server, or a status code. Este parámetro se omite si la dirección URL no es una dirección URL HTTP.This parameter is ignored if the URL is not an HTTP URL.

lpvPostDatalpvPostData
Puntero a los datos que se van a enviar con la transacción HTTP POST.A pointer to the data to send with the HTTP POST transaction. Por ejemplo, la transacción POST se utiliza para enviar los datos recopilados por un formulario HTML.For example, the POST transaction is used to send data gathered by an HTML form. Si este parámetro no especifica ningún dato post, Navigate emite una transacción HTTP GET.If this parameter does not specify any post data, Navigate issues an HTTP GET transaction. Este parámetro se omite si la dirección URL no es una dirección URL HTTP.This parameter is ignored if the URL is not an HTTP URL.

dwPostDataLendwPostDataLen
Datos que se van a enviar con la transacción HTTP POST.Data to send with the HTTP POST transaction. Por ejemplo, la transacción POST se utiliza para enviar los datos recopilados por un formulario HTML.For example, the POST transaction is used to send data gathered by an HTML form. Si este parámetro no especifica ningún dato post, Navigate emite una transacción HTTP GET.If this parameter does not specify any post data, Navigate issues an HTTP GET transaction. Este parámetro se omite si la dirección URL no es una dirección URL HTTP.This parameter is ignored if URL is not an HTTP URL.

CDHtmlDialog:: OnBeforeNavigateCDHtmlDialog::OnBeforeNavigate

Lo llama el marco de trabajo para que se desencadene un evento antes de que se produzca una navegación.Called by the framework to cause an event to fire before a navigation occurs.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

ParámetrosParameters

pDisppDisp
Puntero a un objeto IDispatch .A pointer to an IDispatch object.

szUrlszUrl
Puntero a una cadena que contiene la dirección URL a la que se va a navegar.A pointer to a string containing the URL to navigate to.

CDHtmlDialog:: OnDocumentCompleteCDHtmlDialog::OnDocumentComplete

Lo llama el marco de trabajo para notificar a una aplicación cuando un documento ha logrado el estado READYSTATE_COMPLETE.Called by the framework to notify an application when a document has achieved the READYSTATE_COMPLETE state.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

ParámetrosParameters

pDisppDisp
Puntero a un objeto IDispatch .A pointer to an IDispatch object.

szUrlszUrl
Puntero a una cadena que contiene la dirección URL a la que se navegó.A pointer to a string containing the URL that was navigated to.

CDHtmlDialog:: OnDocWindowActivateCDHtmlDialog::OnDocWindowActivate

Lo llama el marco de trabajo cuando la ventana de documento está activada o desactivada.Called by the framework when the document window is activated or deactivated.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

ParámetrosParameters

fActivatefActivate
Vea fActivate en IDocHostUIHandler:: OnDocWindowActivate en el Windows SDK.See fActivate in IDocHostUIHandler::OnDocWindowActivate in the Windows SDK.

Valor devueltoReturn Value

Devuelve E_NOTIMPL.Returns E_NOTIMPL.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: OnDocWindowActivate, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::OnDocWindowActivate, as described in the Windows SDK.

CDHtmlDialog:: OnFrameWindowActivateCDHtmlDialog::OnFrameWindowActivate

Lo llama el marco de trabajo cuando la ventana de marco está activada o desactivada.Called by the framework when the frame window is activated or deactivated.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

ParámetrosParameters

fActivatefActivate
Vea fActivate en IDocHostUIHandler:: OnFrameWindowActivate en el Windows SDK.See fActivate in IDocHostUIHandler::OnFrameWindowActivate in the Windows SDK.

Valor devueltoReturn Value

Devuelve E_NOTIMPL.Returns E_NOTIMPL.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: OnFrameWindowActivate, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::OnFrameWindowActivate, as described in the Windows SDK.

CDHtmlDialog:: OnInitDialogCDHtmlDialog::OnInitDialog

Se llama en respuesta al mensaje de WM_INITDIALOG.Called in response to the WM_INITDIALOG message.

virtual BOOL OnInitDialog();

Valor devueltoReturn Value

La implementación predeterminada devuelve TRUE.The default implementation returns TRUE.

ObservacionesRemarks

Este mensaje se envía al cuadro de diálogo durante las Create CreateIndirect DoModal llamadas a, o, que se producen inmediatamente antes de que se muestre el cuadro de diálogo.This message is sent to the dialog box during the Create, CreateIndirect, or DoModal calls, which occur immediately before the dialog box is displayed.

Invalide esta función miembro si necesita realizar un procesamiento especial cuando se inicializa el cuadro de diálogo.Override this member function if you need to perform special processing when the dialog box is initialized. En la versión invalidada, llame primero a la clase base OnInitDialog pero omita el valor devuelto.In the overridden version, first call the base class OnInitDialog but disregard its return value. Normalmente, devolverá TRUE desde la función miembro invalidada.You will normally return TRUE from your overridden member function.

Windows llama a la OnInitDialog función mediante el procedimiento de cuadro de diálogo global estándar común a todos los cuadros de diálogo de biblioteca MFC, en lugar de a través del mapa de mensajes, por lo que no se necesita una entrada de mapa de mensajes para esta función miembro.Windows calls the OnInitDialog function through the standard global dialog-box procedure common to all Microsoft Foundation Class Library dialog boxes, rather than through your message map, so you do not need a message-map entry for this member function.

CDHtmlDialog:: OnNavigateCompleteCDHtmlDialog::OnNavigateComplete

Lo llama el marco de trabajo después de que se complete la navegación a la dirección URL especificada.Called by the framework after navigation to the specified URL is completed.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

ParámetrosParameters

pDisppDisp
Puntero a un objeto IDispatch .A pointer to an IDispatch object.

szUrlszUrl
Puntero a una cadena que contiene la dirección URL a la que se navegó.A pointer to a string containing the URL that was navigated to.

CDHtmlDialog:: ResizeBorderCDHtmlDialog::ResizeBorder

Alerta al objeto que necesita para cambiar el tamaño del espacio del borde.Alerts the object that it needs to resize its border space.

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

ParámetrosParameters

prcBorderprcBorder
Vea prcBorder en IDocHostUIHandler:: ResizeBorder en el Windows SDK.See prcBorder in IDocHostUIHandler::ResizeBorder in the Windows SDK.

pUIWindowpUIWindow
Vea pUIWindow en IDocHostUIHandler::ResizeBorder en el Windows SDK.See pUIWindow in IDocHostUIHandler::ResizeBorder in the Windows SDK.

fFrameWindowfFrameWindow
Vea fFrameWindow en IDocHostUIHandler::ResizeBorder en el Windows SDK.See fFrameWindow in IDocHostUIHandler::ResizeBorder in the Windows SDK.

Valor devueltoReturn Value

Devuelve E_NOTIMPL.Returns E_NOTIMPL.

CDHtmlDialog:: SetControlPropertyCDHtmlDialog::SetControlProperty

Establece la propiedad de un control ActiveX en un nuevo valor.Sets the property of an ActiveX control to a new value.

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ámetrosParameters

szElementIdszElementId
IDENTIFICADOR HTML de un control ActiveX.The HTML ID of an ActiveX control.

dispIddispId
IDENTIFICADOR de envío de la propiedad que se va a establecer.The dispatch ID of the property to set.

pVarpVar
Puntero a un tipo VARIANT que contiene el nuevo valor de propiedad.Pointer to a VARIANT containing the new property value.

pdispControlpdispControl
Puntero a la interfaz de un control ActiveX IDispatch .Pointer to an ActiveX control's IDispatch interface.

szPropNameszPropName
Cadena que contiene el nombre de la propiedad que se va a establecer.String containing the name of the property to set.

CDHtmlDialog:: SetElementHtmlCDHtmlDialog::SetElementHtml

Establece la innerHTML propiedad de un elemento HTML.Sets the innerHTML property of an HTML element.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

ParámetrosParameters

szElementIdszElementId
IDENTIFICADOR de un elemento HTML.The ID of an HTML element.

bstrTextbstrText
Nuevo valor de la propiedad innerHTML .The new value of the innerHTML property.

punkElempunkElem
IUnknownPuntero de un elemento HTML.The IUnknown pointer of an HTML element.

CDHtmlDialog:: SetElementPropertyCDHtmlDialog::SetElementProperty

Establece una propiedad de un elemento HTML.Sets a property of an HTML element.

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

ParámetrosParameters

szElementIdszElementId
IDENTIFICADOR de un elemento HTML.The ID of an HTML element.

dispIddispId
IDENTIFICADOR de envío de la propiedad que se va a establecer.The dispatch ID of the property to set.

pVarpVar
Nuevo valor de la propiedad.The new value of the property.

CDHtmlDialog:: SetElementTextCDHtmlDialog::SetElementText

Establece la innerText propiedad de un elemento HTML.Sets the innerText property of an HTML element.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

ParámetrosParameters

szElementIdszElementId
IDENTIFICADOR de un elemento HTML.The ID of an HTML element.

bstrTextbstrText
Nuevo valor de la propiedad innerText .The new value of the innerText property.

punkElempunkElem
IUnknownPuntero de un elemento HTML.The IUnknown pointer of an HTML element.

CDHtmlDialog:: SetExternalDispatchCDHtmlDialog::SetExternalDispatch

Establece la interfaz del host IDispatch .Sets the host's IDispatch interface.

void SetExternalDispatch(IDispatch* pdispExternal);

ParámetrosParameters

pdispExternalpdispExternal
La nueva IDispatch interfaz.The new IDispatch interface.

CDHtmlDialog:: SetHostFlagsCDHtmlDialog::SetHostFlags

Establece las marcas de la interfaz de usuario del host.Sets the host UI flags.

void SetHostFlags(DWORD dwFlags);

ParámetrosParameters

dwFlagsdwFlags
Para ver los valores posibles, vea DOCHOSTUIFLAG en el Windows SDK.For possible values, see DOCHOSTUIFLAG in the Windows SDK.

CDHtmlDialog:: ShowContextMenuCDHtmlDialog::ShowContextMenu

Se le llama cuando un menú contextual está a punto de mostrarse.Called when a context menu is about to be displayed.

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

ParámetrosParameters

dwIDdwID
Vea dwID en IDocHostUIHandler:: ShowContextMenu en el Windows SDK.See dwID in IDocHostUIHandler::ShowContextMenu in the Windows SDK.

PPTppt
Vea PPT in IDocHostUIHandler::ShowContextMenu en el Windows SDK.See ppt in IDocHostUIHandler::ShowContextMenu in the Windows SDK.

pcmdtReservedpcmdtReserved
Vea pcmdtReserved en IDocHostUIHandler::ShowContextMenu en el Windows SDK.See pcmdtReserved in IDocHostUIHandler::ShowContextMenu in the Windows SDK.

pdispReservedpdispReserved
Vea pdispReserved en IDocHostUIHandler::ShowContextMenu en el Windows SDK.See pdispReserved in IDocHostUIHandler::ShowContextMenu in the Windows SDK.

Valor devueltoReturn Value

Devuelve S_FALSE.Returns S_FALSE.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: ShowContextMenu, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::ShowContextMenu, as described in the Windows SDK.

CDHtmlDialog:: ShowUICDHtmlDialog::ShowUI

Muestra la interfaz de usuario del host.Shows the host's UI.

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

ParámetrosParameters

dwIDdwID
Vea dwID en IDocHostUIHandler:: ShowUI en el Windows SDK.See dwID in IDocHostUIHandler::ShowUI in the Windows SDK.

pActiveObjectpActiveObject
Vea d pActiveObject in IDocHostUIHandler::ShowUI en el Windows SDK.See d pActiveObject in IDocHostUIHandler::ShowUI in the Windows SDK.

pCommandTargetpCommandTarget
Vea pCommandTarget en IDocHostUIHandler::ShowUI en el Windows SDK.See pCommandTarget in IDocHostUIHandler::ShowUI in the Windows SDK.

pFramepFrame
Vea pFrame en IDocHostUIHandler::ShowUI en el Windows SDK.See pFrame in IDocHostUIHandler::ShowUI in the Windows SDK.

pDocpDoc
Vea pDoc en IDocHostUIHandler::ShowUI en el Windows SDK.See pDoc in IDocHostUIHandler::ShowUI in the Windows SDK.

Valor devueltoReturn Value

Devuelve S_FALSE.Returns S_FALSE.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: ShowUI, tal como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::ShowUI, as described in the Windows SDK.

CDHtmlDialog:: TranslateAcceleratorCDHtmlDialog::TranslateAccelerator

Se llama para procesar los mensajes de tecla de aceleración del menú.Called to process menu accelerator-key messages.

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

ParámetrosParameters

lpMsglpMsg
Vea lpMsg en IDocHostUIHandler:: TranslateAccelerator en el Windows SDK.See lpMsg in IDocHostUIHandler::TranslateAccelerator in the Windows SDK.

pguidCmdGrouppguidCmdGroup
Vea pguidCmdGroup en IDocHostUIHandler::TranslateAccelerator en el Windows SDK.See pguidCmdGroup in IDocHostUIHandler::TranslateAccelerator in the Windows SDK.

nCmdIDnCmdID
Vea nCmdID en IDocHostUIHandler::TranslateAccelerator en el Windows SDK.See nCmdID in IDocHostUIHandler::TranslateAccelerator in the Windows SDK.

Valor devueltoReturn Value

Devuelve S_FALSE.Returns S_FALSE.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: TranslateAccelerator, tal como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::TranslateAccelerator, as described in the Windows SDK.

CDHtmlDialog:: TranslateUrlCDHtmlDialog::TranslateUrl

Se llama para modificar la dirección URL que se va a cargar.Called to modify the URL to be loaded.

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

ParámetrosParameters

dwTranslatedwTranslate
Vea dwTranslate en IDocHostUIHandler:: TranslateUrl en el Windows SDK.See dwTranslate in IDocHostUIHandler::TranslateUrl in the Windows SDK.

pchURLInpchURLIn
Vea pchURLIn en IDocHostUIHandler::TranslateUrl en el Windows SDK.See pchURLIn in IDocHostUIHandler::TranslateUrl in the Windows SDK.

ppchURLOutppchURLOut
Vea ppchURLOut en IDocHostUIHandler::TranslateUrl en el Windows SDK.See ppchURLOut in IDocHostUIHandler::TranslateUrl in the Windows SDK.

Valor devueltoReturn Value

Devuelve S_FALSE.Returns S_FALSE.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: TranslateUrl, tal y como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::TranslateUrl, as described in the Windows SDK.

CDHtmlDialog:: UpdateUICDHtmlDialog::UpdateUI

Se llama para notificar al host que el estado del comando ha cambiado.Called to notify the host that the command state has changed.

STDMETHOD(UpdateUI)(void);

Valor devueltoReturn Value

Devuelve E_NOTIMPL.Returns E_NOTIMPL.

ObservacionesRemarks

Esta función miembro es la implementación de CDHtmlDialog de IDocHostUIHandler:: updateUI, tal como se describe en el Windows SDK.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::UpdateUI, as described in the Windows SDK.

Consulte tambiénSee also

Ejemplo DHtmlExplore de MFCMFC Sample DHtmlExplore
Macros auxiliares de DDX_DHtmlDDX_DHtml Helper Macros
Gráfico de jerarquíaHierarchy Chart