Show Eul Mail Dialog
Zuletzt geändert: 21.10.2026 05:32

Übersicht

Show-EulMailDialog #

ÜBERSICHT #

Zeigt einen E-Mail-Dialog (WebView2-Variante, Drop-in-Replacement für Show-MailDialog).

SYNTAX #

Show-EulMailDialog [[-From] <string>] [-ForceFrom] [[-To] <string[]>] [[-Cc] <string[]>] [[-Bcc]
    <string[]>] [[-Subject] <string>] [[-HtmlBody] <string>] [[-Attachments] <string[]>]
    [-DisplayName] [[-Conn] <__ComObject>] [[-AddressId] <int>] [-AutoClose] [[-Theme] <string>]
    [<CommonParameters>]

BESCHREIBUNG #

Neue Variante des Mail-Dialogs auf Basis des EULANDA-UI-Toolkits (WebView2 + Quill). Parameter und Return-Objekt sind identisch zu Show-MailDialog, damit ein Aufrufer ohne Code-Anpassung zwischen beiden umschalten kann.

Vorteile gegenüber Show-MailDialog (WPF + IE-WebBrowser):

  • Quill-Editor mit Mail-Toolbar (Bold/Italic/Underline/Lists/Color/Link)
  • mailHtml-Filter normalisiert Output auf Eulanda-Mail-HTML-Subset
  • helles Theme als Vorgabe, dunkles über -Theme Dark
  • F1 öffnet Mail-Hilfe im Default-Browser
  • ESC schließt sauber (Cancel-Status)
  • Modernes Layout über eul-form + eul-row + eul-card

PARAMETER #

-From #

Type: string

Absender-Adresse(n). Verhalten je nach Inhalt:

  • Nicht angegeben: From-Zeile wird ausgeblendet (oder mit -ForceFrom als Textfeld)
  • Eine Adresse: nicht editierbares Label
  • Mehrere Adressen (semikolongetrennt): Dropdown, erste = Default

-ForceFrom #

Type: switch

Erzwingt die Anzeige des From-Felds als editierbares Textfeld, auch wenn -From leer ist oder nur eine Adresse enthält.

-To #

Type: string[]

Empfängeradressen (vorbelegt). Mehrere Adressen kommagetrennt.

-Cc #

Type: string[]

CC-Empfänger (vorbelegt, optional).

-Bcc #

Type: string[]

BCC-Empfänger (vorbelegt, optional).

-Subject #

Type: string

Betreff der E-Mail (vorbelegt).

-HtmlBody #

Type: string

HTML-formatierter Inhalt (vorbelegt im Editor).

-Attachments #

Type: string[]

Dateipfade für vorgegebene Anhänge.

-DisplayName #

Type: switch

Wenn gesetzt, werden Kontakte im Format “Vorname Nachname ” eingefügt.

-Conn #

Type: __ComObject

Optionale ADODB-Verbindung zur EULANDA-Datenbank.

-AddressId #

Type: int

Adress-ID für die Kontaktabfrage. Nur zusammen mit -Conn.

-AutoClose #

Type: switch

Schließt den Dialog sofort nach Anzeige (Bench-Modus). Status im Ergebnis ist dann ‘AutoClosed’.

-Theme #

Type: string
Default: 'Light'

Light (Vorgabe) oder Dark. Hell passt zu den Fenstern der klassischen EULANDA und zu Outlook, aus denen der Dialog meist aufgerufen wird. Dark ist für Aufrufer aus einer dunklen Oberfläche, etwa der X-Suite mit dunklem Farbthema des Benutzers.

AUSGABEN #

PSCustomObject

Identisch zu Show-MailDialog: From, To, Cc, Bcc, Subject, HtmlBody, Attachments, Status (‘Send’ | ‘Cancel’ | ‘AutoClosed’).

BEISPIELE #

$mail = Show-EulMailDialog -From 'info@firma.de' -To 'kunde@beispiel.de' `
  -Subject 'Ihre Rechnung' -Attachments 'C:\Temp\rechnung.pdf'

if ($mail.Status -eq 'Send') {
  $token = Get-GraphToken -UserScope 'Mail.Send offline_access'
  Send-GraphMail -Token $token -To $mail.To `
    -Subject $mail.Subject -HtmlBody $mail.HtmlBody `
    -Attachments $mail.Attachments
}

HINWEISE #

Phase 2 von #82 - Pilot-Migration des Mail-Dialogs auf das neue UI-Toolkit. Drop-in-Replacement für Show-MailDialog.