AES

Editobjekt-Funktionen

Fensterdialoge

8.7 Ereignisverwaltung

Diese Bibliothek stellt Funktionen zur Verfügung, mit deren Hilfe Ereignisse erkannt und bearbeitet werden können. Für diesen Zweck stehen die folgenden Routinen zur Verfügung:

Hinweis: Unter Ereignissen sind in diesem Fall Nachrichten, Tastaturklicks, Mausbewegungen, Zeitereignisse usw. zu verstehen.

Querverweis: AES   GEM   Style-Guidelines

8.7.1 evnt_button

8.7.1.1 Bindings für evnt_button

int16_t evnt_button (int16_t ev_bclicks, int16_t ev_bmask,
                     int16_t ev_bstate,  int16_t *ev_bmx,
                     int16_t *ev_bmy, int16_t *ev_bbutton,
                     int16_t *ev_bkstate )
{
   int_in[0] = ev_bclicks;
   int_in[1] = ev_bmask;
   int_in[2] = ev_bstate;

   crys_if (21);

   *ev_bmx     = int_out[1];
   *ev_bmy     = int_out[2];
   *ev_bbutton = int_out[3];
   *ev_bkstate = int_out[4];

   return ( int_out[0] );
}

8.7.2 evnt_dclick

8.7.2.1 Bindings für evnt_dclick

int16_t evnt_dclick (int16_t ev_dnew, int16_t ev_dgetset)
{
   int_in[0] = ev_dnew;
   int_in[1] = ev_dgetset;

   return ( crys_if(26) );
}

8.7.3 evnt_keybd

8.7.3.1 Bindings für evnt_keybd

int16_t evnt_keybd (void)
{
   return ( crys_if (20) );
}

8.7.4 evnt_mesag

8.7.4.1 Bindings für evnt_mesag

int16_t evnt_mesag (int16_t *msg)
{
   addr_in[0] = msg;
   return ( crys_if (23) );
}

8.7.5 evnt_mouse

8.7.5.1 Bindings für evnt_mouse

int16_t evnt_mouse (int16_t ev_moflags, int16_t ev_mox,
                    int16_t ev_moy, int16_t ev_mowidth,
                    int16_t ev_moheight, int16_t *ev_momx,
                    int16_t *ev_momy, int16_t *ev_mobutton,
                    int16_t *ev_mokstate)
{
   int_in[0] = ev_moflags;
   int_in[1] = ev_mox;
   int_in[2] = ev_moy;
   int_in[3] = ev_mowidth;
   int_in[4] = ev_moheight;

   crys_if (22);

   *ev_momx     = int_out[1];
   *ev_momy     = int_out[2];
   *ev_mobutton = int_out[3];
   *ev_mokstate = int_out[4];

   return (int_out[0]);
}

8.7.6 evnt_multi

8.7.6.1 Bindings für evnt_multi

int16_t evnt_multi (int16_t ev_mflags,  int16_t ev_mbclicks,
                    int16_t ev_mbmask,  int16_t ev_mbstate,
                    int16_t ev_mm1flags, int16_t ev_mm1x,
                    int16_t ev_mm1y, int16_t ev_mm1width,
                    int16_t ev_mm1height, int16_t ev_mm2flags,
                    int16_t ev_mm2x, int16_t ev_mm2y,
                    int16_t ev_mm2width, int16_t ev_mm2height,
                    int16_t *ev_mmgpbuff,
                    int16_t ev_mtlocount,
                    int16_t ev_mthicount,
                    int16_t *ev_mmox, int16_t *ev_mmoy,
                    int16_t *ev_mmbutton,
                    int16_t *ev_mmokstate,
                    int16_t *ev_mkreturn,
                    int16_t *ev_mbreturn)
{
   int_in[0]  = ev_mflags;
   int_in[1]  = ev_mbclicks;
   int_in[2]  = ev_mbmask;
   int_in[3]  = ev_mbstate;
   int_in[4]  = ev_mm1flags;
   int_in[5]  = ev_mm1x;
   int_in[6]  = ev_mm1y;
   int_in[7]  = ev_mm1width;
   int_in[8]  = ev_mm1height;
   int_in[9]  = ev_mm2flags;
   int_in[10] = ev_mm2x;
   int_in[11] = ev_mm2y;
   int_in[12] = ev_mm2width;
   int_in[13] = ev_mm2height;
   int_in[14] = ev_mtlocount;
   int_in[15] = ev_mthicount;
   addr_in[0] = ev_mmgpbuff;

   crys_if (25);

   *ev_mmox      = int_out[1];
   *ev_mmoy      = int_out[2];
   *ev_mmbutton  = int_out[3];
   *ev_mmokstate = int_out[4];
   *ev_mkreturn  = int_out[5];
   *ev_mbreturn  = int_out[6];

   return (intout[0]);
}

