EvtPageSelect

Notebook-Seite selektieren

Details

Name: Typ Beschreibung
aEvt: event Ereignisinformationen
aPage: handle Deskriptor der Notizbuchseite
aSelecting: logic Seite aufgerufen / verlassen
aPageNew: handle Deskriptor der nächsten Notizbuchseite (optional)
Resultat: logic Aktion durchführen?
Siehe: Liste , Objekte , Ereignisbefehle

Das Ereignis wird von dem Objekt Notebook ausgelöst, wenn eine Notebook-Seite aufgerufen oder die aktuelle Seite verlassen wird.

Definition des Funktionskopfs:

sub EvtPageSelect
(
  aEvt                 : event;    // Ereignis
  aPage                : handle;   // Notebook-Seite
  aSelecting           : logic;    // Seite aktiviert / deaktiviert
  aPageNew             : handle;   // Notebook-Seite, die aktiv wird (optional)
) 
: logic;                           // Aktion durchführen?
{
  return(true);
}

aEvt

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

aPage

Der Deskriptor der aktivierten oder deaktivierten Notebook-Seite.

aSelecting

Gibt an, ob eine Seite aufgerufen oder verlassen wurde. Das Ereignis wird zuerst von der Seite ausgelöst, die verlassen werden soll (sofern vorhanden) und dann von der Seite, die aufgerufen werden soll (bevor diese sichtbar wird).

aPageNew

Der Parameter enthält den Deskriptor auf das NotebookPage -Objekt, das als nächstes aktiviert wird. Der Deskriptor wird nur übertragen, wenn in aSelecting false übergeben wurde. Kann keine weitere Notizbuchseite aktiviert werden, ist aPageNew =0.

Die Funktionsdeklaration ohne aPageNew ist ebenfalls möglich.

Resultat

Über den Rückgabewert kann entschieden werden, ob der Vorgang (aufrufen oder verlassen) durchgeführt (true) werden soll oder nicht (false).

Beispiel:

sub EvtPageSelect
(
  aEvt       : event;  // Ereignis
  aPage      : handle; // Notebook-Seite
  aSelecting : logic;  // Seite aufrufen / verlassen
  aPageNew   : handle; // Seite die aktiv wird (optional)
) : logic;             // Aktion durchführen?

{
  if (aSelecting)
  {
    // Beim Aufrufen der Seite
    switch (aPage->wpName)
    {
      case 'Page1' : ...
      case 'Page2' : ...
    }
  }
  else
  {
    // Beim Verlassen der Seite
    switch (aPage->wpName)
    {
      case 'Page1' : ...
      case 'Page2' : ...
    }
  }

  return(true);
}

EvtPageSelect​

EvtPageSelect