EvtJob

EvtJob

Job-Ereignis

Details

• Name: Typ Beschreibung
• aEvt: event Ereignisinformationen
• aJobControl: handle JobControl -Objekt oder Job -Objekt
• Resultat: logic Wird nicht ausgewertet
• Siehe: Liste , Objekte , Ereignisbefehle , JobEvent () JobOpen () JobControl ()

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);
}