New-UDTransferList

Creates a transfer list component.

Synopsis

Creates a transfer list component.

Syntax

New-UDTransferList [[-Id] <String>] [[-Item] <ScriptBlock>] [[-SelectedItem] <String[]>] [[-OnChange] <Endpoint>] [[-ClassName] <String>] [-Disabled] [[-Height] <String>] [[-Width] <String>] [-ShowSearch] [[-Alignment] <String>] [-Dense] [[-LeftTitle] <String>] [[-RightTitle] <String>] [[-LeftSubTitle] <String>] [[-RightSubTitle] <String>] [-Enhanced] [<CommonParameters>]

Description

A transfer list (or "shuttle") enables the user to move one or more list items between lists.

Parameters

-Id

The ID of this component.

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

-Item

A list of items that can be transferred between lists. Use New-UDTransferListItem to create an item.

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

-SelectedItem <String[]>

A list of selected items. Use the value of item to transfer items between lists.

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

-OnChange

A script block that is executed when the user changes the selected items.

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

-ClassName

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

    -Disabled [<SwitchParameter>]

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

-Height

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

-Width

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

    -ShowSearch [<SwitchParameter>]
        Shows search box for left hand items

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

-Alignment

Alignment of the transfer list. Valid values are left, right, and center.

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

    -Dense [<SwitchParameter>]
        Makes the transfer list dense.

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

-LeftTitle

Title for the left hand list.

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

-RightTitle

Title for the right hand list.

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

-LeftSubTitle

Subtitle for the left hand list.

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

-RightSubTitle

Subtitle for the right hand list.

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

    -Enhanced [<SwitchParameter>]
        Show enhanced selection.

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

    <CommonParameters>
        This cmdlet supports the common parameters: Verbose, Debug,
        ErrorAction, ErrorVariable, WarningAction, WarningVariable,
        OutBuffer, PipelineVariable, and OutVariable. For more information, see
        about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

Outputs

-------------------------- EXAMPLE 1 --------------------------

PS >New-UDTransferList -Item {
PS >     New-UDTransferListItem -Name 'test1' -Value 1
PS >     New-UDTransferListItem -Name 'test2' -Value 2
PS >     New-UDTransferListItem -Name 'test3' -Value 3
PS >     New-UDTransferListItem -Name 'test4' -Value 4
PS >     New-UDTransferListItem -Name 'test5' -Value 5
PS > } -Id 'transferlist1'

Basic Transfer List|Creates a basic transfer list.




-------------------------- EXAMPLE 2 --------------------------

PS >New-UDTransferList -Item {
PS >     New-UDTransferListItem -Name 'test1' -Value 1
PS >     New-UDTransferListItem -Name 'test2' -Value 2
PS >     New-UDTransferListItem -Name 'test3' -Value 3
PS >     New-UDTransferListItem -Name 'test4' -Value 4
PS >     New-UDTransferListItem -Name 'test5' -Value 5
PS > } -OnChange {
PS >     if ($EventData) {
PS >        Show-UDToast ($EventData | ConvertTo-Json)
PS >     } else {
PS >        Show-UDToast "No items selected"
PS >     }
PS > } -Id 'transferlist2'

OnChange|Creates a transfer list with an OnChange script block.




-------------------------- EXAMPLE 3 --------------------------

PS >New-UDTransferList -Item {
PS >     New-UDTransferListItem -Name 'test1' -Value 1
PS >     New-UDTransferListItem -Name 'test2' -Value 2
PS >     New-UDTransferListItem -Name 'test3' -Value 3
PS >     New-UDTransferListItem -Name 'test4' -Value 4
PS >     New-UDTransferListItem -Name 'test5' -Value 5
PS > } -SelectedItem @(1, 2) -Id 'transferlist3'

Selected Items|Creates a transfer list with selected items.




-------------------------- EXAMPLE 4 --------------------------