8.7.7 evnt_timer

8.7.7.1 Bindings für evnt_timer

int16_t evnt_timer (int16_t ev_tlocount, int16_t ev_thicount)
{
   int_in[0] = ev_tlocount;
   int_in[1] = ev_thicount;

   return ( crys_if (24) );
}

8.7.8 Nachrichten

Die Standardmessages des Screenmanagers sind wie folgt aufgebaut:

Arten der Standardmessages:

Die Unterstützung der neuen Nachrichtentypen kann per appl_getinfo (Opcode 12) erfragt werden. Für benutzerdefinierte Mitteilungen hat Digital Research übrigens Message-Nummern jenseits von 1024 vorgeschlagen.

Zur Größe des Nachrichtenpuffers:

Eine einzelne Applikation sollte unter MagiC 2.0 nicht mehr als 16 Fenster nutzen, da sonst der Nachrichtenpuffer des Systems überlaufen kann und evtl. Redraws nicht mehr ausgeführt werden können.

Querverweis: evnt_multi   evnt_mesag   AV-Protokoll   OLGA-Protokoll   Drag&Drop

8.7.9 Nachrichten-Liste

8.7.9.1 Das CAB-Protokoll

Das CAB-Protokoll besteht aus einer Reihe von AES-Messages mit deren Hilfe beliebige GEM-Programme bestimmte Aufgaben an CAB übertragen können, bzw. bestimmte Aktionen mit CAB koordinieren können.

Der Inhalt der Environment-Variablen BROWSER= (sofern definiert) enthält den Zugriffspfad von CAB. Sollte sich CAB nicht im Speicher befinden kann ein Programm über diese Variable CAB selbst nachstarten.

Eine mögliche Anwendung: Falls man im Internet weitere aktuelle Informationen oder Updates zu eigenen Programmen anbietet, könnte man mit dem CAB-Protokoll ohne großen Aufwand den Zugriff auf diese Informationen aus diesen Programmen heraus ermöglichen. CAB erledigt dann den Download der Daten und die Darstellung.

Die Beschreibung der Messages

CAB_HELLO (0xCAB8) (Nachricht von CAB)
CAB verschickt nach seinem Start an alle laufenden Programme diese Nachricht

msg[0] = 0xCAB8
msg[1] = Id von CAB
msg[2] = 0
msg[3] = Version des CAB-Protokolls (0x0100 entspricht V1.00)
msg[4] = Bitvektor mit den von CAB (CAB.OVL) unterstützten Internet-
         Protokollen
             Bit 0: HTTP
             Bit 1: FTP
             Bit 2: GOPHER
             Bit 3: WAIS
             Bit 4: MAILTO
             Bit 5: NNTP
             Bit 6: TELNET
             Bit 7-15: 0 (reserviert)
msg[5] = Bitvektor mit den von CAB unterstützten Nachrichten des
         CAB-Protokolls.
             Bit 0: CAB_VIEW
             Bit 1: CAB_MAIL, CAB_MAILSENT
             Bit 2: CAB_REQUESTSTATUS, CAB_RELEASESTATUS, CAB_STATUS,
                    CAB_EXIT
             Bit 3-15: 0 (reserviert)
msg[6] = 0
msg[7] = 0

CAB_SUPPORT (0xCABB) (Nachricht an CAB)
Wird diese Nachricht an CAB geschickt, sendet CAB die Nachricht CAB_HELLO zurück. Bleibt CAB_HELLO aus, wird noch eine alte Version von CAB benutzt welche das CAB-Protokoll noch nicht unterstützt. Alle Programme, die an den Informationen interessiert sind, die CAB_HELLO liefert, sollten nach dem Start CAB_SUPPORT an CAB senden. Wird CAB erst später gestartet, wird CAB_HELLO automatisch an das Programm geschickt.

msg[0] = 0xCABB
msg[1] = Id des PRGs
msg[2] = 0
msg[3] = 0
msg[4] = 0
msg[5] = 0
msg[6] = 0
msg[7] = 0

CAB_VIEW (0xCAB3) (Nachricht an CAB)
Ähnlich wie VA_START aber statt eines Dateinamens wird eine URL übergeben. CAB zeigt diese Datei dann an.

