New-UDToggleButtonGroup

Übersicht

Eine Umschaltschaltfläche kann verwendet werden, um zusammengehörige Optionen zu gruppieren.

Syntax

New-UDToggleButtonGroup [[-Id] <String>] [[-Color] <String>] [-Disabled] [-Exclusive] [-FullWidth] [[-OnChange] <Endpoint>] [[-Size] <String>] [[-Orientation] <String>] [[-Sx] <Hashtable>] [[-Value] <String[]>] [-Children] <ScriptBlock> [<CommonParameters>]

Beschreibung

Eine Umschaltschaltfläche kann verwendet werden, um zusammengehörige Optionen zu gruppieren.

Parameter

-Id

Die ID der Komponente. Wenn nicht angegeben, wird eine zufällige GUID zugewiesen.

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

-Color

Die Farbe der Komponente. Gültige Werte sind 'standard', 'primary', 'secondary', 'error', 'info', 'success', 'warning'.

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

-Disabled

Wenn angegeben, wird die Komponente deaktiviert.

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

-Exclusive

Wenn angegeben, erlaubt die Komponente nur eine einzelne Auswahl.

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

-FullWidth

Wenn angegeben, nimmt die Komponente die gesamte Breite ihres Containers ein.

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

-OnChange

Der Endpunkt, der aufgerufen wird, wenn sich der Wert der Komponente ändert.

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

-Size

Die Größe der Komponente. Gültige Werte sind 'small', 'medium', 'large'.

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

-Orientation

Die Ausrichtung der Komponente. Gültige Werte sind 'horizontal', 'vertical'.

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

-Sx

Der Stil der Komponente.

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

-Value <String[]>

Der Wert der Komponente.

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

-Children

Der Inhalt der Komponente. Verwenden Sie New-UDToggleButton, um Umschaltschaltflächen zu erstellen.

Required?                    true
Position?                    8
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: Exklusive Auswahl

New-UDToggleButtonGroup -Content {
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    }
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    }
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    } -Id 'test'
} -Exclusive

Bei exklusiver Auswahl hebt die Auswahl einer Option die Auswahl aller anderen auf.

Beispiel 2: Mehrfachauswahl

New-UDToggleButtonGroup -Content {
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    }
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    }
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    } -Id 'test'
}

Bei Mehrfachauswahl hebt die Auswahl einer Option die Auswahl anderer nicht auf.

Beispiel 3: Größe

New-UDToggleButtonGroup -Content {
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    }
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    }
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    } -Id 'test'
} -Size 'small'

Die kleine Größe entspricht dem kompakten Stil der Umschaltschaltfläche.

Beispiel 4: Ausrichtung

New-UDToggleButtonGroup -Content {
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    }
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    }
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    } -Id 'test'
} -Orientation 'vertical'

Die vertikale Ausrichtung kann verwendet werden, um eine Spalte von Umschaltschaltflächen anzuzeigen.

Beispiel 5: OnChange

New-UDToggleButtonGroup -Content {
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    }
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    }
    New-UDToggleButton -Content {
        New-UDIcon -Icon 'User'
    } -Id 'test'
} -OnChange {
    Show-UDToast -Message "You selected $EventData"
}

Der OnChange-Endpunkt wird aufgerufen, wenn sich der Wert der Komponente ändert. Die Ereignisdaten sind der Wert der Komponente.