Menüs verwalten

4D - Documentation   Français   English   German   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next

Version 2003 (Geändert)


Terminologie

Die Begriffe Menübefehl und Menüzeile sind gleichbedeutend. Sie werden bei der Beschreibung der Menübefehle abwechselnd verwendet.

Menüleisten


Jede Menüleiste wird über eine Nummer und einen Namen identifiziert. Die erste Menüleiste legt 4th Dimension automatisch an, sie hat die Nummer 1 und lautet standardmäßig Menüleiste # 1. Wollen Sie eine Menüleiste umbenennen, klicken Sie im Menüeditor unter Windows bei gedrückter Strg-Taste, auf MacOS bei gedrückter Befehlstaste auf den Menünamen. Der Name muss einmalig sein und kann bis zu 31 Zeichen lang sein.

Die gleiche Menüleiste kann verschiedene Funktionen haben, je nachdem welche Operationen ausgeführt werden sollen.

Wollen Sie nicht, dass Ihre Anwendung mit der Menüleiste 1 gestartet wird, definieren Sie in der Datenbankmethode On Startup über den Befehl MENU BAR die gewünschte Menüleiste.

Jeder Menüzeile können Sie eine Projektmethode oder eine Standardaktion zuweisen. Die Projektmethode wird ausgeführt, sobald die Menüzeile ausgewählt wurde. Weisen Sie einer Menüzeile keine Projektmethode zu und der Anwender wählt diese Zeile aus, verlässt 4th Dimension die Runtimeumgebung und wechselt zur Benutzerumgebung. Arbeitet er mit der 4D Runtime oder hat er keinen Zugriff auf die Benutzerumgebung, wird das Programm beendet.

Über Standardaktionen können Sie Operationen ausführen, die zum System gehören (Kopieren, Beenden, etc.) oder zur 4D Datenbank (Datensatz hinzufügen, Alle auswählen, etc.)

Sie können einem Menübefehl auch eine Standardaktion und eine Projektmethode zuweisen. Dann wird die Standardaktion nie ausgeführt; 4th Dimension benutzt die Aktion jedoch, um den Menübefehl je nach Kontext zu aktivieren/deaktivieren. Ist ein Menübefehl deaktiviert, kann die zugeordnete Projektmethode nicht ausgeführt werden.

Jede Menüleiste hat standardmäßig drei Menüs, und zwar die Menüs Datei/Ablage, Bearbeiten und Modus.

Das Menü Datei/Ablage enthält nur eine Menüzeile: Beenden. Dieser ist die Standardaktion Beenden zugewiesen. Sie zeigt die Meldung "Sind Sie sicher?" an und beendet die 4D Anwendung bei Bestätigen dieses Fensters. Andernfalls wird die Aktion abgebrochen.

Sie können das Menü umbenennen und weitere Menübefehle hinzufügen. Dabei sollte Beenden immer die letzte Zeile im Menü sein.

Hinweis: Auf Mac OS X wird der Menübefehl mit der zugewiesenen Aktion Beenden automatisch in das Menü der Anwendung gelegt, wenn die Datenbank auf diesem System ausgeführt wird.

Das Menü Bearbeiten enthält standardmäßig die Zeilen zum Bearbeiten. Jeder Zeile ist eine Standardaktion zugewiesen, z.B. Ausschneiden, Kopieren. Sie können weitere Menübefehle hinzufügen oder die Aktionen über eigene Methoden verwalten.

Das Menü Modus enthält die Menübefehle Design, Benutzer und Runtime. Darüber können Sie von der Runtimeumgebung aus auf die verschiedenen 4D Umgebungen zugreifen.

4th Dimension verwaltet standardmäßig die Systemmenüs Hilfe, Apple (MacOS) und Anwendung (MacOS X). Die Menüzeile Über 4th Dimension®… können Sie mit dem Befehl SET ABOUT an Ihre Anwendung anpassen. Die anderen Menüzeilen lassen sich nicht verändern.

Warnung: Menüleisten arbeiten auf Interprozessebene, d.h. jede Änderung spiegelt sich in allen Prozessen wieder, die diese Menüleiste verwenden.

Nummern für Menüs und Menübefehle


