Přidání ovládacích prvků model Windows Forms do dokumentů Office

Ovládací prvky model Windows Forms můžete přidat do systém Microsoft Office Excelu a systém Microsoft Office wordových dokumentů v době návrhu v projektech na úrovni dokumentu. Za běhu můžete přidávat ovládací prvky v přizpůsobeních na úrovni dokumentu a v doplňcích VSTO. Do listu můžete například přidat ComboBox ovládací prvek, aby uživatelé mohli vybírat ze seznamu možností.

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

Toto téma popisuje následující úlohy:

Přidání ovládacích prvků v době návrhu

Existuje několik způsobů, jak přidat ovládací prvky model Windows Forms do dokumentu v projektu na úrovni dokumentu v době návrhu.

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).

Přetažení ovládacího prvku model Windows Forms do dokumentu

  1. Vytvořte nebo otevřete projekt excelového sešitu nebo projekt wordového dokumentu v sadě Visual Studio, aby byl dokument viditelný v návrháři. Informace o vytváření projektů naleznete v tématu Postupy: Vytváření projektů Office v sadě Visual Studio.

  2. Na kartě Společné ovládací prvky panelu nástrojů klikněte na ovládací prvek, který chcete přidat, a přetáhněte ho do dokumentu.

    Poznámka:

    Když vyberete ovládací prvek v Excelu, v řádku vzorců se zobrazí =EMBED("WinForms.Control.Host";""). Tento text je nezbytný a neměl by být odstraněn.

Kreslení ovládacího prvku model Windows Forms v dokumentu

  1. Vytvořte nebo otevřete projekt excelového sešitu nebo projekt wordového dokumentu v sadě Visual Studio, aby byl dokument viditelný v návrháři. Informace o vytváření projektů naleznete v tématu Postupy: Vytváření projektů Office v sadě Visual Studio.

  2. Na kartě Společné ovládací prvky panelu nástrojů klikněte na ovládací prvek, který chcete přidat.

  3. V dokumentu klikněte na místo, kde má být umístěn levý horní roh ovládacího prvku, a přetáhněte ho na místo, kam má být umístěn pravý dolní roh ovládacího prvku.

    Ovládací prvek se přidá do dokumentu se zadaným umístěním a velikostí.

    Poznámka:

    Když vyberete ovládací prvek v Excelu, v řádku vzorců se zobrazí =EMBED("WinForms.Control.Host";""). Tento text je nezbytný a neměl by být odstraněn.

Přidání ovládacího prvku model Windows Forms do dokumentu jedním kliknutím na ovládací prvek

  1. Vytvořte nebo otevřete projekt excelového sešitu nebo projekt wordového dokumentu v sadě Visual Studio, aby byl dokument viditelný v návrháři. Informace o vytváření projektů naleznete v tématu Postupy: Vytváření projektů Office v sadě Visual Studio.

  2. Na kartě Společné ovládací prvky panelu nástrojů klikněte na ovládací prvek, který chcete přidat.

  3. Klikněte na místo, kam chcete ovládací prvek přidat.

    Ovládací prvek se přidá do dokumentu s výchozí velikostí.

    Poznámka:

    Když vyberete ovládací prvek v Excelu, v řádku vzorců se zobrazí =EMBED("WinForms.Control.Host";""). Tento text je nezbytný a neměl by být odstraněn.

Přidání ovládacího prvku model Windows Forms do dokumentu poklikáním na ovládací prvek

  1. Vytvořte nebo otevřete projekt excelového sešitu nebo projekt wordového dokumentu v sadě Visual Studio, aby byl dokument viditelný v návrháři. Informace o vytváření projektů naleznete v tématu Postupy: Vytváření projektů Office v sadě Visual Studio.

  2. Na kartě Společné ovládací prvky panelu nástrojů poklikejte na ovládací prvek, který chcete přidat.

    Ovládací prvek se přidá do dokumentu uprostřed dokumentu nebo v aktivním podokně.

    Poznámka:

    Když vyberete ovládací prvek v Excelu, v řádku vzorců se zobrazí =EMBED("WinForms.Control.Host";""). Tento text je nezbytný a neměl by být odstraněn.

