Version 11
Dynamic pop up menu (Menü{; Standard{; xKoord{; yKoord}}}) EintragRef
Parameter | Typ | Beschreibung | |
Menü | MenüRef | Menüreferenz | |
Standard | EintragRef | Referenz des standardmäßig ausgewählten Eintrags | |
xKoord | Numerisch | X Koordinate der oberen linken Ecke | |
yKoord | Numerisch | Y Koordinate der oberen linken Ecke | |
Funktionsergebnis | EintragRef | Referenz des gewählten Menüeintrags |
Beschreibung
Die Funktion Dynamic pop up menu zeigt ein hierarchisches PopUp-Menü an der aktuellen Mausposition oder an der Position, die durch die optionalen Parameter xKoord und yKoord festgelegt wird.
Sie müssen das hierarchische Menü zuvor mit der neuen Funktion Create menu erstellen. Die von Create menu zurückgegebene Referenz wird dann im Parameter Menü übergeben.
Dieser Befehl wird, in Übereinstimmung mit den geltenden Regeln für die Oberfläche, in der Regel durch einen rechten Mausklick oder längeres Drücken der Maustaste (z.B. Kontextmenü) aufgerufen.
Der optionale Parameter Standard ermöglicht, einen Eintrag im PopUp-Menü als Standardauswahl festzulegen, immer wenn das Menü erscheint. In diesem Parameter übergeben Sie eine Referenz auf den Menüeintrag. Diese müssen Sie zuvor über den Befehl SET MENU ITEM REFERENCE definiert haben.
Übergeben Sie diesen Parameter nicht, wird standardmäßig der erste Eintrag im Menü ausgewählt.
Über die optionalen Parameter xKoord und yKoord können Sie die Position des anzuzeigenden PopUp-Menüs angeben. Hier übergeben Sie jeweils die waagrechten und senkrechten Koordinaten der oberen linken Ecke des Menüs. Die Koordinaten müssen im lokalen Koordinatensystem des aktuellen Formulars in Pixel angegeben werden. Beide Parameter müssen zusammen übergeben werden; ist nur einer überge-ben, wird er ignoriert.
Wollen Sie ein PopUp-Menü anzeigen, das einer 3D Schaltfläche zugewiesen ist, übergeben Sie diese Parameter nicht. In diesem Fall berechnet 4D automatisch die Position des Menüs in Bezug auf die Schaltfläche gemäß den Oberflächen-Standards der aktuellen Plattform.
Wurde ein Menüeintrag ausgewählt, gibt der Befehl dessen Referenz zurück, und zwar so, wie sie mit dem neuen Befehl SET MENU ITEM REFERENCE definiert wurde. Sonst gibt die Funktion einen leeren String zurück.
Hinweis: Mit der vorhandenen Funktion Pop up menu im Kapitel "Benutzeroberfläche" können Sie PopUp-Menüs erstellen, die auf Text basieren.
Referenz
Get menu item reference, Get selected menu item reference, Pop up menu, SET MENU ITEM REFERENCE.