Örnek: XLCLIENT: Excel Otomasyonu istemcisi

XLCLIENT, Microsoft Excel, OLE Otomasyonu'nu kullanarak denetlemek gösterilmiþtir. MFC dizin MFC kullanan örnek içerir. SDK dizin MFC kullanan örnek içerir.

Aþaðýdaki dosya Microsoft Yükleme Merkezi'nden yüklenebilir:
Microsoft destek dosyalarýný karþýdan yükleme konusunda ek bilgi için, Microsoft Bilgi Bankasý'ndaki makaleyi görüntülemek üzere aþaðýdaki makale numarasýný týklatýn: Microsoft bu dosyada virüs taramasý yapmýþtýr. Microsoft, dosyanýn kullanýma sunulduðu tarihteki en güncel virüs tarama yazýlýmýný kullanmýþtýr. Dosya, üzerinde herhangi bir yetkisiz deðiþiklik yapýlmasýný engellemeye yardým eden geliþtirilmiþ güvenliðe sahip sunucularda depolanýr. Excel, bir istemci bunlarý OLE Otomasyonu eriþebilmeleri nesneler, özellikler ve yöntemler sunar. Bu örnek, hücrelere deðerlerini ekler ve bu deðerler bir hesap oluþturur aþaðýdaki Visual Basic 4.0 kod eþit bir otomasyon istemci yazma gösterilmiþtir.

Microsoft Excel'in bir otomasyon istemci Write nasýl kullanýlýr

Bir Otomasyon istemcisinin, <a1>Denetim</a1> Microsoft Excel ýdispatch arabirimini kullanýr. Microsoft Excel'in bir otomasyon istemci yazarken aþaðýdaki bilgiler geçerlidir:

• Microsoft Excel'de otomasyon yöntemleri/Vba_xl.hlp dosyayý Excel ile birlikte kullanmayý planladýðýnýz özelliklerinin belgelerine bakýn.
• Aþaðýdaki knowledge base makalesinden kazanýlabilecek xlWorkSheet, <a2>xl3DPie</a2>, <a4>xlRows vb. gibi Microsoft Excel'in sabit deðerleri:
  112671  (http://support.microsoft.com/kb/112671/EN-US/ ) OFF: "yerleþik sabitleri Visual Basic for Applications" (WC0993)
  Bu sabit deðerleri ayný zamanda Microsoft Excel'in tür kitaplýðýndan tür kitaplýðý tarayýcýda Ole2vw32.exe gibi (derleyici 's \bin dizinine) kullanarak elde edilebilir. Microsoft Excel'in tür kitaplýðý (örneðin, Microsoft Excel 95 ABD sürümü Xl5en32.olb) açmak Ole2vw32.exe dosya/ViewTypeLibrary menüsünü kullanma. Typeinfos bileþik_kutu býrakýn ve "sabit" seçin. Microsoft Excel'in sabit, deðiþken/DataMembers</a1> liste kutusunda görüntülenir.
