Show Eul Mail Dialog
Zuletzt geändert: 23.05.2026 10:43

Ü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
  • Light/Dark/Auto-Theme via CSS Custom Properties
  • 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: 'Auto'

Theme-Vorgabe: ‘Auto’ (Default), ‘Light’ oder ‘Dark’.

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.