New-UDSwitch

Übersicht

Erstellt einen neuen Schalter.

Syntax

New-UDSwitch [[-Id] <String>] [-Disabled] [[-OnChange] <Endpoint>] [[-Checked] <Boolean>] [[-ClassName] <String>] [[-Color] <String>] [[-Label] <String>] [[-LabelComponent] <Hashtable>] [[-CheckedLabel] <String>] [[-CheckedLabelComponent] <Hashtable>] [[-UncheckedLabel] <String>] [[-UncheckedLabelComponent] <Hashtable>] [[-Size] <String>] [[-LabelPlacement] <String>] [-CheckStyle] [[-Sx] <Hashtable>] [[-Style] <Hashtable>] [<CommonParameters>]

Beschreibung

Erstellt einen neuen Schalter. Ein Schalter verhält sich wie ein Kontrollkästchen, sieht aber etwas anders aus.

Parameter

-Id

Die ID der Komponente. Standardmäßig eine zufällige GUID.

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

-Disabled

Ob dieser Schalter deaktiviert ist.

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

-OnChange

Ein Skriptblock, der aufgerufen wird, wenn sich dieser Schalter ändert. Die Variable $EventData enthält den aktivierten Wert ($true$false).

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

-Checked

Ob dieser Schalter aktiviert ist.

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

-ClassName

Eine CSS-Klasse, die auf den Schalter angewendet wird.

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

-Color

Die Themenfarbe, die auf diesen Schalter angewendet wird.

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

-Label

Die Beschriftung, die neben dem Schalter angezeigt wird

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

-LabelComponent

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

-CheckedLabel

Die Beschriftung, die angezeigt wird, wenn der Schalter aktiviert ist

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

-CheckedLabelComponent

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

-UncheckedLabel

Die Beschriftung, die angezeigt wird, wenn der Schalter deaktiviert ist

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

-UncheckedLabelComponent

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

-Size

Die Größe des Schalters. Gültige Werte sind: "small", "medium"

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

-LabelPlacement

Die Platzierung der Beschriftung. Gültige Werte sind: "top", "start", "right", "bottom"

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

-CheckStyle

Schalter mit Häkchen- und Nicht-Häkchen-Symbolen für Farbenblinde gestalten.

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

-Sx

Eine Hashtabelle mit themenbasierten Stilen, die auf den Schalter angewendet werden.

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

-Style

Eine Hashtabelle mit Stilen, die auf den Schalter angewendet werden.

Required?                    false
Position?                    15
Default value
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: Einfacher Schalter

New-UDSwitch -Id 'switch1' -Checked $true

Erstellt einen einfachen Schalter.

Beispiel 2: OnChange

New-UDSwitch -Id 'switch2' -Checked $true -OnChange {
    Show-UDToast -Message "Switch changed to $($EventData)"
}

Erstellt einen Schalter mit einem OnChange-Skriptblock.

Beispiel 3: Deaktiviert

New-UDSwitch -Id 'switch3' -Disabled

Erstellt einen deaktivierten Schalter.

Beispiel 4: Beschriftung

New-UDSwitch -Id 'switch4' -Checked $true -Label 'On' -UncheckedLabel 'Off'

Erstellt einen Schalter mit einer Beschriftung.

Beispiel 5: Beschriftungsplatzierung

New-UDSwitch -Id 'switch5' -Checked $true -Label 'On' -UncheckedLabel 'Off' -LabelPlacement 'bottom'

Erstellt einen Schalter mit einer Beschriftung und einer Beschriftungsplatzierung.

Beispiel 6: Häkchenstil

New-UDSwitch -Id 'switch6' -Checked $true -Label 'On' -UncheckedLabel 'Off' -LabelPlacement 'bottom' -CheckStyle

Erstellt einen Schalter mit einer Beschriftung, einer Beschriftungsplatzierung und einem Häkchenstil.