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"

VERWANDTE LINKS

https://learn.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-messagebox