EvtMenuContext

Kontextmenü aktiviert

Details

Name: Typ Beschreibung
aEvt: event Ereignisinformationen
aHittest: int Hittest-Code
aItem: handle Spalte oder Gantt-Intervall
aID: int / bigint Datensatz-ID bei RecList , Zeile bei DataList
Resultat: logic Wird nicht ausgewertet
Siehe: Liste , Objekte , Ereignisbefehle

Die angegebene Prozedur wird ausgeführt, bevor das Kontextmenü geladen und angezeigt wird. Innerhalb der Ereignisprozedur kann nach Bedarf ein anderes Menü über die Eigenschaft MenuNameCntxt gesetzt werden.

Definition des Funktionskopfes:

sub EvtMenuContext
(
  aEvt                 : event;    // Ereignis
  aHittest             : int;      // Hittest-Code
  aItem                : handle;   // Spalte oder Gantt-Intervall
  aID                  : bigint;   // Rec-ID bei RecList, Zeile bei DataList
)
: logic;                           // Wird nicht ausgewertet
{
  return(true);
}

Alternativer Funktionskopf:

sub EvtMenuContext
(
  aEvt                 : event;    // Ereignis
  aHittest             : int;      // Hittest-Code
  aItem                : handle;   // Spalte oder Gantt-Intervall
  aID                  : int;      // Rec-ID bei RecList, Zeile bei DataList
)
: logic;                           // Wird nicht ausgewertet
{
  return(true);
}

aEvt

In aEvt vom Typ event wird unter anderem der Deskriptor des auslösenden Objektes übergeben.

aHitTest

In diesem Parameter wird der Objekttyp angegeben, der an der Stelle der Mausposition vorliegt:

_WinHitNone: kein Objekt
_WinHitLstHeader: Spaltenkopf eines RecList -, DataList - oder RecView -Objektes
_WinHitLstView: Spalte eines RecList - oder DataList -, Anzeigebereich eines DocView - oder leerer Bereich eines RecView -Objektes
_WinHitCorner: Zwischenraum der Achsen (linke obere Ecke)
_WinHitGanttView: Ausgabebereich eines Gantt-Graphen
_WinHitIvl: Intervall -Objekt eines Gantt-Graphen
_WinHitIvlLeft: linke Seite des Intervalls eines Gantt-Graphen
_WinHitIvlRight: rechte Seite des Intervalls eines Gantt-Graphen
_WinHitAxis: Achse eines Gantt-Graphen
_WinHitTreeNode: Knoten -Objekt eines TreeView
_WinHitDocViewPage: Seite in einem DocView -Objekt
_WinHitGroupColumn: Spalte eines RecView -Objektes
_WinHitGroup: Gruppe eines RecView-Objektes
_WinHitCanvasView: Ausgabebereich eines Canvas -Objektes
_WinHitCanvasGraphic: CanvasGraphic -Objekt eines Canvas -Objektes

aItem

Der Übergabeparameter enthält in Abhängigkeit von dem in aHitTest übergebenen Wert den Deskriptor des angeklickten Objekts:

aHitTest: aItem
_WinHitNone: 0
_WinHitLstView: Deskriptor der Spalte , die angeklickt wurde
_WinHitLstHeader: Deskriptor der Spalte , deren Spaltenkopf angeklickt wurde
_WinHitIvl: Deskriptor des angeklickten Interval -Objektes
_WinHitIvlLeft: Deskriptor des Interval -Objektes, dessen linke Begrenzung angeklickt wurde
_WinHitIvlRight: Deskriptor des Interval -Objektes, dessen rechte Begrenzung angeklickt wurde
_WinHitAxis: Deskriptor der angeklickten Achse
_WinHitTreeNode: Deskriptor des angeklickten Knoten -Objektes
_WinHitDocViewPage: 0
_WinHitGroupColumn: Deskriptor der Spalte , die angeklickt wurde
_WinHitGroup: Deskriptor der Gruppe , die angeklickt wurde
_WinHitCanvasView: 0
_WinHitCanvasGraphic: Deskriptor des angeklickten CanvasGraphic -Objektes im Canvas -Objekt

Wurde das Ereignis bei einem RecView -Objekt mit Hittest _WinHitGroup ausgelöst, sind die Eigenschaften SelectorItem und SelectorSubItem entsprechend gesetzt, so dass auf die Eigenschaften des entsprechenden Items zugegriffen werden kann. Die Eigenschaften können nur gelesen werden.

aID

Enthält aItem einen gültigen Deskriptor auf eine Spalte oder Gruppe , wird in aID entweder die Datensatz-ID des angeklickten Datensatzes (bei den Objekten RecList , RecListPopup und RecView ) oder die Zeilennummer (bei den Objekten DataList und DataListPopup ) übergeben.

info

Wird der alternative Funktionskopf verwendet, kommt es zum Laufzeitfehler _ErrValueOverflow , wenn die zu übergebende Datensatz-ID nicht in den Wertebereich von int passt.

Enthält aItem einen gültigen Deskriptor auf ein Intervall , enthält aID den Wert, der in der Eigenschaft ID des Intervalls enthalten ist.

Enthält aItem einen gültigen Deskriptor auf eine Achse , wird in aID die Nummer der Skala-Zelle (>=0) übergeben. Liegt der Punkt, der zum Auslösen des Ereignisses führte, im Titel der Achse, wird in aID der Wert -1 übergeben.

Wurde in einem DocView -Objekt eine Seite angeklickt, wird die Seitennummer in diesem Übergabeparameter übergeben.

Resultat

Der Rückgabewert der Funktion wird nicht ausgewertet.

EvtMenuContext​

EvtMenuContext