CONTOH: Comaddin.exe Office 2000 COM Add-In ditulis dalam Visual c ++

Terjemahan Artikel Terjemahan Artikel
ID Artikel: 230689 - Melihat produk di mana artikel ini berlaku.
Perbesar semua | Perkecil semua

Pada Halaman ini

RINGKASAN

Comaddin.exe adalah berkas executable yang menunjukkan bangunan Office 2000 atau Office XP Component Object Model (COM) add-in menggunakan Visual C++. COM add-in ini server COM dalam proses yang dirancang khusus untuk berjalan dalam konteks aplikasi satu Office 2000 atau lebih Office XP. Peralatan tambahan COM menyediakan metode fleksibel, efisien, dan seragam untuk memperluas lingkungan kantor.

Peralatan tambahan COM dibangun dengan menggunakan bahasa pemrograman apapun yang dapat membuat komponen COM, seperti Visual Basic, C/c + +, C#, dan edisi Office 2000 pengembang atau Office XP pengembang dari Microsoft Visual Basic for Applications (VBA).

Contoh ini menunjukkan langkah-langkah yang diperlukan untuk membangun COM add-in di Visual C++. Sampel menciptakan dasar add-in shell yang Anda dapat memperpanjang untuk membangun Anda sendiri kantor add-in.

INFORMASI LEBIH LANJUT

Berkas berikut ini tersedia untuk diunduh dari Pusat Unduhan Microsoft:
Comaddin.exe
Tanggal rilis: 4 Januari 1999

Untuk informasi lebih lanjut tentang cara men-download berkas Dukungan Microsoft, klik nomor artikel di bawah ini untuk melihat artikel pada Basis Pengetahuan Microsoft:
119591 Cara mendapatkan berkas Dukungan Microsoft dari Layanan Online
Microsoft telah memindai berkas ini dari virus. Microsoft menggunakan perangkat lunak pendeteksi virus terbaru yang tersedia pada tanggal saat berkas dikirimkan. Berkas tersebut disimpan di server yang aman, yang membantu mencegah pengubahan yang tidak sah terhadap berkas.

Contoh File informasi

Comaddin.exe ekstrak file-file berikut ke folder Anda pilih:
   FileName                    Size
   ----------------------------------------
   
   TestAddin.dsw               541 bytes
   TestAddin.dsp               4.11 KB 
   ComAddin.h                  6.19 KB
   ComAddin.cpp                8.38 KB
   ComAddin.def                205 bytes
   MyAddin.cpp                 10.6 KB
   MyAddinCF.cpp               2.18 KB
   BttnHandler.cpp             6.27 KB

IDTExensibility2

Untuk objek COM menjadi kantor add-in, ia harus mendukung antarmuka IDTExensibility2 seperti yang dijelaskan dalam Microsoft Add-In Designer perpustakaan jenis (Msaddndr.dll). Antarmuka ini telah menyatakan untuk Anda di ComAddin.h sehingga tidak ada impor diperlukan. Semua peralatan tambahan com. mewarisi dari antarmuka ini dan harus menerapkan masing-masing metode lima:
  • OnConnection
  • OnDisconnection
  • OnAddInsUpdate
  • OnStartupComplete
  • OnBeginShutdown
Ketika COM add-in pertama dimuat, panggilan QueryInterface dibuat untuk IDTExtensibility2. Jika panggilan ini gagal, tambahan diturunkan. Jika panggilan berhasil, aplikasi host akan menggunakan referensi kembali untuk memberitahu Tambah-in perubahan yang dibuat ke keadaan. Deskripsi dari masing-masing metode berikut.

OnConnection

OnConnection peristiwa kebakaran setiap kali COM add-in terhubung. Tambahan dapat dihubungkan pada startup, oleh pengguna akhir, atau melalui otomatisasi. Jika OnConnection kembali S_OK, tambahan dikatakan dimuat. Jika nilai lain kembali, aplikasi host akan segera merilis referensi untuk tambahan dan objek akan dihancurkan.

OnConnection mengambil empat parameter berikut:
  • Aplikasi - referensi ke antarmuka IDispatch aplikasi host.
  • ConnectMode - sebuah konstanta yang menentukan bagaimana tambahan terhubung.
    • ext_cm_AfterStartup - dimulai oleh pengguna akhir dari dialog peralatan tambahan COM.
    • ext_cm_CommandLine - terhubung dari baris perintah.
    • ext_cm_External - terhubung oleh aplikasi eksternal melalui otomatisasi.
    • ext_cm_Startup - dimulai oleh tuan rumah pada aplikasi startup. Perilaku ini dapat dikontrol oleh pengaturan registri.
  • AddInInst - referensi objek COMAddIn yang merujuk kepada add-in ini dalam koleksi COMAddIns untuk aplikasi host.
  • Custom - sebuah array dari varian yang dapat menyimpan data yang ditetapkan pengguna.


OnDisconnection

OnDisconnection peristiwa kebakaran ketika peralatan tambahan COM secara terputus dan sebelum membongkar dari memori. Tambahan harus melakukan pembersihan setiap sumber daya dalam acara ini, dan memulihkan perubahan dibuat untuk aplikasi host.

OnDisconnection mengambil dua parameter berikut:
  • RemoveMode - sebuah konstanta yang menentukan bagaimana tambahan diputus.
    • ext_dm_HostShutdown - terputus ketika tuan rumah aplikasi ditutup.
    • ext_dm_UserClosed - terputus oleh pengguna akhir atau kontroler otomatisasi.
  • Custom - sebuah array dari varian yang dapat menyimpan data yang ditetapkan pengguna.


