Eriþim yöntemleri/kapsayýcýsý özelliklerinden nasýl komut dosyasý kaynaðý

Visual C++ uygulamasýnda WebBrowser denetimi barýndýran, Web sayfasýndaki komut dosyasýndan, yöntemleri veya özellikleri kapsayýcýsýnýn eriþmek gerekli olabilir. Bu makalede, IDocHostUIHandler arabirimi uygulayarak bunun nasýl yapýlacaðý açýklanýr.

IDocHostUIHandler arabirimi kullanarak, WebBrowser denetimi kullanýcý arabirimi özelliklerinin çoðunu barýndýrma uygulamanýzda denetleyebilirsiniz. IDocHostUIHandler yöntemlerine ve özelliklerine dosyasý içinde kapsayýcýdan eriþmek için dinamik HTML (DHTML) nesne modeli geniþletmenizi saðlar.

IDocHostUIHandler GetExternal() yöntemi, bu iþlevselliði saðlar. WebBrowser denetimi, bir Web sayfasýnda komut dosyasý "window.external.yourMethod" aradýðýnda, barýndýrma uygulamanýzýn ýdispatch iþaretçisi almak için <a2>GetExternal</a2> yöntemini çaðýrýr. Bu iþaretçi WebBrowser denetimi, yöntemlerine ve özelliklerine eriþebilir olmasýdýr.

WebBrowser denetimi kapsayýcýsýnýn ýdispatch iþaretçisi sonra daha sonra bu durumda, komut dosyasýndan yourMethod adlý bir özellik veya yöntemi DISPID almak için IDispatch::GetIDsOfNames() çaðýrýr.

Son olarak, WebBrowser denetimi çaðrýlarý IDispatch::Invoke() DISPID ile GetIDsOfNames() alýnýr.

DHTML nesne modeli kapsayýcýnýn yöntemleri ve özellikleri komut dosyasýndan eriþebilecek uzatmak için izlemeniz gereken adýmlarý aþaðýda verilmektedir:

1. IDocHostUIHandler uygular.
2. IDocHostUIHandler::GetExternal yöntemini uygular. ýdispatch ayarlamak aþaðýdaki parametresi, kendi kapsayýcýsýnýn gibi:

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

3. Yükleme KIMLIÐI (DISPID) yöntem veya özellik GetIDsOfNames döndürür. Yöntem ya da bir sihirbaz kullanarak özelliði eklediyseniz, bu sizin için yapýlýr.
4. <a1>Uygula</a1> yöntemi veya özelliði, uygulamasýnda IDispatch::Invoke DISPID bunu istiyor:

   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. A?a??daki komut dosyasýndan bir yöntem veya özellik kapsayýcýsýnýn arayýn:

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

Bu makalede açýklanan teknolojileri hakkýnda daha fazla bilgi için Geliþmiþ barýndýrma arabirimleri ve MSDN Online Web Workshop içinde IDocHostUIHandler belgelerine baþvurun: (c) Microsoft Corporation 1998, tüm haklarý saklýdýr. Katkýyý yakýn Scott, Microsoft Corporation