VZORKA: Comaddin.exe Office 2000 COM doplnok napísané vo Visual c ++

Preklady článku Preklady článku
ID článku: 230689 - Zobraziť produkty, ktorých sa tento článok týka.
Rozbaliť všetko | Zbaliť všetko

Na tejto stránke

SUHRN

Comaddin.exe je samorozbaľovací spustiteľný súbor, ktorý demonštruje budovy Office 2000 alebo Office XP Component Object Model (COM) doplnok pomocou Visual C++. COM doplnok je server COM v procese špeciálne navrhnuté aby bežali v rámci jednej alebo viacerých Office 2000 alebo Office XP aplikácie. Doplnky COM poskytnúť pružným, účinným a jednotné metódy rozšírenia kancelárskom prostredí.

Doplnky COM sú postavené pomocou akéhokoľvek programovacieho jazyka, ktoré môžete vytvoriť COM súčasti, napríklad Visual Basic, C/C++, C#, a Office 2000 Developer alebo Office XP Developer edition Microsoft Visual Basic for Applications (VBA).

Táto vzorka ukazuje potrebné kroky na vybudovanie COM doplnok v Visual C++. Vzorka vytvára základné doplnok shell sa môže rozšíriť vybudovať vlastné Office add-in.

DALSIE INFORMACIE

V Stredisku pre prevzatie softvéru spoločnosti Microsoft sú k dispozícii nasledujúce súbory na prevzatie:
Comaddin.exe
Dátum vydania: 4. január 1999

Ďalšie informácie o preberaní súborov technickej podpory spoločnosti Microsoft nájdete v nasledovnom článku databázy Microsoft Knowledge Base:
119591 Získanie súborov technickej podpory spoločnosti Microsoft zo služieb Online
Tento súbor bol skontrolovaný antivírusovým programom spoločnosti Microsoft. Spoločnosť Microsoft použila pri kontrole tohto súboru najnovší antivírusový softvér, ktorý bol v čase jeho publikovania k dispozícii. Po publikovaní je súbor uložený na zabezpečených serveroch, ktoré neumožňujú neoprávnené zmeny súborov.

Informácie o súbore vzorky

Comaddin.exe extrakty nasledovné súbory do priečinka podľa vášho výberu:
   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

Pre objekt COM sa doplnok programu Office je podpora rozhrania IDTExensibility2 ako je opísané v Microsoft Add-In Designer Type Library (Msaddndr.dll). Toto rozhranie bolo vyhlásené na vás v ComAddin.h takže žiadne dovozné je nevyhnutné. Všetky doplnky COM dedia z tohto rozhrania a musia zaviesť každej z jeho piatich metód:
  • OnConnection
  • OnDisconnection
  • OnAddInsUpdate
  • OnStartupComplete
  • OnBeginShutdown
Keď COM doplnok po prvý krát naložené, volaní funkcie QueryInterface sa IDTExtensibility2. Ak toto volanie zlyhá, doplnok je vyložený. Ak sa väzba nevytvorí, hostiteľská aplikácia bude používať vráti oznámiť doplnok zmeny svojho štátu odkaz. Nasleduje opis každej metódy.

OnConnection

OnConnection udalosť požiare keď doplnok COM je pripojený. Doplnok môže byť pripojený na spustení koncovým užívateľom, alebo prostredníctvom automatizácie. Ak OnConnection vracia S_OK, doplnok je povedal zaťaží. Ak je vrátená iná hodnota, hostiteľská aplikácia bude ihneď uvoľniť jeho odkaz na doplnok a objekt sa zničia.

OnConnection má nasledujúce štyri parametre:
  • Aplikácia - odkaz na rozhrania IDispatch hostiteľská aplikácia.
  • ConnectMode - konštanta, ktorý určuje, ako doplnok bol pripojený.
    • ext_cm_AfterStartup - začal konečným užívateľom z dialógového okna doplnky COM.
    • ext_cm_CommandLine - pripojený z príkazového riadka.
    • ext_cm_External - pripojený Externá aplikácia prostredníctvom automatizácie.
    • ext_cm_Startup - začal hostiteľom pri spustení aplikácie. Toto správanie možno ovládať nastavenia v databáze registry.
  • AddInInst - odkaz na objekt COMAddIn, odkazujúci na tento doplnok v kolekcii COMAddIns pre hostiteľská aplikácia.
  • Vlastné - pole varianty, ktoré môžete uchovať užívateľské dáta.


OnDisconnection

OnDisconnection udalosť požiare keď doplnok COM je odpojená a tesne pred uvoľní z pamäte. Doplnok by mali vykonávať žiadne čistenie zdrojov v tomto prípade a obnoviť všetky zmeny vykonané hostiteľská aplikácia.

OnDisconnection má nasledujúce dva parametre:
  • RemoveMode - konštanta, ktorý určuje, ako doplnok bol odpojený.
    • ext_dm_HostShutdown - odpojí pri zatvorení hostiteľa aplikácie.
    • ext_dm_UserClosed - odpojený koncového používateľa alebo automatizácia radič.
  • Vlastné - pole varianty, ktoré môžete uchovať užívateľské dáta.


