+---------------------------------------------------------+
|                                                         |
| Quick'n'Easy                                            |
| Contact-List				                  |
|						          |
| - Readme                                                |
|                                                         |
|                                                         |
| Copyright by Jens Boos 2009                             |
|                                                         |
|                                                         |
| www.jb-electronics.de                                   |
|                                                         |
|                                                         |
| Entwicklungsszeit: 16.07.09 - 18.07.09                  |
|                                                         |
|                                                         |
| Inhalt:     1. Allgemeine Hinweise                      |
|                                                         |
|             2. Bedienung                                |
|                a. Navigation                            |
|                   i  Benutzen der Buttons               |
|                   ii Benutzen der Tastatur              |
|                b. Neuen Kontakt erstellen               |
|                c. Kontake brearbeiten                   |
|                                                         |
|             3. Danksagungen                             |
|                                                         |
|             4. Kontakt                                  |
|                                                         |
+---------------------------------------------------------+


1. Allgemeine Hinweise

   Quick'n'Easy Contact-List (im weiteren als QnE bezeichnet) stellt eine einfache Kontaktdatenverwaltung dar.
   QnE ist Freeware; somit darf das Programm beliebig oft kopiert und weitergegeben werden. Das bedeutet jedoch nicht,
   dass der Quellcode beliebig verndert und weitergegeben werden darf. Die Weitergabe dieses Programms muss inklusive
   aller Dateien erfolgen, und setzt voraus, dass smtlicher Inhalt unbearbeitet bleibt. In diesen Inhalt ist auch diese
   Readme einbezogen.

   Programmiert wurde QnE in freeBASIC 0.20.0b

   Das Programm heit nicht umsonst Quick'n'Easy (englisch fr "schnell und einfach"); es stellt rudimentre FUnktionen
   zur persnlichen Kontaktverwaltung bereit. zu jedem Kontakt lassen sich folgende Informationen speichern:

      - Name, Vorname
      - ein Bild (beliebiges Format)
      - die Festnetznummer
      - die Handynummer
      - die Emailadresse
      - die Adresse (zweizeilig, dazu spter mehr)
      - der Geburtstag
      - Sonstiges (fr andere Informationen)

   Das Programm besteht nur aus einem einzigen lnglichen Fenster, um nicht zu viel Platz auf dem Bildschirm wegzunehmen.
   Oben ist das Logo zu sehen, direkt darunter ist der Bereich "Daten" angesiedelt, in dem zu oberst das Bild des aktuellen
   Kontakts zu sehen ist. Unter dem Bild folgen die Kontaktdaten in Textboxen.