msg[0] = 0xCAB3
msg[1] = Id des PRGs
msg[2] = 0
msg[3] = \ Zeiger auf die URL
msg[4] = /
msg[5] = Wenn hier 1 eingetragen wurde, stellt CAB die URL in einem neuen
         Fenster dar, wenn 0 eingetragen wurde wird das oberste CAB-
         Fenster benutzt.
msg[6] = 0
msg[7] = 0

CAB_REQUESTSTATUS (0xCAB5) (Nachricht an CAB)
Kann an CAB geschickt werden, um zu erfahren ob CAB zur Zeit online oder offline ist. CAB schickt daraufhin bei jeder Änderung des On-/Offline- Statuses die Message CAB_STATUS.

msg[0] = 0xCAB5
msg[1] = Id des PRGs
msg[2] = 0
msg[3] = 0
msg[4] = 0
msg[5] = 0
msg[6] = 0
msg[7] = 0

CAB_RELEASESTATUS (0xCAB7) (Nachricht an CAB)
Sollte an CAB geschickt werden, wenn ein Programm nicht mehr an den on/offline- Informationen interessiert ist, die mit CAB_REQUESTSTATUS angefordert wurden (z.B. weil es sich beendet).

msg[0] = 0xCAB7
msg[1] = Id des PRGs
msg[2] = 0
msg[3] = 0
msg[4] = 0
msg[5] = 0
msg[6] = 0
msg[7] = 0

CAB_STATUS (0xCAB6) (Nachricht von CAB)
Wird von CAB an alle Programme verschickt, die sich mit CAB_REQUESTSTATUS angemeldet haben.

msg[0] = 0xCAB6
msg[1] = Id von CAB
msg[2] = 0
msg[3] = 1 falls CAB online; 0 falls CAB offline.
msg[4] = 0
msg[5] = 0
msg[6] = 0
msg[7] = 0

CAB_EXIT (0xCAB1) (Nachricht von CAB)
Wird von CAB an alle Programme geschickt, die sich mit CAB_REQUESTSTATUS angemeldet haben, sobald sich CAB beendet. Vorher wird auch noch ein CAB_STATUS gesendet, in dem der offline-Zustand gemeldet wird.

msg[0] = 0xCAB1
msg[1] = Id von CAB
msg[2] = 0
msg[3] = 0
msg[4] = 0
msg[5] = 0
msg[6] = 0
msg[7] = 0

CAB_MAIL (0xCAB9) (Nachricht an CAB)
Kann an CAB geschickt werden, um Mails zu verschicken.

msg[0] = 0xCAB9
msg[1] = Id des PRGs
msg[2] = 0

msg[3] = \ Zeiger auf die URL. Ein 'Betreff' (Subject) kann, durch ein
msg[4] = / Fragezeichen getrennt, direkt an die URL gehängt werden.

msg[5] = \ Zeiger auf eine Datei, die den Mailinhalt enthält oder
msg[6] = / null (dann öffnet CAB einen Editor, in dem die Mail eingegeben
           wird).

msg[7] = Bitvektor mit weiteren Optionen.
             Bit 0: 0 falls die Maildatei sofort verschickt werden soll,
                    oder 1 falls die Maildatei vom Benutzer noch in CAB
                    bearbeitet/geändert werden soll.
             Bit 1: bei 1 wird die Maildatei gelöscht, nachdem
                    sie verschickt wurde, bei 0 bleibt sie erhalten.
             Bit 2-15: 0 (reserviert)

CAB_MAILSENT (0xCABA) (Nachricht von CAB)
Wird von CAB an das Programm geschickt, welches CAB_MAIL gesendet hat und enthält Informationen, ob das Verschicken der Mail geklappt hat oder nicht.

msg[0] = 0xCABA
msg[1] = Id von CAB
msg[2] = 0
msg[3] = 1 falls die Mail ohne Fehler verschickt wurde; 0 bei Fehler (in
         diesem Fall ist in msg[4] die Fehlerursache zu erfahren).
msg[4] = Enthält eine Fehlernummer, falls msg[3]=0
              0: Keine URL angegeben.
              1: Offline, Netzverbindung gestört, Server nicht erreichbar.
              2: Benutzer hat Aktion abgebrochen (Falls die Mail in CAB
                 bearbeitet werden sollte, hat der Benutzer die
                 Möglichkeit die Aktion abzubrechen)
              3: GEMDOS-Fehler beim Zugriff auf die Maildatei.
              4: Editor zum Bearbeiten konnte nicht aufgerufen werden.
