Erzeugen der CGIW-Library und der Beispiel-Programme ==================================================== Es wird angenommen, dass in einem Verzeichnis C:\CGIW alle Unterverzeichnisse mit den Quellcode-Dateien der CGIW-Library und der Beispiel-Programme eingerichtet wurden (z. B. dadurch, dass die Datei cgiwsour.zip in ein Verzeichnis C:\CGIW kopiert und dort unter Wahrung der Verzeichnisstruktur dekomprimiert wurde). Das ist nicht zwingend, bei Installation in anderen Verzeichnissen sind die nachfolgend gemachten Angaben zu den Verzeichnissen entsprechend zu modifizieren. Arbeiten mit der integrierten Entwicklungsumgebung von MS-Visual-C++ 5.0 unter Windows 95 und Windows NT (deutschsprachige Version): ------------------------------------------------------ Es wird angenommen, dass die Standard-Einstellung "Debug" im MS-Developer-Studio gewaehlt wurde. Das ist nicht zwingend. Es ist jedoch dringend zu empfehlen, Library und Beispiel-Programme im gleichen Modus zu erzeugen (entweder "Debug" oder "Release"). 1.) Erzeugen der Library CGIW.lib Mit folgenden Befehlen im "Developer Studio" kann z. B. die Library CGIW.lib erzeugt werden (Annahme: Der Quellcode aller Funktionen befindet sich in einem Verzeichnis class): * Datei | Neu , * in der "Neu"-Dialog-Box wird die "Karteikarte Projekte" in den Vordergrund geholt, * im linken Fenster wird der Projekt-Typ "Win32 Static Library" gewaehlt, * im Feld, das mit "Pfad:" ueberschrieben ist, wird das Verzeichnis class eingestellt, in dem sich alle Quellcode-Dateien fuer die CGIW-Library befinden, z. B.: C:\CGIW\class, * im Feld "Projektname:" wird CGIW eingetragen, * die "Neu"-Dialog-Box wird ueber "OK" verlassen, dabei wird automatisch ein Subdirectory CGIW unter dem Verzeichnis class erzeugt, * Projekt | Dem Projekt hinzufuegen | Dateien..., * in der sich oeffnenden "Dateien in Projekt einfuegen"-Dialog-Box befindet man sich zunaechst im Projekt-Directory CGIW, in dem keine Dateien angezeigt werden, durch Anklicken des Buttons mit dem nach oben gerichteten abgewinkelten Pfeil wechselt man in das Verzeichnis class, dort werden alle Dateien ausgewaehlt (am schnellsten durch Anklicken der ersten Datei Appel_md.cpp, Scrollen nach rechts, bis die letzte Datei Xyv2w_gi.cpp sichtbar ist, die bei gleichzeitig gedrueckter Strg- und Shift-Taste angeklickt wird), wenn alle Dateien gekennzeichnet sind und im Feld "Dateiname:" angezeigt werden, wird der "OK"-Button angeklickt, * Projekt | Einstellungen..., * in der sich oeffnenden Dialog-Box "Projekteinstellungen" ("Karteikarte Allgemein") wird im Feld "Microsoft Foundation Classes:" eine Einstellung "MFC verwenden" ausgewaehlt, die Dialogbox wird mit "OK" geschlossen, * Erstellen | CGIW.lib erstellen (schneller durch Anklicken des Buttons mit den abwaerts gerichteten Pfeilen), und Compiler und Library-Manager erzeugen die Library CGIW.lib, die sich mit den oben vorausgesetzten Annahmen dann im Verzeichnis C:\CGIW\class\CGIW\Debug befindet. 2.) Erzeugen des Beispiel-Programms Mtharea2 Mit folgenden Befehlen im "Developer Studio" kann z. B. das Programm Mtharea2.exe erzeugt werden (Annahme: Der Quellcode aller Funktionen befindet sich in einem Verzeichnis Mtharea2). Das Erzeugen der anderen Beispiel- Programme erfolgt nach dem gleichen Schema: * Datei | Neu , * in der "Neu"-Dialog-Box wird die "Karteikarte Projekte" in den Vordergrund geholt, * im linken Fenster wird der Projekt-Typ "Win32 Application" gewaehlt, * empfehlenswert ist, in dem Feld, das mit "Pfad:" ueberschrieben ist, das UEBERGEORDNETE Verzeichnis von Mtharea2 einzustellen, also z. B.: C:\CGIW, * im Feld "Projektname:" wird Mtharea2 eingetragen, so dass im Feld "Pfad:" schliesslich z. B. C:\CGIW\Mtharea2 steht, * die "Neu"-Dialog-Box wird ueber "OK" verlassen, * Projekt | Dem Projekt hinzufuegen | Dateien..., * in der sich oeffnenden "Dateien in Projekt einfuegen"-Dialog-Box befindet man sich im Projekt-Directory Mtharea2, in dem die vier Dateien Mtharea2.cpp, Mtharea2.h, Mtharea2.rc und Resource.h angezeigt werden, die alle dem Projekt hinzugefuegt werden muessen (am schnellsten durch Anklicken der ersten Datei Mtharea2.cpp, anschliessend die letzte Datei resource.h bei gleichzeitig gedrueckter Strg- und Shift-Taste anklicken), wenn alle Dateien gekennzeichnet sind und im Feld "Dateiname:" angezeigt werden, wird der "OK"-Button angeklickt, * ausserdem muss die CGIW-Library dem Projekt hinzugefuegt werden, also noch einmal: Projekt | Dem Projekt hinzufuegen | Dateien..., * in der sich oeffnenden "Dateien in Projekt einfuegen"-Dialog-Box befindet man sich im Projekt-Directory Mtharea2, die (wie oben beschrieben erzeugte) Library befindet sich aber in einem benachbarten Verzeichnis, in das man z. B. so "browsen" kann: Anklicken des abgewinkelten nach oben gerichteten Pfeils, und man landet im uebergeordneten Verzeichnis (z. B. C:\CGIW), Doppelklick auf Verzeichnis class, in dem u. a. das Verzeichnis Cgiw angezeigt wird, Doppelklick auf Cgiw, und das Verzeichnis Debug wird sichtbar, Doppelklick auf Debug, und man befindet sich in dem Verzeichnis, in dem die Library erzeugt wurde, die allerdings nicht zu sehen ist, weil unter "Dateityp:" der eingestellte Filter die lib-Dateien nicht enthaelt, * Umstellen des Filters im Feld "Dateityp:" auf Bibliothekdateien (.lib), und die Datei CGIW.lib wird sichtbar, Doppelklick auf CGIW.lib fuegt diese dem Projekt hinzu und schliesst gleichzeitig die Dialog-Box, * Projekt | Einstellungen..., * in der sich oeffnenden Dialog-Box "Projekteinstellungen" ("Karteikarte Allgemein") wird im Feld "Microsoft Foundation Classes:" eine Einstellung "MFC verwenden" ausgewaehlt, die Dialogbox wird mit "OK" geschlossen, * Erstellen | Mtharea2.exe erstellen (schneller durch Anklicken des Buttons mit den abwaerts gerichteten Pfeilen), und Compiler und Linker erzeugen das Programm Mtharea2.exe, das sich mit den oben vorausgesetzten Annahmen dann im Verzeichnis C:\CGIW\Mtharea2\Debug befindet, * Erstellen | Ausfuehren von Mtharea2.exe (schneller mit Strg-F5 oder durch Anklicken des Buttons mit dem roten Ausrufezeichen), und das Programm wird gestartet. Arbeiten mit der integrierten Entwicklungsumgebung von MS-Visual-C++ 6.0 unter Windows 95 und Windows NT (deutschsprachige Version): ------------------------------------------------------ Es wird angenommen, dass die Standard-Einstellung "Debug" im MS-Developer-Studio gewaehlt wurde. Das ist nicht zwingend. Es ist jedoch dringend zu empfehlen, Library und Beispiel-Programme im gleichen Modus zu erzeugen (entweder "Debug" oder "Release"). 1.) Erzeugen der Library CGIW.lib Mit folgenden Befehlen im "Developer Studio" kann z. B. die Library CGIW.lib erzeugt werden (Annahme: Der Quellcode aller Funktionen befindet sich in einem Verzeichnis class): * Datei | Neu , * in der "Neu"-Dialog-Box wird die "Karteikarte Projekte" in den Vordergrund geholt, * im linken Fenster wird der Projekt-Typ "Win32-Bibliothek (statische)" gewaehlt, * im Feld, das mit "Pfad:" ueberschrieben ist, wird das Verzeichnis class eingestellt, in dem sich alle Quellcode-Dateien fuer die CGIW-Library befinden, z. B.: C:\CGIW\class, * im Feld "Projektname:" wird CGIW eingetragen, * die "Neu"-Dialog-Box wird ueber "OK" verlassen, dabei wird automatisch ein Subdirectory CGIW unter dem Verzeichnis class erzeugt, * es oeffnet sich eine Dialog-Box "Win32-Bibliothek (statische) - Schritt 1 von 1", in der "MFC-Unterstuetzung" angekreuzt wird, danach wird der Button "Fertigstellen" angeklickt, * die sich oeffnende Dialog-Box "Informationen zum neuen Projekt" wird mit "OK" geschlossen, * Projekt | Dem Projekt hinzufuegen | Dateien..., * in der sich oeffnenden "Dateien in Projekt einfuegen"-Dialog-Box befindet man sich zunaechst im Projekt-Directory CGIW, in dem keine Dateien angezeigt werden, durch Anklicken des Buttons mit dem nach oben gerichteten abgewinkelten Pfeil wechselt man in das Verzeichnis class, dort werden alle Dateien ausgewaehlt (am schnellsten durch Anklicken der ersten Datei Appel_md.cpp, Scrollen nach rechts, bis die letzte Datei Xyv2w_gi.cpp sichtbar ist, die bei gleichzeitig gedrueckter Strg- und Shift-Taste angeklickt wird), wenn alle Dateien gekennzeichnet sind und im Feld "Dateiname:" angezeigt werden, wird der "OK"-Button angeklickt, * Projekt | Einstellungen..., * in der sich oeffnenden Dialog-Box "Projekteinstellungen" ("Karteikarte Allgemein") wird im Feld "Microsoft Foundation Classes:" eine Einstellung "MFC verwenden" ausgewaehlt, die Dialogbox wird mit "OK" geschlossen, * Erstellen | CGIW.lib erstellen (schneller durch Anklicken des Buttons mit den abwaerts gerichteten Pfeilen), und Compiler und Library-Manager erzeugen die Library CGIW.lib, die sich mit den oben vorausgesetzten Annahmen dann im Verzeichnis C:\CGIW\class\CGIW\Debug befindet. 2.) Erzeugen des Beispiel-Programms Mtharea2 Mit folgenden Befehlen im "Developer Studio" kann z. B. das Programm Mtharea2.exe erzeugt werden (Annahme: Der Quellcode aller Funktionen befindet sich in einem Verzeichnis Mtharea2). Das Erzeugen der anderen Beispiel- Programme erfolgt nach dem gleichen Schema: * Datei | Neu, * in der "Neu"-Dialog-Box wird die "Karteikarte Projekte" in den Vordergrund geholt, * im linken Fenster wird der Projekt-Typ "Win32 Anwendung" gewaehlt, * empfehlenswert ist, in dem Feld, das mit "Pfad:" ueberschrieben ist, das UEBERGEORDNETE Verzeichnis von Mtharea2 einzustellen, also z. B.: C:\CGIW, * im Feld "Projektname:" wird Mtharea2 eingetragen, so dass im Feld "Pfad:" schliesslich z. B. C:\CGIW\Mtharea2 steht, * die "Neu"-Dialog-Box wird ueber "OK" verlassen, * in der sich oeffnenden Dialog-Box "Win32-Anwendung - Schritt 1 von 1" wird die Voreinstellung "Ein leeres Projekt" akzeptiert, es wird der Button "Fertigstellen" angeklickt, * die sich oeffnende Dialog-Box "Informationen zum neuen Projekt" wird mit "OK" geschlossen, * Projekt | Dem Projekt hinzufuegen | Dateien..., * in der sich oeffnenden "Dateien in Projekt einfuegen"-Dialog-Box befindet man sich im Projekt-Directory Mtharea2, in dem die vier Dateien Mtharea2.cpp, Mtharea2.h, Mtharea2.rc und Resource.h angezeigt werden, die alle dem Projekt hinzugefuegt werden muessen (am schnellsten durch Anklicken der ersten Datei Mtharea2.cpp, anschliessend die letzte Datei resource.h bei gleichzeitig gedrueckter Strg- und Shift-Taste anklicken), wenn alle Dateien gekennzeichnet sind und im Feld "Dateiname:" angezeigt werden, wird der "OK"-Button angeklickt, * ausserdem muss die CGIW-Library dem Projekt hinzugefuegt werden, also noch einmal: Projekt | Dem Projekt hinzufuegen | Dateien..., * in der sich oeffnenden "Dateien in Projekt einfuegen"-Dialog-Box befindet man sich im Projekt-Directory Mtharea2, die (wie oben beschrieben erzeugte) Library befindet sich aber in einem benachbarten Verzeichnis, in das man z. B. so "browsen" kann: Anklicken des abgewinkelten nach oben gerichteten Pfeils, und man landet im uebergeordneten Verzeichnis (z. B. C:\CGIW), Doppelklick auf Verzeichnis class, in dem u. a. das Verzeichnis Cgiw angezeigt wird, Doppelklick auf Cgiw, und das Verzeichnis Debug wird sichtbar, Doppelklick auf Debug, und man befindet sich in dem Verzeichnis, in dem die Library erzeugt wurde, die allerdings nicht zu sehen ist, weil unter "Dateityp:" der eingestellte Filter die lib-Dateien nicht enthaelt, * Umstellen des Filters im Feld "Dateityp:" auf Bibliothekdateien (.lib), und die Datei CGIW.lib wird sichtbar, Doppelklick auf CGIW.lib fuegt diese dem Projekt hinzu und schliesst gleichzeitig die Dialog-Box, * Projekt | Einstellungen..., * in der sich oeffnenden Dialog-Box "Projekteinstellungen" ("Karteikarte Allgemein") wird im Feld "Microsoft Foundation Classes:" eine Einstellung "MFC verwenden" ausgewaehlt, die Dialogbox wird mit "OK" geschlossen, * Erstellen | Mtharea2.exe erstellen (schneller durch Anklicken des Buttons mit den abwaerts gerichteten Pfeilen), und Compiler und Linker erzeugen das Programm Mtharea2.exe, das sich mit den oben vorausgesetzten Annahmen dann im Verzeichnis C:\CGIW\Mtharea2\Debug befindet, * Erstellen | Ausfuehren von Mtharea2.exe (schneller mit Strg-F5 oder durch Anklicken des Buttons mit dem roten Ausrufezeichen), und das Programm wird gestartet.