EvtMenuCommand

Menüoption oder Toolbar-Button ausgewählt

Details

Name: Typ Beschreibung
aEvt: event Ereignisinformationen
aMenuItem: handle auslösender Menüpunkt / Toolbar-Button
Resultat: logic Wird nicht ausgewertet
Siehe: Liste , Objekte , Ereignisbefehle

Dieses Ereignis wird ausgeführt, wenn eine Schaltfläche einer Toolbar, ein Menüpunkt im Fenster oder ein Menüpunkt innerhalb eines Kontextmenüs angeklickt wurde.

info

Damit das Ereignis beim Klick auf einen Toolbar-Button ausgelöst wird, muss das Ereignis beim Frame -Objekt angegeben werden. Wird das Ereignis bei der Toolbar angegeben, reagiert es nur für das Kontextmenü.

Definition des Funktionskopfes:

sub EvtMenuCommand
(
  aEvt                 : event;    // Ereignis
  aMenuItem            : handle;   // Auslösender Menüpunkt / Toolbar-Button
)
: logic;                           // Wird nicht ausgewertet
{
  return(true);
}

aEvt

Im Parameter aEvt vom Typ event wird unter anderem der Deskriptor des auslösenden Objektes übergeben. Das Objekt entspricht demjenigen, in dem die Ereignisfunktion eingetragen wurde.

aMenuItem

aMenuItem enthält den Deskriptor des ausgewählten Menüpunktes oder der ausgewählten Schaltfläche.

Resultat

Der Rückgabewert der Funktion wird nicht ausgewertet.

Beispiel:

sub EvtMenuCommand
(
  aEvt         : event;  // Ereignis
  aMenuItem    : handle; // Menüeintrag / Toolbar-Button
) : logic;               // Wird nicht ausgewertet

{
  switch (aMenuItem->wpName)
  {
    // Neuanlage Datensatz
    case 'miNew'   : NewRec();
    // Fenster schließen
    case 'miClose' : Close();
    // Korrektur Datensatz
    case 'miEdit'  : ChangeRec();
    // Speichern Datensatz
    case 'miSave'  : SaveRec();
  }

  return(true);
}

EvtMenuCommand​

EvtMenuCommand