UKÁZKOVÝ: Comaddin.exe 2000 COM doplněk Office zapsaných v jazyce C++

Překlady článku Překlady článku
ID článku: 230689 - Produkty, které se vztahují k tomuto článku.
Rozbalit všechny záložky | Minimalizovat všechny záložky

Na této stránce

Souhrn

Comaddin.exe je samorozbalovací spustitelný soubor, který demonstruje budovy Office 2000 nebo Office XP komponent modelu COM) doplněk pomocí Visual C++. Doplněk COM je v procesu server COM specificky navržen pro spuštění v rámci kontextu aplikace Office 2000 nebo Office XP. Doplňky COM poskytují flexibilní, efektivní a jednotný způsob rozšíření prostředí Office.

Doplňky COM jsou sestavena pomocí programovacího jazyka, můžete vytvořit součásti COM, například jazyka C/C++, C# a Office 2000 Developer nebo Office XP Developer edition, Microsoft Visual Basic for Applications).

Tento příklad znázorňuje kroky potřebné k sestavení doplněk COM v jazyce C++. Ukázka vytvoří základní doplněk prostředí, které můžete rozšířit sestavení doplněk vlastní Office.

Další informace

Na webu služby Stažení softwaru je k dispozici ke stažení následující soubor:
Comaddin.exe
Datum vydání: Leden 4, 1999

Další informace o tom, jak stahovat soubory podpory společnosti Microsoft, naleznete v následujícím článku znalostní báze Microsoft Knowledge Base:
119591Jak získat soubory podpory společnosti Microsoft ze serverů služeb online
Microsoft tento soubor zkontroloval na výskyt virů. Společnost Microsoft použila aktuální antivirový software, který byl k dispozici v den uveřejnění tohoto článku. Soubor je uložený na zabezpečených serverech neumožňujících neoprávněné změny souborů.

Informace o ukázkové

Následující soubory do složky extrahuje Comaddin.exe:
   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

Objekt COM být doplněk aplikace Office jej popsaným v doplňku Návrhář typ knihovně Microsoft (Msaddndr.dll) musí podporovat rozhraní IDTExensibility2. Toto rozhraní byla deklarována můžete v ComAddin.h, takže žádný import je nezbytné. Všechny doplňky COM dědí z tohoto rozhraní a musí implementovat každý jeho pět metod:
  • OnConnection
  • OnDisconnection
  • OnAddInsUpdate
  • OnStartupComplete
  • OnBeginShutdown
Pokud doplněk COM je nejprve načten, je provedeno volání QueryInterface pro IDTExtensibility2. Pokud toto volání selže, doplněk je uvolněn. Pokud úspěšné volání hostitelské aplikace použijte odkaz vrácena upozornit doplněk změny stavu. Následuje popis každé metody.

OnConnection

Událost OnConnection je vždy připojen doplněk COM. Doplněk mohou být připojeny na spuštění koncovým uživatelem, nebo prostřednictvím automatizace. Pokud OnConnection vrátí S_OK, doplněk takzvaně být načten. Vrácena jiná hodnota hostitelské aplikace okamžitě uvolnit jeho odkaz doplněk a objektu budou zničena, jestliže.

OnConnection trvá následující čtyři parametry:
  • Aplikace - odkaz na rozhraní IDispatch hostitelské aplikace.
  • ConnectMode - konstantu, která určuje, jak připojena doplněk.
    • ext_cm_AfterStartup - Started koncového uživatele z dialogového okna Doplňky COM
    • ext_cm_CommandLine - připojení z příkazového řádku.
    • ext_cm_External - připojení externích aplikací prostřednictvím automatizace.
    • ext_cm_Startup - Started hostitele při spuštění aplikace. Toto chování lze řídit pomocí nastavení v registru.
  • AddInInst - odkaz na objekt COMAddIn odkazující na tento doplněk v kolekci COMAddIns hostitelské aplikace.
  • Vlastní - matice variant může pojmout dat definované uživatelem.


OnDisconnection

Událost OnDisconnection je při odpojení doplněk COM a těsně před uvolnění z paměti. Doplněk byste provádět jakékoli Vyčištění prostředky této události a obnovit všechny změny provedené do hostitelské aplikace.

OnDisconnection trvá následující dva parametry:
  • RemoveMode - konstantu, která určuje, jak doplněk byl odpojen.
    • ext_dm_HostShutdown - odpojeno při zavření hostitelské aplikace.
    • ext_dm_UserClosed - odpojeno podle řadič automatizace nebo koncového uživatele.
  • Vlastní - matice variant může pojmout dat definované uživatelem.


OnAddInsUpdate

