EvtLstDataInit

Ereignis vor Datensatzanzeige

Details

Name: Typ Beschreibung
aEvt: event Ereignisinformationen
aID: int / bigint ID des Datensatzes oder Zeilennummer
Resultat: logic Wird nicht ausgewertet
Siehe: Liste , Objekte , Ereignisbefehle , Beispiel , Ereignisabläufe RecList

Das Ereignis wird ausgelöst, wenn ein Datensatz in einem Listen-Objekt gelesen wurde. Die Ausgabe des Datensatzes erfolgte noch nicht. In diesem Ereignis kann die Veränderung der Feldinhalte, das Lesen von verknüpften Dateiinhalten, das Anpassen der Spaltenfarbe in der aktuellen Zeile usw. erfolgen.

Definition des Funktionskopfes:

sub EvtLstDataInit
(
  aEvt                 : event;    // Ereignis
  aID                  : bigint;   // Datensatz-ID oder Zeilennummer
)
: logic;                           // Wird nicht ausgewertet
{
  return(true);
}

Alternativer Funktionskopf:

sub EvtLstDataInit
(
  aEvt                 : event;    // Ereignis
  aID                  : int;      // Datensatz-ID oder Zeilennummer
)
: logic;                           // Wird nicht ausgewertet
{
  return(true);
}

aEvt

In diesem Parameter wird der Deskriptor des aufrufenden Objekts übergeben. Dabei handelt es sich um das Objekt, bei dem die Ereignisfunktion eingetragen wurde.

aID

Der Parameter enthält entweder die Datensatz-ID des gerade gelesenen Datensatzes (bei den Objekten RecList und RecListPopup ) oder die Zeilennummer (bei den Objekten DataList und DataListPopup ).

info

Wird der alternative Funktionskopf verwendet, kommt es zum Laufzeitfehler _ErrValueOverflow , wenn die zu übergebende Datensatz-ID nicht in den Wertebereich von int passt.

Resultat

Der Rückgabewert der Funktion wird nicht ausgewertet.

Änderungen der folgenden Eigenschaften beziehen sich in diesem Ereignis auf die aktuelle Zelle statt auf die gesamte Spalte:

info

Im Modern Theme Style wirken sich Änderungen der Farbeigenschaften, sowie der Eigenschaft FontAttr im EvtLstDataInit aus, sofern sich der gesetzte Wert von dem gespeicherten Wert in der Spalte unterscheidet. Wird der Wert in EvtLstDataInit auf den gespeicherten Wert gesetzt oder nicht verändert, wird die jeweilige Eigenschaft von dem Theme-Objekt verwendet. Die Eigenschaft FontAttr wirkt sich zusätzlich nur dann aus, wenn die Eigenschaft FontParent nicht gesetzt ist.

Beispiel:

sub EvtLstDataInit
(
  aEvt   : event;    // Ereignis
  aID    : bigint;   // Datensatz-ID oder Zeilennummer
) : logic;           // Wird nicht ausgewertet

{
  // Spalte "ART.aBezeichnung" auf _WinColLightRed setzen, 
  // wenn Artikel-Bezeichnung die Zeichenfolge "Visual" beinhaltet
  if (ART.aBezeichnung =* '*Visual*')
  {
    $clmART.aBezeichnung->wpClmColFg # _WinColLightRed;
  }

  return(true);
}

EvtLstDataInit​

EvtLstDataInit