EvtChangedChild

Änderung in untergeordnetem Eingabe-Objekt

Details

Name: Typ Beschreibung
aEvt: event Ereignisinformationen
aObject: handle Auslösendes Objekt
Resultat: logic Wird nicht ausgewertet
Siehe: Liste , Objekte , Ereignisbefehle

Dieses Ereignis wird nur ausgelöst, wenn in der Eigenschaft ChangedTrigger die Ausprägung _WinChgTriggerChild gesetzt ist.

Erfolgt in einem untergeordneten Eingabe-Objekt eine Änderung, wird das Ereignis aufgerufen. Das Ereignis wird ebenfalls aufgerufen, wenn das entsprechende Eingabe-Objekt über ein Ereignis EvtChanged verfügt.

Durch Setzen der Eigenschaft ChangedTrigger kann das Ereignis auch beim prozeduralen Ändern der Caption-Eigenschaft oder beim Übertragen der Feldpuffer in das Objekt ausgelöst werden.

Wird das Ereignis für das Fenster-Objekt ausgelöst, wird die Eigenschaft ChangedChild auf den Wert true gesetzt. Über diese Eigenschaft kann an einer unabhängigen Stelle (zum Beispiel beim EvtClicked oder EvtClose) festgestellt werden, ob mindestens ein Eingabe-Objekt verändert wurde. Die Eigenschaft kann jederzeit zurückgesetzt werden.

Definition des Funktionskopfes:

sub EvtChangedChild
( 
  aEvt                 : event;    // Ereignis
  aObject              : handle;   // Geändertes 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.

aObject

aObject enthält den Deskriptor des geänderten Eingabe-Objekts.

Resultat

Der Rückgabewert der Funktion wird nicht ausgewertet.

Beispiel:

sub EvtChangedChild
( 
  aEvt                 : event;    // Ereignis
  aObject              : handle;   // Geändertes Objekt
)
: logic;                           // Wird nicht ausgewertet

{
  switch (aObject->wpName)
  {
    case 'edfiCstId' : 
    {
      // Anwender hat den Inhalt des Objekts geändert
      ...
    }
    ...
  }
  return(true);
}

EvtChangedChild​

EvtChangedChild