msg[5] = 0
msg[6] = 0
msg[7] = 0

Spezielle Messages für 'Cache-Tools'

CAB_CHANGED (0xCAB0) (Nachricht an/von CAB)
Der Cache (bzw. CACHE.CAB) wurde verändert und soll neu eingelesen werden.

msg[0] = 0xCAB0
msg[1] = Id von CAB/des PRGs
msg[2] = 0
msg[3] = 0
msg[4] = 0
msg[5] = 0
msg[6] = 0
msg[7] = 0

CAB_EXIT (0xCAB1) (Nachricht an/von CAB)
CAB oder das Cache-Tool beendet sich (als Info für das jeweils andere PRG)

msg[0] = 0xCAB1
msg[1] = Id von CAB/des PRGs
msg[2] = 0
msg[3] = 0
msg[4] = 0
msg[5] = 0
msg[6] = 0
msg[7] = 0

CAB_PATH (0xCAB2) (Nachricht von CAB)
Die lokalen HTML-Verzeichnisse und/oder das Cache-Verzeichnis wurde geändert. Nähere Infos sind in der Cache-Tools-Dokumentation zu erfahren.

msg[0] = 0xCAB2
msg[1] = Id von CAB
msg[2] = 0
msg[3] = 0
msg[4] = 0
msg[5] = 0
msg[6] = 0
msg[7] = 0

CAB_TERM (0xCAB4) (Nachricht von CAB)
Das Cache-Tool soll sich beenden.

msg[0] = 0xCAB4
msg[1] = Id von CAB
msg[2] = 0
msg[3] = 0
msg[4] = 0
msg[5] = 0
msg[6] = 0
msg[7] = 0

8.7.9.2 Messages from Geneva

X_MN_SELECTED (0xE000)

This message is either accompanied by the MU_MESAG bit of an evnt_multi return, or is returned by the evnt_mesag call. When this message occurs, the message buffer contains:
 

Portion	Contents
msg[0]	0xE000
msg[3]	The object index of the menu title selected
msg[4]	The object index of the selected menu item
msg[5], [6]	The object tree of the menu item selected
msg[7]	The handle of the window containing the menu

This feature is used in conjunction with the wind_set option X_WF_MENU, described in detail, below.
 

X_WM_SELECTED (0xE100)

This message is received when the user clicks on a window gadget in a window whose flags were modified with the wind_tree function. It only occurs when the X_WTFL_CLICKS attribute is off. If the user clicks on one of the normal scroll gadgets or arrows, a standard WM_ARROWED message is sent to the application. However, when the user clicks on any other gadget, an X_WM_SELECTED message is sent:
 

Portion	Contents
msg[0]	0xE100
msg[3]	The handle of the window containing the gadget
msg[4]	The object index of the window tree object the user
	clicked on

This feature is used by the Task Manager's "Keyboard..." dialog.
 

X_GET_HELP (0xE200)

This message is sent to the Help display program when the user requests help on a certain topic. The message is actually comprised of two parts. When the application sees the X_GET_HELP message, it must then use the appl_read function to get the entire remainder of the message, whether it intends to use the whole thing or not. The first part of the message is comprised of the following values:
 

Portion	Contents
msg[0]	0xE200
msg[1]	Application ID
msg[2]	Length of the second part ofthe message
msg[3]	Length of the topic portion of the message, including
	the NUL terminator
msg[4]	Length of the filename portion of the message, including
	the NUL terminator
msg[5]	Upper/lowercase sensitivity. If non-zero, the topic is
	case-sensitive.

The second part of the message contains the actual text of the topic and filename fields. This can be read with one or more calls to appl_read.
 