2. Bedienung

   a. Navigation

      Um nun zwischen den Kontakten zu wechseln, gibt es verschiedene Mglichkeiten:

      i Benutzen der Buttons

      Mit Hilfe der Pfeilbuttons, die Sie rechts und links unten in den Ecken finden, knenn sie durch die Kontakte, die
      alphabetisch sortiert sind, blttern.

      Neben jeder Textbox finden sich sogenannte Toggel-Buttons. Wenn Sie z.B. den Button neben der Email-Adresse anklicken,
      verbleibt er auch nach Loslassen der Maustaste gedrckt. Auf den Buttons steht "CB", was fr Clipboard steht. Wenn
      er dieser Buttons aktiviert ist, werden die Daten des entsprechenden Textfeldes in die Zwischenablage kopiert. Wenn
      Sie mehrere Daten bentigen, klicken Sie die anderen Buttons auch an. Mit Hilfe der Toggel-Buttons kann man so die
      Datenfelder beliebig kombinieren. Um einen Toggel-Button wieder zu deaktivieren, gengt ein weiterer Klick. 

      ii Benutzen der Tastatur

      Wenn Sie zu einem bestimmten Buchstaben im Alphabet wollen, reicht es, den entsprechenden Buchstaben auf der Tastatur
      zu drcken, QnE wird den ersten Kontakt mit diesem Anfangsbuchstaben anzeigen. Auerdem gibt es folgende Tasten-
      belegungen:

         - Pos1: Springt zum ersten Kontakt
         - Ende: Springt zum letzten Kontakt
         - PgDn: Springt zum nchsten Buchstaben im Alphabet
         - PgUp: Springt zum vorherigen Buchstaben im Alphabet
         - Entf: Lscht den aktuellen Kontakt
         - F5: Ldt alle Kontaktdaten neu nach
         - ESC: Beendet QnE

   b. Neuen Kontakt erstellen

      Smtliche Kontaktdaten sind im Order "Meine Kontakte" abgespeichert. Um einen neuen Kontakt zu erstellen, gehen Sie
      wiefolgt vor: Nehmen wir zunchst den Namen "Bart Simpson" an, erstellen Sie im "Meine Kontakte"-Ordner einen neuen
      Ordner, den Sie anschlieend in "Simpson, Bart" umbenennen. Anhand seines Ordnernamens wird der Kontakt nachher
      alphabetisch einsortiert, daher sollte die Schreibweise Name, Vorname verwendet werden.

      Um nun Daten hinzuzufgen, starten Sie einfach das Programm QnE.exe. Den Ordnernamen finden Sie in der Liste schon
      wieder, allerdings ohne Bild (bzw. dem "Kein Foto"-Platzhalter) und ohne Daten, bis auf den Namen, der vom Ordner
      abgeleitet ist. Die Daten sind in der Datei "daten.txt" angeordnet nach folgendem Muster:

      [Titel]
      Inhalt

      Es ist wichtig, dass zwischen Titel und Inhalt keine Leerzeile eingefgt ist. Ein Konkretes Beispiel ist:

      [Name]
      Homer Simpson

      [Festnetz]
      555-2918

      So ist eine Datei aufgebaut. WICHTIG: Die Datei mit den Daten muss auch im entsprechenden Ordner angespeichert werden,
      siehe oben. Eine Besonderheit ist die Adresszeile:
   
      [Adresse]
      Musterstr. 12
      D-10101 Berlin

      Dem Adresstitel folgen zwei Zeilen.

      Ganz unten ist der Titel [Bild] zu finden. Um ein Bild einem Kontakt hinzuzufgen, reicht es, wenn Sie das Bild in
      den Ordner des Kontakts kopieren. Als Bildtypen sind BMP, GIF, JPEG, PNG und viele mehr erlaubt. Das Bild wird auch
      automatisch auf die passende Gre skaliert. Sie mssen unter [Bild] nichts hinzufgen, beim ersten Start erkennt QnE
      automatisch, wenn ein Bild im Verzeichnis des Kontaktes liegt, und ldt es automatisch. Sie mssen aber kein Bild
      hinzufgen; denn wenn kein Bild vorhanden ist, zeigt QnE spter nur einen "Kein Foto"-Platzhalter als Bild an. Wenn
      Sie ein Bild zu einem spteren Zeitpunkt hinzufgen wollen, kopieren Sie es einfach in den Ordner, es wird beim
      nchsten Start oder druch F5 automatisch erkannt. Oder Sie fgen das Bild manuell hinzu, mehr dazu jetzt in c.

   c. Kontake bearbeiten

      Wenn Sie nun einen Kontakt erstellt haben, knnen Sie QnE starten und sich den Kontakt ansehen. Wenn Daten gendert
      werden sollen, gehen Sie wiefolgt vor. Doppelklicken Sie zum ndern des Bildes auf das Kontaktbild, ein Auswahldialog
      ffnet sich, mit der sie die Bilddatei auswhlen knnen. Wenn Sie das Fenster schlieen, ohne eine Auswahl gettigt
      zu haben, bleibt Ihr altes Bild selbstverstndlich gespeichert.

      Wollen Sie die Kopntaktdaten ndern, so doppelklicken Sie bitte auf die Textboxen (egal wo). Notepad ffnet sich mit
      der entsprechenden Datei "daten.txt". Nehmen Sie die nderungen vor, und speichern Sie sie in Notepad ab.
      WICHTIG: Danach bitte F5 drcken, um die genderten Daten neu einzuladen. Wenn F5 nicht gedrckt wird, werden die
               nderungen bei Programmende wieder mit den alten Dateien berschrieben.

      Wenn Ihnen das Verwalten der Kontakte etwas zu ungewhnlich vorkommt, nehmen Sie sich Zeit und schauen Sie sich die
      Beispielkontakte noch einmal grndlich an, es ist sehr logisch aufgebaut. Es wurde bewusst keine Eingaberoutine im-
      plementiert, um das Programm so einfach bedienbar wie mglich zu halten - denn schlielich soll es in der Praxis ja
      auch seinem Namen alle Ehre machen.



3. Danksagungen

   Ohne die FreeImage.dll und die Codeschnipsel von Volta zur Portierung FreeImageBitmap <-> FBImage wre dieses Projekt
   nie mglich gewesen. Daher an dieser Stelle ein ausdrckliches Dankeschn an alle Programmierer, die durch ihre
   unermdliche Arbeit Open-Source-Projekte entwickeln und fr jeden benutzbar machen.



4. Kontakt

   Falls Sie Kommentare oder Fragen zu QnE selbst haben, knnen Sie mich gerne kontaktieren.
   Schreiben Sie einfach eine Email an webmaster@jb-electronics.de!

   Mehr Informationen zu QnE finden Sie auf www.jb-electronics.de.

   Und nun wnsche ich Ihnen viel Spa mit QnE!
 
   Jens Boos