Komponenty projektu doplňku
Doplňky Visual Studio jsou ve verzi aplikace Visual Studio 2013 zastaralé.Měli byste upgradovat doplňky na rozšíření VSPackage.Další informace o upgradu viz Nejčastější dotazy: Převádění doplňků na rozšíření VSPackage.
Doplňkové projekty jsou projekty knihovny tříd, které jsou vytvořeny pomocí průvodce doplňkem a které jsou kompilovány do knihoven DLL.Doplňkové projekty obsahují soubor zdrojového kódu s názvem Připojení, což je také název třídy.Třída Connect implementuje rozhraní s názvem IDTExtensibility2, které předává příkazy mezi doplňkem a integrovaným vývojovým prostředím (IDE) Visual Studio.
IDTExtensibility2 má pět metod, které se při provádění chovají jako události.
Metoda |
Description |
|---|---|
Tato metoda je volána při načtení doplňku do aplikace Visual Studio. |
|
Tato metoda je volána, když se načte aplikace Visual Studio. |
|
Tato metoda je volána, když se doplněk načte nebo uvolní z aplikace Visual Studio. |
|
Tato metoda je volána, když je aplikace Visual Studio zavřena. |
|
Tato metoda je volána při uvolnění doplňku z aplikace Visual Studio. |
Kromě rozhraní IDTExtensibility2, rozhraní IDTCommandTarget je implementováno automaticky, pokud zaškrtnete možnost uživatelského rozhraní při použití průvodce doplňkem k vytvoření doplňku.Pokud se rozhodnete vytvořit panely příkazů nebo s nimi manipulovat v doplňku, musíte také implementovat obor názvů Microsoft.VisualStudio.CommandBars.
Metoda OnConnection
Metoda OnConnection je jednoznačně nejdůležitější způsob používaná v projektech doplňků, protože je volána vždy, když je doplněk načten.Kromě toho se používá pro volání jiného kódu automatizace v doplňku.Metodě OnConnection jsou předány čtyři argumenty: Application, ConnectMode, AddInInst a custom.Application představuje IDE Visual Studio.Je typovaná jako objekt DTE2 s názvem _applicationObject.Tento objekt představuje hlavní objekt v základním modelu automatizace a poskytuje přístup ke všem jeho typům a členům.ConnectMode (jehož hodnoty jsou obsaženy v Extensibility.extConnectMode) představuje způsob, jakým je doplněk načítán; to znamená prostřednictvím příkazového řádku, otevřením řešení, a tak dále.AddInInst představuje samotný doplněk.Parametr custom je pole, ve kterém lze volitelně předávat data doplňku.
Kromě inicializace těchto proměnných OnConnection také obsahuje kód, který vytvoří příkaz pro doplněk v nabídce Nástroje, pokud jste tuto možnost vybrali při jejím vytváření pomocí průvodce doplňkem.
Jiné metody doplňku
Další čtyři metody doplňku, které jsou na místě Průvodce doplňkem, jsou ve výchozím nastavení prázdné.Chcete-li zpracovat události související s doplňkem, můžete použít tyto jiné metody v reakci na ně.Můžete například přidat kód do metody OnAddInsUpdate pro odeslání oznámení jinému postupu při uzavření doplňku.Můžete zavolat OnBeginShutdown pro provedení úkolů čištění, když se Visual Studio IDE vypíná.
Když vytvoříte doplněk a zaškrtnete možnost „Chcete vytvořit uživatelské rozhraní panelu příkazů pro doplněk?“ (která vytvoří příkaz pro doplněk v nabídce Nástroje), je implementováno rozhraní IDTCommandTarget.Další dvě metody – QueryStatus a Exec – jsou přidány do projektu doplňku pro zpracování úloh příkazu.Tyto metody obsahují malé množství kódu, který pomáhá nahradit příkaz v nabídce Nástroje a reagovat na kliknutí od uživatele.QueryStatus upozorní doplněk na dostupnost příkazu.Metoda Exec je volána, když uživatel klepne na příkaz doplňku v nabídce Nástroje, takže je to místo, kam byste měli přidat kód, pokud chcete odpovědět na tuto událost.