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

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.

Berkas berikut ini tersedia untuk diunduh dari Pusat Unduhan Microsoft:
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: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:

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:

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.