Názorný postup: Vytvoření Průvodce

Článek
03/04/2013

Průvodci, například Přidat Průvodce, jsou programy, které vedou uživatele prostřednictvím řady akcí k provádění složitých, opakované nebo složité úlohy.Systém Windows, například použití průvodců pro připojení k síťovým prostředkům, připojení k tiskárnám atd.

V Visual Studio, průvodci obecně požádat řadu otázek, které vyžadují vstup od uživatele a výsledky potom použít ke generování kódu.Průvodci, však nemusí vždy zobrazit uživatelské rozhraní (UI).Může být naprogramován tedy bez zásahu uživatele generovat kód na pozadí.

Existují tři různé typy průvodců.

Noví průvodci projektu – jak naznačuje název, průvodců slouží ke generování nového kódu pro určitý typ projektu, poskytující počáteční bod, ze kterého chcete přidat vlastní kód uživatele.Toto je nejběžnější typ průvodce.
Přidat novou položku Průvodce – průvodců slouží k přidání nových položek, jako jsou například webové formuláře, textové soubory, HTML stránky, stránky XML a tak dále do projektu.
Vlastní Průvodce– tito průvodci nejsou volána dialogové okno.Místo toho se nazývají přímo z doplňků, makra nebo jiné typy kódu.Mohou i nemusí zobrazit uživatelské rozhraní.V obou případech mohou generovat kód.Tento typ průvodce se používá nejméně často.

Bez ohledu na typ průvodce všechny mají společné znaky.

Jsou.NET objekty této implementace IDTWizard rozhraní a související metodu, Execute, která obsahuje kód, který chcete spustit průvodce.
Všechny samy v zobrazení pomocí souboru .vsz Visual Studio.
Jsou všechny generovat kód nebo některé jiné úkol provést.

Můžete upravit vzhled prvků v průvodcích, které vytvoříte.Průvodci nejčastěji obsahovat jedno nebo více oken nebo stránky.Stránky mohou obsahovat popisný obraz jako na horní nebo levé stránky, popis štítku, pokyny a oblasti, ve které ovládací prvky jako například Další a předchozí mohou být umístěny.

Proces vytvoření průvodců v Visual C++ se poněkud liší od vytvoření standardní Visual Studio průvodců.Další informace o vytváření průvodců zaměřený na Visual C++, viz Návrh průvodce a Vytvoření vlastního průvodce.

[!POZNÁMKA]

Dialogová okna a příkazy v nabídkách menu, které vidíte, se mohou lišit od těch popsaných v nápovědě, v závislosti na vašich aktivních nastaveních nebo edici.Tyto postupy byly vyvinuty s aktivní Obecné nastavení pro vývoj.Chcete-li změnit nastavení, zvolte Import a ExportNastavení na Nástroje nabídce.Další informace naleznete v tématu Nastavení aplikace Visual Studio.

Příklad základního Průvodce

Aplikace Visual Studio přidat Průvodce

Tento obrázek ukazuje panel z Přidat Průvodce, nový projekt typ průvodce, který vás provede řadou kroků vytvořit v.Můžete upravit vzhled vašeho průvodců, ale Přidat Průvodce je dobrým příkladem styl standardní typ průvodce.Dokončení průvodce se stanou dostupné šablony v Nový projekt nebo Přidat novou položku dialogová okna.

Následující ukazuje, jak vytvořit základní průvodce a volitelně jí přiřadit vlastní ikonu.

Vytvoření základní průvodce v jazyce Visual Basic a Visual C#

Spustit Visual Studio jako správce.Průvodce registrací vyžaduje aktualizaci registru, proto potřebuje toto oprávnění.
Vytvoření nového projektu knihovny třídu s názvem MyNewWizard.
Přidat odkazy na EnvDTE a EnvDTE80 projektu.

Chcete-li to provést, klepněte pravým tlačítkem myši projekt a klepněte na tlačítko Přidat odkaz na.V.NET na kartě Přidat odkaz na dialog, EnvDTE a EnvDTE80 a klepněte na tlačítko OK.

V modulu třídy obsahují odkazy na EnvDTE a EnvDTE80 a provádět IDTWizard rozhraní.Tento Visual C# příklad, musíte také přidat odkaz na System.Windows.Forms a System.Runtime.InteropServices.

Imports EnvDTE
Imports EnvDTE80
Public Class Class1
    Implements IDTWizard

using System;
using System.Collections.Generic;
using System.Text;
using EnvDTE;
using EnvDTE80;
using System. Windows.Forms;

using System.Runtime.InteropServices;

namespace MyNewWizard
{

[ComVisible(true)]

[Guid("20184B81-7C38-4E02-A1E3-8D564EEC2D25"),

ProgId("MyNewWizard.Class1")]

    public class Class1 : IDTWizard
    {
    }
}

Po přidání Implements příkaz Visual Basic, umístěte kurzor na konec řádku a stisknutím klávesy enter automaticky vytvořit Execute postupu.Pro Visual C#, je však nutné přidat Execute postup ručně:

