Copy-Discovery 2000 Homepage

Erste Schritte

Downloads (deaktiviert)

C# Programmquellcode

Visual Basic .NET Programmquellcode

Nur Plugin DLL

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 Textbox System.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.
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.

Tutorial bewerten:

• Sehr gut
• Gut
• Mittelmäßig
• Schlecht
• Miserabel