EvtLstGroupArrange

Ereignis nach der Initialisierung einer Gruppe

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 , EvtLstGroupInit , Ereignisbefehle

Das Ereignis wird aufgerufen, nachdem eine Gruppe durch EvtLstGroupInit initialisiert wurde. Die Ausgabe der Gruppe erfolgte noch nicht. In diesem Ereignis können SubItems neu positioniert werden.

Definition des Funktionskopfes:

sub EvtLstGroupArrange
(
  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 der Deskriptor des Datensatzpuffers angegeben, über den das View des RecViews die Datensätze liest.

aGroup

Der Parameter enthält den Deskriptor der Gruppe , die angezeigt werden soll.

In diesem Ereignis hat die Gruppe die Eigenschaften ContentWidth, ContentHeight, ContentLeft und ContentTop. Die Eigenschaft ContentHeight kann beim Item und SubItem geändert werden. Sie enthalt die Höhe des Inhaltes von dem Item oder SubItem . Bei SubItems können zusätzlich die Eigenschaften ContentLeft, ContentTop und ContentWidth verändert werden. Bei Items sind die drei Eigenschaften nur lesbar. Diese Eigenschaften definieren die Position und die Breite des Items oder SubItems relativ zur Gruppe .

aViewId

Dieser Parameter enthält die Nummer des Views , das die Gruppe zur Anzeige initialisiert hat. 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. Alle anderen Eigenschaften, außer SelectorItem , SelectorSubItem , ContentWidth , ContentHeight , ContentLeft und ContentTop sowie 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.

Auf die Eigenschaften AreaLeft und AreaTop kann in diesem Ereignis nicht zugegriffen werden.

Beispiel:

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

{
  // Position des SubItem "ART.aBezeichnung" setzen
  aGroup->wpSelectorItem    # 1;
  aGroup->wpSelectorSubItem # 3;

  aGroup->wpContentLeft # 50;
  aGroup->wpContentTop  # 5;

  return(true);
}

EvtLstGroupArrange​

EvtLstGroupArrange