Show Msg Box
Zuletzt geändert: 14.03.2026 05:56

Show-MsgBox #

ÜBERSICHT #

Zeigt eine native Windows-MessageBox, die garantiert im Vordergrund angezeigt wird.

SYNTAX #

Show-MsgBox [-Prompt] <string> [[-Buttons] <int>] [[-Title] <string>] [[-Icon] <int>]
    [[-DefaultButton] <int>] [<CommonParameters>]

BESCHREIBUNG #

Diese Funktion zeigt eine Windows-MessageBox über die native user32.dll. Das zugehörige Fensterhandle wird per GetForegroundWindow ermittelt, wodurch sichergestellt ist, dass die MessageBox immer im Vordergrund (TopMost) erscheint – auch bei Skriptstart aus dem Hintergrund.

Die Funktion unterstützt verschiedene Button-/Icon-Kombinationen und vermeidet die Anzeige in automatisierten Tests durch Abbruch bei gesetzter Umgebungsvariable PESTER_TEST_RUN=1.

PARAMETER #

-Prompt #

Type: string
Mandatory: True

Der anzuzeigende Text.

-Buttons #

Type: int
Default: 0

Button-Typ (Standard: 0 = OK). Zulässige Werte:

  • 0: OK
  • 1: OKCancel
  • 2: AbortRetryIgnore
  • 3: YesNoCancel
  • 4: YesNo
  • 5: RetryCancel

-Title #

Type: string
Default: "Info"

Titel der MessageBox (Standard: „Info“).

-Icon #

Type: int
Default: 64

Symboltyp (Standard: 64 = Info). Zulässige Werte:

  • 16: Stop
  • 32: Question
  • 48: Exclamation
  • 64: Information

-DefaultButton #

Type: int
Default: 0

Voreingestellter Button (Standard: 0). Zulässige Werte:

  • 0: 1. Button
  • 256: 2. Button
  • 512: 3. Button
  • 768: 4. Button

AUSGABEN #

int

Rückgabewert der gedrückten Taste: - 1: OK - 2: Cancel - 6: Yes - 7: No - 10: Retry - usw.

BEISPIELE #

$result = Show-MsgBox -Prompt "Möchten Sie fortfahren?" -Buttons 4 -Icon 32 -Title "Frage"