New-UDSwitch

Sinossi

Crea un nuovo switch.

Sintassi

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>]

Descrizione

Crea un nuovo switch. Uno switch si comporta come una casella di controllo ma ha un aspetto leggermente diverso.

Parametri

-Id

L'ID del componente. Per impostazione predefinita è un GUID casuale.

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

-Disabled

Indica se questo switch è disabilitato.

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

-OnChange

Un blocco di script che viene chiamato quando questo switch cambia. La variabile $EventData conterrà il valore selezionato ($true$false).

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

-Checked

Indica se questo switch è selezionato.

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

-ClassName

Una classe CSS da applicare allo switch.

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

-Color

Il colore del tema da applicare a questo switch.

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

-Label

L'etichetta da visualizzare accanto allo switch

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

L'etichetta da visualizzare quando lo switch è selezionato

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

L'etichetta da visualizzare quando lo switch non è selezionato

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

La dimensione dello switch. I valori validi sono: "small", "medium"

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

-LabelPlacement

La posizione dell'etichetta. I valori validi sono: "top", "start", "right", "bottom"

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

-CheckStyle

Applica allo switch uno stile con icone di selezione e deselezione per i daltonici.

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

-Sx

Una hashtable di stili basati sul tema da applicare allo switch.

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

-Style

Una hashtable di stili da applicare allo switch.

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

Parametri comuni

Questo cmdlet supporta i parametri comuni: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable e OutVariable. Per maggiori informazioni, consulti about_CommonParameters.

Output

Esempi

Esempio 1: switch di base

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

Crea uno switch di base.

Esempio 2: OnChange

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

Crea uno switch con un blocco di script OnChange.

Esempio 3: disabilitato

New-UDSwitch -Id 'switch3' -Disabled

Crea uno switch disabilitato.

Esempio 4: etichetta

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

Crea uno switch con un'etichetta.

Esempio 5: posizione dell'etichetta

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

Crea uno switch con un'etichetta e una posizione dell'etichetta.

Esempio 6: stile di selezione

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

Crea uno switch con un'etichetta, una posizione dell'etichetta e uno stile di selezione.