Starten Sie Visual Studio .NET 2003, eröffnen Sie ein neues Projekt. Dabei ist es wichtig, dass Sie
die Vorlage für eine Klassenbibliothek verwenden.
Anschließend sollte die Oberfläche so wie im Bild gezeigt aussehen.
Der nächste Schritt ist, die Interfaces.dll einzubinden, welche die Kommunikation zwischen Ihrem Plugin und Copy-Discovery 2000 verwaltet.
Dies tun Sie wie folgt: Klicken Sie im Treeview der Projektmappe mit der rechten Maustaste auf
Verweise und dann auf den Menüpunk Verweis hinzufügen.
Anschließend muss sich folgendes Fenster öffnen Hier klicken Sie auf den Button Durchsuchen...
Nun öffnet sich dieser Open Dialog. Wählen Sie die Interfaces.dll, welche sich im Copy-Discovery 2000 Hauptverzeichnis befindet aus und
klicken Sie dann auf Öffnen.
Wie Sie sehen, befindet sich die Interfaces.dll nun unter den ausgewählten Komponenten.
Um die gleichen Funktionen wie in einer Windows Anwendung benutzen zu können, müssen wir nun auch noch die Verweise System.Drawing und
System.Windows.Forms eingebunden werden. Klicken Sie daher im ListView der .NET Komponenten doppelt auf jedes
dieser zwei Elemente. Da wir die nötigen Verweise hinzugefügt haben, können wir jetzt den OK Button betätigen.
Wie Sie sehen, hat Visual Studio .NET nun die Interfaces.dll zu ihrem Projekt hinzugefügt.
Damit wäre der Grundstock des Plugins schon einmal gelegt.
Anschließend müssen wir die Eigenschaft Lokale Kopie der Interfaces auf False setzen.
Das machen wir, indem wir mit der linken Maustaste auf Interfaces in der Kategorie Verweise im Projektmappen-Explorer klicken.
Nun kann man die Eigenschaften des Verweises bearbeiten. Setzen Sie die Eigenschaft Lokale Kopie auf False.
Starten Sie nun den Eigenschaftsdialog. Sie erreichen ihn über das Menü.
Wählen Sie in der Kategorie Allgemeine Eigenschaften den Punkt Importe aus.
Geben Sie in der Namespace TextboxSystem.Windows.Forms ein und
bestätigen Sie anschließend durch den Klick auf Import hinzufügen.
Wie Sie sehen befindet sich nun der angegebene Verweis unter den Projektimporten.
Bestätigen Sie anschließend indem Sie auf OK klicken.
Nun ist es wichtig den Klassennamen der Hauptklasse zu ändern.
Das ist deshalb wichtig, denn sollten Plugins mit dem gleichen
Klassennamen vorhanden sein so erkennt Copy-Discovery 2000 nur eine davon.
Aus diesem Grund benennen wir die Klasse um.
Bitte auch nicht zu clsMain, ClassMain, usw. umbenennen, da diese
geläufige Namen sind und vielleicht mehrere Plugins diese Namen benutzen.
Ich ändere den Namen zu clsDemoMain, bitte verwenden Sie einen anderen,
denn sollten sich dieses Demo Plugin und Ihr Plugin im Plugins Ordner
befinden, so wird CD2000 eines der Plugins nicht erkennen.
Ändern Sie den Klassennamen sowie den Dateinamen.
Der nächste Schritt besteht darin Copy-Discovery 2000 mit zu teilen
welche Klasse die Hauptklasse ist. Das machen wir indem wir Implements CD2000Plugin.Interfaces.IPlugin
unter dem Public Class <Ihr Klassenname> einfügen.
Visual Studio.NET sollte nun folgenden Code automatisch generieren.
Public ReadOnly Property AddToPluginMenu() As Boolean Implements CD2000Plugin.Interfaces.IPlugin.AddToPluginMenu Get
End Get End Property
Public Sub Execute() Implements CD2000Plugin.Interfaces.IPlugin.Execute
End Sub
Public Sub Initialize(ByVal Host As CD2000Plugin.Interfaces.IHost)
Implements CD2000Plugin.Interfaces.IPlugin.Initialize
End Sub
Public ReadOnly Property Name() As String Implements CD2000Plugin.Interfaces.IPlugin.Name Get
End Get End Property
Public Sub OnCD2000Start() Implements CD2000Plugin.Interfaces.IPlugin.OnCD2000Start
End Sub
Sollte das nicht der Fall sein fügen Sie diesen Code bitte zwischen Implements CD2000Plugin.Interfaces.IPlugin und End Class ein. Zu den verschiedenen Propertys & Subs:
AddToPluginMenu
Das hoch entwickelte Pluginsystem von Copy-Discovery 2000 ermöglicht es
Ihnen Ihr eigenes Menü hinzuzufügen. Deswegen ist es manchmal nicht mehr notwendig das Plugin zum Standard
Menü Plugins hinzuzufügen. Sollten Sie kein eigenes Menü hinzufügen so geben Sie bitte
True zurück.
Execute
Dieser Sub wird ausgelöst sobald der Benutzer das Plugin über das Plugin Menü startet.
Initialize
Hier übermittelt Ihnen Copy-Discovery 2000 die nötigen Informationen,
um Funktionen von Copy-Discovery 2000 zu benutzen. Legen Sie eine Public Variable des Types
CD2000Plugin.Interfaces.IHost
an und und weißen Sie dieser den Host zu.
Name Bestimmen Sie einen Namen Ihres Plugins.
OnCD2000Start
Der Code der sich in diesem Sub befindet wird ausgeführt, sobald
Copy-Discovery 2000 startet. Der nächste Schritt besteht darin ein neues Modul der Anwendung
hinzuzufügen. Öffnen Sie in der ToolBar das zweite Item und wählen Sie
Neues Item Hinzufügen.
Anschließend öffnet sich folgendes Fenster Wählen Sie Module aus, geben Sie dem einen Namen und bestätigen Sie
mit Öffnen. Hier ist es egal, wenn Ihr Module gleich heißt wie meines.
Nun deklarieren wir in unserem neu erstellten Modul die Variable,
die uns den Zugang zu Copy-Discovery 2000 erlaubt.
Fügen Sie in das Modul folgenden Code ein: Public [VariblenName] As CD2000Plugin.Interfaces.IHost
Ersetzen Sie [VariblenName] mit einem beibiegen Variablen Namen, Vorschlag: CD2000
Nun müssen wir wieder zurück in die Hauptklasse, um die gerade eben
erstellte Variable zu initialisieren.
Weisen Sie im Sub Initialize der Variable [VariblenName] den Wert Host
zu, den Copy-Discovery 2000 in dieser Methode übergibt.
Nun geben wir Copy-Discovery 2000 die nächsten benötigten Informationen: AddToPluginMenu & Name (Um die Bedeutung dieser
Eigenschaften in Erfahrung zu bringen scrollen Sie bitte etwas hinauf...)
Und zum Abschluss lassen wir Copy-Discovery 2000 beim Starten des
Plugins den Pfad des Copy-Discovery 2000 Installationsverzeichnis ausgeben.
Dafür verwenden wir CD2000Path aus dem Interface CD2000.