OnAddInsUpdate

OnAddInsUpdate udalosť požiare, keď súbor registrovaných doplnky COM zmení. Inými slovami, kedykoľvek COM doplnok je nainštalované alebo odstránené z hostiteľská aplikácia, táto udalosť požiare.


OnStartupComplete a OnBeginShutdown

OnStartupComplete a OnBeginShutdown podujatí upozorní doplnok hostiteľská aplikácia opustil alebo vstupuje do štátu, kde interakcie užívateľa by mali vyhnúť, pretože aplikácia je zaneprázdnená nakládky alebo vykládky sám z pamäte. OnStartupComplete bude len oheň, ak váš doplnok bol pripojený počas spustenia a OnBeginShutdown bude oheň iba rozpojení doplnok je hostiteľom počas vypnutia.

Pretože používateľské rozhranie pre hostiteľskou aplikáciou je plne aktívnym, keď tieto udalosti požiaru, môžu byť jediným spôsobom vykonávať určité činnosti, ktoré by sa inak nedostupné z OnConnection a OnDisconnection.

Registrujú sa doplnok COM

Popri bežného registračného COM, COM doplnok potrebuje zaregistrovať s každá aplikácia balíka Office 2000, v ktorom môžete bezpečne spustiť. Zaregistrovať najmä aplikáciou, doplnok vytvorí podkľúč, pomocou jeho ProgID ako názov kľúča, podľa nasledovného umiestnenia:

HKEY_CURRENT_USER\Software\Microsoft\Office\<appname>\Addins\<addinprogid> </addinprogid> </appname>
Doplnok môže poskytnúť hodnoty toto kľúčové umiestnenie pre priateľské zobrazované meno a úplný opis. Okrem toho doplnok by mali špecifikovať jeho požadovaný zaťaženie správania pomocou hodnotu DWORD s názvom "LoadBehavior." Táto hodnota sa určuje ako doplnok načíta hostiteľská aplikácia a pozostáva z kombinácie nasledujúcich hodnôt:
  • 0x00 = odpojiť - nie je zavedený.
  • 0x01 = pripojené - je načítaný.
  • 0x02 = bootload - zaťaženie na aplikáciu pri spustení.
  • 0x08 = demandLoad - zaťaženie iba ak požaduje užívateľ.
  • 0x16 = ConnectFirstTime - zaťaženie len raz (pri ďalšom spustení).
Typická hodnota zadaná je 0x03 (pripojené | Bootload).

Doplnky, ktoré implementujú IDTExtensibility2 by malo tiež vyšpecifikovať DWORD hodnotu nazýva "CommandLineSafe" na označenie, či sú bezpečné pre operácie, ktoré nepodporujú používateľské rozhranie. Hodnota 0x00 znamená NEPRAVDA, 0x01 je pravda. Pretože táto vzorka zobrazí okno s hlásením, nie je bezpečné pre vykonanie príkazového riadka, a preto nastaví hodnoty 0x00.

Začíname

Začať písať doplnky, zostavuje vzorku projektu, spustite nástroj regsvr32.exe na postavený DLL a potom spustiť program Microsoft Word, Excel, Powerpoint a Frontpage 2000. Mali by ste vidieť dialógové otvárať ako doplnok dostane naložené hovorí "Hello" a povie vám, aké aplikácie je v.

(c) Microsoft Corporation 1999, všetky práva vyhradené. Príspevky Richard R. Taylor, Microsoft Corporation.

Vlastnosti

ID článku: 230689 - Posledná kontrola: 23. októbra 2011 - Revízia: 3.0
Informácie v tomto článku sa týkajú nasledujúcich produktov:
  • 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 Standard Edition
  • Microsoft Word 2000 Standard Edition
  • Microsoft Excel 2002 Standard Edition
  • Microsoft Outlook 2000 Standard Edition
  • Microsoft Outlook 2002 Standard Edition
Kľúčové slová: 
kbdownload kbautomation kbfile kbinfo kbsample kbmt KB230689 KbMtsk
Strojovo preložené
DÔLEŽITÉ: Tento článok bol preložený pomocou softvéru na strojový preklad od spoločnosti Microsoft, nie prekladateľom. Spoločnosť Microsoft ponúka články preložené prekladateľmi aj strojovo preložené články, vďaka čomu máte možnosť prístupu ku všetkým článkom databázy Knowledge Base vo svojom jazyku. Strojovo preložený článok však nie je vždy perfektný. Môže obsahovať chyby týkajúce sa slovnej zásoby, syntaxe alebo gramatiky, podobne ako cudzinec môže robiť chyby, keď rozpráva vašim jazykom. Spoločnosť Microsoft nenesie zodpovednosť za akékoľvek nepresnosti, chyby alebo škody spôsobené akýmkoľvek nepresným prekladom obsahu alebo jeho použitím zo strany zákazníkov. Spoločnosť Microsoft softvér na strojový preklad pravidelne aktualizuje.
Pokiaľ chcete vidieť anglickú verziu článku, kliknite sem:230689

Odošlite odozvu

 

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