Událost OnAddInsUpdate je při změně sady registrovaných doplňky COM. Jinými slovy kdykoli doplněk COM je nainstalovány nebo odebrány z hostitelské aplikace, tato událost je.


OnStartupComplete a OnBeginShutdown

Události OnStartupComplete a OnBeginShutdown upozorní doplňků v hostitelské aplikaci opustil nebo zadávání stavu, kde by měl interakce uživatele vyhnout protože aplikace je zaneprázdněna načítání nebo samotný uvolnění z paměti. OnStartupComplete bude platit pouze, pokud váš doplněk byl připojen během spuštění a OnBeginShutdown bude platit, pouze pokud vaše doplněk je odpojen hostitelem během vypnutí.

Protože je uživatelského rozhraní hostitele aplikace při těchto událostech Požární plně aktivní, jejich může být pouze způsobem provádět určité akce jinak by nedostupné z OnConnection a OnDisconnection.

Registrace doplněk COM

Na normální registrace COM doplněk COM musí registrovat sebe sama s každou aplikací Office 2000, ve kterém lze bezpečně spustit. Samotný zaregistrovat s konkrétní aplikace, doplněk vytvoří podklíč pomocí jeho ID jako název klíče pod následujícím umístění:

HKEY_CURRENT_USER\Software\Microsoft\Office\<appname>\Addins\<addinprogid>
Doplněk může poskytovat hodnoty v tomto umístění klíče pro zobrazení popisný název a úplný popis. Navíc doplněk byste určete jeho chování požadované zatížení pomocí hodnotu DWORD s názvem "LoadBehavior" Tato hodnota určuje, jak doplněk bude načten do hostitelské aplikace a je tvořen kombinací následujících hodnot:
  • 0x00 = odpojit - není načten.
  • 0x01 = připojeno - je načten.
  • bootload - zatížení aplikace spouštěcí = 0x02.
  • 0x08 = demandLoad - načíst pouze v případě požadavku uživatele.
  • 0x16 = ConnectFirstTime - načíst pouze jednou (na další spuštění).
Typické zadaná hodnota je 0x03 (připojeno | Bootload).

Doplňky, které implementují IDTExtensibility2 byste také určit DWORD hodnota nazývané "CommandLineSafe" označte, zda jsou bezpečné pro operace, které nepodporují uživatelského rozhraní. Hodnota 0x00 znamená FALSE, 0x01 je TRUE. Protože tento příklad zobrazí okno zprávy, není bezpečné spuštění příkazového řádku a proto nastaví hodnotu 0x00.

Začínáme

Začít psaní doplňky kompilovat ukázkový projekt, spustit regsvr32.exe na předdefinovaný DLL a spuštění aplikace Word, Excel, PowerPoint nebo FrontPage 2000. Měla by se zobrazit dialogové okno otevřít jako získává načíst doplněk, říká "Ahoj" a informuje o jaké je v aplikaci.

(c) 1999 Microsoft Corporation, všechny rezervované práv. Příspěvky Richard R. Anita, Microsoft Corporation.

Vlastnosti

ID článku: 230689 - Poslední aktualizace: 9. srpna 2004 - Revize: 5.4
Informace v tomto článku jsou určeny pro produkt:
  • Microsoft Excel 2000 Standard Edition
  • Microsoft Visual C++ 5.0 Enterprise Edition
  • Microsoft Visual C++ 6.0 Enterprise Edition
  • Microsoft Visual C++ 5.0 Professional Edition
  • Microsoft Visual C++ 6.0 Professional Edition
  • Microsoft Visual C++, 32-bit Learning Edition 6.0
  • 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
  • Microsoft Outlook 2002 Standard Edition
Klíčová slova: 
kbmt kbdownload kbautomation kbfile kbinfo kbsample KB230689 KbMtcs
Strojově přeložený článek
Důležité: Tento článek byl přeložen pomocí software společnosti Microsoft na strojový překlad, ne profesionálním překladatelem. Společnost Microsoft nabízí jak články přeložené překladatelem, tak články přeložené pomocí software na strojový překlad, takže všechny články ve Znalostní databázi (Knowledge Base) jsou dostupné v češtině. Překlad pomocí software na strojový překlad ale není bohužel vždy dokonalý. Obsahuje chyby ve skloňování slov, skladbě vět, nebo gramatice, podobně jako když cizinci dělají chyby při mluvení v češtině. Společnost Microsoft není právně zodpovědná za nepřesnosti, chyby nebo škody vzniklé chybami v překladu, nebo při použití nepřesně přeložených instrukcí v článku zákazníkem. Společnost Microsoft aktualizuje software na strojový překlad, aby byl počet chyb omezen na minimum.
Projděte si také anglickou verzi článku:230689

Dejte nám zpětnou vazbu

 

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