Dieses Blockkommando bildet die Struktur für eine einfache Eingabemaske welche aus einem Hinweistext, Eingabefeldern, Auswahlfeldern und weiteren Dialogkomponenten zusammengesetzt werden kann. Der Dialog selber besteht aus 3 Teilen. Am oberen Drittel des Dialogs befindet sich das Textpanel in dem ein allg. Einleitungstext definiert werden kann, in der Mitte befindet sich das Contentpanel mit den eigentlichen Dialogkomponenten und am unteren Ende des Dialogs befindet sich das Buttonpanel mit den beiden Buttons „OK“ und „Abbrechen“. Zur Positionierung der einzelnen Dialogkomponenten innerhalb des Dialogs werden als Basis für Breitenangaben die durchschnittliche Zeichenbreite und als Basis für Höhenangaben die durchschnittliche Zeichenhöhe verwendet. Zudem kann die Positionierung und das Setzen von Abmessungen der Dialogkomponenten auch über eine tabellenartige Struktur definiert werden (siehe Kommando „Dialog Spaltenbreiten setzen“) oder über zuvor festgelegte Tabulatoren (siehe Kommando „Dialog Tabulatoren-X (horizontal) setzen“ und Kommando „Dialog Tabulatoren-Y (vertikal) setzen“).
Parameter:
- Titel: (optional) Der Titel, welcher in der Dialogmaske visualisiert wird.
- Text: (optional) Hier kann ein Hinweistext angegeben werden, welcher oben im Textpanel angezeigt wird.
- Dimensionierungseinheit: (optional) Die Einheit, in welcher die nachfolgenden Parameter Maske-Breite, Maske-Höhe, Maske-X, Maske-Y, Rand-X und Rand-Y eingegeben werden können. Die Standardeinheit ist DU (Dialog-Unit). Das bedeutet in horizontaler Richtung (DU_X) die Durchschnittsbreite eines Zeichens des gewählten Zeichensatzes und in vertikaler Richtung (DU_Y) die Durchschnittshöhe eines Textfeldes gemäss des gewählten Zeichensatzes plus gewählter Zeilenabstand. Optional können auch Pixel gewählt werden.
- Maske-Breite: (optional) Bestimmt die Breite der Dialogmaske gemäß der gewählten Dimensionierungseinheit. Bleibt dieser Parameter ohne Wert, dann wird die Breite intern berechnet (empfohlen).
- Maske-Höhe: (optional) Bestimmt die Höhe der Dialogmaske gemäß der gewählten Dimensionierungseinheit. Bleibt dieser Parameter ohne Wert, dann wird die Höhe intern berechnet (empfohlen).
- Maske-X: (optional) Bestimmt die X-Koordinaten des oberen linken Punktes auf dem Bildschirm gemäß der gewählten Dimensionierungseinheit. Bleiben dieser Parameter ohne Wert, dann wird automatisch Positioniert (zentriert auf dem Bildschirm – empfohlen).
- Maske-Y: (optional) Bestimmt die Y-Koordinaten des oberen linken Punktes auf dem Bildschirm gemäß der gewählten Dimensionierungseinheit. Bleiben dieser Parameter ohne Wert, dann wird automatisch Positioniert (zentriert auf dem Bildschirm – empfohlen).
- Rand-X: (optional) Bestimmt die X-Koordinate des oberen linken Punktes des Dialogcontentpanels. Bleiben diese Parameter ohne Wert, dann gilt: Rand-X = 2 DU_X, Rand-Y = 1 DU_Y
- Rand-Y: (optional) Bestimmt die Y-Koordinate des oberen linken Punktes des Dialogcontentpanels. Bleiben diese Parameter ohne Wert, dann gilt: Rand-X = 2 DU_X, Rand-Y = 1 DU_Y
- Zeichengrösse: (optional) Bestimmt die Grössen von DU_X und DU_Y. Bleibt der Parameter ohne Wert, werden DU_X und DU_Y gemäss Zeichensatz „Arial“, Grösse 12 bestimmt.
- Textpanel-, Contentpanel- und Buttonpanelfarbe: (optional) Bestimmen die Hintergrundfarben der obengenannten Panels.
- Rasteranzeige: (optional) Bei „Ja“ wird eine Taste visualisiert, welche den Raster des Dialogs anzeigt und als Hilfe für die Positionierung der Dialogfelder dient.
Wenn in die Struktur Dialog ein Kommando eingefügt wird, erscheinen zusätzliche Kommandos für die Dialogkomponenten und Layouteinstellungen.