Wie können wir helfen?

View Categories

2026_03 Neue Script-Functions

Zentrale Theme-Konfiguration für Dialoge und Oberflächen

Viele Scriptfunktionen im MCDMS-Framework unterstützen ein zentrales Theme-System. Damit lassen sich Farben und Schriftgrößen für Dialoge und Oberflächenelemente einmal definieren und automatisch in allen unterstützten Funktionen verwenden.
Die Einstellungen werden z.B. in der Datei SYSTEM_COLOR.INI gespeichert. Diese Datei enthält dann verschiedene Theme-Sektionen (z. B. DARK, LIGHT, ERROR) mit Farb- und Schriftdefinitionen.

Zentrale Vorteile
• Einheitliches Erscheinungsbild für alle Dialoge und Programme
• Farben und Schriftgrößen können zentral geändert werden
• Scriptfunktionen übernehmen die Theme-Werte automatisch
• Anpassung an Dark-Mode oder Light-Mode möglich

Unterstützte Scriptfunktionen
Folgende Funktionen können ein Theme verwenden:
• MCEXT.DLGTEXT
• MCEXT.DLGLIST
• MCEXT.DLGCOMBO
• MCEXT.DLGMSG
• MCEXT.GRID
(sofern aktiviert)

Diese Funktionen können optional zwei Parameter erhalten:
ThemeIniPath
ThemeMode

Beispiel:

Beispiel.mcfscr 
//Pfad und Name zur Theme-Datei
INI_COLOR={APPPATH}\CONFIG\SYSTEM_COLOR.INI
//Gewünschtes Theme
THEME="DARK"
//Übergabe der Theme-Parameter an diesen Dialog
MCEXT.DLGCOMBO{Titel,Beschreibung,{ARRAY},,400,150,{INI_COLOR},{THEME},Auswählen}

Aufbau der Theme-INI
Die Datei kann verschiedene Sektionen beinhalten, z. B.:

\CONFIG\SYSTEM_COLOR.INI 
[DARK]
FORM_BG_COLOR=#28272c
CONTROL_BG_COLOR=#3c3c3c
FONTSIZE=9
BUTTON_FONT_COLOR=#000000
TEXTBOX_FONT_COLOR=#ffffff
DESCRIPTION_FONT_COLOR=#ffffff
BUTTON_BG_COLOR=#e5007f
DGV_HEADER_FONT_COLOR=#e5007f
CONTROL_FONT_COLOR=#e5007f
CONTROL_BORDER_COLOR=#5a5a5a
CONTROL_SELECTION_BG_COLOR=#e5007f
CONTROL_SELECTION_FONT_COLOR=#ffffff
DGV_SELECTION_BG_COLOR=#e5007f
PNG_COLOR=#e5007f
MENU_SELECTION_BG_COLOR=#e5007f
MENU_SELECTION_FONT_COLOR=#ffffff
MENU_BG_COLOR=#2d2d2d
MENU_FONT_COLOR=#ffffff
MENU_BORDER_COLOR=#5a5a5a
MENU_SEPARATOR_COLOR=#5a5a5a
DGV_BG_COLOR=#202124
DGV_FONT_COLOR=#ffffff
DGV_ALTROW_BG_COLOR=#2d2d2d
DGV_SELECTION_FONT_COLOR=#000000
DGV_HEADER_BG_COLOR=#141414
DGV_GRID_COLOR=#5a5a5a
RTB_BG_COLOR=#2d2d2d
RTB_FONTCOLOR=#ffffff

Alle Farbwerte werden im HEX-Format gespeichert:
Beispiele:
#202124
#ffffff
#ff9000

Das führende # muss immer mit angegeben werden.

