EvtJob

Die angegebene Prozedur wird ausgeführt, wenn in einer parallel ausgeführten Prozedur die Funktion ``JobEvent() aufgerufen wird. Dabei sind zwei verschiedene Szenarien möglich:

1. Der Aufruf von ``JobEvent() erfolgt in einem Job, das Ereignis wird dann in dem Dialog ausgelöst, welcher auf Seite des Jobstarters bei JobOpen() angegeben wurde.

2. Der Aufruf von ``JobEvent() erfolgt auf der Seite des Jobstarters, das Ereignis wird dann in dem Dialog ausgelöst, welcher auf Seite des Jobs mittels JobControl() und der Option _JobEventReceiver angegeben wurde.

Definition des Funktionskopfes:

sub EvtJob
(
  aEvt                 : event;    // Ereignis
  aJobHdl              : handle;   // JobControl- oder Job-Objekt
)
: logic;                           // Wird nicht ausgewertet
{
  return(true);
}

aEvt

Die Funktion hat einen Übergabeparameter vom Typ event. In aEvt wird unter anderem der Deskriptor des auslösenden Objektes, d. h. das Objekt, in dem die Ereignisfunktion eingetragen wurde, übergeben.

aJobControl

Deskriptor des ``JobControl()- oder des Job-Objektes, je nachdem ob der Ereignis auf Seite des Jobstarters (JobControl()-Objekt) oder auf Seite des Jobs (Job-Objekt) ausgelöst wird. Es ist zu beachten, dass die beiden Objekttypen teilweise unterschiedliche Eigenschaften haben.

Resultat

Der Rückgabewert der Funktion wird nicht ausgewertet.

Beispiel

sub EvtJob
(
  aEvt                 : event;    // Ereignis
  aJobHdl              : handle;   // JobControl- oder Job-Objekt
)
: logic;                           // Wird nicht ausgewertet

{
  switch (aJobHdl->spJobStatus)
  {
    case ... :
    {
      ...
    }
  }

  return(true);
}