Wie die Menüleisten werden auch die Menüs von links nach rechts durchnumeriert. Daher hat das Menü Datei/Ablage die Nummer 1, das folgende die Nummer 2 usw.. Diese Numerierung ist z.B. für die Funktion Menu selected von Bedeutung. Wird ein Menü mit einem Formular zugeordnet, ist die Nummerierung anders. Das erste angehängte Menü beginnt mit der Nummer 2049, die anderen Menüs werden um 1 hochgezählt.

Die Menüzeilen werden ebenfalls von oben nach unten durchnumeriert. Das oberste Menü beginnt mit 1.

Verbundene Menüleisten


Sie können einem Formular eine Menüleiste zuweisen. Rufen Sie dazu auf der Seite Allgemein die Formulareigenschaften auf. Wir nennen solche Menüleisten im folgenden "Formularmenüleiste". Ist eine Menüleiste mit einem Formular verbunden, werden ihre Menüs bei Aufruf des entsprechenden Formulars der aktuellen Menüleiste angefügt. Sie können Menüs in Eingabeformularen der Benutzer- und Runtime-Umgebung sowie in Ausgabeformularen der Runtime-Umgebung zuweisen.

Wird ein Formular mit einer eigenen Menüleiste angezeigt, sind die Befehle der aktuellen Menüleiste standardmäßig deaktiviert, d.h. sie können nicht gewählt werden. Dieses Verhalten können Sie ändern, wenn Sie in den Formulareigenschaften die Option "Aktive Menüleiste" markieren. In diesem Fall bleiben auch die Befehle der aktuellen Menüleiste aktiv.

In beiden Fällen bewirkt die Auswahl eines Menübefehls, dass das Ereignis On Menu Selected an die Formularmethode gesendet wird; Sie können dann mit der Funktion Menu Selected das gewählte Menü testen.

Menüzeilen per Programmierung ändern


4th Dimension bietet folgende Befehle, um eine Menüzeile hinzufügen, zu löschen, einzufügen oder zu ändern, die einem Menü der Menüleiste in einem Prozess zugeordnet ist:

ENABLE MENU ITEM

DISABLE MENU ITEM

SET MENU ITEM

SET MENU ITEM STYLE

SET MENU ITEM MARK

SET MENU ITEM

APPEND MENU ITEM

INSERT MENU ITEM

DELETE MENU ITEM

Die Reichweite dieser Befehle beschränkt sich auf den aktuellen Einsatz der Menüleiste. Sobald Sie erneut MENU BAR aufrufen, kehren die Menüs zu ihrem ursprünglichen Zustand zurück, so wie er im Menüleisteneditor der Designumgebung definiert wurde.

Diese Befehle arbeiten mit den Nummern der Menüs und der Menübefehle.

Wie bereits erwähnt, werden die Menüs von links nach rechts von 1 zu N durchnumeriert, inkl. der Trennungslinien. Normalerweise ist Datei/Ablage das erste Menü. Von dieser Numerierung ausgeschlossen sind die Systemmenüs Hilfe (Windows/MacOS), Apple (MacOS) und Anwendung (MacOS X).

Beachten Sie, dass die Funktion Count menus diese Menüs nicht mitzählt. Haben Sie beispielsweise eine Menüleiste mit den Menüs Datei/Ablage, Bearbeiten, Kunden, Rechnungen und Hilfe, gibt Count menus 4 zurück. Die von 4D vorgegebenen Systemmenüs werden ignoriert.

Menüs, die über eine Formularmenüleiste eingefügt werden und demnach an die aktuelle Menüleiste angehängt werden, werden von links nach rechts numeriert, beginnend mit der Nummer 2049 (2048 + 1 zu N).

Die Funktion Menu selected gibt die Nummern für Menüs und Menüzeilen nach dieser Konvention zurück.

WARNUNG: Diese Befehle können nicht auf die Systemmenüs von 4D zugreifen.

Verknüpfte Menüs: Sie können Menüs mit Menüleisten verknüpfen. Ändern Sie ein verknüpftes Menü mit einem der oben beschriebenen Befehle, wirkt sich das auf alle anderen Instanzen dieses Menüs aus. Weitere Informationen dazu finden Sie im Handbuch 4th Dimension Designmodus.


4D - Documentation   Français   English   German   4D Programmiersprache, Befehle nach Themen   4D Programmiersprache, Befehle alphabetisch   4D Programmiersprache, Konstanten nach Themen   Back   Previous   Next