OnAddInsUpdate

OnAddInsUpdate peristiwa kebakaran ketika set terdaftar tambahan COM perubahan. Dengan kata lain, setiap kali COM add-in diinstal atau dihapus dari aplikasi tuan rumah, ini peristiwa kebakaran.


OnStartupComplete dan OnBeginShutdown

OnStartupComplete dan OnBeginShutdown peristiwa memberitahu tambahan ketika aplikasi host telah meninggalkan atau memasuki keadaan di mana interaksi pengguna harus dihindari karena aplikasi sibuk loading atau pembongkaran sendiri dari memori. OnStartupComplete hanya akan api jika Anda add-in terhubung selama Persiapan, dan OnBeginShutdown akan hanya api jika Anda menambahkan-di terputus oleh tuan rumah selama pematian.

Karena antarmuka pengguna untuk aplikasi host sepenuhnya aktif ketika peristiwa kebakaran, mereka mungkin satu-satunya cara untuk melakukan tindakan tertentu yang kalau tidak akan tersedia dari OnConnection dan OnDisconnection.

Mendaftar COM Add-In

Selain untuk normal COM pendaftaran, COM add-in perlu untuk mendaftar sendiri dengan setiap aplikasi Office 2000 di mana dapat dengan aman berjalan. Untuk mendaftar sendiri dengan aplikasi tertentu, tambahan menciptakan subkunci, menggunakan yang ProgID sebagai nama untuk kunci, di bawah lokasi berikut:

HKEY_CURRENT_USER\Software\Microsoft\Office\<appname>\Addins\<addinprogid> </addinprogid> </appname>
Tambahan dapat memberikan nilai-nilai di lokasi ini kunci untuk nama tampilan ramah dan keterangan lengkap. Selain itu, tambahan harus menentukan perilaku beban yang dikehendaki dengan menggunakan nilai DWORD yang disebut "LoadBehavior." Nilai ini menentukan bagaimana tambahan akan dimuat oleh aplikasi host, dan terdiri dari kombinasi nilai-nilai berikut:
  • 0x00 = putuskan - tidak dimuat.
  • 0x01 = Connected - load.
  • 0x02 = bootload - beban pada aplikasi Startup.
  • 0x08 = demandLoad - beban hanya ketika diminta oleh pengguna.
  • 0x16 = ConnectFirstTime - beban hanya sekali (pada startup berikutnya).
Nilai khas yang ditentukan adalah 0x03 (Connected | Bootload).

Add-in yang menerapkan IDTExtensibility2 juga menjelaskan DWORD nilai disebut "CommandLineSafe" untuk menunjukkan apakah mereka aman untuk operasi yang tidak mendukung antarmuka pengguna. Nilai 0x00 berarti palsu, 0x01 adalah benar. Karena contoh ini menampilkan kotak pesan, tidak aman untuk baris perintah eksekusi, dan karena itu set nilai untuk 0x00.

Persiapan

Untuk memulai menulis tambahan, menyusun contoh proyek, jalankan regsvr32.exe pada DLL dibangun, dan kemudian memulai Microsoft Word, Excel, Powerpoint dan/atau Frontpage 2000. Anda akan melihat kotak dialog membuka sebagai tambahan akan dimuat yang mengatakan "Halo" dan memberitahu Anda apa aplikasi dalam.

(c) Microsoft Corporation 1999, Semua Hak Dilindungi Undang-Undang. Kontribusi oleh Richard R. Taylor, Microsoft Corporation.

Properti

ID Artikel: 230689 - Kajian Terakhir: 19 September 2011 - Revisi: 2.0
Berlaku bagi:
  • Microsoft Excel 2000 Standard Edition
  • Microsoft Visual C++ 5.0 Enterprise Edition
  • Microsoft Visual C++ 5.0 Professional Edition
  • Microsoft Office XP Developer Edition
  • Microsoft Office 2000 Developer Edition
  • Microsoft FrontPage 2002 Standard Edition
  • Microsoft FrontPage 2000 Standard Edition
  • Microsoft PowerPoint 2002 Standard Edition
  • Microsoft PowerPoint 2000 Standard Edition
  • Microsoft Word 2002
  • Microsoft Word 2000
  • Microsoft Excel 2002 Standard Edition
  • Microsoft Outlook 2000 Standard Edition
  • Microsoft Outlook 2002 Standard Edition
Kata kunci: 
kbdownload kbautomation kbfile kbinfo kbsample kbmt KB230689 KbMtid
Penerjemahan Mesin
PENTING: Artikel ini diterjemahkan menggunakan perangkat lunak mesin penerjemah Microsoft dan bukan oleh seorang penerjemah. Microsoft menawarkan artikel yang diterjemahkan oleh seorang penerjemah maupun artikel yang diterjemahkan menggunakan mesin sehingga Anda akan memiliki akses ke seluruh artikel baru yang diterbitkan di Pangkalan Pengetahuan (Knowledge Base) dalam bahasa yang Anda gunakan. Namun, artikel yang diterjemahkan menggunakan mesin tidak selalu sempurna. Artikel tersebut mungkin memiliki kesalahan kosa kata, sintaksis, atau tata bahasa, hampir sama seperti orang asing yang berbicara dalam bahasa Anda. Microsoft tidak bertanggung jawab terhadap akurasi, kesalahan atau kerusakan yang disebabkan karena kesalahan penerjemahan konten atau penggunaannya oleh para pelanggan. Microsoft juga sering memperbarui perangkat lunak mesin penerjemah.
Klik disini untuk melihat versi Inggris dari artikel ini:230689

Berikan Masukan

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com