Elemente in den Dialogfeldern Neues Element hinzufügen
Der Prozess zum Hinzufügen von Elementen zum Starten der Neues Element hinzufügen Dialogfeld mit Registrierungsschlüsseln. Wie in den folgenden Registrierungseinträgen gezeigt AddItemTemplates-Abschnitt enthält den Pfad und Name des Verzeichnisses, in dem Elemente im Neues Element hinzufügen Dialogfeld bereitgestellt haben, werden eingefügt.
Hinweis
Die Tabelle direkt nach dem Codesegment enthält zusätzliche Informationen über den Registrierungseintrag.
In diesem Abschnitt wird befindet sich unter [HKEY_LOCAL_MACHINE \ SOFTWARE \ Microsoft \ VisualStudio \ Projects \ 9.0Exp.]
Das erste GUID ist die CLSID für Projekte dieses Typs. Das zweite GUID gibt den registrierten Projekttyp für die Vorlagen Element hinzufügen.
{\ C061 DB26-5833-11D2-96F5-000000000000} \ AddItemTemplates \ TemplateDirs CEF4} {\ 1 \ EB2-57CF-11D2-96F4-000000000000
@= " #6“
„TemplatesDir " = " Installationspfad <Visual-Studios \ SDK \ VSIntegration \ \. \ \ SomeFolder FigPkg \ \. \ \ FigPrj FigPrjProjectItems“
„=dword: " SortPriority00000064
Name |
Typ |
RGS-Datei von Daten () |
Beschreibung |
|---|---|---|---|
@ (Standard) |
REG_SZ |
#%IDS_ADDITEM_TEMPLATES_ENTRY% |
Ressourcen-ID für Element hinzufügen Vorlagen. |
Val TemplatesDir |
REG_SZ |
%TEMPLATE_PATH% \ FigPrjProjectItems |
Der Pfad der Projektelemente angezeigt im Dialogfeld für den Neues Element hinzufügen Wizard. |
Val SortPriority |
REG_DWORD |
100 (x64) |
Bestimmt die Sortierreihenfolge im Strukturknoten aus den Dateien, die im Dialogfeld Neues Element hinzufügen angezeigt werden. |
Hinweis
GUIDS für die Visual C#- und Visual Basic-Projekttypen lauten wie folgt:Visual C#: {FAE04E C0 -301F-11D3-BF4B-00 C04 F79EFBC}Visual Basic: {F184B08F- C81 C-45F6-A57F-5ABD9991F28F}
Das Verzeichnis, das für TemplateDirs aufgeführt ist, das %TEMPLATE_PATH% \ FigPrjProjectItems ist, ist der Knoten auf der linken Seite der Neues Element hinzufügen Dialogfeld Struktur. Zusätzliche Elemente in der Struktur basieren auf das Unterverzeichnis innerhalb des Stammverzeichnisses. Die Dateien, die dem Projekt hinzugefügt werden sollen, sind die verfügbaren Elemente im rechten Bereich des Dialogfelds Neues Element hinzufügen .
In der Regel enthält der Ordner die Vorlagendateien für das Projekt z. B. eine Vorlage HTML oder CPP-Datei und alle für .vsz-Dateien Assistenten starten. Um zu steuern, wie die Elemente angezeigt werden, können Sie .vsdir-Dateien zum Suchen von Verzeichnisnamen und Symbolen außerdem einschließen. Die lokalisierte Zeichenfolge, die die Beschriftung im Dialogfeld wird angezeigt, das diesen Knoten in der Struktur des Dialogfelds Neues Element hinzufügen darstellt.
Sie müssen jedoch alle in einer .vsdir-Datei enthalten. Sie können eine .vsdir-Datei für jedes Element im Verzeichnis verfügen. Weitere Informationen finden Sie unter (Assistent. Datei Vsz) und (Vorlagen-Verzeichnis-Beschreibung. Dateien Vsdir).
Hinweis
Die .vsdir-Dateien in den Vorlagenverzeichnissen sind optional.Wenn Sie ein Projektelement in das Verzeichnis speichern und sie im Neues Element hinzufügen Dialogfeld anzeigen möchten, können Sie diese Datei im Verzeichnis Vorlagen, das in der TemplatesDir-Anweisung angegeben wird.Die Datei wird dann im rechten Bereich des Dialogfelds Neues Element hinzufügen für dieses Projekt angezeigt.Wenn Sie jedoch eine lokalisierte Beschriftung für die Datei bzw. ein Symbol darstellen möchten, müssen Sie eine .vsdir-Datei im Verzeichnis Vorlagen mindestens ein.
Gruppieren von Projektelementen
Wenn Sie Vorlagengruppen in Ordnern in der Neues Element hinzufügen Dialogfeld Struktur enthalten sein sollen, müssen Sie Unterverzeichnisse unter dem Stammverzeichnis von Elementen in ihnen Verzeichnis verfügen. Wenn das Dialogfeld Neues Element hinzufügen der Benutzern angezeigt wird, finden diese auch die Unterordner und sind in der Lage, Projektelemente von XML-Strukturen auszuwählen.
Die Sortierpriorität in Codesegment bestimmt, wo dieses Verzeichnis der Vorlagen in der Struktur relativ zu anderen Elementen des Strukturknotens erstellt wird. Für das Neues Element hinzufügen Dialogfeld ist die Sortierpriorität alle, die berücksichtigt werden müssen, damit die Elemente an der korrekten Position im Dialogfeld angezeigt werden.
Sie können auch die IVsFilterAddProjectItemDlg2-Schnittstelle implementieren, um zu filtern, was im Neues Element hinzufügen Dialogfeld angezeigt wird. Wenn Sie diese Schnittstelle implementieren, können Sie ein Verzeichnis für Vorlagen auf dem Datenträger installieren, z. B. 50) und Assistenten Vorlage enthält. Auf diese Weise können Sie unterschiedliche Projekttypen mit 20 Dateien verfügen, die zu einem anderen Projekttyp 30 Dateien, die einem anderen Projekttyp enthalten sind und alle Dateien, die in einem allgemeinen Typ Projekt gehören. Auf diese Weise werden entsprechend dem Projektvorlage erstellt wurde, können Sie einen weiteren Satz von Vorlagendateien anzeigen.
Beispielsweise kann in einem Visual Basic-Projekt und Webprojekte Sie möglicherweise Clientprojekte. Web Forms sind keine nützlichen einem Clientprojekt Elemente hinzuzufügen, und Fenster formulare sind keine nützlichen einem Webserver, Elemente hinzuzufügen. Daher können Sie ein Verzeichnis für Vorlagen erstellen, das alle Dateien für beide Profilarten Projekt enthält. Dann indem Sie IVsFilterAddProjectItemDlg2implementieren, können Sie Elemente ausblenden, die nicht auf dem Typ des Projekts oder der Projekteinstellungen des Projekts angezeigt werden sollen.
Filterungs-Projektelemente
IVsFilterAddProjectItemDlg2 stellt zum Filtern der Elemente in der Struktur (linker Bereich) und in den Projektdateien (rechter Bereich) auf folgende Weise:
Durch die lokalisierten Namen (die im Dialogfeld angezeigte Beschriftung in der .vsdir-Datei enthalten ist), die von IVsFilterAddProjectItemDlgbereit.
Durch die tatsächlichen Namen der Dateien und Ordner auf der Festplatte (nicht-lokalisiert — keine .vsdir-Datei) bereitgestellten von IVsFilterAddProjectItemDlg.
Mithilfe der Kategorie von IVsFilterAddProjectItemDlg2bereitgestellt.
Um nach Kategorie zu filtern, geben Sie eine Kategoriezeichenfolge für ein Element in der .vsdir-Datei, z. B. „Web Forms“ oder „Client“ element in Visual Basic. Der Code des Dialogfelds ruft dann die Kategorien klassifizierung aus der .vsdir-Datei ab und übergibt sie für Sie. Sie können diese Informationen zur Implementierung von IVsFilterAddProjectItemDlg2 dann übergeben, um das Dialogfeld Neues Element hinzufügen nach Kategorien zu filtern. Sie können Elemente für Webseiten oder Win32-Anwendungs Client als auch fälle filtern. Darüber hinaus können Sie Visual C++ markierte Elemente als Microsoft Foundation Classes (MFC) oder Elemente der Active Template Library (ATL) identifizieren. Wenn Sie diese Elemente identifizieren, kann das Projektsystem eigene Klassifizierern definieren, damit das System anhand von Kategorien und Klassifizierern gefiltert werden kann.
Wenn Sie diese Funktionalität zu implementieren, müssen Sie Filter auf eine Tabelle jedes Elements nicht zuordnen, die ausgeblendet werden soll. Sie können Elemente in einfache Typen klassifizieren und Klassifizierern in die .vsdir-Datei oder Dateien ablegen. Danach können Sie beliebige Elemente ausblenden, die eine bestimmte Rangfolge haben, indem sie die Schnittstelle implementieren. Auf diese Weise können Sie die Elemente im Neues Element hinzufügen Dialogfeld Ausführen dynamisch basierend auf dem Zustand innerhalb des Projekts.
Siehe auch
Referenz
Konzepte
Registrieren von Projekt- und Elementvorlagen
CATID für Objekte, die i. d. R. verwendet werden, um Projekte zu erweitern
(Vorlagen-Verzeichnis-Beschreibung. Dateien Vsdir)