Como métodos/propriedades de acesso do contentor de script

Quando hospedar o controlo WebBrowser numa aplicação Visual C++, poderá ser necessário aceder métodos ou propriedades do contentor a partir do script numa página Web. Este artigo descreve como efectuar este procedimento implementa a interface IDocHostUIHandler.

Ao implementar a interface IDocHostUIHandler, pode controlar muitas das funcionalidades de interface de utilizador do controlo WebBrowser na aplicação anfitriã. IDocHostUIHandler também lhe permite alargar o modelo do objecto DHTML (Dynamic HTML) para aceder aos métodos e propriedades do contentor de dentro de script.

O método GetExternal() IDocHostUIHandler fornece esta funcionalidade. Quando o script numa página Web chama "window.external.yourMethod", o controlo WebBrowser chama o método GetExternal para obter um apontador para IDispatch da aplicação anfitriã. Está a este ponteiro que o controlo WebBrowser conseguir aceder a métodos e propriedades.

Depois do controlo WebBrowser tem um apontador para IDispatch do contentor, em seguida, chama IDispatch::GetIDsOfNames() obter DISPID do método ou propriedade denominada de script, yourMethod neste caso.

Finalmente, as chamadas de controlo WebBrowser IDispatch::Invoke() com o DISPID obtidas GetIDsOfNames().

Eis os passos que tem de seguir para expandir o modelo de objectos DHTML para conseguir acesso o contentor métodos e propriedades de script:

1. Implemente IDocHostUIHandler.
2. Implemente o método IDocHostUIHandler::GetExternal. Definir o IDispatch parâmetro para que o contentor seguinte forma:

   STDMETHOD(GetExternal)(IDispatch** ppDispatch)
   {
      // Assumes you inherit from IDispatch
      *ppDispatch = (IDispatch*)this;
      (*ppDispatch)->AddRef();
   
      return S_OK;
   }
   					

3. Devolver a distribuição ID (DISPID) do método ou propriedade de GetIDsOfNames. Se tiver adicionado o método ou propriedade utilizando um assistente, este será efectuado por si.
4. Implementar DISPID do método ou propriedade na implementação de IDispatch::Invoke seguinte forma:

   STDMETHODIMP CAtlBrCon::Invoke(DISPID dispidMember, REFIID riid,
                                  LCID lcid, WORD wFlags,
                                  DISPPARAMS* pDispParams,
                                  VARIANT* pvarResult,
                                  EXCEPINFO* pExcepInfo, UINT* puArgErr)
   {
      switch (dispidMember)
      {
         case DISPID_MYMETHOD_OR_PROPERTY:
            // Do something here
   
         default:
            return E_INVALIDARG;
      }
   
      return S_OK;
   }
   					

5. Chamar um método ou propriedade do contentor de script assim:

    <SCRIPT LANGUAGE="VBScript">
       Sub SomeControl_OnClick
          window.external.yourMethod
       End Sub
    </SCRIPT>
   					

Para mais informações sobre as tecnologias descritos neste artigo, consulte a documentação sobre interfaces de anfitrião avançado e IDocHostUIHandler na MSDN Online Web Workshop: (c) Microsoft Corporation 1998, todos os direitos reservados. Contribuições de Scott Roberts, Microsoft Corporation