EvtLstGroupInit

Ereignis vor Gruppenanzeige

Details

Name: Typ Beschreibung
aEvt: event Ereignisinformationen
aRecBuf: handle Datensatzpuffer
aGroup: handle Gruppe
aViewId: int Nummer des Views
Resultat: logic Wird nicht ausgewertet
Siehe: Liste , Objekte , Ereignisbefehle , Ereignisabläufe RecView

Das Ereignis wird aufgerufen, wenn eine Gruppe zum ersten Mal angezeigt werden soll (z. B. weil der Anwender diese in den sichtbaren Bereich scrollt), oder sie nicht mehr im Cache des RecView vorhanden ist. Die Ausgabe der Gruppe erfolgte noch nicht. In diesem Ereignis kann die Veränderung der Feldinhalte, das Lesen von verknüpften Dateiinhalten, das Anpassen der Itemfarbe in der aktuellen Gruppe usw. erfolgen.

Definition des Funktionskopfes:

sub EvtLstGroupInit
(
  aEvt                 : event;    // Ereignis
  aRecBuf              : handle;   // Datensatzpuffer
  aGroup               : handle;   // Gruppe
  aViewId              : int;      // Nummer des Views
)
: 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.

aRecBuf

In aRecBuf wird eine Kopie des internen Datensatzpuffers angegeben, über den das View des RecViews die Datensätze liest. Änderungen am Inhalt des übergebenen Datensatzpuffers wirken sich nicht auf die dargestellten Daten aus.

aGroup

Der Parameter enthält den Deskriptor der Gruppe , die angezeigt werden soll. Durch Setzen der Eigenschaft ExpireTime der Gruppe kann definiert werden, wann das Ereignis EvtLstGroupInit frühestens für diese Gruppe wieder aufgerufen wird.

Weiterhin kann die Vorder- und die Hintergrundfarbe für die Gruppe mit den Eigenschaften GroupColFg und GroupColBkg gesetzt werden. Bei allen Items , bei denen die Eigenschaft ClmColFg bzw. ClmColBkg auf _WinColParent gesetzt ist, wird die jeweilige Farbe der Gruppe übernommen.

aViewId

Dieser Parameter enthält die Nummer des Views , das die Gruppe zur Anzeige initialisiert. Ein RecView kann über die Eigenschaft SplitStyle in bis zu vier Views geteilt werden. Dadurch kann eine unterschiedliche Darstellung der Items und SubItems pro View erreicht werden.

Resultat

Der Rückgabewert der Funktion wird nicht ausgewertet.

Besonderheiten

Um ein Item oder SubItem auszuwählen, müssen die Eigenschaften SelectorItem und SelectorSubItem gesetzt werden. Anschließend können die Eigenschaften des Items beziehungsweise SubItems geändert werden.

info

Während dieses Ereignisses ist eine Veränderung des RecView -Objektes nicht zulässig. Eigenschaften und Befehle, die das RecView , die Columns oder SubColumns verändern würden, lösen den Laufzeitfehler _ErrHdlInvalid aus. Das Abfragen von Eigenschaften sowie der Aufruf von WinInfo () sind zulässig.

Die Eigenschaft Caption... kann bei den Items mit dem jeweiligen Typ direkt gesetzt werden. Somit werden keine Hilfsfelder mehr benötigt. Die Eigenschaft ContentSource muss dazu auf _WinContentSourceField gesetzt sein.

Beispiel:

sub EvtLstGroupInit
(
  aEvt                 : event;    // Ereignis
  aRecBuf              : handle;   // Datensatzpuffer
  aGroup               : handle;   // Gruppe
  aViewId              : int;      // Nummer des Views
)
: logic;                           // Wird nicht ausgewertet

{
  // Subitem "ART.aBezeichnung" auf _WinColLightRed setzen, 
  // wenn Artikel-Bezeichnung die Zeichenfolge "Visual" beinhaltet
  aGroup->wpSelectorItem    # 1;
  aGroup->wpSelectorSubItem # 3;

  if (aRecBuf->ART.aBezeichnung =* '*Visual*')
  {
    aGroup->wpClmColFg # _WinColLightRed;
  }

  return(true);
}

EvtLstGroupInit​

EvtLstGroupInit