Automatische Anwendung
Wenn eine Scriptfunktion ein Theme verwendet:
1. Die Theme-INI wird geladen
2. Die Werte der gewählten Sektion (z. B. DARK) werden gelesen
3. Die Farben werden automatisch auf Formulare, Buttons, Menüs und Controls angewendet
Damit kann das Erscheinungsbild aller Dialoge zentral gesteuert werden, ohne einzelne Scripts ändern zu müssen.
Beispiel: Theme auswählen
Das Script SYSTEM_ERSTELLE_SYSTEM_INI.MCFSCR erzeugt die SYSTEM_COLOR.INI und ermöglicht die Auswahl verschiedener Farbvarianten, z. B.:
• Dunkel & Blau
• Dunkel & Orange
• Dunkel & Türkis
• Dunkel & Indigo
• Dunkel & Smaragd
• Dunkel & Magenta
• Dunkel & Rot
• Dunkel & MCDMS-Standard
• Standard (hell)

Neue Scriptfunktion

MCEXT.DLGCOMBO

Auswahl eines Eintrags aus einer Dropdown-Liste
Optional sortierbar
Vollständig theme-basiert
Automatische Größenanpassung (Vollbild möglich)

MCEXT.DLGLIST

Mehrfachauswahl per Checkbox
Optional mit Mindest- und Maximalanzahl
Radio-Modus (automatisch, wenn min=1 und max=1)
„Alle markieren / demarkieren“-Funktion
Horizontale Scrollbar bei langen Einträgen
Validierung der Auswahl vor Bestätigung

MCEXT.DLGTEXT

Texteingabe (ein- oder mehrzeilig)
Optionale Validierung:
– UCase/LCase
– Zahl
– Datum
– E-Mail
– freie Eingabe
– Eingabebegrenzung möglich (Zeichenmenge / Länge)
– Theme-gesteuerte Darstellung

MCEXT.OUTLOOK

Öffnet eine neue E-Mail direkt im Outlook-Dialog
Übergabe von:
– Empfänger
– Betreff
– Text
– Anhängen
Kein automatischer Versand!
Bei nicht gestartetem Outlook erfolgt ein Hinweis
Die Funktion verhält sich bewusst wie ein manueller Klick auf „Neue E-Mail“ in Outlook.

MCEXT.SENDMAIL

  • Unterstützung für TLS/STARTTLS
  • Port 587 empfohlen
  • Mehrere Anhänge möglich
  • CC und BCC optional
  • HTML oder Text
  • Ausführliche Fehlermeldungen für Anwender
  • Technische Detailmeldung für Support

MCEXT.GRID

Die Scriptfunktion MCEXT.GRID ermöglicht die Darstellung von Daten in einer komfortablen Tabellenansicht. Sie eignet sich ideal, um Listen, Datenbankergebnisse oder Auswahllisten übersichtlich darzustellen und vom Benutzer auswählen zu lassen.


Das Grid basiert auf einer DataGridView-Komponente und unterstützt zahlreiche Funktionen wie Sortierung, Zeilenauswahl und automatische Anpassung der Spaltenbreiten.

  • Funktionen
  • Anzeige strukturierter Daten in Tabellenform
  • Auswahl einzelner oder mehrerer Datensätze
  • Sortierung nach Spalten
  • Hervorhebung der aktuellen Auswahl
  • Unterstützung für große Datenmengen
  • Integration in Scripts zur Weiterverarbeitung der Auswahl
  • Theme-Unterstützung

Das Grid unterstützt – wie viele andere Dialogfunktionen – das zentrale Theme-System.
Farben und Schriftgrößen werden automatisch aus der Datei SYSTEM_COLOR.INI geladen.
Dadurch passen sich Tabellen automatisch an das gewählte Theme an, z. B.:
Dark Mode
Light Mode
individuelle Farbschemata
Dabei werden unter anderem folgende Elemente automatisch angepasst:
Hintergrundfarbe der Tabelle
Schriftfarbe der Zellen
Farben der Spaltenüberschriften
Markierungsfarben der Auswahl
Gitternetzlinien
Alternierende Zeilenfarben

Download Beispiel Script-Dialog Theme Color