[GuiDialog]

[GuiDialog]

Muss beim Dialog selbst hinterlegt sein. Die angegebenen Prozeduren (CallBacks) werden bei den entsprechenden Ereignissen für den Dialog ausgeführt, aber nicht bei den Ereignissen für die einzelnen Objekte des Dialogs (s. dazu Sektion GuiCBControl). Evtl. hinterlegte Prozedurangaben (CallBack) zu jedem Ereignis im GRIT-Editor werden ignoriert !

Der erste Parameter enthält den Namen der Prozedur (CallBack), der zweite die Parameter für diese Routine.

CBClose = Name, Parameter

CBCreate = Name, Parameter

Prozedur (CallBack) für Create-Ereignis (siehe zum Beispiel Stammdatenverwaltung). Standardmäßig ist im CGW das Create-Ereignis durch unsere Sibdef-Definitionen belegt !

CBDefault = Name, Parameter

Ereignis z.B. durch Doppelklick oder Enter in Listbox

CBDestroy = Name, Parameter

Prozedur (CallBack) für Destroy-Ereignis. Ohne Angabe kommt Meldung, dass kein Schließen zulässig ist.

CBFocusIn = Name, Parameter

CBFocusOut = Name, Parameter

CBPrepare = Name, Parameter

Zunächst für Auskunftssystem

CBPreShow = Name, Parameter

Dieses Ereignis wird unmittelbar vor der Anzeige eines Dialogs bzw. Controls ausgelöst. Zu diesem Zeitpunkt ist das betroffene Objekt bereits existent und in der Verwaltung aufgenommen, aber noch nicht mit Daten (z.B. aus einem Programmpuffer) versorgt. Das Ereignis kann zum Beispiel zum direkten Füllen einer Auswahlliste genutzt werden (siehe auch 15.02 infra-Prozedur CBgGuiFillControl).

Gegenüber dem CBCreate- oder CBPrepare-Ereignis wird das CBPreShow-Ereignis auch dann ausgelöst, wenn ein Dialog oder Control temporär unsichtbar war und erneut angezeigt wird.

Hinweis:

Das Ereignis wird vom Listengenerator benutzt.

CBSelect = Name, Parameter

Ereignis z.B. durch Klick oder Pfeil in Listbox (Selektieren)

CBShow = Name, Parameter

EventsOnActiveFrame = Yes (Default: No)

Zum besseren Verständnis siehe Sektion [GuiFramePatch].

Sobald ein Dialog (Masterframe) ein oder mehrere Patchdialoge enthält, ist es u.U. notwendig, Ereignisse, die durch die Bedienung des Masterframes erzeugt werden (z.B. Betätigung von Schaltflächen, Schließen des Masterframes o.ä.), an den zur Zeit aktiven Patchdialog weiterzureichen. Nur dadurch ist sichergestellt, dass die betroffenen Benutzerinteraktionen auch vom Programm verarbeitet werden und nicht vom System blockiert werden. Dieser Eintrag kann auch direkt bei Schaltflächen (Sektion [GuiPush]) oder Menüeinträgen (Sektion [GuiMenu]) hinterlegt werden, wenn nur die Bedienungsereignisse dieses einzelnen Controls an den aktiven Dialog weitergeleitet werden sollen.

KeepToolbar = Yes (Default: No)

Dieser Eintrag verhindert, dass die Symbolleiste des betroffenen Dialogs in der Symbolleiste des infra-Hauptfensters angezeigt wird. Stattdessen wird die Symbolleiste unter der Titelleiste des Dialogs angezeigt. Standardmäßig werden Symbolleisten nur im infra-Hauptfenster angezeigt. Ausnahme: wenn das infra Hauptfenster durch die Anzeige modaler (exklusiv bedienbarer) Dialoge nicht bedient werden kann.

NoAutoPos = Yes (Default: No)

Dieser Eintrag verhindert, dass der anzuzeigende Dialog automatisch an eine bestimmte Stelle des Bildschirms positioniert wird. Dadurch wird ebenfalls verhindert, dass der Dialog automatisch an die zuletzt gespeicherte Position verschoben wird. Diese Einstellung wird benötigt, wenn ein Programm die Position eines Dialogs vollständig selbst kontrollieren muss.

NoFocusFrame = Yes

Zunächst nur für Druckausgabedialog für Focussteuerung

NoPrfDim = Yes

Für den Dialog wird die zuletzt benutzte Höhe und Breite gespeichert (Default)

NoPrfPos = Yes

