Show-UDToast

Übersicht

Zeigt dem Benutzer eine Toast-Nachricht an.

Syntax

Show-UDToast [-Message] <String> [-MessageColor <DashboardColor>] [-MessageSize <String>] [-Duration <Int32>] [-Title <String>] [-TitleColor <DashboardColor>] [-TitleSize <String>] [-Id <String>] [-BackgroundColor <DashboardColor>] [-Theme <String>] [-Icon <Object>] [-IconColor <DashboardColor>] [-Position <String>] [-HideCloseButton] [-CloseOnClick] [-CloseOnEscape] [-ReplaceToast] [-RightToLeft] [-Balloon] [-Overlay] [-OverlayClose] [-OverlayColor <DashboardColor>] [-TransitionIn <String>] [-TransitionOut <String>] [-Broadcast] [-Persistent] [<CommonParameters>]

Beschreibung

Zeigt dem Benutzer eine Toast-Nachricht an.

Parameter

-Message

Die anzuzeigende Nachricht.

Required?                    true
Position?                    1
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-MessageColor

Die Textfarbe der Nachricht.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-MessageSize

Die Größe der Nachricht.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Duration

Die Dauer in Millisekunden, bevor die Nachricht verschwindet.

Required?                    false
Position?                    named
Default value                1000
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Title

Der anzuzeigende Titel.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-TitleColor

Die Textfarbe des Titels.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-TitleSize

Die Größe des Titels.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Id

Die ID des Toasts. Zur Verwendung mit Hide-UDToast.

Required?                    false
Position?                    named
Default value                [Guid]::NewGuid()
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-BackgroundColor

Die Hintergrundfarbe des Toasts.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Theme

Helles oder dunkles Design.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Icon

Das im Toast anzuzeigende Symbol.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-IconColor

Die Farbe des Symbols.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Position

Wo der Toast angezeigt werden soll.

Required?                    false
Position?                    named
Default value                topRight
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-HideCloseButton

Blendet die Schaltfläche zum Schließen aus.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-CloseOnClick

Schließt den Toast beim Anklicken.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-CloseOnEscape

Schließt den Toast, wenn die Esc-Taste gedrückt wird.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-ReplaceToast

Ersetzt einen vorhandenen Toast, falls bereits einer angezeigt wird.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-RightToLeft

Text von rechts nach links.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Balloon

Erstellt einen Ballon-Toast.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Overlay

Zeigt ein Overlay hinter dem Toast an.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-OverlayClose

Ermöglicht dem Benutzer, das Overlay zu schließen.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-OverlayColor

Die Farbe des Overlays.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-TransitionIn

Der Einblendeffekt.

Required?                    false
Position?                    named
Default value                fadeInUp
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-TransitionOut

Der Ausblendeffekt.

Required?                    false
Position?                    named
Default value                fadeOut
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Broadcast

Sendet den Toast an alle verbundenen Benutzer.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

-Persistent

Verhindert, dass der Toast aufgrund der Dauer geschlossen wird.

Required?                    false
Position?                    named
Default value                False
Accept pipeline input?       false
Aliases
Accept wildcard characters?  false

Allgemeine Parameter

Dieses Cmdlet unterstützt die allgemeinen Parameter: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable und OutVariable. Weitere Informationen finden Sie unter about_CommonParameters.

Ausgaben

Beispiele

Beispiel 1

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!'
} -Id 'toast1'

Einfacher Toast Zeigt eine Toast-Nachricht an.

Beispiel 2: Dauer

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -Duration 5000
} -Id 'toast2'

Zeigt eine Toast-Nachricht mit einer längeren Dauer an.

Beispiel 3: Titel

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -Title 'Toast Title'
} -Id 'toast3'

Zeigt eine Toast-Nachricht mit einem Titel an.

Beispiel 4: Titelfarbe

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -Title 'Toast Title' -TitleColor 'red'
} -Id 'toast4'

Zeigt eine Toast-Nachricht mit einem Titel und einer roten Titelfarbe an.

Beispiel 5: Titelgröße

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -Title 'Toast Title' -TitleColor 'red' -TitleSize 'large'
} -Id 'toast5'

Zeigt eine Toast-Nachricht mit einem Titel, einer roten Titelfarbe und einer großen Titelgröße an.

Beispiel 6: Nachrichtenfarbe

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -MessageColor 'blue'
} -Id 'toast6'

Zeigt eine Toast-Nachricht mit einer blauen Nachrichtenfarbe an.

Beispiel 7: Nachrichtengröße

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -MessageSize 'large'
} -Id 'toast7'

Zeigt eine Toast-Nachricht mit einer großen Nachrichtengröße an.

Beispiel 8: Symbol

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -Icon 'check'
} -Id 'toast8'

Zeigt eine Toast-Nachricht mit einem Häkchen-Symbol an.

Beispiel 9: Persistent

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -Persistent -Id 'MyToast'
} -Id 'toast9'
New-UDButton -Text 'Hide Toast' -OnClick {
   Hide-UDToast -Id 'MyToast'
} -Id 'toast10'

Zeigt eine Toast-Nachricht an, die nicht geschlossen wird. Mit dem Befehl Hide-UDToast kann der Toast geschlossen werden.

Beispiel 10: Position

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -Position 'bottomRight'
} -Id 'toast11'

Zeigt eine Toast-Nachricht unten rechts auf dem Bildschirm an.

Beispiel 11: Schaltfläche zum Schließen ausblenden

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -HideCloseButton
} -Id 'toast12'

Zeigt eine Toast-Nachricht ohne Schaltfläche zum Schließen an.

Beispiel 12: Beim Klicken schließen

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -CloseOnClick
} -Id 'toast13'

Zeigt eine Toast-Nachricht an, die beim Anklicken geschlossen wird.

Beispiel 13: Bei Esc schließen

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -CloseOnEscape
} -Id 'toast14'

Zeigt eine Toast-Nachricht an, die geschlossen wird, wenn die Esc-Taste gedrückt wird.

Beispiel 14: Toast ersetzen

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -ReplaceToast -Id "toastId"
} -Id 'toast15'

Zeigt eine Toast-Nachricht an, die einen vorhandenen Toast ersetzt. -Id ist erforderlich.

Beispiel 15: Von rechts nach links

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -RightToLeft
} -Id 'toast16'

Zeigt eine Toast-Nachricht mit Text von rechts nach links an.

Beispiel 16: Ballon

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -Balloon
} -Id 'toast17'

Zeigt eine Toast-Nachricht als Ballon an.

Beispiel 17: Overlay

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -Overlay
} -Id 'toast18'

Zeigt eine Toast-Nachricht als Overlay an.

Beispiel 18: Design

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -Theme 'dark'
} -Id 'toast19'

Zeigt eine Toast-Nachricht mit einem dunklen Design an.

Beispiel 19: Hintergrundfarbe

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -BackgroundColor 'red'
} -Id 'toast20'

Zeigt eine Toast-Nachricht mit einer roten Hintergrundfarbe an.

Beispiel 20: Übergang

New-UDButton -Text 'Show Toast' -OnClick {
   Show-UDToast -Message 'Hello, World!' -TransitionIn 'bounceInLeft' -TransitionOut 'bounceInRight'
} -Id 'toast21'

Zeigt eine Toast-Nachricht mit einem Bounce-In-Left-Übergang und einem Bounce-Out-Right-Übergang an.