• Tüm baðýmsýz deðiþkenleri ve dönüþ türleri, Microsoft Excel Otomasyonu yöntemleri ve türleri VARIANT tipindedir. Içine doldurulmalarý gerekir ve bir VARIANT alýnan fiili türleri açýkça Vba_xl.hlp içinde bildirilen deðil. Ancak türleri belgelere kolayca edilebilir. Örneðin, bir sayý, vt_ý2, dize olarak VT_BSTR ve nesne VT_DISPATCH olarak geçirilebilir. Gerekirse, Microsoft Excel'in uygun coercions yapacaksýnýz. Microsoft Excel tarafýndan döndürülen deðerleri ayný þekilde edilebilir. Tam dönüþ deðeri türü belirlenemez VARIANT.vt alaný denetleyin veya VariantChangeType kullanarak dönüþ türü iþlenemiyor. "Microsoft Excel özelliklerini" da belirtildiði gibi Office Developer's Kit'te MSDN CD'sinde, Microsoft Excel, Microsoft Excel Developer's Kit'te Bölüm 7'in bir bölümü hiçbir zaman, aþaðýdaki listede olmayan bir veri türü ile bir VARIANT döndürür:

     Data Type                               Variant Constant
     ---------                               ----------------
     Boolean                                 VT_BOOL
     Currency (scaled integer)               VT_CY
     Date                                    VT_DATE
     Error cell values (#N/A, #REF etc.)     VT_ERROR
     Integer                                 VT_I2
     Long (long integer)                     VT_I4
     Object                                  VT_DISPATCH
     Single (single-precision floating-point)VT_R4
     Double (double-precision floating-point)VT_R8
     String                                  VT_BSTR
  						

Herhangi bir Otomasyon istemcisi aþaðýdaki bilgiler geçerlidir:

• OLE, Unicode dize kullanýlýr. OLESTR makro dizeleri Unicode dize sabitleri dönüþtürmek için kullanýlýr. MFC içinde dizeleri içeren deðiþkenler için ve Unicode T2OLE ve OLE2T makrolarýný kullanarak dönüþtürülebilir. Bkz: Ayrýntýlar MFC TechNote 59. MFC kullanan kodu, ANSý/Unicode dönüþümü için bilgi aþaðýdaki Bilgi Bankasý makalesinde bulabilirsiniz:
  
  Ansý'den Unicode'a Unicode ve ANSI için OLE için dönüþtürme nasýl KIMLIÐI:138813  (http://support.microsoft.com/kb/138813/EN-US/ )
• OLE API veya arabirim yönteminin çaðýran, baðýmsýz deðiþkenleri ve dönüþ deðerleri boþaltmayý sorumludur.

Bir MFC Otomasyon istemcisi Microsoft Excel'in Write nasýl kullanýlýr

1. Otomasyon ile uygulama oluþturmak için kullanmak AppWizard destekler.
2. Class Wizard ve seçme AddClass / bir OLE TypeLibrary Kimden, OLE Otomasyonu sekmesini seçin. Excel'in tür kitaplýðý (ABD Xl5en32.olb seçin. Microsoft Excel 95 sürümü) <a0>Microsoft Excel</a0> dizinindeki. Kullanacaðýnýz Microsoft Excel nesneleri seçin. Seçtiðiniz her nesne için bir türetilmiþ COleDispatchDriver proxy sýnýf ClassWizard oluþturacak. Örnek uygulama, aralýk, çalýþma kitabý, çalýþma kitaplarýný, çalýþma sayfasý, grafik ve grafikleri Excel nesne seçili ve ClassWizard yeni sýnýflar Xl5en32.h ve Xl5en32.h oluþturuldu. Aralýðýn yöntemi iletiþim kutusu, DialogBoxA veya DialogBoxW olarak sistem üstbilgi dosyalarý tanýmlamak için farklý bir ad (örneðin, iletiþim kutusu) nesne iletiþim kutusu adýný deðiþtirin.
3. Microsoft Excel'in denetim için kod içeren .cpp dosyasýna adým 2'de oluþturulan üstbilgi dosyasý içerir.
4. Geçirilen isteðe baðlý baðýmsýz deðiþkenlerini VT_ERROR/DISP_E_PARAMNOTFOUND içeren bir VARIANT ileterek belirtilebilir.
5. Bazý Microsoft Excel yöntemleri, iki sözdizimi kullanarak Vba_xl.hlp içinde belirtildiði gibi çaðrýlabilir. Örneðin, çalýþma kitaplarýný yöntemi gibi belgelenmiþtir:
   Sözdizimi 1
   Object.Workbooks(Index)
   
   Sözdizimi 2
   Object.Workbooks
   ClassWizard yalnýzca bir yöntemini oluþturur. Böylece, diðer sözdizimini kullanmak gerekiyorsa, oluþturulan .h ve diðer sözdizimi için baþka bir yöntem eklemek için .cpp dosyasýný deðiþtirin. Örneðin bu bir örnek Workbooks2 gibi <a0>çalýþma kitaplarýný</a0> yönteminin 2 sözdizimine karþýlýk gelmesi için uygulama sýnýfý eklendi:

      VARIANT Application::Workbooks2()
      {
      VARIANT result;
      InvokeHelper(0x23c, DISPATCH_METHOD, VT_VARIANT, (void*)&result, NULL);
      return result;
      }
   						

   Workbooks2 olarak çalýþma kitaplarýný ayný DISPID (0x23c) vardýr, ancak herhangi bir baðýmsýz deðiþkeni yoktur. Bu sorun, VT_ERROR/DISP_E_PAMNOTFOUND ileterek çözümlenemiyor. Tüm yöntemler, iki sözdizimleri sahip bu þekilde ele alýnmasý gereken olarak iþaretlenmiþ.
   
   Örnek, iki sözdizimleri sahiptir aralýðý, çalýþma kitaplarýný ve grafikleri yöntemleri kullanýr. Sonuç olarak Range1, <a2>Workbooks2</a2> ve <a4>Charts2 ekler.
6. MFC'ýn COleDispatchDriver sýnýfý, adlandýrýlmýþ deðiþkenleri desteklemiyor. Baðýmsýz deðiþkenler, konuma göre geçirilmelidir.
7. Microsoft Excel, bir özel durum oluþturur, DISP_E_EXCEPTION IDispatch::Invoke döndürür ve bu yöntemin EXCEPINFO parametre doldurur. MFC olur ve istemci bu özel yakalama tarafýndan EXCEPINFO yapýsýnda hata bilgilerini alabilir, bir COleDispatchException durum oluþturur.
8. Doc.cpp kod örneðinde, Microsoft Excel'in MFC sýnýflarý kullanýlarak nasýl gösterir.

Microsoft Excel'in olmayan MFC otomasyon istemci yazma

1. CreateObject ve ýnvoke (Invhelp.cpp ve Win32 SDK'sýndaki <a1>Gözat</a1> örneðinin Invhelp.h yardýmcý iþlevlerini kolayca olmayan MFC otomasyon istemci yazmak için kullanýlýr. IDispatch::Invoke doðrudan çaðýrmak için baþka bir yakla??md?r'ý týklatýn. Kullandýðý geç bir sunucuyu denetlemek için baðlama çaðýrýr. Bunu daha verimli deðiþiklik yaparak kimliði baðlama DISPID IDispatch::GetIDsOfNames üzerinden deðil, tür kitaplýðýndan alýnýr'ý kullanmak için yapýlabilir.
2. Invoke yardýmcý iþlevi, adlandýrýlmýþ deðiþkenleri desteklemiyor. Baðýmsýz deðiþkenler, konuma göre geçirilmelidir.
3. Invoke yardýmcý iþlevi bir EXCEPINFO yapýsý parametrelerden biri geçirilmesini saðlar. Microsoft Excel'in hata bilgileri bu yapýsýyla, bir özel durum oluþturur ve bir EXCEPINFO doldurur yapýsý, istemci tarafýndan saðlanýr. Olacak Çaðýr Microsoft Excel, bir özel durum oluþturur, DISP_E_EXCEPTION dönün. Dizeleri istemci tarafýndan serbest gerekir EXCEPINFO yapýsý. Örnek kod Microsoft Excel'e bir EXCEPINFO yapýsý vermeyen.
4. Xlclient.cpp kod örneðinde, Microsoft Excel'in nasýl gösterir.