public class Class1 : IDTWizard
    {
    public void Execute(object Application, 
        int hwndOwner, ref object[] contextParams, 
        ref object[] customParams, 
        ref EnvDTE.wizardResult retval)

Chcete průvodce spustit kód Execute postup.V tomto příkladu přidáme stejně jednoduché okno zprávy.

Měli byste mít následující:

Imports EnvDTE
Imports EnvDTE80

Public Class Class1
    Implements IDTWizard

    Public Sub Execute(ByVal Application As Object, ByVal _
    hwndOwner As Integer, ByRef ContextParams() As Object, ByRef _
    CustomParams() As Object, ByRef retval As EnvDTE.wizardResult) _
    Implements EnvDTE.IDTWizard.Execute
        MsgBox("The wizard is now running.")
    End Sub
End Class

using System.Text;
using EnvDTE;
using EnvDTE80;
using System.Windows.Forms;
using System.Runtime.InteropServices;

namespace MyNewWizardCS
{
    public class Class1 : IDTWizard
    {

    public void Execute(object Application, 
        int hwndOwner, ref object[] contextParams, 
        ref object[] customParams, 
        ref EnvDTE.wizardResult retval)
    {
        MessageBox.Show("The wizard is now running.");
    }
}

}

Execute Postup se nazývá po spuštění průvodce.

Klepněte pravým tlačítkem myši v projektu Aplikaci Solution Explorer a klepněte na tlačítko Vlastnosti otevřete Vlastnosti projektu klepněte na možnost sestavení a potom zkontrolujte registrovat pro volání interop modelu COM pole v dolní části stránky.
Najít v souboru AssemblyInfo.cs ComVisible atributu a nastavit na hodnotu true.
Vytvořte projekt klepnutím na tlačítko Vytvořit knihovnu dll třídy Sestavit řešení na sestavení nabídce.
Vytvořte textový soubor .vsz pro Průvodce s názvem MyNewWizard.vsz.

To provedete kopii existující soubor .vsz jako některý z těch, na < Visual Studio nainstalovat adresář >\VC#\CSharpProjectItems\Windows formuláře a přejmenujte jej na "MyNewWizard.vsz".

Soubor .vsz je textový soubor, který umožňuje Visual Studio Průvodce rozpoznat a zobrazit ji v Nový projekt nebo Přidat novou položku dialogová okna.Wizard Nastavte parametr progID (Project.Classname) projektu nebo identifikátor GUID.Další informace naleznete v tématu Konfigurace.Soubory Vsz spuštění průvodců.

[!POZNÁMKA]

Volitelně můžete také vytvořit soubor VSDir pro průvodce.Obsahuje informace, které se zobrazí jako popis pro Průvodce v PřidatNový projekt nebo PřidatNový soubor dialogová okna.Je také možné určit ikonu a uspořádat jeho umístění v seznamu.Další informace naleznete v tématu Přidání průvodců přidat pomocí položky a dialogových oknech nový projekt.Vsdir soubory.

Nahradíte obsah MyNewWizard.vsz následující:

VSWizard 7.0
Wizard=MyNewWizard.Class1
Param=First Item
Param=Second Item

Uložte nový soubor .vsz v adresáři, kde chcete, aby se průvodce.

V tomto příkladu chceme průvodce v Přidat novou položku dialogové okno pro Visual Basic projekty, tak uložit soubor .vsz v adresáři: < Visual Studio nainstalovat adresář >\VB\VBProjectItems.
Konec Visual Studio a restartujte ji.

Tento příznak vynutí Visual Studio číst nový soubor .vsz.
Vytvořit nový Visual Basic projektu, jako je například projekt aplikace systému Windows.
Klepněte pravým tlačítkem myši projekt, přejděte na Přidatzbožía klepněte na tlačítko Nové položky.

Zobrazí Průvodce vytvořením (MyNewWizard) v Přidat nové položky dialogové okno.
Klepněte na tlačítko průvodce a klepněte Přidat tlačítko.

Zobrazí se zpráva, "Průvodce je nyní spuštěno.

Zobrazit vlastní ikonu pro nového Průvodce

Umístěte soubor ikonu stejný základní název souboru DLL, ale s příponou ICO do stejného adresáře jako soubor průvodce.

Pokud průvodce s názvem MyNewWizard.dll, název souboru ICO MyNewWizard.ico.

-nebo-
Pokud jste vytvořili soubor VSDir, zadejte cestu k dispozici soubor ikony (ICO).

Viz také

Sdílet prostřednictvím

Názorný postup: Vytvoření Průvodce

Příklad základního Průvodce

Vytvoření základní průvodce v jazyce Visual Basic a Visual C#

Zobrazit vlastní ikonu pro nového Průvodce

Viz také

Úkoly

Referenční dokumentace

Koncepty

Další zdroje

Další materiály