Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.2.3  Der Datenaustausch über das GEM-Klemmbrett                  TOS

Um Dateien im Klemmbrett abzulegen, sollte man folgendermaßen 
vorgehen:

   ∙ alle Klemmbrett-Dateien, die auf die Maske 'scrap.*' und 
     'SCRAP.*' passen, löschen. Anmerkung: Die Maske 'SCRAP.*' muss 
     berücksichtigt werden, da alte Programme noch nichts von 
     alternativen und case-sensitiven Dateisystemen wussten.
   ∙ die abzulegenden Daten in einem oder mehreren Formaten sichern.
   ∙ die Nachricht SC_CHANGED an alle Applikationen im System, 
     SH_WDRAW an die System-Shell schicken.

Der Dateiname ist immer 'scrap.', die Namenserweiterung (Suffix) hängt 
dabei vom gewählten Format ab; nach Möglichkeit sollte immer eines der 
folgenden Standardformate unterstützt werden:

 Suffix  Bedeutung 
 gem     Vektorgrafiken im Metafile-Format 
 img     Pixelbilder im XIMG-Format 
 txt     ASCII-Textdatei, jede Zeile mit CR/LF abgeschlossen 

Zusätzlich kann man eines oder mehrere der folgenden Formate 
unterstützen (der Empfänger hat dann die Möglichkeit, das Format mit 
den meisten Informationen zu benutzen):

 Suffix  Bedeutung 
 asc     ASCII-Textdatei, jeder Absatz mit CR/LF abgeschlossen 
 csv     ASCII-Datei mit durch Kommata getrennten Zahlen 
 cvg     Calamus Vektorgrafik-Format 
 dif     Export-Datei von Tabellenkalkulationen 
 eps     Encapsulated PostScript 
 1wp     Wordplus-Format 
 rtf     Microsoft Rich Text Format 
 tex     TeX 

Das empfangende Programm sollte zunächst überprüfen, welche der 
vorhandenen Dateien die meisten Informationen enthält, und dann diese 
Datei nehmen.

Wichtig: Jede der Dateien im Klemmbrett enthält prinzipiell die 
gleichen Informationen, nur eben in einem anderen Format. Die 
Textverarbeitung Papyrus z.B. importiert 'scrap.rtf' nur dann, wenn 
das eigene Format 'scrap.pap' nicht gefunden werden konnte.

Aus den obigen Erklärungen wird ersichtlich, daß sich immer nur ein 
Datenobjekt (allerdings in verschiedenen Formaten) auf einmal im 
Klemmbrett befinden kann.

Querverweis: Klemmbrett-Funktionen   scrp_clear   Style-Guidelines