PS >New-UDTransferList -Item {
PS >     New-UDTransferListItem -Name 'test1' -Value 1
PS >     New-UDTransferListItem -Name 'test2' -Value 2
PS >     New-UDTransferListItem -Name 'test3' -Value 3
PS >     New-UDTransferListItem -Name 'test4' -Value 4
PS >     New-UDTransferListItem -Name 'test5' -Value 5
PS > } -Disabled -Id 'transferlist4'

Disabled|Creates a disabled transfer list.




-------------------------- EXAMPLE 5 --------------------------

PS >New-UDTransferList -Item {
PS >     New-UDTransferListItem -Name 'test1' -Value 1
PS >     New-UDTransferListItem -Name 'test2' -Value 2
PS >     New-UDTransferListItem -Name 'test3' -Value 3
PS >     New-UDTransferListItem -Name 'test4' -Value 4
PS >     New-UDTransferListItem -Name 'test5' -Value 5 -Disabled
PS > } -Id 'transferlist5'

Disabled Item|Creates a transfer list with a disabled item.




-------------------------- EXAMPLE 6 --------------------------

PS >New-UDTransferList -Item {
PS >     New-UDTransferListItem -Name 'test1' -Value 1
PS >     New-UDTransferListItem -Name 'test2' -Value 2
PS >     New-UDTransferListItem -Name 'test3' -Value 3
PS >     New-UDTransferListItem -Name 'test4' -Value 4
PS >     New-UDTransferListItem -Name 'test5' -Value 5
PS > } -Id 'transferlist6' -Width "50%" -Height '200'

Width and Height|Creates a transfer list with a width and height.




-------------------------- EXAMPLE 7 --------------------------

PS >New-UDTransferList -Item {
PS >     New-UDTransferListItem -Name 'test1' -Value 1
PS >     New-UDTransferListItem -Name 'test2' -Value 2
PS >     New-UDTransferListItem -Name 'test3' -Value 3
PS >     New-UDTransferListItem -Name 'test4' -Value 4
PS >     New-UDTransferListItem -Name 'test5' -Value 5
PS > } -Id 'transferlist7' -Dense

Dense|Creates a transfer list with dense items.




-------------------------- EXAMPLE 8 --------------------------

PS >New-UDTransferList -Item {
PS >     New-UDTransferListItem -Name 'test1' -Value 1
PS >     New-UDTransferListItem -Name 'test2' -Value 2
PS >     New-UDTransferListItem -Name 'test3' -Value 3
PS >     New-UDTransferListItem -Name 'test4' -Value 4
PS >     New-UDTransferListItem -Name 'test5' -Value 5
PS > } -Id 'transferlist8' -ShowSearch

Show Search|Creates a transfer list with a search box.




-------------------------- EXAMPLE 9 --------------------------

PS >New-UDTransferList -Item {
PS >     New-UDTransferListItem -Name 'test1' -Value 1
PS >     New-UDTransferListItem -Name 'test2' -Value 2
PS >     New-UDTransferListItem -Name 'test3' -Value 3
PS >     New-UDTransferListItem -Name 'test4' -Value 4
PS >     New-UDTransferListItem -Name 'test5' -Value 5
PS > } -Id 'transferlist9' -LeftTitle 'Left Title' -RightTitle 'Right Title' -LeftSubTitle 'Left Subtitle' -RightSubTitle 'Right Subtitle'

Titles|Creates a transfer list with titles.




-------------------------- EXAMPLE 10 --------------------------

PS >New-UDTransferList -Item {
PS >     New-UDTransferListItem -Name 'test1' -Value 1
PS >     New-UDTransferListItem -Name 'test2' -Value 2
PS >     New-UDTransferListItem -Name 'test3' -Value 3
PS >     New-UDTransferListItem -Name 'test4' -Value 4
PS >     New-UDTransferListItem -Name 'test5' -Value 5
PS > } -Id 'transferlist10' -Enhanced

Enhanced|Creates a transfer list with enhanced selection.