Sdílet prostřednictvím


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

Tento návod ukazuje, jak vytvořit doplněk VSTO pro systém Microsoft Office PowerPointu. Funkce, které vytvoříte v tomto druhu řešení, jsou k dispozici pro samotnou aplikaci bez ohledu na to, které prezentace 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 PowerPoint. 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 PowerPoint VSTO pro PowerPoint

  • Psaní kódu, který používá objektový model PowerPointu k přidání textového pole do každého nového snímku

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

  • Vyčištění projektu tak, aby se doplněk VSTO už na vývojovém počítači nespustí automaticky.

    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

  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 projekt doplňku PowerPoint VSTO.

  6. Do pole Název zadejte FirstPowerPointAddIn.

  7. Klikněte na OK.

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

Napsání kódu, který přidá text do každého nového snímku

Dále přidejte kód do souboru kódu ThisAddIn. Nový kód používá objektový model PowerPointu k přidání textového pole do každého nového snímku. 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 PowerPointu. 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ž PowerPoint načte a uvolní 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í textového pole do každého nového snímku

  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 Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide události objektu Aplikace .

    Když uživatel přidá do aktivní prezentace nový snímek, tato obslužná rutina události přidá do horní části nového snímku textové pole a přidá do textového pole nějaký text.

    void Application_PresentationNewSlide(PowerPoint.Slide Sld)
    {
        PowerPoint.Shape textBox = Sld.Shapes.AddTextbox(
            Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50);
        textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.");
    }
    
  2. Pokud používáte jazyk C#, přidejte do ThisAddIn_Startup obslužné rutiny události následující kód. Tento kód je nutný pro připojení Application_PresentationNewSlide obslužné rutiny události s událostí Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide událostí.

    this.Application.PresentationNewSlide += 
        new PowerPoint.EApplication_PresentationNewSlideEventHandler(
        Application_PresentationNewSlide);
    

    Pokud chcete upravit každý nový snímek, předchozí příklady kódu používají následující objekty:

Testování projektu

Když projekt sestavíte a spustíte, ověřte, že se textové pole zobrazí v nových snímcích, které přidáte do prezentace.

Otestování projektu

  1. Stisknutím klávesy F5 sestavte a spusťte projekt.

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

  2. V PowerPointu přidejte do aktivní prezentace nový snímek.

  3. Ověřte, že se do nového textového pole v horní části snímku přidá následující text.

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

  4. Zavřete PowerPoint.

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í. Jinak se doplněk VSTO spustí při každém otevření PowerPointu 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 PowerPoint, najdete další informace o tom, jak vyvíjet doplňky VSTO z těchto témat:

  • Obecné programovací úlohy, které můžete provádět v doplňcích VSTO pro PowerPoint. Další informace naleznete v tématu Program VSTO Doplňky.

  • Použití objektového modelu PowerPointu Další informace najdete v tématu PowerPoint solutions.

  • Přizpůsobení uživatelského rozhraní PowerPointu, například přidáním vlastní karty na pás karet nebo vytvořením vlastního podokna úloh. Další informace najdete v tématu Přizpůsobení uživatelského rozhraní Office.

  • Vytváření a ladění doplňků VSTO pro PowerPoint Další informace najdete v tématu Sestavení řešení Office.

  • Nasazení doplňků VSTO pro PowerPoint Další informace najdete v tématu Nasazení řešení Office.