Für den Dialog wird die zuletzt benutzte Bildschirmposition gespeichert (Default)

NoQuery = Yes (Default: No)

Mit der Einstellung Yes wird verhindert, dass beim Öffnen eines Kontextmenüs innerhalb des betroffenen Dialogs, die Einträge für das Auskunftsystem in das Kontextmenü aufgenommen werden. Das ist besonders dann wichtig, wenn in ein Programm über "CBgGuiStartFrame" zusätzliche Dialoge eingebaut werden, von denen das Programm selbst nichts weiß. Ansonsten kann es zu Problemen beim Öffnen eines Kontextmenüs in derartigen Dialogen kommen, da das System zur Bereitstellung der Auskunft-Menüeinträge im Kontextmenü die Kontrolle an das jeweilige Programm übergibt.

NoRegisterDlg = Yes

Kann fehlen, Default ist "No". Bei "Yes" wird der Dialog nicht in die Liste der aktuellen Fenster eingetragen. Bei den versteckten Dialogen für "alte" Programme und die Stammdatenverwaltung Pflicht !

NoTitleModul = Yes

Die INI-Dateieinstellung TITLEMODUL in der Sektion LAYOUT kann je Dialog übersteuert werden. Bei "Yes" wird vor dem ursprünglichen Titel keine Menünummer angezeigt. Default ist "No".

NoTitlePrompt = Yes

Die INI-Dateieinstellung TITLEPROMPT der Sektion LAYOUT kann je Dialog übersteuert werden. Bei "Yes" wird vor dem ursprünglichen Titel kein Text angezeigt. Default ist "No".

NoTitleSuffix = Yes

Die INI-Dateieinstellung TITLESUFFIX der Sektion LAYOUT kann je Dialog übersteuert werden. Bei "Yes" wird nach dem ursprünglichen Titel kein Text angezeigt. Default ist "No".

Preset =

Mögliche Eingaben: ReadAlways, ReadNever, ReadFirstTime oder HideMenu

Die Angabe steuert den Vorbelegungsmechanismus (siehe dazu auch Kapitel 05.04 Vorbelegungsdateien). Dieselben Angaben wie hier im CGW können auch im Programm beim Aufruf eines Dialogs mitgegeben werden.

Die Angabe im Programm hat Vorrang!

ReadAlways

Jedes Mal, wenn der Dialog angezeigt wird, wird vorbelegt.
ReadFirstTime

Default-Wert bei Programmen mit Druckmenü. Nur beim ersten Mal, wenn der Dialog angezeigt wird, wird vorbelegt.
ReadNever

Default-Wert bei Programmen ohne Druckmenü. Es werden keine lesenden Vorbelegungsangaben ausgewertet. Bei Menüanwahl kommt Warnung.
HideMenu

Das Vorbelegungsmenü erscheint nicht. Es werden keine Vorbelegungsangaben ausgewertet.

Bei dynamischen Vorbelegungen beeinflusst die Einschränkung des Vorbelegungsverhaltens nur den lesenden Zugriff auf Vorbelegungsvariablen (das Anzeigen gespeicherter Werte). Schreibende Zugriffe - also das Speichern von Werten in dynamischen Vorbelegungsvariablen - werden dadurch nicht eingeschränkt.

PresetForModul = Yes (Default: No)

Dieser Eintrag führt dazu, dass statische Vorbelegungen nicht mehr (wie im Standard üblich) nur abhängig vom betreffenden Dialog gespeichert werden, sondern zusätzlich abhängig vom Programm (Modul) in dem der betreffende Dialog verwendet wird. Das macht dann Sinn, wenn ein Dialog in mehreren unterschiedlichen Programmen verwendet wird, zum Beispiel bei "43A Belege drucken" und "463 Rechnungen drucken".

Beispiel für Eintrag in eine SDF-Datei:

[AUF43A_1##GuiDialog]

PresetForModul=Yes

ScaleToFont = No (Default: Yes)

Dieser Eintrag verhindert, dass für den betreffenden Dialog eine Skalierung (Verkleinerung/Vergrößerung) abhängig vom verwendeten Font und den Einstellungen in der INI-Datei durchgeführt wird. D.H. der Dialog wird zur Laufzeit in der Größe angezeigt, in der er mit dem Dialogeditor erzeugt wurde (siehe auch Einträge DialogScaleFactorX, DialogScaleFactorY und FntDefault in Kapitel "Aufbau SIBPPS.INI", Sektion [LAYOUT]).