home *** CD-ROM | disk | FTP | other *** search
/ ST-Computer Leser 1998 October / STC_CD_10_1998.iso / BASE / AVPROTO / AV.H next >
Text File  |  1998-09-26  |  11KB  |  452 lines
  1. /*
  2.  * Hinweis:
  3.  * Dieser Text wurde automatisch aus dem beiliegenden Hypertext
  4.  * generiert und enthält die für Programmierer wichtigen defines
  5.  * sowie zu jeder Nachricht eine Kurzbeschreibung zu deren Aufbau
  6.  */
  7.  
  8.  
  9.  
  10. /*
  11.  * AV_PROTOKOLL
  12.  * msg[3]   = Bitfeld
  13.  *                Bit 0:  VA_SETSTATUS
  14.  *                Bit 1:  VA_START
  15.  *                Bit 2:  AV_STARTED
  16.  *                Bit 3:  VA_FONTCHANGED
  17.  *                Bit 4:  Quoting
  18.  *                Bit 5:  VA_PATH_UPDATE
  19.  *            Alle anderen Bits sind für Erweiterungen reserviert und
  20.  *            sollten daher mit 0 vorbesetzt werden.
  21.  * msg[4]   = 0 (reserviert)
  22.  * msg[5]   = 0 (reserviert)
  23.  * msg[6/7] = Pointer auf den Accessorynamen, wie er bei appl_find benutzt
  24.  *            werden mu₧; also 8 Zeichen lang und nullterminiert. Wer auf
  25.  *            der sicheren Seite sein will, trägt den Namen komplett in Gro₧-
  26.  *            buchstaben ein.
  27.  */
  28. #define AV_PROTOKOLL 0x4700
  29.  
  30.  
  31. /*
  32.  * VA_PROTOSTATUS
  33.  * msg[3]   = Bitfeld
  34.  *                Bit 0   AV_SENDKEY
  35.  *                Bit 1   AV_ASKFILEFONT
  36.  *                Bit 2   AV_ASKCONFONT, AV_OPENCONSOLE
  37.  *                Bit 3   AV_ASKOBJECT
  38.  *                Bit 4   AV_OPENWIND
  39.  *                Bit 5   AV_STARTPROG
  40.  *                Bit 6   AV_ACCWINDOPEN, AV_ACCWINDCLOSED
  41.  *                Bit 7   AV_STATUS, AV_GETSTATUS
  42.  *                Bit 8   AV_COPY_DRAGGED
  43.  *                Bit 9   AV_PATH_UPDATE, AV_WHAT_IZIT, AV_DRAG_ON_WINDOW
  44.  *                Bit 10  AV_EXIT
  45.  *                Bit 11  AV_XWIND
  46.  *                Bit 12  VA_FONTCHANGED
  47.  *                Bit 13  AV_STARTED
  48.  *                Bit 14: Versteht und benutzt Quoting von Dateinamen
  49.  *                Bit 15: AV_FILEINFO, VA_FILECHANGED
  50.  * msg[4]:        Bit 0:  AV_COPYFILE, VA_FILECOPIED
  51.  *                Bit 1:  AV_DELFILE, VA_FILEDELETED
  52.  *                Bit 2:  AV_VIEW, VA_VIEWED
  53.  *                Bit 3:  AV_SETWINDPOS
  54.  *                Bit 4:  erlaubt Anlegen symbolischer Links mit AV_COPYFILE
  55.  * msg[5]   = 0 (reserviert)
  56.  * msg[6/7] = Pointer auf den Programmnamen, wie er bei appl_find benutzt
  57.  *            werden mu₧; also 8 Zeichen lang und nullterminiert. Wer auf der
  58.  *            sicheren Seite sein will, trägt den Namen komplett in Gro₧buch-
  59.  *            staben ein.
  60.  */
  61. #define VA_PROTOSTATUS 0x4701
  62.  
  63.  
  64. /*
  65.  * AV_GETSTATUS
  66.  */
  67. #define AV_GETSTATUS 0x4703
  68.  
  69.  
  70. /*
  71.  * AV_STATUS
  72.  * msg[3/4] = Pointer auf einen String, der keine Steuerzeichen enthalten
  73.  *            darf und nicht länger als 256 Zeichen sein darf. Dieser
  74.  *            Pointer darf allerdings NULL sein.
  75.  */
  76. #define AV_STATUS 0x4704
  77.  
  78.  
  79. /*
  80.  * VA_SETSTATUS
  81.  * msg[3/4] = Pointer auf einen String, der keine Steuerzeichen enthält.
  82.  *            Dieser Pointer kann allerdings NULL sein, dann war
  83.  *            kein Status gespeichert.
  84.  */
  85. #define VA_SETSTATUS 0x4705
  86.  
  87.  
  88. /*
  89.  * AV_SENDKEY
  90.  * msg[3] = Tastaturstatus (ev_mmokstate, also SHIFT, CTRL, ALT...)
  91.  * msg[4] = ASCII/Scancode der gedrückten Taste (ev_mkreturn)
  92.  */
  93. #define AV_SENDKEY 0x4710
  94.  
  95.  
  96. /*
  97.  * VA_START
  98.  * msg[3/4] = Pointer auf eine Kommandozeile, der auch NULL sein kann.
  99.  *            In der Kommandozeile stehen Pfade oder Dateinamen.
  100.  */
  101. #define VA_START 0x4711
  102.  
  103.  
  104. /*
  105.  * AV_ASKFILEFONT
  106.  */
  107. #define AV_ASKFILEFONT 0x4712
  108.  
  109.  
  110. /*
  111.  * VA_FILEFONT
  112.  * msg[3] = Dateifontnummer (font id)
  113.  * msg[4] = Dateifontgrö₧e (in points)
  114.  */
  115. #define VA_FILEFONT 0x4713
  116.  
  117.  
  118. /*
  119.  * AV_ASKCONFONT
  120.  */
  121. #define AV_ASKCONFONT 0x4714
  122.  
  123.  
  124. /*
  125.  * VA_CONFONT
  126.  * msg[3] = Consolefontnummer (font id)
  127.  * msg[4] = Consolefontgrö₧e (in points)
  128.  */
  129. #define VA_CONFONT 0x4715
  130.  
  131.  
  132. /*
  133.  * AV_ASKOBJECT
  134.  */
  135. #define AV_ASKOBJECT 0x4716
  136.  
  137.  
  138. /*
  139.  * VA_OBJECT
  140.  * msg[3/4] = Namen aller selektierten Dateien, durch Leerzeichen von-
  141.  *            einander getrennt. Falls keine Objekte selektiert sind, so
  142.  *            kann dieser Pointer NULL sein.
  143.  */
  144. #define VA_OBJECT 0x4717
  145.  
  146.  
  147. /*
  148.  * AV_OPENCONSOLE
  149.  */
  150. #define AV_OPENCONSOLE  0x4718
  151.  
  152.  
  153. /*
  154.  * VA_CONSOLEOPEN
  155.  * msg[3] = 0            -> Console wurde nicht geöffnet
  156.  *          anderer Wert -> Console ist jetzt offen und liegt vorne
  157.  */
  158. #define VA_CONSOLEOPEN 0x4719
  159.  
  160.  
  161. /*
  162.  * AV_OPENWIND
  163.  * msg[3/4] = Pfad für das Fenster
  164.  * msg[5/6] = Wildcard für darzustellende Dateien.
  165.  */
  166. #define AV_OPENWIND 0x4720
  167.  
  168.  
  169. /*
  170.  * VA_WINDOPEN
  171.  * msg[3] = 0            -> Fenster konnte nicht geöffnet werden
  172.  *          anderer Wert -> Fenster ist jetzt offen und liegt vorne
  173.  */
  174. #define VA_WINDOPEN 0x4721
  175.  
  176.  
  177. /*
  178.  * AV_STARTPROG
  179.  * msg[3/4] = Programmname mit kompletten Pfad; kann auch eine beliebige
  180.  *            Datei sein, für die der Empfänger dann die zugehörige
  181.  *            Applikation startet
  182.  * msg[5/6] = Kommandozeile (kann NULL sein)
  183.  * msg[7]   = Beliebiges 16-Bit Wort, das in VA_PROGSTART wieder
  184.  *            zurückgeliefert wird.
  185.  */
  186. #define AV_STARTPROG 0x4722
  187.  
  188.  
  189. /*
  190.  * VA_PROGSTART
  191.  * msg[3] = 0            -> Programm wure nicht gestartet
  192.  *          anderer Wert -> Programm wurde gestartet
  193.  * msg[4] = Returncode des gestarteten Programms (so vorhanden)
  194.  * msg[7] = 16-Bit Wort aus AV_STARTPROG
  195.  */
  196. #define VA_PROGSTART 0x4723
  197.  
  198.  
  199. /*
  200.  * AV_ACCWINDOPEN
  201.  * msg[3] = AES-Handle des geöffneten Fensters
  202.  */
  203. #define AV_ACCWINDOPEN 0x4724
  204.  
  205.  
  206. /*
  207.  * VA_DRAGACCWIND
  208.  * msg[3]   = AES-Handle des Fensters
  209.  * msg[4]   = X-Position der Maus
  210.  * msg[5]   = Y-Position der Maus
  211.  * msg[6/7] = Pointer auf einen String, der die Namen der Objekte enthält.
  212.  */
  213. #define VA_DRAGACCWIND 0x4725
  214.  
  215.  
  216. /*
  217.  * AV_ACCWINDCLOSED
  218.  * msg[3] = AES-Handle des Fensters
  219.  */
  220. #define AV_ACCWINDCLOSED 0x4726
  221.  
  222.  
  223. /*
  224.  * AV_COPY_DRAGGED
  225.  * msg[3]   = Tastaturstatus (Alternate, Control, Shift)
  226.  * msg[4/5] = Pointer auf einen String, der den Namen des Zielobjektes
  227.  *            enthält. Dies mu₧ ein Pfad sein!
  228.  */
  229. #define AV_COPY_DRAGGED 0x4728
  230.  
  231.  
  232. /*
  233.  * VA_COPY_COMPLETE
  234.  * msg[3] = Wenn hier ein Wert ungleich Null steht, dann wurde
  235.  *          wirklich etwas kopiert oder verschoben.
  236.  */
  237. #define VA_COPY_COMPLETE 0x4729
  238.  
  239.  
  240. /*
  241.  * AV_PATH_UPDATE
  242.  * msg[3/4] = Pointer auf den absoluten Pfad
  243.  */
  244. #define AV_PATH_UPDATE 0x4730
  245.  
  246.  
  247. /*
  248.  * AV_WHAT_IZIT
  249.  * msg[3] = X-Koordinate
  250.  * msg[4] = Y-Koordinate
  251.  */
  252. #define AV_WHAT_IZIT 0x4732
  253.  
  254.  
  255. /*
  256.  * VA_THAT_IZIT
  257.  * msg[3]   = ID der zuständigen Applikation
  258.  * msg[4]   = Typ des Objektes
  259.  *             Unbekannt: 0
  260.  *             Mülleimer: 1
  261.  *             Shredder : 2
  262.  *             Clipboard: 3
  263.  *             Datei    : 4
  264.  *             Ordner   : 5
  265.  *             Laufwerk : 6
  266.  *             Fenster  : 7
  267.  *             (alle anderen für Erweiterungen reserviert.)
  268.  * msg[5+6] = Zeiger auf den Namen des Objektes (oder NULL, falls nicht
  269.  *            vorhanden)
  270.  */
  271. #define VA_THAT_IZIT    0x4733
  272. #define VA_OB_UNKNOWN   0
  273. #define VA_OB_TRASHCAN  1
  274. #define VA_OB_SHREDDER  2
  275. #define VA_OB_CLIPBOARD 3
  276. #define VA_OB_FILE      4
  277. #define VA_OB_FOLDER    5
  278. #define VA_OB_DRIVE     6
  279. #define VA_OB_WINDOW    7
  280.  
  281.  
  282. /*
  283.  * AV_DRAG_ON_WINDOW
  284.  * msg[3]   = X-Position, wohin die Maus gezogen wurde
  285.  * msg[4]   = Y-Position, wohin die Maus gezogen wurde
  286.  * msg[5]   = Tastaturstatus (Shift,Control,Alternate)
  287.  * msg[6/7] = Pointer auf einen String, der die Namen der Objekte enthält.
  288.  */
  289. #define AV_DRAG_ON_WINDOW 0x4734
  290.  
  291.  
  292. /*
  293.  * VA_DRAG_COMPLETE
  294.  * msg[3] = Status der Aktion. (!= 0 hei₧t, da₧ wirklich etwas
  295.  *          kopiert oder verschoben wurde.
  296.  */
  297. #define VA_DRAG_COMPLETE 0x4735
  298.  
  299.  
  300. /*
  301.  * AV_EXIT
  302.  * msg[3] = AES-ID des Senders
  303.  */
  304. #define AV_EXIT 0x4736
  305.  
  306.  
  307. /*
  308.  * AV_STARTED
  309.  * msg[3/4] = Der Pointer aus der VA_START Nachricht.
  310.  */
  311. #define AV_STARTED 0x4738
  312.  
  313.  
  314. /*
  315.  * VA_FONTCHANGED
  316.  * msg[3] = Dateifontnummer   (font id)
  317.  * msg[4] = Dateifontgrö₧e    (in points)
  318.  * msg[5] = Consolefontnummer (font id)
  319.  * msg[6] = Consolefontgrö₧e  (in points)
  320.  */
  321. #define VA_FONTCHANGED 0x4739
  322.  
  323.  
  324. /*
  325.  * AV_XWIND
  326.  * msg[3/4] = Pfad für das Fenster
  327.  * msg[5/6] = Wildcard als Filter für die Anzeige
  328.  * msg[7]   = Bitmaske  0x0001 - toppe evtl. vorhandenes Fenter
  329.  *                      0x0002 - Wildcard soll nur selektieren
  330.  *                             - alle anderen Bits auf 0 setzen!
  331.  */
  332. #define AV_XWIND 0x4740
  333.  
  334.  
  335. /*
  336.  * VA_XOPEN
  337.  * msg[3] = Gibt an, ob das Fenster geöffnet werden konnte.
  338.  *          (Word 3 == 0 (nein) != 0 (ja))
  339.  */
  340. #define VA_XOPEN 0x4741
  341.  
  342.  
  343. /*
  344.  * AV_VIEW
  345.  * msg[3/4]: Zeiger auf den Namen der anzuzeigenden Datei (es ist nur
  346.  *           EINE einzelne Datei zulässig!)
  347.  * msg[5-7]: reserviert, immer 0
  348.  */
  349. #define AV_VIEW 0x4751
  350.  
  351.  
  352. /*
  353.  * VA_VIEWED
  354.  *  msg[3]  : 0=Fehler, 1=Alles ok
  355.  *  msg[4-7]: reserviert, immer 0
  356.  */
  357. #define VA_VIEWED 0x4752
  358.  
  359.  
  360. /*
  361.  * AV_FILEINFO
  362.  * msg[3/4]: Zeiger auf Datei oder Ordnernamen. Mehrere Dateien/Ordner
  363.  *           werden durch Leerzeichen getrennt. Ordner MÜSSEN mit ab-
  364.  *           schliessendem '\' übergeben werden!
  365.  * msg[5-7]: reserviert, immer 0
  366.  */
  367. #define AV_FILEINFO 0x4753
  368.  
  369.  
  370. /*
  371.  * VA_FILECHANGED
  372.  * msg[3/4]: Zeiger auf die Namen der Dateien/Ordner, die bei
  373.  *           AV_FILEINFO übergeben wurden, wobei natürlich einige
  374.  *           Dateien/Ordner neue Namen haben können
  375.  *           Beispiel: Es wurde 'C:\ANNA.TXT C:\AUTO\' übergeben.
  376.  *                     Der Benutzer ändert 'ANNA.TXT' in 'ANNELIE.TXT'
  377.  *                     um. Als Ergebnis erhält man dann in dieser
  378.  *                     Message den String 'C:\ANNELIE.TXT C:\AUTO\'
  379.  * msg[5-7]: reserviert, immer 0
  380.  */
  381. #define VA_FILECHANGED 0x4754
  382.  
  383.  
  384. /*
  385.  * AV_COPYFILE
  386.  * msg[3/4]: Zeiger auf die Quelldateie(n) und -Ordner, durch Leer-
  387.  *           stellen getrennt, Order mit abschliessendem '\'
  388.  * msg[5/6]: Zeiger auf den Zielordner
  389.  * msg[7]  : Bit 0:    Originale löschen (verschieben)
  390.  *           Bit 1:    Kopien umbenennen
  391.  *           Bit 2:    Ziel kommentarlos überschreiben
  392.  *           Bit 3:    Nur symbolische Links der Quellen erzeugen
  393.  *                     (Bit 0 ist dann bedeutungslos)
  394.  *           Bit 3-15: reserviert, immer 0
  395.  */
  396. #define AV_COPYFILE 0x4755
  397.  
  398.  
  399. /*
  400.  * VA_FILECOPIED
  401.  * msg[3]  : 0=Fehler, 1=Alles Ok
  402.  * msg[4-7]: reserviert, immer 0
  403.  */
  404. #define VA_FILECOPIED 0x4756
  405.  
  406.  
  407. /*
  408.  * AV_DELFILE
  409.  * msg[3/4]: Zeiger auf die zu löschenden Dateie(n)/Ordner, durch Leer-
  410.  *           stellen getrennt, Order mit abschliessendem '\'
  411.  * msg[5-7]: reserviert, immer 0
  412.  */
  413. #define AV_DELFILE 0x4757
  414.  
  415.  
  416. /*
  417.  * VA_FILEDELETED
  418.  *  msg[3]  : 0=Fehler, 1=Alles Ok
  419.  *  msg[4-7]: reserviert, immer 0
  420.  */
  421. #define VA_FILEDELETED 0x4758
  422.  
  423.  
  424. /*
  425.  * AV_SETWINDPOS
  426.  * msg[3]:  Position X
  427.  * msg[4]:  Position Y
  428.  * msg[5]:  Breite
  429.  * msg[6]:  Höhe
  430.  * msg[7]:  reserviert, immer 0
  431.  */
  432. #define AV_SETWINDPOS 0x4759
  433.  
  434.  
  435. /*
  436.  * VA_PATH_UPDATE
  437.  * msg[3/4]: Zeiger auf das Verzeichnis, immer mit '\' abgeschlossen
  438.  * msg[5-7]: reserviert, immer 0
  439.  */
  440. #define VA_PATH_UPDATE 0x4760
  441.  
  442.  
  443. /*
  444.  * AV_SENDKLICK
  445.  * msg[3]: ev_mmox
  446.  * msg[4]: ev_mmoy
  447.  * msg[5]: ev_mmobutton
  448.  * msg[6]: ev_mmokstate
  449.  * msg[7]: ev_mbreturn
  450.  */
  451. #define AV_SENDKLICK 0x4709
  452.