Návod: Vytvoření prvního doplňku VSTO pro Project

  • Článek

V tomto názorném postupu se dozvíte, jak vytvořit doplněk VSTO pro systém Microsoft Office Project. Funkce, které vytvoříte v tomto typu řešení, jsou k dispozici pro samotnou aplikaci bez ohledu na to, které projekty jsou otevřené. Další informace najdete v tématu Přehled vývoje řešení pro Office (VSTO).

Platí pro: Informace v tomto tématu platí pro projekty doplňků VSTO pro Project. Další informace naleznete v tématu Funkce dostupné aplikace Office lication a typu projektu.

Tento návod znázorňuje následující úlohy:

  • Vytvoření projektu doplňku VSTO

  • Psaní kódu, který používá objektový model Projectu k přidání úkolu do nového projektu

  • Sestavení a spuštění projektu, který ho otestuje.

  • Vyčištění dokončeného projektu tak, aby se doplněk VSTO přestal automaticky spouštět na vývojovém počítači.

    Poznámka:

    Váš počítač může v následujících pokynech zobrazovat odlišné názvy nebo umístění některých prvků uživatelského rozhraní sady Visual Studio. Tyto prvky jsou určeny edicí sady Visual Studio a použitým nastavením. Další informace naleznete v tématu Přizpůsobení integrovaného vývojového prostředí (IDE).

Požadavky

K dokončení tohoto návodu budete potřebovat následující komponenty:

Vytvoření projektu

Vytvoření nového projektu v sadě Visual Studio

  1. Spusťte Visual Studio.

  2. V nabídce Soubor přejděte na příkaz Nový a klepněte na tlačítko Projekt.

  3. V podokně šablon rozbalte Visual C# nebo Visual Basic a potom rozbalte Office/SharePoint.

  4. V rozbaleném uzlu Office nebo SharePointu vyberte uzel Doplňky Pro Office.

  5. V seznamu šablon projektů vyberte doplněk Project 2010 nebo doplněk Project 2013.

  6. Do pole Název zadejte FirstProjectAddIn.

  7. Klikněte na OK.

    Visual Studio vytvoří projekt FirstProjectAddIn a otevře soubor kódu ThisAddIn v editoru.

Napsání kódu, který přidá nový úkol do projektu

Dále přidejte kód do souboru kódu ThisAddIn. Nový kód používá objektový model Projectu k přidání nového úkolu do projektu. Ve výchozím nastavení soubor kódu ThisAddIn obsahuje následující vygenerovaný kód:

  • Částečná definice ThisAddIn třídy. Tato třída poskytuje vstupní bod pro váš kód a poskytuje přístup k objektovému modelu Aplikace Project. Další informace naleznete v tématu Program VSTO Doplňky. Zbývající část ThisAddIn třídy je definována ve skrytém souboru kódu, který byste neměli upravovat.

  • Obslužné ThisAddIn_Startup rutiny událostí a ThisAddIn_Shutdown obslužné rutiny událostí. Tyto obslužné rutiny událostí se volají, když Project načte a uvolní váš doplněk VSTO. Pomocí těchto obslužných rutin událostí inicializujete doplněk VSTO při jeho načtení a vyčistíte prostředky používané doplňkem VSTO při jeho uvolnění. Další informace naleznete v tématu Události v projektech Office.

Přidání úkolu do nového projektu

  1. Do souboru kódu ThisAddIn přidejte do ThisAddIn třídy následující kód. Tento kód definuje obslužnou rutinu události pro NewProject událost třídy Microsoft.Office.Interop.MSProject.Application .

    Když uživatel vytvoří nový projekt, tato obslužná rutina události přidá do projektu úkol.

    void Application_NewProject(Microsoft.Office.Interop.MSProject.Project pj)
{
    MSProject.Task newTask = pj.Tasks.Add
        ("This text was added by using code", missing);
    newTask.Start = DateTime.Now;
    newTask.Duration = "3";
    newTask.ResourceNames = "Rob Caron, Kelly Krout";
}

    Tento příklad kódu používá k úpravě projektu následující objekty:

  • Pole ApplicationThisAddIn třídy. Pole Application vrátí Microsoft.Office.Interop.MSProject.Application objekt, který představuje aktuální instanci aplikace Project.

  • Parametr pj obslužné rutiny události pro událost NewProject. Parametr pj je Microsoft.Office.Interop.MSProject.Project objekt, který představuje projekt. Další informace najdete v tématu Řešení projectu.

  1. Pokud používáte jazyk C#, přidejte do ThisAddIn_Startup obslužné rutiny události následující kód. Tento kód připojí obslužnou rutinu Application_Newproject události s událostí NewProject.

    this.Application.NewProject += new Microsoft.Office.Interop.MSProject._EProjectApp2_NewProjectEventHandler(Application_NewProject);

Testování projektu

Při sestavení a spuštění projektu ověřte, že se nový úkol zobrazí ve výsledném novém projektu.

Otestování projektu

  1. Stisknutím klávesy F5 sestavte a spusťte projekt. Spustí se Microsoft Project a automaticky otevře nový prázdný projekt.

    Při sestavení projektu se kód zkompiluje do sestavení, které je součástí výstupní složky sestavení projektu. Visual Studio také vytvoří sadu položek registru, které projectu umožňují vyhledat a načíst doplněk VSTO, a nakonfiguruje nastavení zabezpečení na vývojovém počítači tak, aby bylo možné doplněk VSTO spustit. Další informace najdete v přehledu procesu sestavení řešení Office.

  2. Ověřte, že je do prázdného projektu přidán nový úkol.

  3. Ověřte, že se v poli Název úkolu úkolu zobrazí následující text.

    Tento text byl přidán pomocí kódu.

  4. Zavřete Microsoft Project.

Vyčištění projektu

Po dokončení vývoje projektu odeberte z vývojového počítače sestavení doplňku VSTO, položky registru a nastavení zabezpečení. V opačném případě se doplněk VSTO spustí při každém otevření aplikace Microsoft Project na vývojovém počítači.

Vyčištění projektu

  1. V sadě Visual Studio v nabídce Sestavení klepněte na tlačítko Vyčistit řešení.

Další kroky

Teď, když jste vytvořili základní doplněk VSTO pro Project, můžete se dozvědět více o tom, jak vyvíjet doplňky VSTO z těchto témat:

Související obsah