Example:
 

    void read_string( char *s, int max, int size )
    {
      char dummy;

      if( size<=max )               /* the whole string fits */
        appl_read( my_application_id, size, s );
      else
      {
        /* read what we can */
        appl_read( my_application_id, max-1, s);
        s[max-1] = '\0';            /* terminate the string   */
        /* now, get the remaining bytes of the string         */
        for( size=size-(max-1); size>0; size-- )
           appl_read( my_application_id, 1, &dummy );
      }
    }

    main()
    {
      int msg[8], caps_sens;
      char topic[20], filename[100];

      evnt_mesag( msg );
      switch( msg[0] )
      {
        case X_GET_HELP:
           caps_sens = msg[5];
          /* Read the topic portion */
           read_string( topic, sizeof(topic), msg[3] );
          /* Read the filename portion */
            read_string( filename, sizeof(filename). msg[4] );
          /* Do whatever with it... */

X_WM_HSPLIT (0xE400)

This message is sent to an application when the position of the horizontal split bar has changed:
 

Portion	Contents
msg[0]	0xE400
msg[1]	Application ID
msg[2]	0
msg[3]	Handle of the window being affected
msg[4]	The new offset (in pixels) of the split bar

The application is then free to either act upon this message and change the split bar position with wind_set(X_WF_HSPLIT), or to ignore the message completely.
 
See the x_wind_create function for more information.
 

X_WM_ARROWED2 (0xE600)

This message is sent to an application when the user has licked on one of the arrow or scroll bar gadgets which are not reported by the normal WM_ARROWED message. X_WM_ARROWED2 reports changes in gadgets which are below a vertical split bar and/or to the right of a horizontal split bar. The format of a X_WM_ARROWED2 message is identical to that of WM_ARROWED.
 
See the x_wind_create function for more information.
 

X_WM_HSLID2 (0xE700)

This message is sent to an application when the user has dragged the second horizontal scroll gadget, which appears to the right of a horizontal split bar. The format of this message is identical to that of WM_HSLID.
 
See the x_wind_create function for more information.
 

X_WM_VSLID2 (0xE800)

This message is sent to an application when the user has dragged the second vertical scroll gadget, which appears below a vertical split bar. The format of this message is identical to that of WM_VSLID.
 
See the x_wind_create function for more information.
 

X_WM_OBJECT (0xE900) (since Release 003)

This message type is returned to an application when it uses wind_set mode X_WF_OBJHAND to affect the manner in which window gadgets are handled.
 
If an application receives this message, it is because the object tree handler routine instructed Geneva not to process the mouse click on a window gadget as a normal event. Instead, a special message is returned to the application:
 

Portion	Contents
msg[0]	0xE900
msg[1]	Application ID
msg[2]	0
msg[3]	Handle of the window containing the object
msg[4]	Object tree index of the object which was clicked

Note that in order for Geneva to determine that the mouse has been clicked on an object in a window's tree structure, it must be of type EXIT or TOUCHEXIT. Geneva's default window gadgets already have these attributes set correctly.
 
See also: wind_set mode   X_WF_OBJHAND.
 

8.7.9.3 RSDAEMON_MSG

Der RSDAEMON ist eine parallel laufende Applikation, die die Aufgabe des Resolvers per AES-Message übernimmt. Sinn ist quasi ein nichtblockierendes gethostbyname(), allerdings liefert der RSDAEMON nur eine IP, kein ganzes hostent-struct.

Der RSDAEMON wird normalerweise automatisch von IConnect gestartet und beendet.

Nutzung:

Per appl_find("RSDAEMON") ist die App-ID zu ermitteln. Im Fehlerfall sollte man auf das blockierende gethostbyname() zurückgreifen und nur, wenn garnicht anders möglich, stattdessen mit Fehlermeldung abbrechen.

Nun kann dem RSDAEMON eine AES-Message geschickt werden:

#include <rsdaemon.h>

pbuf[0]=RSDAEMON_MSG
pbuf[1]=<eigene App-ID>
pbuf[2]=0
pbuf[3]=RSD_REQUEST_IP
pbuf[4]=<eigene frei wählbare ID, um die Antwort zuordnen zu können>
pbuf[5/6]=<Zeiger auf den String, der den Namen des Hosts enthält>
           (Ggf. Speicherschutz beachten!)

Der RSDAEMON liefert eine Antwort folgender Form:

pbuf[0]=RSDAEMON_MSG
pbuf[1]=<RSDAEMON-ID>
pbuf[2]=0

pbuf[3]=RSD_IP_UNKNOWN = IP konnte nicht ermittelt werden. Das kann
                         verschiedene Ursachen haben (User hat keinen
                         DNS eingetragen, DNS kenn den Host nicht etc.)
pbuf[4]=<hier wird die ID aus dem Request zurückgeliefert>

oder:

pbuf[3]=RSD_IP_FOUND
pbuf[4]=<hier wird die ID aus dem Request zurückgeliefert>
pbuf[5/6]=<IP des Hosts als ulong>

Und hier noch die RSDAEMON.H:

#ifndef __RSDAEMON__
#define __RSDAEMON__

#define RSDAEMON_MSG    0x995

#define RSD_REQUEST_IP  1
#define RSD_IP_FOUND    2
#define RSD_IP_UNKNOWN  3

#endif

AES

Editobjekt-Funktionen

Fensterdialoge