Přidání ovládacího prvku model Windows Forms do dokumentu stisknutím klávesy Enter

  1. Vytvořte nebo otevřete projekt excelového sešitu nebo projekt wordového dokumentu v sadě Visual Studio, aby byl dokument viditelný v návrháři. Informace o vytváření projektů naleznete v tématu Postupy: Vytváření projektů Office v sadě Visual Studio.

  2. Na kartě Společné ovládací prvky panelu nástrojů klikněte na ovládací prvek, který chcete přidat, a stiskněte klávesu Enter.

    Ovládací prvek se přidá do dokumentu uprostřed dokumentu nebo v aktivním podokně.

    Poznámka:

    Když vyberete ovládací prvek v Excelu, v řádku vzorců se zobrazí =EMBED("WinForms.Control.Host";""). Tento text je nezbytný a neměl by být odstraněn.

Přidání ovládacích prvků za běhu v projektech na úrovni dokumentů

Ovládací prvky model Windows Forms můžete do dokumentu přidávat programově za běhu. Ve Wordu Controls použijte metody vlastnosti ThisDocument třídy. V Aplikaci Excel použijte metody Controls vlastnosti Sheetn třídy. Každá metoda má několik přetížení, které umožňují určit umístění ovládacího prvku různými způsoby.

Když přidáte ovládací prvek model Windows Forms do dokumentu za běhu, ovládací prvek se při zavření dokumentu neuchová. Ovládací prvek můžete znovu vytvořit při příštím otevření dokumentu. Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů Office za běhu.

Přidání ovládacího prvku model Windows Forms za běhu

  1. Použijte metodu s názvem Přidat<třídu ovládacího prvku (kde třída ovládacího prvku> je název třídy model Windows Forms ovládací prvek, který chcete přidat, například AddButton).

    Následující příklad kódu ukazuje, jak přidat Button do buňky C5Sheet1 projektu na úrovni dokumentu pro Excel.

    private void Sheet1_Startup(object sender, System.EventArgs e)
    {
        Microsoft.Office.Tools.Excel.Controls.Button salesButton;
        salesButton = this.Controls.AddButton(this.get_Range("C5"), "salesButton");
        salesButton.Text = "Calculate Total Sales";
    }
    

Přidání ovládacích prvků za běhu v doplňcích VSTO

Ovládací prvky model Windows Forms můžete přidat programově do libovolného otevřeného dokumentu za běhu. Nejprve vygenerujte položku hostitele založenou na otevřeném dokumentu nebo listu. Potom ve Wordu Controls použijte metody vlastnosti nové položky hostitele. V Excelu Controls použijte metody vlastnosti nové položky hostitele. Každá metoda má několik přetížení, které umožňují určit umístění ovládacího prvku různými způsoby.

Když přidáte ovládací prvek model Windows Forms do dokumentu za běhu, ovládací prvek se při zavření dokumentu neuchová. Ovládací prvek můžete znovu vytvořit při příštím otevření dokumentu. Další informace naleznete v tématu Přidání ovládacích prvků do dokumentů Office za běhu.

Další informace o generování hostitelských položek v projektech doplňků VSTO naleznete v tématu Rozšíření wordových dokumentů a excelových sešitů v doplňkech VSTO za běhu.

Přidání ovládacího prvku model Windows Forms za běhu

  1. Použijte metodu s názvem Přidat<třídu ovládacího prvku (kde třída ovládacího prvku> je název třídy model Windows Forms ovládací prvek, který chcete přidat, například AddButton).

    Poznámka:

    V projektech doplňků VSTO, které cílí na rozhraní .NET Framework 4 nebo novější, musíte přidat odkaz na microsoft.Office.Tools.Excel.v4.0.Utilities.dll nebo Microsoft.Office.Tools.Word.v4.0.Utilities.dll sestavení, než budete mít přístup k metodám přidat<třídy řízení>.

    Následující příklad kódu ukazuje, jak přidat Button do prvního odstavce aktivního dokumentu pomocí wordového doplňku VSTO.

    Microsoft.Office.Tools.Word.Controls.Button salesButton;
    
    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
    
    extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
    salesButton = extendedDocument.Controls.AddButton(
        extendedDocument.Paragraphs[1].Range, 75, 18, "salesButton");
    salesButton.Text = "Calculate Sales";